[66200] trunk/base
jmr at macports.org
jmr at macports.org
Tue Apr 6 22:18:26 PDT 2010
Revision: 66200
http://trac.macports.org/changeset/66200
Author: jmr at macports.org
Date: 2010-04-06 22:18:25 -0700 (Tue, 06 Apr 2010)
Log Message:
-----------
document new actions and pseudo-ports
Modified Paths:
--------------
trunk/base/doc/port.1
trunk/base/src/port/port-help.tcl
trunk/base/src/port/port.tcl
Modified: trunk/base/doc/port.1
===================================================================
--- trunk/base/doc/port.1 2010-04-07 04:33:18 UTC (rev 66199)
+++ trunk/base/doc/port.1 2010-04-07 05:18:25 UTC (rev 66200)
@@ -119,6 +119,18 @@
.Ar obsolete :
set of ports that are installed but no longer exist in any port tree
.Pp
+.It
+.Ar requested :
+installed ports that were explicitly asked for.
+.Pp
+.It
+.Ar unrequested :
+installed ports that were installed only to satisfy dependencies.
+.Pp
+.It
+.Ar leaves :
+installed ports that are unrequested and have no dependents.
+.Pp
.El
Other options, also known as
.Ar pseudo-portname selectors ,
@@ -164,6 +176,22 @@
Search strings that will expand to a set of matching ports can be constructed based on the
.Ar \(rqpseudo-portname selector\(lq:regex
combination used.
+.Pp
+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:
+.Pp
+.Bl -bullet -offset indent -compact
+.It
+.Ar depof
+.It
+.Ar rdepof
+.It
+.Ar dependentof
+.It
+.Ar rdependentof
+.El
+.Pp
.Ar portnames
containing valid UNIX glob patterns will also expand to the set of matching ports. Any
.Ar action
@@ -173,6 +201,7 @@
.Pp
.Dl port list variant:no_ssl
.Dl port uninstall name:sql
+.Dl port echo depof:mysql5
.\" COMMENT: glob pattern expansion in portnames:
.\" write an example here that illustrats better glob pattern expansion in portnames, but that does not employ
.\" logical operators (and, or, not, !) because I still haven't gotten to them yet.
@@ -293,9 +322,25 @@
Lists the other ports that are required to build and run
.Ar portname .
This is simply an alias for "info --pretty --fullname --depends".
+.Ss rdeps
+Recursively lists the other ports that are required to build and run
+.Ar portname .
+To display the full dependency tree instead of only showing each port once, use
+.Fl -full .
+To take dependency information from the PortIndex instead of the Portfile
+(faster, but does not take variant selections into account), use
+.Fl -index .
+To exclude dependencies that are only needed at build time (i.e.
+depends_fetch, depends_extract, depends_build), use
+.Fl -no-build .
.Ss dependents
Lists the installed ports that depend on the port
.Ar portname .
+.Ss dependents
+Recursively lists the installed ports that depend on the port
+.Ar portname .
+To display the full tree of dependents instead of only showing each port once, use
+.Fl -full .
.Ss install
Install and activate
.Ar portname .
@@ -318,6 +363,14 @@
.Ss deactivate
Deactivate the installed
.Ar portname .
+.Ss setrequested
+Mark
+.Ar portname
+as requested.
+.Ss unsetrequested
+Mark
+.Ar portname
+as unrequested.
.Ss installed
Show the installed versions and variants for
.Ar portname .
Modified: trunk/base/src/port/port-help.tcl
===================================================================
--- trunk/base/src/port/port-help.tcl 2010-04-07 04:33:18 UTC (rev 66199)
+++ trunk/base/src/port/port-help.tcl 2010-04-07 05:18:25 UTC (rev 66200)
@@ -73,10 +73,29 @@
Dependents are those ports which depend on the given port, not vice-versa!
}
+set porthelp(rdependents) {
+Recursive version of dependents
+
+--full Display all branches of the tree of dependents instead of only
+ showing each port once.
+}
+
set porthelp(deps) {
This action is an alias for 'info --pretty --fullname --depends'
}
+set porthelp(rdeps) {
+Display a recursive dependency listing for the given ports
+
+--full Display all branches of the dependency tree instead of only
+ showing each port once.
+--index Do not read the Portfile, instead rely solely on the PortIndex
+ information. Note this option will prevent the dependencies
+ reported from reflecting the effects of any variants specified.
+--no-build Exclude dependencies only required at build time, i.e.
+ depends_fetch, depends_extract, and depends_build.
+}
+
set porthelp(destroot) {
Destroot the given ports
}
@@ -265,6 +284,14 @@
Creates a srpm for each of the given ports
}
+set porthelp(setrequested) {
+Marks each of the given ports as requested
+}
+
+set porthelp(unsetrequested) {
+Marks each of the given ports as unrequested
+}
+
set porthelp(submit) {
Submit a port to the MacPorts Web Application (unimplemented)
}
Modified: trunk/base/src/port/port.tcl
===================================================================
--- trunk/base/src/port/port.tcl 2010-04-07 04:33:18 UTC (rev 66199)
+++ trunk/base/src/port/port.tcl 2010-04-07 05:18:25 UTC (rev 66200)
@@ -88,14 +88,16 @@
----------------
Pseudo-portnames are words that may be used in place of a portname, and
which expand to some set of ports. The common pseudo-portnames are:
-all, current, active, inactive, installed, uninstalled, outdated and obsolete.
+all, current, active, inactive, installed, uninstalled, outdated, obsolete,
+requested, unrequested and leaves.
These pseudo-portnames expand to the set of ports named.
Additional pseudo-portnames start with...
variants:, variant:, description:, depends:, depends_lib:, depends_run:,
depends_build:, depends_fetch:, depends_extract:, portdir:, homepage:, epoch:,
platforms:, platform:, name:, long_description:, maintainers:, maintainer:,
-categories:, category:, version:, revision:, and license:.
+categories:, category:, version:, revision:, license:, depof:, rdepof:,
+dependentof:, and rdependentof:.
These each select a set of ports based on a regex search of metadata
about the ports. In all such cases, a standard regex pattern following
the colon will be used to select the set of ports to which the
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20100406/f2d2fe9e/attachment.html>
More information about the macports-changes
mailing list