[100538] branches/new-help-system/base/doc
raimue at macports.org
raimue at macports.org
Fri Dec 14 17:34:40 PST 2012
Revision: 100538
https://trac.macports.org/changeset/100538
Author: raimue at macports.org
Date: 2012-12-14 17:34:40 -0800 (Fri, 14 Dec 2012)
Log Message:
-----------
Update port.1 with merged changes from trunk and other improvements
Modified Paths:
--------------
branches/new-help-system/base/doc/port.1
branches/new-help-system/base/doc/port.1.txt
Modified: branches/new-help-system/base/doc/port.1
===================================================================
--- branches/new-help-system/base/doc/port.1 2012-12-15 01:29:05 UTC (rev 100537)
+++ branches/new-help-system/base/doc/port.1 2012-12-15 01:34:40 UTC (rev 100538)
@@ -173,7 +173,7 @@
\fIleaves\fR: installed ports that are unrequested and have no dependents
.RE
.sp
-Sets of ports can also be specified with \fIpseudo\-portname selectors\fR, which expand to the ports in which the value of the \fIPortfile\fR option corresponding to the selector\(cqs name (in either singular or plural form where applicable) matches the given regular expres\- sion\&. Usage is: selector:regex
+Sets of ports can also be specified with \fIpseudo\-portname selectors\fR, which expand to the ports in which the value of the \fIPortfile\fR option corresponding to the selector\(cqs name (in either singular or plural form where applicable) matches the given regular expression\&. Usage is: selector:regex
.PP
\fBThe \fR\fB\fIpseudo\-portname selectors\fR\fR\fB are:\fR
.sp
@@ -366,6 +366,18 @@
.IP \(bu 2.3
.\}
+\fIlicense\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
\fIportdir\fR
.RE
.sp
@@ -444,7 +456,7 @@
.RS 4
.\}
.nf
-port upgrade outdated and \*(Aqpy25\-*\*(Aq
+port upgrade outdated and \*(Aqpy27\-*\*(Aq
port echo maintainer:jberry and uninstalled and \e( category:java and not commons* \e)
.fi
.if n \{\
@@ -517,16 +529,12 @@
.PP
\-s
.RS 4
-Source\-only mode, build and install from source, ignore any existing binary archives; do not create/recreate binary archives\&. (Applies only when
-\fIarchive mode\fR
-is enabled)
+Source\-only mode, build and install from source; do not attempt to fetch binary archives\&.
.RE
.PP
\-b
.RS 4
-Binary\-only mode, build and install from binary archives, ignore source, abort if no archive present; do not create/recreate binary archives from source\&. (Applies only when
-\fIarchive mode\fR
-is enabled)
+Binary\-only mode, build and install from binary archives, ignore source, abort if no archive available\&.
.RE
.PP
\fBCleaning\fR
@@ -554,7 +562,7 @@
.PP
\-o
.RS 4
-Honor state files older than Portfile
+Honor state files even if the Portfile was modified\&. This flag is called \-o because it used to mean "older"\&.
.RE
.PP
\-t
@@ -632,7 +640,7 @@
port \-q info \-\-category \-\-name \-\-version category:java
port info \-\-line \-\-category \-\-name all
port info \-\-pretty \-\-fullname \-\-depends gtk2
-port info \-\-index python24
+port info \-\-index python27
.fi
.if n \{\
.RE
@@ -686,7 +694,7 @@
\fIinactive\fR
ports, use
\fB\-u\fR\&. To recursively uninstall all dependents of this port, use
-\fB\-\-follow\-dependents\fR\&.
+\fB\-\-follow\-dependents\fR\&. To uninstall portname and then recursively uninstall all ports it depended on, use \-\-follow\-dependencies\&. This will not uninstall dependencies that are marked as requested or that have other dependents\&.
.sp
For example:
.sp
@@ -696,13 +704,32 @@
.nf
port uninstall vim
port \-u uninstall
-port uninstall \-\-follow\-dependents python24
+port uninstall \-\-follow\-dependents python27
.fi
.if n \{\
.RE
.\}
.RE
.PP
+select
+.RS 4
+For a given group, selects a version to be the default by creating appropriate symbolic links\&. For instance, python might be linked to python2\&.6\&. Available select groups are installed as subdirec\- tories of \-\-list\&. To see which version is currently selected for a group, use \-\-show\&. To change the selected version for a group, use \-\-set\&.
+.sp
+For example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+port select \-\-list python
+port select \-\-show gcc
+port select \-\-set gcc mp\-gcc47
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.PP
activate
.RS 4
Activate the installed
@@ -862,6 +889,7 @@
.if n \{\
.RE
.\}
+.sp
.if n \{\
.sp
.\}
@@ -877,8 +905,31 @@
By selecting the variants to use in the upgraded build of the port, any variants specified on the command line take highest precedence, then the variants active in the latest installed version of the port, and finally the global variants specified in variants\&.conf, if any\&. Note that upgrade will not normally rebuild a port only to change the selected variants; you can either specify \-\-enforce\-variants, or deactivate the port and reinstall it with different variants\&.
.sp .5v
.RE
+\ \&
+.sp
+After the upgrade MacPorts will automatically run rev\-upgrade to check for broken ports that need to be rebuilt\&. If there are known problems with rev\-upgrade or other reasons why you would want to avoid running this step, you can disable it by running port upgrade with the \-\-no\-rev\-upgrade switch:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+port upgrade \-\-no\-rev\-upgrade outdated
+.fi
+.if n \{\
.RE
+.\}
+.RE
.PP
+rev\-upgrade
+.RS 4
+Manually check for broken binaries and rebuild ports containing broken binaries\&. rev\-upgrade is usually automatically run after each upgrade, unless you specify the \-\-no\-rev\-upgrade option\&.
+
+rev\-upgrade can run more checks against a special loadcommand in Mach\-O binaries that should always be referencing the file itself\&. This check is most helpful for maintainers to check whether their ports have been built correctly\&. It is disabled by default and can be enabled by passing \-\-id\- loadcmd\-check to rev\-upgrade\&.
+
+See also:
+\fBmacports.conf\fR(5)
+.RE
+.PP
clean
.RS 4
Clean the files used for building
@@ -1012,7 +1063,7 @@
.RS 4
.\}
.nf
-sudo port \-d selfupdate
+sudo port selfupdate
.fi
.if n \{\
.RE
@@ -1103,7 +1154,7 @@
\fIed\fR
also invokes this command\&.
-You can also use the \-\-editor flag on the command line to specify an alternative edi\- tor\&.
+You can also use the \-\-editor flag on the command line to specify an alternative editor\&.
.sp
For example:
.sp
@@ -1118,14 +1169,6 @@
.\}
.RE
.PP
-unarchive
-.RS 4
-Unpack the port from a pre\-built binary archive\&. When archive mode is enabled, this command is called automatically, prior to
-\fIfetch\fR, to check for an existing binary archive to unpack\&. If found, it is unpacked and all stages up to
-\fIinstall\fR
-are then skipped\&.
-.RE
-.PP
fetch
.RS 4
Fetches the distribution files required to build
@@ -1183,11 +1226,6 @@
\fB\-\-nitpick\fR\&.
.RE
.PP
-archive
-.RS 4
-Archive the port for a later unarchive\&. When archive mode is enabled, binary archives will be created automatically whenever an install is performed, or when the archive target is called explicitly\&.
-.RE
-.PP
distcheck
.RS 4
Check if the distfiles haven\(cqt changed and can be fetched\&.
@@ -1308,7 +1346,7 @@
Matt Anton <matt at opendarwin\&.org>
Joe Auty <joe at opendarwin\&.org>
Rainer Mueller <raimue at macports\&.org>
-(C) 2009\-2010 The MacPorts Project
+(C) 2009\-2012 The MacPorts Project
.fi
.if n \{\
.RE
Modified: branches/new-help-system/base/doc/port.1.txt
===================================================================
--- branches/new-help-system/base/doc/port.1.txt 2012-12-15 01:29:05 UTC (rev 100537)
+++ branches/new-help-system/base/doc/port.1.txt 2012-12-15 01:34:40 UTC (rev 100538)
@@ -57,7 +57,7 @@
Sets of ports can also be specified with 'pseudo-portname selectors', which
expand to the ports in which the value of the 'Portfile' option corresponding
to the selector's name (in either singular or plural form where applicable)
-matches the given regular expres- sion. Usage is: selector:regex
+matches the given regular expression. Usage is: selector:regex
[options="compact"]
.The 'pseudo-portname selectors' are:
@@ -76,6 +76,7 @@
- 'description'
- 'long_description'
- 'homepage'
+ - 'license'
- 'portdir'
Other pseudo-portname selectors match ports which have a particular
@@ -107,7 +108,7 @@
For example:
--------
-port upgrade outdated and 'py25-*'
+port upgrade outdated and 'py27-*'
port echo maintainer:jberry and uninstalled and \( category:java and not commons* \)
--------
@@ -150,14 +151,12 @@
.Sources
-s::
- Source-only mode, build and install from source, ignore any existing binary
- archives; do not create/recreate binary archives. (Applies only when
- 'archive mode' is enabled)
+ Source-only mode, build and install from source; do not attempt to fetch
+ binary archives.
-b::
Binary-only mode, build and install from binary archives, ignore source,
- abort if no archive present; do not create/recreate binary archives from
- source. (Applies only when 'archive mode' is enabled)
+ abort if no archive available.
.Cleaning
-c::
@@ -173,7 +172,8 @@
.Development
-o::
- Honor state files older than Portfile
+ Honor state files even if the Portfile was modified. This flag is called -o
+ because it used to mean "older".
-t::
Enable trace mode debug facilities on platforms that support it, currently
@@ -237,7 +237,7 @@
port -q info --category --name --version category:java
port info --line --category --name all
port info --pretty --fullname --depends gtk2
-port info --index python24
+port info --index python27
--------
notes::
@@ -272,18 +272,37 @@
Install and activate 'portname'.
uninstall::
- Deactivate and uninstall portname. To uninstall all installed but
- 'inactive' ports, use *-u*. To recursively uninstall all dependents of
- this port, use *--follow-dependents*.
+ Deactivate and uninstall portname. To uninstall all installed but 'inactive'
+ ports, use *-u*. To recursively uninstall all dependents of this port, use
+ *--follow-dependents*. To uninstall portname and then recursively uninstall
+ all ports it depended on, use --follow-dependencies. This will not
+ uninstall dependencies that are marked as requested or that have other
+ dependents.
+
For example:
+
--------
port uninstall vim
port -u uninstall
-port uninstall --follow-dependents python24
+port uninstall --follow-dependents python27
--------
+select::
+ For a given group, selects a version to be the default by creating
+ appropriate symbolic links. For instance, python might be linked to
+ python2.6. Available select groups are installed as subdirec- tories of
+ ${prefix}/etc/select/. To list the available versions in a group, use
+ --list. To see which version is currently selected for a group, use --show.
+ To change the selected version for a group, use --set.
++
+For example:
++
+--------
+port select --list python
+port select --show gcc
+port select --set gcc mp-gcc47
+--------
+
activate::
Activate the installed 'portname'.
@@ -381,8 +400,33 @@
a port only to change the selected variants; you can either specify
--enforce-variants, or deactivate the port and reinstall it with different
variants.
+
+// Forcing a new paragraph here by inserting a dummy space
+{nbsp}
+
+After the upgrade MacPorts will automatically run rev-upgrade to check for
+broken ports that need to be rebuilt. If there are known problems with
+rev-upgrade or other reasons why you would want to avoid running this step, you
+can disable it by running port upgrade with the --no-rev-upgrade switch:
+
+--------
+port upgrade --no-rev-upgrade outdated
+--------
--
+rev-upgrade::
+ Manually check for broken binaries and rebuild ports containing broken
+ binaries. rev-upgrade is usually automatically run after each upgrade,
+ unless you specify the --no-rev-upgrade option.
+ +
+ rev-upgrade can run more checks against a special loadcommand in Mach-O
+ binaries that should always be referencing the file itself. This check is
+ most helpful for maintainers to check whether their ports have been built
+ correctly. It is disabled by default and can be enabled by passing --id-
+ loadcmd-check to rev-upgrade.
+ +
+ See also: man:macports.conf[5]
+
clean::
Clean the files used for building 'portname'. To just remove the work files,
use the *--work* 'actionflag'. This is the default when no flag is given.
@@ -451,8 +495,8 @@
(though if no database is found, it will be created automatically). If the
fetched file does not match the checksum given in the Portfile, it is
deleted. This can be used with 'pseudo-portnames', e.g. 'all', to mirror
- everything. Note that if you use 'all', you'll most likely want to use *-p* so
- *port* doesn't quit on the first download failure.
+ everything. Note that if you use 'all', you'll most likely want to use *-p*
+ so *port* doesn't quit on the first download failure.
version::
Display the release number of the installed MacPorts infrastructure.
@@ -464,7 +508,7 @@
To update you would typically do:
+
--------
-sudo port -d selfupdate
+sudo port selfupdate
--------
+
See 'sync' for more information about updating ports tree(s).
@@ -520,8 +564,8 @@
ed::
Opens Portfile with your default editor specified in your shell's
environment variable. Alias 'ed' also invokes this command. +
- You can also use the --editor flag on the command line to specify an alternative edi-
- tor.
+ You can also use the --editor flag on the command line to specify an
+ alternative editor.
+
For example:
+
@@ -529,12 +573,6 @@
port edit --editor nano apache2
--------
-unarchive::
- Unpack the port from a pre-built binary archive. When archive mode is
- enabled, this command is called automatically, prior to 'fetch', to check for
- an existing binary archive to unpack. If found, it is unpacked and all
- stages up to 'install' are then skipped.
-
fetch::
Fetches the distribution files required to build 'portname'.
@@ -564,11 +602,6 @@
Verifies Portfile for portname. To nitpick about whitespace and patchfile
names, use *--nitpick*.
-archive::
- Archive the port for a later unarchive. When archive mode is enabled,
- binary archives will be created automatically whenever an install is
- performed, or when the archive target is called explicitly.
-
distcheck::
Check if the distfiles haven't changed and can be fetched.
@@ -660,4 +693,4 @@
Matt Anton <matt at opendarwin.org>
Joe Auty <joe at opendarwin.org>
Rainer Mueller <raimue at macports.org>
- (C) 2009-2010 The MacPorts Project
+ (C) 2009-2012 The MacPorts Project
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20121214/7f2f60a8/attachment.html>
More information about the macports-changes
mailing list