[69815] branches/new-help-system/base/doc
raimue at macports.org
raimue at macports.org
Fri Jul 16 19:23:38 PDT 2010
Revision: 69815
http://trac.macports.org/changeset/69815
Author: raimue at macports.org
Date: 2010-07-16 19:23:35 -0700 (Fri, 16 Jul 2010)
Log Message:
-----------
Merge changes from port.1 on trunk
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 2010-07-17 02:11:26 UTC (rev 69814)
+++ branches/new-help-system/base/doc/port.1 2010-07-17 02:23:35 UTC (rev 69815)
@@ -128,7 +128,43 @@
\fIobsolete\fR: set of ports that are installed but no longer exist in any port tree
.RE
.sp
-Other options, also known as \fIpseudo\-portname selectors\fR, matching the searchable keys used in a \fIPortfile\fR are also accepted\&. Where applicable, both singular and plural forms are accepted\&.
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIrequested\fR: installed ports that were explicitly asked for
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIunrequested\fR: installed ports that were installed only to satisfy dependencies
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\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
.PP
\fBThe \fR\fB\fIpseudo\-portname selectors\fR\fR\fB are:\fR
.sp
@@ -324,6 +360,56 @@
\fIportdir\fR
.RE
.sp
+Other pseudo\-portname selectors match ports which have a particular relationship to another port\&. These will match ports that are direct or recursive dependencies or dependents of the given portname:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIdepof\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIrdepof\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIdependentof\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIrdependentof\fR
+.RE
+.sp
Search strings that will expand to a set of matching ports can be constructed based on the "\fIpseudo\-portname selector\fR":regex combination used\&. \fIportnames\fR containing valid UNIX glob patterns will also expand to the set of matching ports\&. Any action passed to port will be invoked on each of them\&.
.sp
For example:
@@ -334,6 +420,7 @@
.nf
port info variant:no_ssl
port uninstall name:sql
+port echo depof:mysql5
port echo \'apache*\'
.fi
.if n \{\
@@ -561,12 +648,23 @@
Lists the other ports that are required to build and run portname\&. This is simply an alias for \(lqinfo \-\-pretty \-\-fullname \-\-depends\(rq\&.
.RE
.PP
+rdeps
+.RS 4
+Recursively lists the other ports that are required to build and run portname\&. To display the full dependency tree instead of only showing each port once, use \-\-full\&. To take dependency information from the PortIndex instead of the Portfile (faster, but does not take variant selections into account), use \-\-index\&. To exclude dependencies that are only needed at build time (i\&.e\&. depends_fetch, depends_extract, depends_build), use
+\fB\-\-no\-build\fR\&.
+.RE
+.PP
dependents
.RS 4
Lists the installed ports that depend on the port
\fIportname\fR\&.
.RE
.PP
+rdependents
+.RS 4
+Recursively lists the installed ports that depend on the port portname\&. To display the full tree of dependents instead of only showing each port once, use \-\-full\&.
+.RE
+.PP
install
.RS 4
Install and activate
@@ -608,6 +706,16 @@
\fIportname\fR\&.
.RE
.PP
+setrequested
+.RS 4
+Mark portname as requested\&.
+.RE
+.PP
+unsetrequested
+.RS 4
+Mark portname as unrequested\&.
+.RE
+.PP
installed
.RS 4
Show the installed version, variants and activation status for each
Modified: branches/new-help-system/base/doc/port.1.txt
===================================================================
--- branches/new-help-system/base/doc/port.1.txt 2010-07-17 02:11:26 UTC (rev 69814)
+++ branches/new-help-system/base/doc/port.1.txt 2010-07-17 02:23:35 UTC (rev 69815)
@@ -49,10 +49,15 @@
current version/revision in the ports tree(s)
- 'obsolete': set of ports that are installed but no longer exist in any
port tree
+ - 'requested': installed ports that were explicitly asked for
+ - 'unrequested': installed ports that were installed only to satisfy
+ dependencies
+ - 'leaves': installed ports that are unrequested and have no dependents
-Other options, also known as 'pseudo-portname selectors', matching the
-searchable keys used in a 'Portfile' are also accepted. Where applicable, both
-singular and plural forms are accepted.
+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
[options="compact"]
.The 'pseudo-portname selectors' are:
@@ -73,6 +78,16 @@
- 'homepage'
- 'portdir'
+Other pseudo-portname selectors match ports which have a particular
+relationship to another port. These will match ports that are direct or
+recursive dependencies or dependents of the given portname:
+
+[options="compact"]
+ - 'depof'
+ - 'rdepof'
+ - 'dependentof'
+ - 'rdependentof'
+
Search strings that will expand to a set of matching ports can be constructed
based on the "'pseudo-portname selector'":regex combination used. 'portnames'
containing valid UNIX glob patterns will also expand to the set of matching
@@ -82,6 +97,7 @@
--------
port info variant:no_ssl
port uninstall name:sql
+port echo depof:mysql5
port echo 'apache*'
--------
@@ -235,9 +251,23 @@
Lists the other ports that are required to build and run portname. This is
simply an alias for ``info --pretty --fullname --depends''.
+rdeps::
+ Recursively lists the other ports that are required to build and run
+ portname. To display the full dependency tree instead of only showing each
+ port once, use --full. To take dependency information from the PortIndex
+ instead of the Portfile (faster, but does not take variant selections into
+ account), use --index. To exclude dependencies that are only needed at
+ build time (i.e. depends_fetch, depends_extract, depends_build), use
+ *--no-build*.
+
dependents::
Lists the installed ports that depend on the port 'portname'.
+rdependents::
+ Recursively lists the installed ports that depend on the port portname. To
+ display the full tree of dependents instead of only showing each port once,
+ use --full.
+
install::
Install and activate 'portname'.
@@ -260,6 +290,12 @@
deactivate::
Deactivate the installed 'portname'.
+setrequested::
+ Mark portname as requested.
+
+unsetrequested::
+ Mark portname as unrequested.
+
installed::
Show the installed version, variants and activation status for each
'portname'. If no arguments are given, all installed ports are displayed.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20100716/c84e4dbd/attachment-0001.html>
More information about the macports-changes
mailing list