<pre style='margin:0'>
Rainer Müller (raimue) pushed a commit to branch master
in repository macports-base.
</pre>
<p><a href="https://github.com/macports/macports-base/commit/0beb6b72a2edd7ef1d9828c51b05fab142287757">https://github.com/macports/macports-base/commit/0beb6b72a2edd7ef1d9828c51b05fab142287757</a></p>
<pre style="white-space: pre; background: #F8F8F8"><span style='display:block; white-space:pre;color:#808000;'>commit 0beb6b72a2edd7ef1d9828c51b05fab142287757
</span>Author: Rainer Müller <raimue@macports.org>
AuthorDate: Tue Jan 9 16:58:43 2018 +0100
<span style='display:block; white-space:pre;color:#404040;'> doc: Regenerate man pages
</span>---
doc/port.1 | 467 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 466 insertions(+), 1 deletion(-)
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port.1 b/doc/port.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 24b8eec..e60953f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port.1
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,5 +1,5 @@
</span> '\" t
<span style='display:block; white-space:pre;background:#ffe0e0;'>-.TH "PORT" "1" "2017\-10\-25" "MacPorts 2\&.4\&.99" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT" "1" "2018\-01\-09" "MacPorts 2\&.4\&.99" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,16 +19,24 @@
</span> .\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "NAME"
port \- Command line interface for MacPorts
.SH "SYNOPSIS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.nf
\fBport\fR [\fB\-bcdfknNopqRstuvy\fR] [\fB\-D\fR \fIportdir\fR] [\fB\-F\fR \fIcmdfile\fR] [\fIaction\fR] [\fIactionflags\fR]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[[\fI@version\fR] [+/\-variant \&...] \&... [option=value \&...]]
.fi
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "DESCRIPTION"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR is designed to operate on individual or multiple \fIports\fR, optionally within a single call, based on the requested \fIaction\fR\&. If no \fIaction\fR is specified the port command enters shell mode, in which commands are read via stdin\&. If no \fIportdir\fR or \fIportname\fR is specified for an \fIaction\fR, the current working directory is assumed\&. Batch commands may be passed via a \fIcmdfile\fR\&. Port \fIoptions\fR are passed as key=value pairs and take precedence ov [...]
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -48,6 +56,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIall\fR: all the ports in each ports tree listed in
\fIsources\&.conf\fR
.RE
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -60,6 +69,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIcurrent\fR: the port in the current working directory
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -71,6 +81,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIactive\fR: set of installed and active ports
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -82,6 +93,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIinactive\fR: set of installed but inactive ports
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -93,6 +105,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIinstalled\fR: set of all installed ports
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -104,6 +117,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIuninstalled\fR: ports in the ports tree(s) that are not installed
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -115,6 +129,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIoutdated\fR: installed ports that are out of date with respect to their current version/revision in the ports tree(s)
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -126,6 +141,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIobsolete\fR: set of ports that are installed but no longer exist in any port tree
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -137,6 +153,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIrequested\fR: installed ports that were explicitly asked for
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -148,6 +165,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIunrequested\fR: installed ports that were installed only to satisfy dependencies
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -159,6 +177,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIleaves\fR: installed ports that are unrequested and have no dependents
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -170,6 +189,7 @@ When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIrleaves\fR: installed ports that are unrequested and that no requested ports depend on
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -185,6 +205,7 @@ Sets of ports can also be specified with \fIpseudo\-portname selectors\fR, which
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIname\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -196,6 +217,7 @@ Sets of ports can also be specified with \fIpseudo\-portname selectors\fR, which
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIversion\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -207,6 +229,7 @@ Sets of ports can also be specified with \fIpseudo\-portname selectors\fR, which
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIrevision\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -218,6 +241,7 @@ Sets of ports can also be specified with \fIpseudo\-portname selectors\fR, which
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIepoch\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -229,6 +253,7 @@ Sets of ports can also be specified with \fIpseudo\-portname selectors\fR, which
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIvariant\fR
or
\fIvariants\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -242,6 +267,7 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIcategory\fR
or
\fIcategories\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -255,6 +281,7 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fImaintainer\fR
or
\fImaintainers\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -268,6 +295,7 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIplatform\fR
or
\fIplatforms\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -281,6 +309,7 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIdescription\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -292,6 +321,7 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIlong_description\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -303,6 +333,7 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIhomepage\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -314,6 +345,7 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIlicense\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -325,10 +357,12 @@ or
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \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:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.RS 4
.ie n \{\
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -338,6 +372,7 @@ Other pseudo\-portname selectors match ports which have a particular relationshi
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIdepof\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -349,6 +384,7 @@ Other pseudo\-portname selectors match ports which have a particular relationshi
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIrdepof\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -360,6 +396,7 @@ Other pseudo\-portname selectors match ports which have a particular relationshi
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIrdepends\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -371,6 +408,7 @@ Other pseudo\-portname selectors match ports which have a particular relationshi
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fIdependentof\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -382,12 +420,14 @@ Other pseudo\-portname selectors match ports which have a particular relationshi
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \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:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -405,6 +445,7 @@ port echo \*(Aqapache*\*(Aq
</span> Logical operators "and", "or", "not", "!", "(" and ")" may be used to combine individual \fIportnames\fR, port glob patterns and/or \fIpseudo\-portnames\fR to construct complex \fIport\-expressions\fR that expand to the set of matching ports\&.
.sp
For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -416,6 +457,7 @@ port echo maintainer:jberry and uninstalled and \e( category:java and not common
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .if n \{\
.sp
.\}
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -433,133 +475,222 @@ Special shell characters like *, \e( or \e) need to be escaped in order to be pa
</span> .sp .5v
.RE
.SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The port command recognizes several global flags and options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBOutput control\fR
.PP
\-v
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Verbose mode, generates verbose messages
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-d
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Debug mode, generate debugging messages, implies \-v
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-q
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Quiet mode, suppress informational messages to a minimum, implies \-N
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-N
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Non\-interactive mode, interactive questions are not asked
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBInstallation and upgrade\fR
.PP
\-n
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Don\(cqt follow dependencies in upgrade (affects
\fIupgrade\fR
and
\fIinstall\fR)
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-R
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Also upgrade dependents (only for
\fIupgrade\fR)
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-u
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Uninstall inactive ports when upgrading and uninstalling
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-y
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Perform a dry run\&. All of the steps to build the ports and their dependencies are computed, but not actually performed\&. With the verbose flag, every step is reported; otherwise there is just one message per port, which allows you to easily determine the recursive deps of a port (and the order in which they will be built)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBSources\fR
.PP
\-s
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Source\-only mode, build and install from source; do not attempt to fetch binary archives\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-b
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Binary\-only mode, build and install from binary archives, ignore source, abort if no archive available\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBCleaning\fR
.PP
\-c
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Autoclean mode, execute clean after
\fIinstall\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-k
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Keep mode, do not autoclean after
\fIinstall\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBExit status\fR
.PP
\-p
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Despite any errors encountered, proceed to process multiple ports and commands\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBDevelopment\fR
.PP
\-o
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Honor state files even if the Portfile was modified\&. This flag is called \-o because it used to mean "older"\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-t
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Enable trace mode debug facilities on platforms that support it, currently only Mac OS X\&.
This feature is two\-folded\&. It consists in automatically detecting and reporting undeclared dependencies based on what files the port reads or what programs the port executes\&. In verbose mode, it will also report unused dependencies for each stage of the port installation\&. It also consists in forbidding and reporting file creation and file writes outside allowed directories (temporary directories and ${workpath})\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBMisc\fR
.PP
\-f
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Force mode, ignore state file
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-D \fIportdir\fR
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Specfiy
\fIportdir\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\-F \fIcmdfile\fR
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Read and process the
\fIfile\fR
of commands specified by the argument\&. If the argument is
\fI\-\fR, then read commands from stdin\&. If the option is given multiple times, then multiple files will be read\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "USER ACTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Actions most commonly used by regular MacPorts users are:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
search
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Search for an available port whose name or description matches a regular expression\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -570,10 +701,15 @@ port search vim
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
info
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays meta\-information available for
\fIportname\fR\&. Specific meta\-information may be requested through an option such as
\fB\-\-maintainer\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -588,7 +724,9 @@ is provided, the information will be formatted in a somewhat more attractive fas
</span> \fB\-\-index\fR
is provided, the information will be pulled from the PortIndex rather than from the Portfile\&. In this case variant information, such as dependencies, will not affect the output\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -604,54 +742,87 @@ port info \-\-index python27
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
notes
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays notes for
\fIportname\fR
which usually contain useful information concerning setup and use of the port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
variants
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Lists the variants available for
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
deps
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Lists the other ports that are required to build and run portname\&. This is simply an alias for \(lqinfo \-\-pretty \-\-fullname \-\-depends\(rq\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
rdeps
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> 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
\fB\-\-full\fR\&. To take dependency information from the PortIndex instead of the Portfile (faster, but does not take variant selections into account), use
\fB\-\-index\fR\&. To exclude dependencies that are only needed at build time (i\&.e\&. depends_fetch, depends_extract, depends_build), use
\fB\-\-no\-build\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
dependents
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Lists the installed ports that depend on the port
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
rdependents
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> 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
\fB\-\-full\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
install
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Install and activate
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
uninstall
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Deactivate and uninstall portname\&. To uninstall all installed but
\fIinactive\fR
ports, use
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -659,7 +830,9 @@ ports, use
</span> \fB\-\-follow\-dependents\fR\&. To uninstall portname and then recursively uninstall all ports it depended on, use
\fB\-\-follow\-dependencies\fR\&. This will not uninstall dependencies that are marked as requested or that have other dependents\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -672,17 +845,24 @@ port uninstall \-\-follow\-dependents python27
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
select
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> 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 subdirectories of ${prefix}/etc/select/ and can be listed using
\fB\-\-summary\fR\&. To list the available versions in a group, use
\fB\-\-list\fR\&. To see which version is currently selected for a group, use
\fB\-\-show\fR\&. To change the selected version for a group, use
\fB\-\-set\fR\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -696,57 +876,96 @@ port select \-\-set python python34
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
activate
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Activate the installed
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
deactivate
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Deactivate the installed
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
setrequested
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Mark portname as requested\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
unsetrequested
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Mark portname as unrequested\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
setunrequested
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Alias for unsetrequested command\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
installed
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Show the installed version, variants and activation status for each
\fIportname\fR\&. If no arguments are given, all installed ports are displayed\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
location
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Print the install location of a given port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
contents
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Lists the files installed by
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
provides
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Determines which port owns a given file and can take either a relative or absolute path\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -758,13 +977,20 @@ port provides include/tiff\&.h
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
sync
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Performs a sync operation only on the ports tree of a MacPorts installation, pulling in the latest revision available of the Portfiles from the MacPorts rsync server\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> To update you would normally do:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -776,24 +1002,35 @@ sudo port \-d sync
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> If any of the ports tree(s) uses a file: URL that points to a local subversion working copy, sync will perform an svn update on the working copy with the user set to the owner of the working copy\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
outdated
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Lists the installed ports which need a
\fIupgrade\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
upgrade
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> The upgrade action works on a port and its dependencies\&. If you want to change this behavior, look at the switches for
\fB\-n\fR
(no dependencies) and
\fB\-R\fR
(dependents) above\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Upgrade all outdated ports:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -822,8 +1059,10 @@ It is recommended to always upgrade all ports with the command indicated above\&
</span> .RE
\ \&
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Upgrade the installed
\fIportname\fR\&. For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -835,9 +1074,11 @@ port upgrade vim
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> To upgrade
\fIportname\fR
and the ports that depend on it:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -849,9 +1090,11 @@ port \-R upgrade libiconv
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> To force a rebuild of
\fIportname\fR
and all of its dependencies use:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -863,12 +1106,15 @@ port upgrade \-\-force vim
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> To upgrade
\fIportname\fR
without following its dependencies before, use
\fB\-n\fR\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -900,9 +1146,11 @@ will retain the variant merging procedure described previously\&. Variants will
</span> .RE
\ \&
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> 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
\fB\-\-no\-rev\-upgrade\fR
switch:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -913,10 +1161,15 @@ port upgrade \-\-no\-rev\-upgrade outdated
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
rev\-upgrade
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Manually check for broken binaries and rebuild ports containing broken binaries\&. rev\-upgrade is usually automatically run after each upgrade, unless you specify the
\fB\-\-no\-rev\-upgrade\fR
option\&.
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -927,10 +1180,14 @@ to rev\-upgrade\&.
</span>
See also:
\fBmacports.conf\fR(5)
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
clean
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Clean the files used for building
\fIportname\fR\&. To just remove the work files, use the
\fB\-\-work\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -940,7 +1197,9 @@ Clean the files used for building
</span> \fB\-\-logs\fR\&. To remove the work files, distribution files, temporary archives and logs pass
\fB\-\-all\fR\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -954,7 +1213,9 @@ port clean \-\-logs vim
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> To remove only certain version(s) of a port\(cqs archives (version is any valid UNIX glob pattern), you can use:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -966,7 +1227,9 @@ port clean \-\-archive vim 6\&.2\&.114
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> or:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -977,10 +1240,15 @@ port clean \-\-archive vim \*(Aq6\&.*\*(Aq
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
log
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Parses and shows log files for
\fIportname\fR\&. To filter log files by some criterions use
\fB\-\-phase\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -988,7 +1256,9 @@ to specify the phase you want to show and
</span> \fB\-\-verbosity\fR
to specify message category (msg, info, debug)\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1000,16 +1270,25 @@ port log \-\-phase fetch \-\-verbosity debug vim
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
logfile
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays the path to the log file for
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
echo
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Writes to stdout the arguments passed to
\fIport\fR\&. This follows the expansion of
\fIpseudo\-portnames\fR, portname glob patterns,
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1019,7 +1298,9 @@ and the evaluation of
</span> \fBecho\fR
may be used to determine the exact set of ports to which a given string of arguments will expand, without performing any further operations on them\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1032,15 +1313,24 @@ port echo maintainer:jmpp and \e( net* or category:text \e)
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
list
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> If no argument is given, display a list of the latest version of all available ports\&. If portname(s) are given as arguments, display a list of the latest version of each port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
mirror
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Create/update a local mirror of distfiles used for ports given on the command line\&. The filemap database can be reset by using the
\fB\-\-new\fR
option (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
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1051,18 +1341,28 @@ option (though if no database is found, it will be created automatically)\&. If
</span> so
\fBport\fR
doesn\(cqt quit on the first download failure\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
version
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Display the release number of the installed MacPorts infrastructure\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
selfupdate
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Updates the MacPorts system, ports tree(s) and base tools if needed, from the MacPorts rsync server, installing the newest infrastructure available\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> To update you would typically do:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1074,14 +1374,20 @@ sudo port selfupdate
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> See
\fIsync\fR
for more information about updating ports tree(s)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
load
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Provides a shortcut to using launchctl to load a port\(cqs daemon (as installed in /Library/LaunchDaemons)\&. It runs:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1092,79 +1398,134 @@ launchctl load \-w /Library/LaunchDaemons/org\&.macports\&.${port}\&.plist
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
unload
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> A shortcut to launchctl, like load, but unloads the daemon\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
reload
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> A shortcut to launchctl, like load and unload, but reloads the daemon\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
gohome
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Loads the home page for the given portname in the default web browser\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
usage
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays a condensed usage summary\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
help
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays a summary of all available actions and port command syntax on stdout\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "DEVELOPER ACTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The actions that are often used by Port developers are intended to provide access to the different phases of a Port\(cqs build process:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
dir
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays the path to the directory containing
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
work
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays the path to the work directory for
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
cd
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Changes the current working directory to the one containing portname\&. Only useful in shell mode\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
file
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays the path to the Portfile for
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
url
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Displays the URL for the path of the given portname, which can be passed as
\fIport\-url\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
cat
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Concatenates and prints the contents of
\fIPortfile\fR
on stdout\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
edit
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Opens Portfile with your default editor specified in your shell\(cqs environment variable\&. You can also use the
\fB\-\-editor\fR
flag on the command line to specify an alternative editor\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> For example:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1175,111 +1536,184 @@ port edit \-\-editor nano apache2
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
fetch
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Fetches the distribution files required to build
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
checksum
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Compute the checksums of the distribution files for
\fIportname\fR, and compare them to the checksums listed in
\fIPortfile\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
extract
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Extracts the distribution files for
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
patch
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Applies any required patches to
\fIportname\(cqs\fR
extracted distribution files\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
configure
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Runs any configure process for
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Build
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Installs
\fIportname\fR
to a temporary directory\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
test
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Tests
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
lint
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Verifies Portfile for portname\&. To nitpick about whitespace and patchfile names, use
\fB\-\-nitpick\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
distcheck
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Check if the distfiles haven\(cqt changed and can be fetched\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
distfiles
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Display each distfile, its checksums, and the URLs used to fetch it\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
livecheck
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Check if the software hasn\(cqt been updated since the Portfile was last modified\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "PACKAGING ACTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
There are also actions for producing installable packages of ports:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
pkg
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Creates an OS X installer package of
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
mpkg
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Creates an OS X installer metapackage of
\fIportname\fR
and its dependencies\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
dmg
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Creates an internet\-enabled disk image containing an OS X package of
\fIportname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
mdmg
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Creates an internet\-enabled disk image containing an OS X metapackage of
\fIportname\fR
and its dependencies\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "EXAMPLES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The following demonstrates invoking port with the extract action on portdir \(lqtextproc/figlet\(rq and extract\&.suffix set to \(lq\&.tgz\(rq:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1290,36 +1724,64 @@ port extract \-D textproc/figlet extract\&.suffix=\&.tgz
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "FILES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
${prefix}/etc/macports/macports\&.conf
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Global configuration file for the MacPorts system\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
${prefix}/etc/macports/sources\&.conf
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Global listing of the ports trees used by MacPorts\&. This file also enables rsync synchronization\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
${prefix}/etc/macports/variants\&.conf
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Global variants used when a port is installed\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
~/\&.macports/macports\&.conf
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> User configuration file for the MacPorts system\&. It overrides the global
\fImacports\&.conf(5)\fR
file\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "DIAGNOSTICS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The \fBport\fR utility exits 0 on success, and >0 if an error occurs\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBmacports.conf\fR(5), \fBportfile\fR(7), \fBportgroup\fR(7), \fBportstyle\fR(7), \fBporthier\fR(7)
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "AUTHORS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1342,3 +1804,6 @@ Rainer Mueller <raimue@macports\&.org>
</span> .if n \{\
.RE
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span></pre><pre style='margin:0'>
</pre>