<pre style='margin:0'>
Joshua Root (jmroot) pushed a commit to branch release-2.4
in repository macports-base.
</pre>
<p><a href="https://github.com/macports/macports-base/commit/a393413460aae5ac9749b994681381087089cdb5">https://github.com/macports/macports-base/commit/a393413460aae5ac9749b994681381087089cdb5</a></p>
<pre style="white-space: pre; background: #F8F8F8"><span style='display:block; white-space:pre;color:#808000;'>commit a393413460aae5ac9749b994681381087089cdb5
</span>Author: Joshua Root <jmr@macports.org>
AuthorDate: Wed Apr 11 10:23:40 2018 +1000
<span style='display:block; white-space:pre;color:#404040;'> Bump branch version to 2.4.3
</span>---
config/macports_version | 2 +-
configure | 20 +--
doc/macports.conf.5 | 182 ++++++++++++++++++-
doc/port-activate.1 | 33 +++-
doc/port-archive.1 | 21 ++-
doc/port-archivefetch.1 | 27 ++-
doc/port-cat.1 | 18 +-
doc/port-cd.1 | 20 ++-
doc/port-clean.1 | 50 +++++-
doc/port-contents.1 | 70 +++++++-
doc/port-dependents.1 | 26 ++-
doc/port-deps.1 | 43 ++++-
doc/port-diagnose.1 | 26 ++-
doc/port-dir.1 | 37 +++-
doc/port-distcheck.1 | 21 ++-
doc/port-distfiles.1 | 18 +-
doc/port-dmg.1 | 30 +++-
doc/port-echo.1 | 23 ++-
doc/port-edit.1 | 32 +++-
doc/port-exit.1 | 24 ++-
doc/port-fetch.1 | 20 ++-
doc/port-gohome.1 | 18 +-
doc/port-help.1 | 39 +++-
doc/port-info.1 | 112 +++++++++++-
doc/port-install.1 | 32 +++-
doc/port-installed.1 | 31 +++-
doc/port-lint.1 | 47 ++++-
doc/port-list.1 | 18 +-
doc/port-livecheck.1 | 29 ++-
doc/port-load.1 | 20 ++-
doc/port-log.1 | 56 +++++-
doc/port-mirror.1 | 39 +++-
doc/port-notes.1 | 26 ++-
doc/port-outdated.1 | 32 +++-
doc/port-platform.1 | 25 ++-
doc/port-provides.1 | 19 +-
doc/port-reclaim.1 | 32 +++-
doc/port-rev-upgrade.1 | 28 ++-
doc/port-search.1 | 100 ++++++++++-
doc/port-select.1 | 55 +++++-
doc/port-selfupdate.1 | 67 ++++++-
doc/port-setrequested.1 | 24 ++-
doc/port-space.1 | 67 ++++++-
doc/port-sync.1 | 25 ++-
doc/port-unarchive.1 | 20 ++-
doc/port-uninstall.1 | 36 +++-
doc/port-upgrade.1 | 58 +++++-
doc/port-usage.1 | 18 +-
doc/port-variants.1 | 37 +++-
doc/port-version.1 | 26 ++-
doc/port.1 | 466 +++++++++++++++++++++++++++++++++++++++++++++++-
doc/portgroup.7 | 241 ++++++++++++++++++++++++-
doc/portstyle.7 | 12 +-
doc/portundocumented.7 | 36 +++-
doc/pubkeys.conf.5 | 25 ++-
doc/sources.conf.5 | 69 ++++++-
doc/variants.conf.5 | 21 ++-
57 files changed, 2679 insertions(+), 70 deletions(-)
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/config/macports_version b/config/macports_version
</span><span style='display:block; white-space:pre;color:#808080;'>index 8e8299d..35cee72 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/config/macports_version
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/config/macports_version
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1 +1 @@
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-2.4.2
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+2.4.3
</span><span style='display:block; white-space:pre;color:#808080;'>diff --git a/configure b/configure
</span><span style='display:block; white-space:pre;color:#808080;'>index 04d7370..9bf14df 100755
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/configure
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/configure
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,6 +1,6 @@
</span> #! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-# Generated by GNU Autoconf 2.69 for MacPorts 2.4.2.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# Generated by GNU Autoconf 2.69 for MacPorts 2.4.3.
</span> #
# Report bugs to <macports-dev@lists.macports.org>.
#
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -580,8 +580,8 @@ MAKEFLAGS=
</span> # Identity of this package.
PACKAGE_NAME='MacPorts'
PACKAGE_TARNAME='macports'
<span style='display:block; white-space:pre;background:#ffe0e0;'>-PACKAGE_VERSION='2.4.2'
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-PACKAGE_STRING='MacPorts 2.4.2'
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+PACKAGE_VERSION='2.4.3'
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+PACKAGE_STRING='MacPorts 2.4.3'
</span> PACKAGE_BUGREPORT='macports-dev@lists.macports.org'
PACKAGE_URL=''
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1416,7 +1416,7 @@ if test "$ac_init_help" = "long"; then
</span> # Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
<span style='display:block; white-space:pre;background:#ffe0e0;'>-\`configure' configures MacPorts 2.4.2 to adapt to many kinds of systems.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\`configure' configures MacPorts 2.4.3 to adapt to many kinds of systems.
</span>
Usage: $0 [OPTION]... [VAR=VALUE]...
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1482,7 +1482,7 @@ fi
</span>
if test -n "$ac_init_help"; then
case $ac_init_help in
<span style='display:block; white-space:pre;background:#ffe0e0;'>- short | recursive ) echo "Configuration of MacPorts 2.4.2:";;
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ short | recursive ) echo "Configuration of MacPorts 2.4.3:";;
</span> esac
cat <<\_ACEOF
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1623,7 +1623,7 @@ fi
</span> test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
<span style='display:block; white-space:pre;background:#ffe0e0;'>-MacPorts configure 2.4.2
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+MacPorts configure 2.4.3
</span> generated by GNU Autoconf 2.69
Copyright (C) 2012 Free Software Foundation, Inc.
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2292,7 +2292,7 @@ cat >config.log <<_ACEOF
</span> This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-It was created by MacPorts $as_me 2.4.2, which was
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+It was created by MacPorts $as_me 2.4.3, which was
</span> generated by GNU Autoconf 2.69. Invocation command line was
$ $0 $@
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2787,7 +2787,7 @@ test -n "$target_alias" &&
</span> # Read in the MacPorts version from the base/config/macports_version file
{ $as_echo "$as_me:${as_lineno-$LINENO}: checking MacPorts version" >&5
$as_echo_n "checking MacPorts version... " >&6; }
<span style='display:block; white-space:pre;background:#ffe0e0;'>-MACPORTS_VERSION=2.4.2
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+MACPORTS_VERSION=2.4.3
</span> { $as_echo "$as_me:${as_lineno-$LINENO}: result: $MACPORTS_VERSION" >&5
$as_echo "$MACPORTS_VERSION" >&6; }
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -11520,7 +11520,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
</span> # report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
<span style='display:block; white-space:pre;background:#ffe0e0;'>-This file was extended by MacPorts $as_me 2.4.2, which was
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+This file was extended by MacPorts $as_me 2.4.3, which was
</span> generated by GNU Autoconf 2.69. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -11582,7 +11582,7 @@ _ACEOF
</span> cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
<span style='display:block; white-space:pre;background:#ffe0e0;'>-MacPorts config.status 2.4.2
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+MacPorts config.status 2.4.3
</span> configured by $0, generated by GNU Autoconf 2.69,
with options \\"\$ac_cs_config\\"
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/macports.conf.5 b/doc/macports.conf.5
</span><span style='display:block; white-space:pre;color:#808080;'>index 9182701..3661def 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/macports.conf.5
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/macports.conf.5
</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 "MACPORTS\&.CONF" "5" "2017\-02\-12" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "MACPORTS\&.CONF" "5" "2017\-02\-12" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,13 +19,17 @@
</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"
macports.conf \- Configuration file of the MacPorts system
.SH "DESCRIPTION"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBmacports\&.conf\fR is the configuration file used to bootstrap the MacPorts system\&. This file is read by the \fBport\fR command and determines how it behaves\&. Lines beginning with \fI#\fR are comments, empty lines are ignored\&. The format is that of a simple key/value space or tab separated pair\&.
.sp
The file contains entries of the form:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -38,12 +42,19 @@ The file contains entries of the form:
</span> .\}
.sp
The value of any given key can be referred to by the \fI${<keyname>}\fR abstraction, where \fI<keyname>\fR expands to the key in question\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "KEYS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The following keys are used by \fBport\fR itself:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
prefix
.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> Sets the directory where ports are installed\&. Any path may be used but those with spaces and/or non ascii characters should be avoided, as this can break some ports\&. This key is often referred to as
\fI${prefix}\fR\&.
.TS
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -56,10 +67,14 @@ T}:T{
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
portdbpath
.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> Directory where MacPorts keeps working data such as downloaded sources, installed ports\*(Aq receipts and the main registry\&. The same path restrictions apply as for
\fI${prefix}\fR\&.
.TS
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -72,10 +87,14 @@ ${prefix}/var/macports
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
portdbformat
.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> Storage type to use for the MacPorts registry\&. The preferred format is "sqlite", with "flat" also available as a legacy format\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -87,10 +106,14 @@ sqlite
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
applications_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> Directory containing Applications installed from ports\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -102,10 +125,14 @@ T}:T{
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
frameworks_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> Directory containing Frameworks installed from ports\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -117,10 +144,14 @@ ${prefix}/Library/Frameworks
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
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> Location of the sources file\&. This file enables rsync synchronization of the default ports tree with the MacPorts rsync server (through the "sync" target of the port command) and any other local tree(s) you might have\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -132,10 +163,14 @@ ${prefix}/etc/macports/sources\&.conf
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
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> Location of the optional global variants definition file, listing those that should be used in all installed ports if available\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -147,10 +182,14 @@ ${prefix}/etc/macports/variants\&.conf
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
buildfromsource
.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> Controls whether ports are built from source or downloaded as pre\-built archives\&. Setting to
\fIalways\fR
will never use archives,
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -168,10 +207,14 @@ ifneeded
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
portarchivetype
.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> Format of archives in which to store port images\&. This controls the type of archive created locally after building from source, but not the type to request from remote servers (that is controlled by
\fIarchive_sites\&.conf\fR)\&. Changing this will not affect the usability of already installed archives; they can be of any supported type\&.
.TS
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -190,10 +233,14 @@ tbz2
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
configureccache
.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> Use ccache (C/C++ compiler cache)\&. Requires that ccache has been installed\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -205,10 +252,14 @@ no
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
ccache_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> Location where ccache stores its files
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -220,10 +271,14 @@ ${portdbpath}/build/\&.ccache
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
ccache_size
.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> Maximum size ccache may use\&. Use
\fIG\fR,
\fIM\fR, or
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -239,10 +294,14 @@ T}:T{
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
configuredistcc
.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> Use distcc (distributed compiler)\&. Requires that distcc has been installed\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -254,10 +313,14 @@ no
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
configurepipe
.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> Use pipes rather than intermediate files when compiling C/C++/etc (gcc \-pipe)
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -269,10 +332,14 @@ yes
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
buildnicevalue
.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> Lowered scheduling priority (0\-20) to use for make when building ports
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -284,10 +351,14 @@ T}:T{
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
buildmakejobs
.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> Number of simultaneous make jobs (commands) to use when building ports\&. 0 is a special value meaning "the number of CPU cores or the number of GB of physical memory plus one, whichever is less\&."
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -299,10 +370,14 @@ T}:T{
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
portautoclean
.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> Automatic cleaning of the build directory of a given port after it has been installed\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -314,10 +389,14 @@ yes
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
keeplogs
.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 logs for ports\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -329,10 +408,14 @@ no
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build_arch
.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 machine architecture to try to build for in normal use\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -356,10 +439,14 @@ i386 or ppc depending on hardware
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
universal_archs
.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 machine architectures to use for +universal variant (multiple architecture entries should be space separated)\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -383,10 +470,14 @@ i386 ppc
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
startupitem_type
.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> Set the default type of startupitems to be generated, overridable by Portfiles that explicitly state a startupitem\&.type key\&. If set to "default", then a type will be selected that\(cqs appropriate to the OS\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -404,10 +495,14 @@ default
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot_umask
.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> Umask value to use during the destrooting of a port\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -419,10 +514,14 @@ T}:T{
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
rsync_server
.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> Default rsync server to connect to when running "selfupdate" through the port com\- mand to update your base MacPorts infrastructure\&. While selfupdate also syncs the ports tree, it uses the settings from ${sources_conf} to do so\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -434,10 +533,14 @@ rsync\&.macports\&.org
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
rsync_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> Rsync directory from which to pull MacPorts sources from the rsync server\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -449,10 +552,14 @@ macports/release/base/ (which pulls sources for the currently shipping MacPorts
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
rsync_options
.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> Default rsync options to use when connecting to the rsync server\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -464,10 +571,14 @@ T}:T{
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
binpath
.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> Sets the directory search path for locating system executables used by MacPorts\&. This variable should contain the paths for locating utilities such as rsync, tar, cvs and others\&. Don\(cqt change this unless you understand and accept the consequences\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -479,15 +590,23 @@ ${prefix}/bin:${prefix}/sbin:/bin:/sbin:/usr/bin:/usr/sbin
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
extra_env
.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> List of extra environment variables MacPorts should keep in the user\(cqs environment when sanitizing it\&. Changing this is unsupported\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
proxy_override_env
.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> Proxy support\&. Precedence is: env, macports\&.conf, System Preferences\&. That is, if it\(cqs set in the environment, that will be used instead of anything here or in System Preferences\&. Setting proxy_override_env to yes will cause any proxies set here (or in System Preferences if set there but not here) to override what\(cqs in the environment\&. Note that System Preferences doesn\(cqt have an rsync proxy definition\&. Also note, on 10\&.5, sudo will clear many environment variables [...]
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -499,10 +618,14 @@ yes
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
proxy_http
.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> HTTP proxy
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -514,10 +637,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
proxy_https
.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> HTTPS proxy
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -529,10 +656,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
proxy_ftp
.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> FTP proxy
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -544,10 +675,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
proxy_rsync
.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> rsync proxy
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -559,10 +694,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
proxy_skip
.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> Hosts not to go through the proxy (comma\-separated, applies to HTTP, HTTPS and FTP, but not rsync)\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -574,10 +713,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
host_blacklist
.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> Space separated list of download hosts that should not be used\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -589,10 +732,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
preferred_hosts
.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> Space separated list of download hosts that should be used preferentially\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -604,10 +751,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
revupgrade_autorun
.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> Controls whether the rev\-upgrade action will be run automatically after upgrading ports\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -619,10 +770,14 @@ yes
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
revupgrade_mode
.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> Controls the rev\-upgrade functionality which checks for broken linking and can rebuild ports to fix it\&.
\fIrebuild\fR
means ports will automatically be rebuilt when broken linking is detected in their files, while
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -638,10 +793,14 @@ rebuild
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
default_compilers
.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> Default value for configure\&.compiler\&. This can be a space\-separated list\&. Later entries will be used if earlier entries are unavailable or blacklisted by a port\&. Setting this is unsupported\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -653,22 +812,40 @@ none (internal list based on Xcode version is normally used)
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<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> Standard system\-wide MacPorts configuration file\&.
<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\-specific configuration override\&. This file, if found, will be used instead of the default file at ${prefix}/etc/macports/macports\&.conf\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBportfile\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;'>@@ -682,3 +859,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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-activate.1 b/doc/port-activate.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 8cb8b78..da67137 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-activate.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-activate.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\-ACTIVATE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-ACTIVATE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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-activate, port-deactivate \- Change active version of an installed port
.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\-vdf\fR] [\fB\-D\fR \fIportdir\fR] \fBactivate\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -30,38 +34,63 @@ port-activate, port-deactivate \- Change active version of an installed port
</span> [\fI@version\fR]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-vdf\fR] [\fB\-D\fR \fIportdir\fR] \fBdeactivate\fR
[\-\-no\-exec]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 activate\fR will set the status of an previously installed version of a port to active\&. The passed ports have to reference already installed versions\&.
.sp
\fBport deactivate\fR will set the status of a port to inactive\&. The passed ports have to be active at the moment\&. You will be warned if this port has active dependents\&.
.sp
If any version is active at the time of using \fBport activate\fR, it will be deactivated first\&. This can be used to switch from one version to another\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "PORT IMAGES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIarchives\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be copied to their intended place in \fIprefix\fR\&.
.sp
More information on this topic can be found in the \m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2\&.
.sp
To check the current status of a specific port, use \fB\fBport-installed\fR(1)\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-no\-exec\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> Do not execute any stored pre\- or post\-uninstall procedures\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-install\fR(1), \fBport-installed\fR(1), \fBport-deactivate\fR(1)
<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;'>@@ -73,6 +102,8 @@ 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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-archive.1 b/doc/port-archive.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 670216b..5d85563 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-archive.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-archive.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\-ARCHIVE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-ARCHIVE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,36 +19,53 @@
</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-archive \- Create an archive of a port\&.
.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\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBarchive\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[+/\-variant \&...]
.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 archive\fR will create the port image (also called archive) for a port but will not actually install the port\(cqs files\&. In a nutshell, \fBport archive\fR is like \fBinstall\fR, but without the implicit \fBactivate\fR at the end\&. See \fBport-install\fR(1) and \fBport-activate\fR(1) and the \fBPORT IMAGES\fR section for details\&. The created port image can be located using \fBport-location\fR(1),
.sp
You can choose multiple variants, by specifying +name, which indicates the variant is desired, or \-name, indicating the contrary\&.
.sp
Global variants will be applied as specified in \fBvariants.conf\fR(5)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "PORT IMAGES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIarchives\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be copied to their intended place in \fIprefix\fR\&.
.sp
More information on this topic can be found in the \m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2\&.
.sp
To check the current status of a specific port, use \fB\fBport-installed\fR(1)\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-install\fR(1), \fBport-activate\fR(1), \fBport-info\fR(1), \fBport-variants\fR(1), \fBvariants.conf\fR(5)
<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;'>@@ -60,6 +77,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-archivefetch.1 b/doc/port-archivefetch.1
</span><span style='display:block; white-space:pre;color:#808080;'>index c58f8db..e681ff1 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-archivefetch.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-archivefetch.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\-ARCHIVEFETCH" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-ARCHIVEFETCH" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,41 +19,64 @@
</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-archivefetch \- Fetch archive for the given ports if available\&.
.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\-vdqypotf\fR] [\fB\-D\fR \fIportdir\fR] \fBarchivefetch\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[+/\-variant \&...]
.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 archivefetch\fR attempts to download a binary archive for the given port(s) from the configured binary sources, by default from \fIpackages\&.macports\&.org\fR and its mirrors\&. An archive or port image is a tarball containing the files of a port and some metadata and can be used to install a port without building it from source\&. See the \fBPORT IMAGES\fR section for a description of the port image concept in MacPorts\&.
.sp
You can choose multiple variants, by specifying +name, which indicates the variant is desired, or \-name, indicating the contrary\&.
.sp
Global variants will be applied as specified in \fBvariants.conf\fR(5)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "PORT IMAGES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIarchives\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be copied to their intended place in \fIprefix\fR\&.
.sp
More information on this topic can be found in the \m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2\&.
.sp
To check the current status of a specific port, use \fB\fBport-installed\fR(1)\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-p\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> Proceed even if a port fails to fetch\&. This is useful if you are trying to download all available binary images for a number of ports, e\&.g\&., if you want to install them later without a network connection\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-archive\fR(1), \fBport-variants\fR(1), \fBvariants.conf\fR(5)
<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;'>@@ -65,6 +88,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-cat.1 b/doc/port-cat.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 9126526..66ed8a0 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-cat.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-cat.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\-CAT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-CAT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,21 +19,34 @@
</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-cat \- Print the contents of a Portfile
.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\-D\fR \fIportdir\fR] \fBcat\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
Print the \fIPortfile\fR of the given port(s)\&. Note that always the latest version in your local ports tree is printed\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-selfupdate\fR(1)
<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;'>@@ -45,3 +58,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-cd.1 b/doc/port-cd.1
</span><span style='display:block; white-space:pre;color:#808080;'>index fbceee5..a5de7e4 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-cd.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-cd.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\-CD" "1" "2017\-01\-08" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-CD" "1" "2017\-01\-08" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,26 +19,41 @@
</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-cd \- Change the current working directory in shell mode\&.
.SH "SYNOPSIS"
.sp
To be used only in shell mode:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.nf
\fBcd\fR
[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]
.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
\fBcd\fR can be used when \fBport\fR is running in shell mode (see \fBport-shell\fR(7)) to change the current working directory to the directory that contains a given port\&. The second parameter is not optional, as it usually is with \fBcd\fR in your shell\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "BUGS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport cd\fR can be used from the command line, but is a no\-op\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-shell\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;'>@@ -50,3 +65,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-clean.1 b/doc/port-clean.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 2e69d1c..4018a46 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-clean.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-clean.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\-CLEAN" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-CLEAN" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,20 +19,29 @@
</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-clean \- Remove temporary files used to build a port\&.
.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\-vdqypotf\fR] [\fB\-D\fR \fIportdir\fR] \fBclean\fR
[\-\-archive] [\-\-dist] [\-\-logs] [\-\-work] [\-\-all]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 clean\fR removes temporary files that were created while installing a port\&.
.sp
During the installation of a port, a number of files might be placed on your system\&. Whether they actually are depends on the installation process (e\&.g\&., if a pre\-built binary is available, source code will not be downloaded and extracted)\&. The temporary files include:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.RS 4
.ie n \{\
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -42,6 +51,7 @@ During the installation of a port, a number of files might be placed on your sys
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Archives of source code, the so\-called distfile(s),
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -53,6 +63,7 @@ Archives of source code, the so\-called distfile(s),
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> log files for the build,
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -64,6 +75,7 @@ log files for the build,
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> a working directory for the build MacPorts internal state, and folders + used as home and temporary directories,
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -75,6 +87,7 @@ a working directory for the build MacPorts internal state, and folders + used as
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> an extracted copy of the source code, and
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -86,50 +99,82 @@ an extracted copy of the source code, and
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> a staging directory for installations\&.
.RE
.sp
By default, most of these temporary files are removed after a successful installation, while others (such as the source code archives) are kept because they might be re\-used later\&. However, if a build fails, these files are not deleted, might be re\-used later and lead to failure again\&. It is for this reason, that the standard approach in case of a build failure in MacPorts is \fBclean\fR and try again\&.
.sp
Which of the temporary files are removed depends on the flags given to clean\&. The default behavior is \fB\-\-work\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-archive\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> Remove partially downloaded binary archives\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-dist\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> Delete source code archives, the so\-called distfiles\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-logs\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> Delete log files\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-work\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> Delete the work directory of a port\&. This is the default and includes the extracted source code, the staging directory and MacPorts\*(Aq internal progress information\&. This is included in all but
\fB\-\-logs\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-all\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> Remove all temporary files\&. The same as specifying
\fB\-\-archive\fR,
\fB\-\-dist\fR,
\fB\-\-logs\fR, and
\fB\-\-work\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -141,3 +186,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-contents.1 b/doc/port-contents.1
</span><span style='display:block; white-space:pre;color:#808080;'>index a19b935..d6d1f54 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-contents.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-contents.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\-CONTENTS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-CONTENTS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,20 +19,29 @@
</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-contents \- List the files installed by a given port
.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\-q\fR] [\fB\-D\fR \fIportdir\fR] \fBcontents\fR
[\-\-size] [\-\-units \fIunit\fR]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 contents\fR displays a list of all files that have been installed by a given port\&. You can only use \fBcontents\fR for ports that are \fIactive\fR and installed\&.
.sp
Common uses for \fBcontents\fR include finding the location of a port\(cqs executable after installing it\&. You can combine \fBport contents\fR with other tools to simplify this, e\&.g\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -43,70 +52,126 @@ port \-q contents asciidoc | grep \-E \*(Aq/s?bin/\*(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> .SH "OPTIONS"
<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
\fB\-\-size\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> Enable printing a human\-readable representation of the files\*(Aq sizes\&. The size output can be adjusted using the
\fB\-\-units \fR\fB\fIunit\fR\fR
flag\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-units \fR\fB\fIunit\fR\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> Used in conjunction with
\fB\-\-size\fR
to choose the unit in which the size is given\&. Valid values for
\fIunit\fR
are
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBB\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> List sizes in bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBK\fR, \fBKi\fR, \fBKiB\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> List sizes in KiB, i\&.e\&., 1024 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBMi\fR, \fBMiB\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> List sizes in MiB, i\&.e\&., 1024 * 1024 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBGi\fR, \fBGiB\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> List sizes in GiB, i\&.e\&., 1024 * 1024 * 1024 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBk\fR, \fBkB\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> List sizes in kB, i\&.e\&., 1000 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBM\fR, \fBMB\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> List sizes in MB, i\&.e\&., 1000 * 1000 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBG\fR, \fBGB\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> List sizes in GB, i\&.e\&., 1000 * 1000 * 1000 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Do not print the header line\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBgrep\fR(1)
<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;'>@@ -118,3 +183,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-dependents.1 b/doc/port-dependents.1
</span><span style='display:block; white-space:pre;color:#808080;'>index fd2a140..d2294b1 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-dependents.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-dependents.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\-DEPENDENTS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-DEPENDENTS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,24 +19,37 @@
</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-dependents, port-rdependents \- List ports that depend on a given (installed) port
.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\-D\fR \fIportdir\fR] \fBdependents\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBrdependents\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 dependents\fR reports which ports depend upon a given (installed) port, if any\&. Note that \fBdependents\fR does not work for ports that are not installed on your system\&. It uses the database of installed ports that MacPorts keeps internally, which records the dependency relations at installation time\&. \fBport dependents\fR prints this information\&.
.sp
For this reason, \fBport dependents\fR does not work for ports that are not installed on your system\&. If you want to find out which ports depend on a port you haven\(cqt installed, you can use the \fBdepends:\fR pseudo\-portname selector:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -53,9 +66,12 @@ This command will, however, not cover dependencies that are only present in non\
</span> \fBport rdependents\fR will print a tree of installed ports that depend on the given port\&.
.sp
The dependency relations printed by \fBport dependents\fR and \fBport rdependents\fR are the same that are used to determine if a port can be safely uninstalled\&. Ports that still have dependents installed cannot be safely uninstalled without possibly breaking their dependents\&. All dependents can be removed at the same time using the \fB\-\-follow\-dependents\fR flag\&. The check can be ignored using the \fB\-f\fR flag\&. See \fBport-uninstall\fR(1) for more details\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "DEPENDENCY RELATIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Do not confuse \fIdependents\fR and \fIdependencies\fR (or, shortened, \fIdeps\fR)\&. Refer to the following example to understand the difference:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -68,10 +84,15 @@ portA \-\-> portB
</span> .\}
.sp
\fBportA\fR depends on \fBportB\fR, i\&.e\&., \fBportA\fR needs \fBportB\fR to run\&. Because of that, \fBportB\fR is a \fIdependency\fR (or \fIdep\fR) of \fBportA\fR\&. After installing \fBportA\fR, \fBportB\fR has been automatically installed\&. At this point, \fBportA\fR has become a \fIdependent\fR of \fBportB\fR\&. You can only uninstall \fBportB\fR once all of its dependents (i\&.e\&., including \fBportA\fR) have been uninstalled\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-echo\fR(1), \fBport-deps\fR(1), \fBport-uninstall\fR(1)
<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;'>@@ -83,3 +104,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-deps.1 b/doc/port-deps.1
</span><span style='display:block; white-space:pre;color:#808080;'>index b6fc568..9db8f9d 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-deps.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-deps.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\-DEPS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-DEPS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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-deps, port-rdeps \- Display a dependency listing for the given port(s)
.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\-D\fR \fIportdir\fR] \fBdeps\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -29,39 +33,68 @@ port-deps, port-rdeps \- Display a dependency listing for the given port(s)
</span> [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBrdeps\fR
[\-\-full] [\-\-index] [\-\-no\-build]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 deps\fR lists all dependencies of the given port(s), i\&.e\&., the ports that need to be installed to build or use a port\&.
.sp
\fBport rdeps\fR recursively descends into the dependencies and displays a tree of dependencies for a given port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-full\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> When using
\fBrdeps\fR, display all branches of the dependency tree instead of listing each dependency only once\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-index\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> Do not read Portfiles, but instead rely solely on the PortIndex information\&. Note that this option will prevent the dependencies reported from reflecting the effects of any variants specified\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-no\-build\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> Exclude dependencies only required at build time, i\&.e\&., fetch, extract, and build dependencies\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "DEPENDENCY RELATIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Do not confuse \fIdependents\fR and \fIdependencies\fR (or, shortened, \fIdeps\fR)\&. Refer to the following example to understand the difference:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -74,10 +107,15 @@ portA \-\-> portB
</span> .\}
.sp
\fBportA\fR depends on \fBportB\fR, i\&.e\&., \fBportA\fR needs \fBportB\fR to run\&. Because of that, \fBportB\fR is a \fIdependency\fR (or \fIdep\fR) of \fBportA\fR\&. After installing \fBportA\fR, \fBportB\fR has been automatically installed\&. At this point, \fBportA\fR has become a \fIdependent\fR of \fBportB\fR\&. You can only uninstall \fBportB\fR once all of its dependents (i\&.e\&., including \fBportA\fR) have been uninstalled\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-variants\fR(1)
<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;'>@@ -89,3 +127,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-diagnose.1 b/doc/port-diagnose.1
</span><span style='display:block; white-space:pre;color:#808080;'>index c0e3b7d..441f138 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-diagnose.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-diagnose.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\-DIAGNOSE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-DIAGNOSE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,27 +19,48 @@
</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-diagnose \- Detects common issues
.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 diagnose\fR
[\-\-quiet]
.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 diagnose\fR will check a list of common issues that could affect the user or MacPorts in one way or another\&. If any issues are found, a warning will be shown to the user included with a possible fix for said problem\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-quiet\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> Only display warnings or errors\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -51,3 +72,6 @@ Kyle Sammons <ksammons@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-dir.1 b/doc/port-dir.1
</span><span style='display:block; white-space:pre;color:#808080;'>index c602fd8..5362ad5 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-dir.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-dir.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\-DIR" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-DIR" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,39 +19,64 @@
</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-dir, port-url, port-file, port-location, port-work \- Print paths for certain properties of a port
.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\-D\fR \fIportdir\fR] \fBdir\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBurl\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBfile\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-q\fR] [\fB\-D\fR \fIportdir\fR] \fBlocation\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBwork\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
These commands print a path for each given port\&. The meaning of the path differs by the command given:
.sp
\fBport dir\fR prints the directory that contains the \fIPortfile\fR for the given port expression\&. This can be quite handy in your shell, if you want to locate a \fIPortfile\fR:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -70,13 +95,20 @@ cd $(port dir <portname>)
</span> \fBport location\fR only works for installed ports and prints the location of the archive MacPorts internally uses to be able to deactivate and activate a port\&. See \fBport-activate\fR(1) for more details on that\&. This command might be useful for you if you want to setup a local binary mirror of MacPorts packages that are not available from our official infrastructure due to licensing reasons\&.
.sp
\fBport work\fR prints the path to the so\-called \fIwork\fR directory, i\&.e\&., the directory used by MacPorts to build a port\&. No output is generated if no build directory exists, e\&.g\&., because there is no unfinished build in progress for the given port\&. Work directories are deleted after successful installation or using \fBport-clean\fR(1)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-edit\fR(1), \fBport-activate\fR(1), \fBport-clean\fR(1)
<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;'>@@ -88,3 +120,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-distcheck.1 b/doc/port-distcheck.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 48b9926..ab7bdc9 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-distcheck.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-distcheck.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\-DEPS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-DEPS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,31 +19,48 @@
</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-distcheck \- Check if a port can be fetched from all of its mirrors
.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\-qvdy\fR] [\fB\-D\fR \fIportdir\fR] \fBdistcheck\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 distcheck\fR downloads all source files for a given port from all available mirrors (including MacPorts\*(Aq mirror infrastructure) and checks that the modification date of the file on the mirror is not more recent than the modification date of the \fIPortfile\fR\&.
.sp
Distcheck can be switched to verify the file size of the downloaded files instead by setting the \fIdistcheck\&.type\fR option to \fIfilesize\fR in the \fIPortfile\fR for the tested port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "BUGS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport distcheck\fR should not rely on timestamps or file sizes but use the checksums available in the \fIPortfile\fR to verify the integrity of the files on the mirrors instead\&. See \fBport-checksum\fR(1)\&.
.sp
Meanwhile, you can use \m[blue]\fBport\-checkmirrors\fR\m[]\&\s-2\u[1]\d\s+2 from contrib to do that\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-checksum\fR(1)
<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;'>@@ -55,6 +72,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
port-checkmirrors
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-distfiles.1 b/doc/port-distfiles.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 09c8cc0..8a423f8 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-distfiles.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-distfiles.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\-DISTFILES" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-DISTFILES" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,23 +19,36 @@
</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-distfiles \- Print a list of distribution files for a port
.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\-qvd\fR] [\fB\-D\fR \fIportdir\fR] \fBdistfiles\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
Print a list of source archives required to build the given port along with the checksums for the file and a list of mirrors\&. If you want to verify that all mirrors actually serve the same file see \fBport-distcheck\fR(1)\&.
.sp
To delete the distfiles once they have been downloaded, use \fBport clean \-\-dist\fR\&. See \fBport-clean\fR(1) for more information regarding the \fBclean\fR command\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-distcheck\fR(1), \fBport-clean\fR(1)
<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;'>@@ -47,3 +60,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-dmg.1 b/doc/port-dmg.1
</span><span style='display:block; white-space:pre;color:#808080;'>index a0bc13f..3901657 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-dmg.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-dmg.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\-DMG" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-DMG" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,30 +19,50 @@
</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-dmg, port-mdmg, port-pkg, port-mpkg \- Create binary archives of a port, and optionally its dependencies\&.
.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\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBdmg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBmdmg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBpkg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBmpkg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
These commands create OS X\-native binary archives of a given port\&. Depending on the command, one of a \&.dmg disk image file, a \&.pkg, or \&.mpkg installer package is created\&.
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -70,12 +90,18 @@ Instead, follow \m[blue]\fBSection 2\&.2\&.4 of the MacPorts Guide\fR\m[]\&\s-2\
</span> .sp .5v
.RE
.SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-work\fR(1), \m[blue]\fBSection 2\&.2\&.4 of the MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2
<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;'>@@ -87,6 +113,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
Section 2.2.4 of the MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-echo.1 b/doc/port-echo.1
</span><span style='display:block; white-space:pre;color:#808080;'>index a277d0c..cc4def2 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-echo.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-echo.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\-ECHO" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-ECHO" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,19 +19,28 @@
</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-echo \- Print the list of ports the argument expands to
.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 \fBecho\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 echo\fR expands its argument list according to MacPorts\*(Aq rules and prints a list of ports that match the expression given as argument\&. It can be useful to see what a pseudo\-portname or a pseudo\-portname selector (see \fBport\fR(1)) expands to\&.
.sp
If \fBport echo\fR doesn\(cqt recognize an argument as port, it will still print it as\-is\&. You cannot use \fBport echo\fR to check whether a port exists:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -43,9 +52,13 @@ nonexistentport
</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 "EXAMPLES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Common use cases are:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -63,10 +76,15 @@ port echo category:^mail$
</span> .\}
.sp
Note that \fBecho\fR is usually \fInot\fR used to list outdated ports, since a separate action \fBport-outdated\fR(1) exists for that\&. \fBport outdated\fR has the advantage compared to \fBport echo outdated\fR that it gives the reason why MacPorts considers the port outdated\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-outdated\fR(1)
<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;'>@@ -78,3 +96,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-edit.1 b/doc/port-edit.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 26bd878..ad1d13c 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-edit.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-edit.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\-EDIT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-EDIT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "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-edit \- Open the Portfile in an editor
.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\-D\fR \fIportdir\fR] \fBedit\fR
[\-\-editor <editor>]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 edit\fR will open the associated \fIPortfile\fR in an editor\&. It will try to determine your favorite editor by respecting the environment variables \fB$VISUAL\fR or \fB$EDITOR\fR in this order\&. If none has been set it will fallback to \fI/usr/bin/vi\fR\&. Your shell will be blocked until the editor returns\&. The path to the \fIPortfile\fR is passed as one single argument to the editor\&.
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -50,22 +58,42 @@ If you edit a \fIPortfile\fR, your changes might be lost on the next sync\&. If
</span> .sp .5v
.RE
.SH "OPTIONS"
<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
\fB\-\-editor <editor>\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> Use the specified
\fIeditor\fR, overriding environment variables\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "ENVIRONMENT"
<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
\fBEDITOR\fR, \fBVISUAL\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> Specifies the editor to be launched\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-file\fR(1), \fBport-cat\fR(1)
<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;'>@@ -77,6 +105,8 @@ 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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-exit.1 b/doc/port-exit.1
</span><span style='display:block; white-space:pre;color:#808080;'>index b3e7c3d..d788f38 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-exit.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-exit.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\-EXIT" "1" "2017\-01\-08" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-EXIT" "1" "2017\-01\-08" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,29 +19,48 @@
</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-exit \- Exit shell mode
.SH "SYNOPSIS"
.sp
To be used only in shell mode:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.nf
\fBexit\fR
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBquit\fR
.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
\fBexit\fR or \fBquit\fR can only be used when \fBport\fR is running in shell mode (see \fBport-shell\fR(7))\&. It causes \fBport\fR to exit\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "BUGS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport exit\fR and \fBport quit\fR can be used from the command line, but are no\-ops\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-shell\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;'>@@ -53,3 +72,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-fetch.1 b/doc/port-fetch.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 1d7c18f..3804313 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-fetch.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-fetch.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\-FETCH" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-FETCH" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,28 +19,43 @@
</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-fetch, port-checksum, port-extract, port-patch, port-configure, port-build, port-destroot, port-test \- Run a specific phase of a port
.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\-vdoy\fR] [\fB\-D\fR \fIportdir\fR] [\fBfetch\fR | \fBchecksum\fR | \fBextract\fR | \fBpatch\fR | \fBconfigure\fR | \fBbuild\fR | \fBdestroot\fR | \fBtest\fR ]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
These commands run a specific phase of a port\&. Depending phases will be executed automatically as needed\&.
.sp
If the \fIPortfile\fR has changed between multiple invocation, \fBport\fR will perform a clean before running the phase\&. The flag \fI\-o\fR can be used to ignore this and keep the current state of the \(lqwork\(rq dir\&.
.sp
Note that the \fBtest\fR phase is special in that it will not be run by MacPorts by default\&. When supported by the given port, the \fBtest\fR phase will run the testcases of the software\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-install\fR(1)
<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;'>@@ -52,3 +67,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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-gohome.1 b/doc/port-gohome.1
</span><span style='display:block; white-space:pre;color:#808080;'>index a788c13..9f7a119 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-gohome.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-gohome.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\-GOHOME" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-GOHOME" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,21 +19,34 @@
</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-gohome \- Open the homepage of the given port(s)
.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\-D\fR \fIportdir\fR] \fBgohome\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 gohome\fR opens the homepage of the given port(s) in your default browser\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -45,3 +58,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-help.1 b/doc/port-help.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 63c1eeb..d098133 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-help.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-help.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\-HELP" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-HELP" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,47 +19,82 @@
</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-help \- Get help on MacPorts commands
.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 \fBhelp\fR [\fIaction\fR | \fIhelp\-topic\fR]
.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 help\fR opens the manpage for a given port action such as \fIinstall\fR, \fIupgrade\fR, \fIselfupdate\fR, etc\&. or a specific help topic like \fImacports\&.conf\fR\&. MacPorts even has help for its help feature\&. MacPorts will however not engage in higher level abstractions: There is no help on the help on the help\&.
.sp
Further documentation on MacPorts can be found in the following places:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2
.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> Detailed help and support guide
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBThe MacPorts Wiki\fR\m[]\&\s-2\u[2]\d\s+2
.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> MacPorts usage, development, and support
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBMailing Lists\fR\m[]\&\s-2\u[3]\d\s+2
.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> Ask questions on the mailing lists: macports\-dev for base and Portfile development, macports\-users for user support questions
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBFAQ\fR\m[]\&\s-2\u[4]\d\s+2
.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> Frequently Asked Questions
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBProblem Hotlist\fR\m[]\&\s-2\u[5]\d\s+2
.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> Solutions for the most common error messages and other problems
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -71,6 +106,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-info.1 b/doc/port-info.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 649edf4..e99f324 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-info.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-info.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\-INFO" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-INFO" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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-info \- Return information about the given ports\&.
.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\-q\fR] [\fB\-D\fR \fIportdir\fR] \fBinfo\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -34,140 +38,243 @@ port-info \- Return information about the given ports\&.
</span> [\-\-version]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 info\fR prints information about the given ports\&. Specifying at least one of the options limits the output to the corresponding field\&. If no fields are specified, a useful default set consisting of name, epoch, version, revision, categories, replaced_by, variants, description, homepage, dependencies, platforms, license, and maintainers is shown\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The following options do not select fields for the output but change how the information is obtained or formatted:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-\-index\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> Do not read the
\fIPortfile\fR, but rely solely on the port index information\&. Note that this option will prevent the information reported from reflecting the effects of any variants specified\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-line\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> Print a single line for each port\&. Fields are separated by spaces\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-pretty\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> Format the output in a convenient, human\-readable fashion\&. This is the default when no options are specified\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.sp
The rest of the options affect which fields will be given in the output:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-\-category\fR, \fB\-\-categories\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> List the categories of a port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-conflicts\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> List other ports that cannot be active at the same time as the given port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-depends\fR, \fB\-\-depends_fetch\fR, \fB\-\-depends_extract\fR, \fB\-\-depends_build\fR, \fB\-\-depends_lib\fR, \fB\-\-depends_run\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> List the specified dependencies of a port\&.
\fB\-\-depends\fR
is a shorthand option for all other
\fB\-\-depends_\fR* options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-description\fR, \fB\-\-long_description\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> Print the short or long description of a port, respectively\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-epoch\fR, \fB\-\-version\fR, \fB\-\-revision\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> List the components of a MacPorts version tuple, epoch, version and revision, respectively\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-fullname\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> Print name and the full MacPorts version tuple, e\&.g\&., \(lqyubico\-pam @2\&.16\(rq\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-heading\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> Like
\fB\-\-fullname\fR
but including the categories\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-homepage\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> List the homepage of a port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-license\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> Print the license that applies to the source code of a port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-maintainer\fR, \fB\-\-maintainers\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> List the email address(es) of a port\(cqs maintainer(s)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-name\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> Print the name of a port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-patchfiles\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> List the patches that will be applied to the port, taking the current platform and selected variants into account\&. This information will not be available if
\fB\-\-index\fR
is specified\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-platform\fR, \fB\-\-platforms\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> List the platforms supported by a port\&. This field exists for historical reasons only\&. In modern MacPorts, this is always
\fIdarwin\fR, i\&.e\&., OS X\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-portdir\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> Print the path to a port\(cqs directory relative to the port tree root\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-replaced_by\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> List the name of the port that replaces a port, if any\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-subports\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> Print a list of subports defined by this port\(cqs
\fIPortfile\fR, i\&.e\&., ports that are defined in the same
\fIPortfile\fR
because they share common parts\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-variant\fR, \fB\-\-variants\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> List the variants defined by a port by name\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Do not print the field description when using
\fB\-\-pretty\fR
output\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -179,3 +286,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-install.1 b/doc/port-install.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 1821e18..cd035aa 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-install.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-install.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\-INSTALL" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-INSTALL" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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-install \- Install a new port
.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\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBinstall\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -29,33 +33,56 @@ port-install \- Install a new port
</span> [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[+/\-variant \&...]
.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 install\fR will install a new port on your system\&. You can choose multiple variants, by specifying \e+name, which indicates the variant is desired, or \-name, indicating the contrary\&.
.sp
Global variants will be applied as specified in \fBvariants.conf\fR(5)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-no\-rev\-upgrade\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> Do not run rev\-upgrade after installation\&. See
\fBport-rev-upgrade\fR(1)
for more information\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-unrequested\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> Do not mark the installed ports as requested\&. See
\fBport-setrequested\fR(1)
for more information\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-uninstall\fR(1), \fBport-info\fR(1), \fBport-variants\fR(1), \fBport-rev-upgrade\fR(1), \fBport-setrequested\fR(1), \fBvariants.conf\fR(5)
<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;'>@@ -67,3 +94,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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-installed.1 b/doc/port-installed.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 817fadf..11a6920 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-installed.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-installed.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\-INSTALLED" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-INSTALLED" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,45 +19,72 @@
</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-installed \- List installed versions of a given port, or all installed ports
.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\-vq\fR] \fBinstalled\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 installed\fR can be used in two separate ways: Either without arguments, in which case it will print a list of all installed ports (both active and inactive), or with arguments, which will return a list of installed ports that match the argument expression\&.
.sp
The output of \fBport installed\fR contains the name, version and variants of the installed ports and whether the port is active or inactive\&. See the PORT IMAGES section for an explanation of the active/inactive state\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-v\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> Print the platform at install time (i\&.e\&., your OS X version) and the architecture(s) of the installed port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-q\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> Do not print the header line\&. This is useful when parsing the output of
\fBport installed\fR
in scripts for further processing\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "PORT IMAGES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIarchives\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be copied to their intended place in \fIprefix\fR\&.
.sp
More information on this topic can be found in the \m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2\&.
.sp
To check the current status of a specific port, use \fB\fBport-installed\fR(1)\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-activate\fR(1)
<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;'>@@ -69,6 +96,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-lint.1 b/doc/port-lint.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 4365f12..cd71afa 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-lint.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-lint.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\-LINT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-LINT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,20 +19,29 @@
</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-lint \- Check a port for common problems
.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\-vdq\fR] [\fB\-D\fR \fIportdir\fR] \fBlint\fR
[\-\-nitpick]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 lint\fR checks the \fIPortfile\fR of a given port for potential errors\&. It is a useful tool for port maintainers to check for possible typos, mistakes and missing definitions\&.
.sp
For example, it verifies that
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.RS 4
.ie n \{\
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -42,6 +51,7 @@ For example, it verifies that
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Portfiles are valid UTF\-8
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -53,6 +63,7 @@ Portfiles are valid UTF\-8
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> all mandatory properties are present
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -64,6 +75,7 @@ all mandatory properties are present
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> all dependencies actually exist, and
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -75,40 +87,70 @@ all dependencies actually exist, and
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> no deprecated features are used\&.
.RE
.sp
If problems are found, \fBport lint\fR emits warnings and error messages explaining the problem\&. Please fix all errors and consider fixing any warnings before submitting your \fIPortfile\fR or your changes to MacPorts\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-nitpick\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> Enables additional checks that are mostly whitespace\-related and best practices\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-v\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> Print messages for successful tests\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-d\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> Print the
\fIPortfile\fR, and debugging information parsed from the
\fIPortfile\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-q\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> Suppress the header line, warning and error count; only print warnings and errors, if any\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBportfile\fR(7), \fBport-dev-style\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;'>@@ -120,3 +162,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-list.1 b/doc/port-list.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 2b012d3..158056a 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-list.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-list.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\-ECHO" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-ECHO" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,15 +19,23 @@
</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-list \- List the latest available version for the given ports
.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 \fBlist\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 list\fR prints the latest version of the given port(s) that is available through MacPorts\&. It prints name, version number and the relative path of the port in the port tree, i\&.e\&. the name of the primary category followed by the port name\&.
.if n \{\
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -50,10 +58,15 @@ This leads to the common mistake that \fBport list installed\fR lists the same p
</span> .RE
.sp
Pretty much the only use case for \fBport list\fR is checking which version of a specific port is current in MacPorts, or if a port exists at all\&. Do \fBnot\fR use \fBport list\fR to print \fBoutdated\fR, \fBinactive\fR, \fBinstalled\fR, \fBrequested\fR, \fBleaves\fR, or other pseudo\-ports\&. Use \fBport-outdated\fR(1), \fBport-installed\fR(1), or \fBport-echo\fR(1) instead\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-installed\fR(1), \fBport-echo\fR(1), \fBport-outdated\fR(1)
<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;'>@@ -65,3 +78,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-livecheck.1 b/doc/port-livecheck.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 26d88b2..a6eb2d9 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-livecheck.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-livecheck.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\-LIVECHECK" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-LIVECHECK" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,36 +19,61 @@
</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-livecheck \- Check if a new version of the software is available
.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\-vd\fR] [\fB\-D\fR \fIportdir\fR] \fBlivecheck\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 livecheck\fR checks whether a newer version of a given port is available upstream\&. It (usually) does that by automatically downloading a web page and applying a regular expression that extracts a version number\&. If the version number is different from the one the port packages, a message is printed\&.
.sp
\fBport livecheck\fR is useful for maintainers that want to check whether new versions of their ports are available so they can be updated\&. It can also be used by users that encounter a problem, because updating to the latest upstream version is generally one of the first steps in case of an error or when encountering a bug\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-v\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> Print a message if the port is up to date\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-d\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> Print debugging information such as the regular expression and all matches\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBportfile\fR(7), \fBport-upgrade\fR(7), \m[blue]\fBLivecheck/Distcheck in the MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2
<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;'>@@ -60,6 +85,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
Livecheck/Distcheck in the MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-load.1 b/doc/port-load.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 850addb..bca61e8 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-load.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-load.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\-LOAD" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-LOAD" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,26 +19,41 @@
</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-load, port-unload, port-reload \- Control daemons installed by a port
.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\-d\fR] [\fB\-D\fR \fIportdir\fR] [\fBload\fR | \fBunload\fR | \fBreload\fR]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
These commands control the daemons that are installed by some of the ports\&. If a port provides daemon functionality, a note will be printed during installation advising you how to use it\&.
.sp
The daemon functionality is provided by installing a \fBlaunchd\fR(8) configuration file (see \fBlaunchd.conf\fR(5)) and calling \fBlaunchctl\fR(1) on your behalf\&. \fBport load\fR advises launchd to start the daemon defined by a port\(cqs configuration file, also called a \(lqstartup item\(rq\&. Once loaded, launchd will preserve this state \- even across reboots \- until the daemon is unloaded using \fBport unload\fR\&. If you want to restart a daemon, you can use \fBport reload\fR, w [...]
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBlaunchd\fR(8), \fBlaunchd.conf\fR(5), \fBlaunchctl\fR(1)
<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;'>@@ -50,3 +65,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-log.1 b/doc/port-log.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 0d2166f..cb92fc4 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-log.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-log.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\-LOG" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-LOG" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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-log, port-logfile \- Print contents or path of a port\*(Aqs log file
.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\-D\fR \fIportdir\fR] \fBlog\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -30,51 +34,92 @@ port-log, port-logfile \- Print contents or path of a port\*(Aqs log file
</span> [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBlogfile\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 log\fR prints and optionally filters the contents of the log file for the installation of the given port\&. The file can be filtered by log message level and installation phase\&.
.sp
\fBport logfile\fR prints the path to the log file for the last installation of the given port\&. This is helpful to locate the file to attach when reporting bugs against ports in MacPorts\*(Aq issue tracker\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport logfile\fR has no options\&. \fBport log\fR has the following options:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-\-level SEVERITY\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> Hide all messages below the given severity, which is one of
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
error
.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 error messages
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
warn
.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 warnings
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
msg
.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 standard MacPorts output
<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> for output shown in verbose mode
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
debug
.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 all output including debugging messages
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-phase PHASE\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> Only print messages that were generated in the given installation phase, where possible values for
\fBPHASE\fR
include
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -85,11 +130,17 @@ include
</span> \fIconfigure\fR,
\fIbuild\fR, and
\fIdestroot\fR\&. Note that you can specify an arbitrary value which will be used in a regular expression to filter the log file\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-install\fR(1), \fBport-clean\fR(1)
<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;'>@@ -101,3 +152,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-mirror.1 b/doc/port-mirror.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 209e967..0c6d431 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-mirror.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-mirror.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\-MIRROR" "1" "2016\-12\-27" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-MIRROR" "1" "2016\-12\-27" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,38 +19,65 @@
</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-mirror \- Fetch distfiles for a port
.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\-qvdp\fR] [\fB\-D\fR \fIportdir\fR] \fBmirror\fR
[\-\-new]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 mirror\fR creates or updates a local mirror of source archives (called \fIdistfiles\fR in MacPorts lingo) for the ports given on the command line\&. It will download any file that can be fetched using the standard \fBlibcurl\fR(3) download method and ignore ports that fetch from version control systems such as Subversion or Git\&.
.sp
Downloaded files will be checked for consistency and deleted if the checksums don\(cqt match those specified in the \fIPortfile\fR\&. Additionally, successfully downloaded files are stored in a custom database in \fI$portdbpath/distfiles_mirror\&.db\fR, where \fI$portdbpath\fR can be configured in \fBmacports.conf\fR(5)\&. This database can be deleted and re\-created from scratch using the \fB\-\-new\fR option\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-new\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> Delete the existing database of mirrored files and re\-create it from scratch\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-p\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> Don\(cqt abort downloading on the first error\&. This can be useful when attempting to create or update a full mirror, e\&.g\&. when using
\fBport mirror all\fR\&.
<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
If your use case for \fBport mirror\fR is downloading the files you need to install a set of ports later without a network connection, do not use \fBport mirror\fR: It will not work for ports that distribute their source code using a version control system such as Subversion or Git\&. Instead, use \fBport fetch\fR:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -64,6 +91,7 @@ $> sudo port \-p fetch $newport
</span> .\}
.sp
These can also be conveniently wrapped in a single command using a port expression (see \fBport\fR(1) for details):
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -78,6 +106,7 @@ $> sudo port \-p fetch $newport rdepof:$newport and not installed
</span> If your intention is creating a new complete mirror of all MacPorts distfiles, it is probably easier to sync them via rsync from our main mirror\&. See \m[blue]\fBMirrors\fR\m[]\&\s-2\u[1]\d\s+2 for details\&.
.sp
If you want to create a partial mirror of MacPorts distfiles or are running the main mirror for MacPorts, you should use \fBport mirror\fR:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -89,10 +118,16 @@ $> sudo port \-p mirror maintainer:^cal or category:haskell
</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 "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-fetch\fR(1), \fBlibcurl\fR(3), \fBcurl\fR(1)
<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;'>@@ -104,6 +139,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
Mirrors
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-notes.1 b/doc/port-notes.1
</span><span style='display:block; white-space:pre;color:#808080;'>index fc8524b..c41c17a 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-notes.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-notes.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\-NOTES" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-NOTES" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,31 +19,52 @@
</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-notes \- Re\-display install\-time messages for a port
.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\-q\fR] [\fB\-D\fR \fIportdir\fR] \fBnotes\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
\fINotes\fR are messages associated with ports that are displayed after successful installation\&. These messages often contain further instructions required to use the software, helpful tips on how to configure the port or information about important changes in a port\&.
.sp
\fBport notes\fR can be used to display these messages again after installation\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Do not display the header line; just print the note contents\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-install\fR(1)
<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;'>@@ -55,3 +76,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-outdated.1 b/doc/port-outdated.1
</span><span style='display:block; white-space:pre;color:#808080;'>index aae5370..5c4f2aa 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-outdated.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-outdated.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\-OUTDATED" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-OUTDATED" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,16 +19,25 @@
</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-outdated \- List outdated ports
.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\-q\fR] \fBoutdated\fR
.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 outdated\fR lists all ports that have newer versions available\&. For each port, it prints the name and both the old and the new version\&. \fBport outdated\fR will give you the reason why MacPorts considers a port to be outdated\&. This could be
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.RS 4
.ie n \{\
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -38,6 +47,7 @@ port-outdated \- List outdated ports
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> due to an update, i\&.e\&. if the version number increased,
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -49,6 +59,7 @@ due to an update, i\&.e\&. if the version number increased,
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> due to a revision bump, i\&.e\&. a higher revision,
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -60,6 +71,7 @@ due to a revision bump, i\&.e\&. a higher revision,
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> due to an epoch increase (used in situations where the version number decreased, but the port still is newer than the previous one), or
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -71,10 +83,12 @@ due to an epoch increase (used in situations where the version number decreased,
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> due to an OS upgrade\&. MacPorts will consider ports built on a previous version of OS X outdated\&.
.RE
.sp
The ports listed in \fBport outdated\fR are the ports that will be upgraded when you run
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -87,18 +101,31 @@ $> sudo port upgrade outdated
</span> .\}
.sp
i\&.e\&. those the \fIoutdated\fR pseudo\-port selector expands to, with one exception: If you have the newest version of a port installed, but deactivated in favor of an older version, \fBport outdated\fR will list it as outdated, but \fBsudo port upgrade outdated\fR will not upgrade it\&. This can be used to intentionally stay at an older version of a port, e\&.g\&. if the newer version does not work as expected\&. Note that MacPorts will still install newer versions of such ports if t [...]
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Do not list the header line or the message that no ports are outdated\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-upgrade\fR(1)
<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;'>@@ -110,3 +137,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-platform.1 b/doc/port-platform.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 4e30894..4624476 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-platform.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-platform.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\-PLATFORM" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-PLATFORM" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,30 +19,51 @@
</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-platform \- Print the OS version for which MacPorts was built
.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\-q\fR] \fBplatform\fR
.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
This command prints the version of your operating system used to configure and build MacPorts\&. This value is used to detect OS updates and refer users to the \m[blue]\fBMigration\fR\m[]\&\s-2\u[1]\d\s+2 instructions\&.
.sp
Since MacPorts picks up a number of paths at configure\-time and uses them later on, changes in the operating system can break a MacPorts installation\&. For example, this happened when Apple removed \(lq/usr/bin/gnutar\(rq from OS X with the release of Mavericks\&. Since MacPorts keeps the path to its tar command in a file, this change required rebuilding MacPorts\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Do not print the \(lqPlatform:\(rq prefix\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \m[blue]\fBMigration\fR\m[]\&\s-2\u[1]\d\s+2
<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;'>@@ -54,6 +75,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
Migration
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-provides.1 b/doc/port-provides.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 223772e..4290796 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-provides.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-provides.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\-PROVIDES" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-PROVIDES" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,14 +19,22 @@
</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-provides \- Find the port that installed a file
.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 \fBprovides\fR \fIfile\fR \&...
.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 provides\fR looks up which port installed a given file, if the file has been installed by MacPorts\&. If the given file is not known to MacPorts it was either obtained using a different method, or has been created by a script or an executable after installation\&.
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -48,12 +56,18 @@ You can only use \fBprovides\fR on files that you have installed on your system\
</span> .sp .5v
.RE
.SH "BUGS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
If MacPorts is configured to use a prefix that contains symlinks, \fBprovides\fR may incorrectly report that a file is unknown to MacPorts\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-contents\fR(1)
<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;'>@@ -65,3 +79,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-reclaim.1 b/doc/port-reclaim.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 63210d1..ed8b355 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-reclaim.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-reclaim.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\-RECLAIM" "1" "2016\-12\-07" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-RECLAIM" "1" "2016\-12\-07" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,37 +19,64 @@
</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-reclaim \- Reclaims disk space\&.
.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\-vd\fR] \fBreclaim\fR
[\-\-enable\-reminders] [\-\-disable\-reminders]
.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 reclaim\fR will reclaim disk space by uninstalling inactive ports on your system, and removing unneeded or unused installation files\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-enable\-reminders\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> Enable regular reminders to run
\fBport reclaim\fR\&. Using this option will only update the configuration; the reclaim process will not be run\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-disable\-reminders\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> Disable reminders to run
\fBport reclaim\fR\&. Using this option will only update the configuration; the reclaim process will not be run\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-uninstall\fR(1), \fBport-clean\fR(1),
<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;'>@@ -61,3 +88,6 @@ Kyle Sammons <ksammons@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-rev-upgrade.1 b/doc/port-rev-upgrade.1
</span><span style='display:block; white-space:pre;color:#808080;'>index f867c29..38f4e06 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-rev-upgrade.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-rev-upgrade.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\-REV\-UPGRADE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-REV\-UPGRADE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,32 +19,55 @@
</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-rev-upgrade \- Check for linking inconsistencies and attempt to fix them automatically\&.
.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\-vdy\fR] \fBrev\-upgrade\fR
[\-\-id\-loadcmd\-check]
.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 rev\-upgrade\fR will check all binaries (i\&.e\&., executables and libraries) installed by MacPorts for consistency\&. If any linking problems such as missing or incompatible libraries are found, \fBrev\-upgrade\fR will rebuild broken ports in an attempt to fix the problems\&.
.sp
By default, \fBrev\-upgrade\fR is run automatically after each installation or upgrade, unless you pass the \fB\-\-no\-rev\-upgrade\fR option or disable this beahvior in \fBmacports.conf\fR(5) using the \fBrevupgrade_autorun\fR switch\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-id\-loadcmd\-check\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> Check the ID load command in each library installed by MacPorts\&. This load command contains a path that should always reference the library itself, because the path will be copied into all binaries and libraries that link against this library\&. This option verifies that this is the case and will detect incorrect or non\-absolute paths\&. Since this check is only helpful for port maintainers, it is disabled by default\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBmacports.conf\fR(5)
<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;'>@@ -56,3 +79,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-search.1 b/doc/port-search.1
</span><span style='display:block; white-space:pre;color:#808080;'>index cd0a38e..9118079 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-search.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-search.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\-SEARCH" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-SEARCH" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,40 +19,64 @@
</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-search \- Search for a port using keywords
.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\-dq\fR] \fBsearch\fR
[\-\-case\-sensitive] [\-\-line] [\-\-exact|\-\-glob|\-\-regex] [\-\-\fIfield\fR \&...]
\fIkeyword\fR \&...
.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 search\fR helps you find ports by partial matches of the name or description (or other fields, depending on the given options)\&. It is the tool of choice if you are looking for software in MacPorts\&.
.sp
\fBsearch\fR works by searching for your given keyword(s) in a set of fields of all available ports\&. By default, a port\(cqs name and short description are searched, as if you had specified both \fB\-\-name\fR and \fB\-\-description\fR\&. See \fBOPTIONS\fR for possible values for \fIfield\fR\&.
.sp
Note that you can specify multiple fields to be searched\&. A port will be printed when any of the fields matches your keyword(s)\&. If you specify multiple keywords, \fBsearch\fR will run multiple separate searches, one for each given keyword\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SS "Search behavior"
<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
\fB\-\-case\-sensitive\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> Do not ignore case when searching for the given keyword\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-exact\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> Search for the given string exactly\&. Disables
\fB\-\-glob\fR
(the default) and
\fB\-\-regex\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-glob\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> Treat the keyword(s) as wildcard (i\&.e\&., expand
\fI*\fR,
\fI?\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -62,26 +86,46 @@ and
</span> section of
\fBstring\fR(n)
for a detailed syntax description\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-regex\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> Treat the given string as a Tcl regular expression\&. See
\fBre_syntax\fR(n)
for a description of Tcl regular expressions\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SS "Output behavior"
<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
\fB\-\-line\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> Print one match per line, where a line consists of name, version, categories and short description\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.sp
See also \fB\-q\fR in the \fBGLOBAL OPTIONS\fR section below\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SS "Field selection"
<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
\fB\-\-category\fR, \fB\-\-categories\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> Search the category\&. You can use this to list all ports in a given category\&. For example,
\fBport search \-\-category haskell\fR
will print all Haskell ports in MacPorts\&. If you don\(cqt need the description it\(cqs usually faster to use the pseudo\-portname selector
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -92,65 +136,106 @@ with
</span> \fBport echo category:haskell\fR) instead\&. See
\fBport\fR(1)
for more information on pseudo\-port selectors\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-depends\fR, \fB\-\-depends_build\fR, \fB\-\-depends_extract\fR, \fB\-\-depends_fetch\fR, \fB\-\-depends_lib\fR, \fB\-\-depends_run\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> Search for ports that depend on the port given as keyword\&.
\fB\-\-depends\fR
is an alias for all other
\fB\-\-depends_\fR
options combined\&. Note that only dependencies present in default variants will be found by this search\&. As with
\fB\-\-category\fR, there also are pseudo\-portname selectors available for dependencies\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-description\fR, \fB\-\-long_description\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> Test the search string against ports\*(Aq descriptions\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-homepage\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> Search for the keyword(s) in the homepage property\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-maintainer\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> Search for ports maintained by a specific maintainer\&. Note that there also is a pseudo\-portname selector available for maintainer addresses\&. See
\fBport\fR(1)
for more information\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-name\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> Search in ports\*(Aq names\&. Since this is the default (together with
\fB\-\-description\fR), this flag is only useful when you to search
\fIonly\fR
in the name, but not the description\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-portdir\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> Test the search string against the path of the directory that contains the port\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-variant\fR, \fB\-\-variants\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> Search for variant names\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Only print the name of the port that matched your query\&. Print one match per line\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "EFFICIENT SEARCHING"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The output of \fBsearch\fR can be overwhelming and confusing, especially with a large number of results\&. Here are a few tips to improve your search efficiency with MacPorts\&.
.sp
Suppose you are looking for PHP in MacPorts\&. You might start with
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -163,6 +248,7 @@ $> port search php
</span> .\}
.sp
and notice your query produces a lot of output\&. In fact, at the time of writing this, this search produces 763 matches\&. By default, \fBsearch\fR searches both name and description of a port\&. While we\(cqre looking for PHP, we can reduce the number of hits by using the \fB\-\-name\fR flag\&. Furthermore, we only want ports whose name starts with \(lqphp\(rq, so we add the \fB\-\-glob\fR flag (actually, we could leave it out because it is the default) and modify the search term to \f [...]
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -175,6 +261,7 @@ $> port search \-\-name \-\-glob \*(Aqphp*\*(Aq
</span> .\}
.sp
Since that still produces 689 results, we can activate compressed output using the \fB\-\-line\fR flag
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -187,6 +274,7 @@ $> port search \-\-line \-\-name \-\-glob \*(Aqphp*\*(Aq
</span> .\}
.sp
Scrolling over the output, we see a large number of PHP modules starting with php<version>\-<modulename>\&. That tells us the main PHP ports might be named php<version>\&. Using regex we can further narrow down the results:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -199,6 +287,7 @@ $> port search \-\-line \-\-name \-\-regex \*(Aq^php\ed+$\*(Aq
</span> .\}
.sp
Note it is not always necessary to drill down to reduce the amount of output\&. For example, if you\(cqre looking for \fBrrdtool\fR, a popular system to store and graph time\-series data, the simple approach works well, with only 12 ports being returned:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -209,10 +298,16 @@ $> port search rrd
</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 "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBstring\fR(n), \fBre_syntax\fR(n), \fBport-install\fR(1)
<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;'>@@ -224,3 +319,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-select.1 b/doc/port-select.1
</span><span style='display:block; white-space:pre;color:#808080;'>index e888f21..e9742ed 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-select.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-select.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\-SELECT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-SELECT" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,26 +19,46 @@
</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-select \- Switch between different implementations of a tool
.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\-dv\fR] \fBselect\fR \-\-summary
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-dv\fR] \fBselect\fR \-\-show \fIgroup\fR
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-dv\fR] \fBselect\fR [\-\-list] \fIgroup\fR
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-dv\fR] \fBselect\fR [\-\-set] \fIgroup\fR \fIoption\fR
.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 select\fR provides a mechanism to choose from different implementations of a common tool or port\&. Selecting one of the options makes it the primary version or implementation, e\&.g\&. the one to be run by default when you do not explicitly select a version or implementation on the command line\&.
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -47,27 +67,46 @@ Note that \fBport select\fR is only for your convenience as user\&. It does not,
</span> One example is the set of MySQL and forks of MySQL, where there are mysql51, mysql55, mysql56, mariadb, mariadb\-10\&.0, mariadb\-11\&.0, percona, possibly among others\&. \fBport select\fR lets you choose which of these becomes the version run, when you simply run \fImysql\fR or other commands from the MySQL suite\&.
.sp
\fBport select\fR has multiple modes of operation: It can display a summary, show the current primary implementation and list all available implementations given a group name, and change the primary implementation\&. See \fBOPTIONS\fR below for details\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-summary\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> Display a summary of all available selection groups, their current primary implementation and a list of all available choices\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-show\fR \fIgroup\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> Print the current primary implementation for the given group\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-list\fR \fIgroup\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> Print a list of all currently available choices for the given group\&. This is the default when
\fBport select\fR
is called with one argument\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-set\fR \fIgroup\fR \fIoption\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> Make
\fIoption\fR
the primary selection for the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -75,13 +114,19 @@ the primary selection for the
</span> group\&. This is the default when
\fBport select\fR
is called with two arguments\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "EXAMPLES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
If you have both the mysql56 and the percona port installed, you can switch your implementation of the \fImysql\fR command by running
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -94,10 +139,15 @@ $> sudo port select \-\-set mysql $option
</span> .\}
.sp
where \fI$option\fR is \fImysql56\fR if you want the version from MySQL, or \fIpercona\fR, if you want the version from Percona\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -109,3 +159,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-selfupdate.1 b/doc/port-selfupdate.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 5380da6..17352ac 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-selfupdate.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-selfupdate.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\-SELFUPDATE" "1" "2017\-10\-27" "MacPorts 2\&.4\&.99" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-SELFUPDATE" "1" "2017\-10\-27" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,42 +19,73 @@
</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-selfupdate \- Upgrade MacPorts itself and update the port definition files\&.
.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\-qvdf\fR] \fBselfupdate\fR [\-\-nosync]
.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 selfupdate\fR checks for new releases of MacPorts and upgrades it when necessary\&. \fBselfupdate\fR also updates the local port definitions (the so\-called ports tree) to the latest state so you have the latest versions of ports available\&. This part of the operation corresponds to \fBport-sync\fR(1)\&.
.sp
You should regularly run \fBselfupdate\fR to update your local port definitions\&. Running \fBselfupdate\fR is required to get updated software with bug fixes and new features\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-nosync\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> Only check for updates \- and install if available \- for MacPorts itself\&. Do not update the ports tree\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Suppress status output, be as silent as possible\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-f\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> Do not check whether the downloaded MacPorts version is newer than the currently installed one, but always rebuild and reinstall MacPorts\&.
You can use this to downgrade from a beta or development version to the latest release\&. Note that there is no guarantee that there have not been made incompatible and irreversible changes to MacPorts\*(Aq internal data structures, making a downgrade impossible\&.
<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
When no new versions are available, \fBselfupdate\fR looks like this:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -62,8 +93,8 @@ When no new versions are available, \fBselfupdate\fR looks like this:
</span> .nf
$ sudo port selfupdate
\-\-\-> Updating MacPorts base sources using rsync
<span style='display:block; white-space:pre;background:#ffe0e0;'>-MacPorts base version 2\&.4\&.99 installed,
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-MacPorts base version 2\&.4\&.99 downloaded\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+MacPorts base version 2\&.4\&.3 installed,
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+MacPorts base version 2\&.4\&.3 downloaded\&.
</span> \-\-\-> Updating the ports tree
\-\-\-> MacPorts base is already the latest version
.fi
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -72,6 +103,7 @@ MacPorts base version 2\&.4\&.99 downloaded\&.
</span> .\}
.sp
If \fBselfupdate\fR detects that a newer version of MacPorts is available, it attempts to update your copy to this version\&. In that case, the output will be different:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -80,32 +112,46 @@ If \fBselfupdate\fR detects that a newer version of MacPorts is available, it at
</span> $ sudo port selfupdate
\-\-\-> Updating MacPorts base sources using rsync
MacPorts base version 2\&.3\&.0 installed,
<span style='display:block; white-space:pre;background:#ffe0e0;'>-MacPorts base version 2\&.4\&.99 downloaded\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+MacPorts base version 2\&.4\&.3 downloaded\&.
</span> \-\-\-> Updating the ports tree
<span style='display:block; white-space:pre;background:#ffe0e0;'>-\-\-\-> MacPorts base is outdated, installing new version 2\&.4\&.99
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\-\-\-> MacPorts base is outdated, installing new version 2\&.4\&.3
</span> Installing new MacPorts release in /opt/local as root:admin; permissions 755
.fi
.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 "TROUBLESHOOTING"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
If \fBselfupdate\fR fails, it usually does so in one of two places: The network connection, or the installation of the update\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
Network Problems
.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> MacPorts uses the
\fIrsync\fR
protocol to update its sources to the latest version\&. This will fail if you are on a network that blocks TCP connections to the rsync port 873\&. Talk to your network administrators and ask them to allow connections to port 873 if this happens to you\&. Alternatively, you can just download a new installer \&.pkg from macports\&.org and run that to upgrade your installation\&.
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> Network connection problems might also affect you if you are in a country with US export restrictions\&. We suggest using one of our other
\m[blue]\fBmirrors\fR\m[]\&\s-2\u[1]\d\s+2
outside of the US in these cases\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
Compilation Problems
.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> When a problem occurs while building and installing the new MacPorts version, you will see the message
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -117,6 +163,7 @@ Error installing new MacPorts base: command execution failed
</span> .RE
.\}
.sp
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> To find out what went wrong, re\-run
\fBselfupdate\fR
with the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -124,6 +171,7 @@ with the
</span> flag\&. This will allow you to see all output generated by the build system\&. Look for the first occurance of \(lqerror\(rq\&. If you cannot figure out what\(cqs wrong on your own, feel free to ask on
\m[blue]\fBthe macports\-users mailing list\fR\m[]\&\s-2\u[2]\d\s+2
and attach the output generated by
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -134,11 +182,18 @@ $ sudo port \-d selfupdate
</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
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-sync\fR(1)
<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;'>@@ -150,6 +205,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
mirrors
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-setrequested.1 b/doc/port-setrequested.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 0580b2d..71ddf3f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-setrequested.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-setrequested.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\-SETREQUESTED" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-SETREQUESTED" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,33 +19,52 @@
</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-setrequested, port-unsetrequested, port-setunrequested \- Set and clear the \*(Aqmanually installed\*(Aq flag of a port
.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\-qvd\fR] [\fB\-D\fR \fIportdir\fR] \fBsetrequested\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
<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><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span> .nf
\fBport\fR [\fB\-qvd\fR] [\fB\-D\fR \fIportdir\fR] [\fBunsetrequested\fR | \fBsetunrequested\fR]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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
MacPorts keeps records indicating whether you installed a port manually, or whether it was pulled in as a dependency of another port\&. This flag is called \fIrequested\fR and is usually automatically set for all ports you list after \fBport install\fR when installing\&. You can disable this automatic behavior by passing the \fB\-\-unrequested\fR flag to \fBport install\fR\&. See \fBport-install\fR(1) for more information\&.
.sp
\fBport setrequested\fR and \fBport unsetrequested\fR allow you to manipulate the requested flag of a port manually\&. \fBport setunrequested\fR is an alias of \fBport unsetrequested\fR\&.
.sp
The requested flag is used to expand the \fIleaves\fR pseudo\-portname, i\&.e\&. the list of ports that were automatically installed and are no longer needed\&. See \fBport\fR(1) for more information on pseudo\-portnames\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-install\fR(1)
<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;'>@@ -57,3 +76,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-space.1 b/doc/port-space.1
</span><span style='display:block; white-space:pre;color:#808080;'>index ec393f8..9aac068 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-space.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-space.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\-SPACE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-SPACE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,82 +19,139 @@
</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-space \- Show the disk usage of the given ports
.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\-D\fR \fIportdir\fR] \fBspace\fR [\-\-units \fIunit\fR] [\fItotal\fR]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.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 space\fR lists the amount of disk space the port(s) given on the command line occupy on disk\&. Note that the space reported is for the files installed by a port, but not the image of the port\(cqs files MacPorts keeps internally\&. See the \fBPORT IMAGES\fR section for more information on how images work\&. Consequently, \fBport space\fR will only work on active ports\&.
.sp
By default, \fBport space\fR will print a line with the size in an appropriate unit followed by the name of a port for each port given on the command line (or expanded from a pseudo\-port expression given; see \fBport\fR(1) for more info on pseudo\-port expressions)\&. The last line of output will contain a total\&.
.sp
If you are only interested in the total of all ports (e\&.g\&. if you want to get the total amount of space used by your installed ports) use the \fB\-\-total\fR flag\&. If you want to sort the output by file size, you can pipe the results of \fBport space\fR to \fBsort \-n\fR\&. Since \fBport space\fR defauts to using a suitable unit, you should specify a unit to allow for meaningful numeric sorting, e\&.g\&. \fBport space \-\-units KiB\fR to get all output in KiB\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-total\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> Only print the total amount of space used by all given ports\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-units \fR\fB\fIunit\fR\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> Choose the unit in which the size is given\&. You should specify this if you intend to sort the output\&. Valid values for
\fIunit\fR
are
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBB\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> List sizes in bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBK\fR, \fBKi\fR, \fBKiB\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> List sizes in KiB, i\&.e\&., 1024 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBMi\fR, \fBMiB\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> List sizes in MiB, i\&.e\&., 1024 * 1024 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBGi\fR, \fBGiB\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> List sizes in GiB, i\&.e\&., 1024 * 1024 * 1024 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBk\fR, \fBkB\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> List sizes in kB, i\&.e\&., 1000 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBM\fR, \fBMB\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> List sizes in MB, i\&.e\&., 1000 * 1000 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBG\fR, \fBGB\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> List sizes in GB, i\&.e\&., 1000 * 1000 * 1000 bytes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "PORT IMAGES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIarchives\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be copied to their intended place in \fIprefix\fR\&.
.sp
More information on this topic can be found in the \m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2\&.
.sp
To check the current status of a specific port, use \fB\fBport-installed\fR(1)\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "EXAMPLES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
To find the 10 largest ports in your MacPorts installation, you can use the following command:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -105,10 +162,16 @@ $> port space \-\-units MiB active | sort \-rn | head \-n10
</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 "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-archive\fR(1), \fBsort\fR(1)
<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;'>@@ -120,6 +183,8 @@ Clemens Lang <cal@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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-sync.1 b/doc/port-sync.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 3f0a73a..bc2131f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-sync.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-sync.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\-SYNC" "1" "2017\-10\-27" "MacPorts 2\&.4\&.99" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-SYNC" "1" "2017\-10\-27" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,14 +19,22 @@
</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-sync \- Update the port definition files
.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\-qvd\fR] \fBsync\fR
.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 sync\fR updates the local port definitions (the so\-called ports tree) to the latest state so you have the latest versions of ports available\&. You should normally not run \fBport sync\fR directly, but use \fBport selfupdate\fR, which updates MacPorts itself and then proceeds to do the same operation as \fBsync\fR does\&. You can, however, use \fBport sync\fR if you know that \fBselfupdate\fR does not work on your system or in your network environment, for example because your n [...]
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -48,17 +56,29 @@ When you use \fBport sync\fR, it is your responsibility to check whether new upd
</span> .sp .5v
.RE
.SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Suppress status output, be as silent as possible\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-selfupdate\fR(1)
<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;'>@@ -70,3 +90,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-unarchive.1 b/doc/port-unarchive.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 39e9a20..b7e7417 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-unarchive.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-unarchive.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\-UNARCHIVE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-UNARCHIVE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,25 +19,40 @@
</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-unarchive \- Extract the destroot of the given ports from a binary archive
.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\-vdtoy\fR] [\fB\-D\fR \fIportdir\fR] \fBunarchive\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[+/\- variant \&...]
.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
Extract the destroot (i\&.e\&. the set of files that are installed by a port) from installed or downloaded binary archives\&. Usually, users will not have to run this command manually\&. It is run automatically by MacPorts when installing a port from a pre\-built binary\&. The possibility to execute it directly exists for debugging purposes\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-install\fR(1)
<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;'>@@ -49,3 +64,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-uninstall.1 b/doc/port-uninstall.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 720f2a9..eca454d 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-uninstall.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-uninstall.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\-INSTALL" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-INSTALL" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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-uninstall \- Remove a previously installed port
.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\-vdquxpf\fR] [\fB\-D\fR \fIportdir\fR] \fBuninstall\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -29,34 +33,61 @@ port-uninstall \- Remove a previously installed port
</span> [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[@version]
.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 uninstall\fR removes a port from your system\&. You can only uninstall a port if all dependents have been removed before or by applying force with \fB\-f\fR\&.
.sp
If multiple versions of the same port are installed, you need to specify a version using the \fB@version\fR syntax\&. Use \fBport installed\fR to find out which versions are currently installed on your system\&. If multiple versions are installed and you did not specify a version, \fBport\fR will output a list\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-follow\-dependents\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> Also uninstall all ports recursively depending directly or indirectly on one of the specified ports before uninstalling the port itself\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-follow\-dependencies\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> Also recursively uninstall all ports that the specified port depends on\&. This will not uninstall dependencies that are marked as requested or that have other dependents\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-no\-exec\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> Do not execute any stored pre\- or post\-uninstall procedures\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-uninstall\fR(1), \fBport-info\fR(1), \fBport-variants\fR(1), \fBvariants.conf\fR(5)
<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;'>@@ -68,3 +99,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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-upgrade.1 b/doc/port-upgrade.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 98c3b61..deb06d8 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-upgrade.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-upgrade.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\-UPGRADE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-UPGRADE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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-upgrade \- Upgrade a port to the latest version
.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\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBupgrade\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -29,11 +33,16 @@ port-upgrade \- Upgrade a port to the latest version
</span> [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[+/\-variant \&...]
.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 upgrade\fR will upgrade the given installed ports to the latest available version\&. To upgrade a port, MacPorts needs an updated port definition, which can be obtained using the \fBport-selfupdate\fR(1) command\&. You should regularly run \fBselfupdate\fR followed by \fBupgrade outdated\fR to make sure your system has the latest versions and bug fixes\&.
.sp
When specifying variants during upgrade, the order of precedence is
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.RS 4
.ie n \{\
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -43,6 +52,7 @@ When specifying variants during upgrade, the order of precedence is
</span> .sp -1
.IP " 1." 4.2
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> variants specified on the command line
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -54,6 +64,7 @@ variants specified on the command line
</span> .sp -1
.IP " 2." 4.2
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> variants active in the latest installed version of the port
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -65,63 +76,105 @@ variants active in the latest installed version of the port
</span> .sp -1
.IP " 3." 4.2
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> variants specified in
\fBvariants.conf\fR(5)
.RE
.sp
In most cases, you should specify the \fBoutdated\fR pseudo\-port expression as argument to \fBport upgrade\fR to upgrade all ports where a newer version is available\&. This is the recommended upgrade method for end users\&. See \fBport\fR(1) for more information on pseudo\-port expressions\&. Upgrading individual packages should only be performed by expert users who know what they are doing, since a mix of upgraded and non\-upgraded packages can lead to various software errors\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-enforce\-variants\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> Upgrade all given ports and their dependencies where the installed variants do not match those requested on the command line, even if those ports aren\(cqt outdated\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-force\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> Ignore circumstances that would normally cause ports to be skipped, such as not being outdated\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-no\-replace\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> Do not automatically install ports that replace a now\-obsolete port you have installed\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-\-no\-rev\-upgrade\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> Do not run rev\-upgrade after upgrading\&. See
\fBport-rev-upgrade\fR(1)
for more information\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-f\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> Upgrade a port, even if it is not outdated\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-n\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> Only upgrade the given ports and avoid upgrading their dependencies\&. This flag may be useful when combined with
\fB\-\-enforce\-variants\fR\&.
WARNING: Ports expect their dependencies to always be at the latest version, which is why MacPorts upgrades dependencies first\&. Do not specify this flag if you don\(cqt know what you are doing\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fB\-p\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> Keep going and attempt to upgrade the next port when a port fails to build\&.
WARNING: This option is harmful to
\fBupgrade\fR
and should be avoided at all cost\&. Often, MacPorts ports are only upgraded to rebuild them against updated dependencies\&. Specifying this flag will cause a spurious rebuild if a dependency of a port fails to build and leave your system in a broken state once the dependent port is fixed\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-uninstall\fR(1), \fBport-info\fR(1), \fBport-variants\fR(1), \fBport-rev-upgrade\fR(1), \fBport-setrequested\fR(1), \fBvariants.conf\fR(5)
<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;'>@@ -133,3 +186,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-usage.1 b/doc/port-usage.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 930bd4b..25ba33f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-usage.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-usage.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\-USAGE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-USAGE" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,20 +19,33 @@
</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-usage \- Show a short command synopsis summary for the port command
.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 \fBusage\fR
.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 usage\fR displays a very brief summary of all possible options of \fBport\fR(1) and the canonical order in which port expects them\&. It prints the \fBSYNOPSIS\fR port of the \fBport\fR(1) manpage\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -44,3 +57,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-variants.1 b/doc/port-variants.1
</span><span style='display:block; white-space:pre;color:#808080;'>index 78362c6..accd5e6 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-variants.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-variants.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\-VARIANTS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-VARIANTS" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,40 +19,67 @@
</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-variants \- Print a list of variants with descriptions provided by a port
.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\-qvd\fR] [\fB\-D\fR \fIportdir\fR] \fBvariants\fR [\-\-index]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
[+/\-variant \&...]
.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 variants\fR prints a list of variants provided by the port(s) given on the command line\&. Variants allow users to select certain features when installing a certain port\&. For example, the gtk3 port provides two conflicting variants \fI+quartz\fR and \fI+x11\fR that select whether Gtk uses the X11 backend (which requires an X server) or the OS X\-native Quartz backend (which attempts to provide a more native OS X look and feel)\&. In addition, many ports feature an \fI+universal [...]
.sp
\fBport variants\fR lists all variants by name and (if available) description\&. If variants depend on or conflict with other variants, this information is printed as a bulleted list for each variant\&.
.sp
The output of \fBport variants\fR contains \fI[+]\fR before a variant name, if the port declares this variant as default\&. \fI(+)\fR or \fI(\-)\fR in the same spot mark variants enabled or disabled by your \fBvariants.conf\fR(5)\&. Last, a single \fI+\fR or \fI\-\fR marks variants explicitly enabled or disabled on the command line by appending \fI+variantname\fR or \fI\-variantname\fR\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "OPTIONS"
<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
\fB\-\-index\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> Do not read the
\fIPortfile\fR, but rely solely on the port index information\&. Note that this will limit the output to the variant names only\&. No descriptions, dependencies or conflicts between variants will be reported\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Do not print the header line\&.
<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 output of \fBport variants\fR provides all available information on a port\(cqs variants\&. The gtk3 port can serve as a good 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;'>@@ -71,10 +98,15 @@ gtk3 has the variants:
</span> .\}
.sp
In this case, \fI(+)\fR means that we have chosen \fI+quartz\fR as a default variant in our \fBvariants.conf\fR(5)\&. Additionally, we have explicitly disabled the universal variant on the command line, as indicated by its leading \fI\-\fR symbol\&. Finally, the port maintainer has chosen \fI+x11\fR as the default, indicated by \fI[+]\fR\&. Furthermore, the \fIquartz\fR and \fIx11\fR variants conflict with each other\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -86,3 +118,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-version.1 b/doc/port-version.1
</span><span style='display:block; white-space:pre;color:#808080;'>index a2db18e..4f91d31 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port-version.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-version.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\-VERSION" "1" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-VERSION" "1" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,28 +19,49 @@
</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-version \- Print the MacPorts version
.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\-q\fR] \fBversion\fR
.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
This command prints the version of your MacPorts installation\&. You can use \fBport-selfupdate\fR(1) to update your MacPorts installation to the latest release\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GLOBAL OPTIONS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fB\-q\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> Do not print the \(lqVersion:\(rq prefix\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-selfupdate\fR(1)
<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;'>@@ -52,3 +73,6 @@ Clemens Lang <cal@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><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 8a9e83e..54c2455 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\-01\-08" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT" "1" "2017\-01\-08" "MacPorts 2\&.4\&.3" "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;'>@@ -174,6 +193,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;'>@@ -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> \fIversion\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> \fIrevision\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> \fIepoch\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> \fIvariant\fR
or
\fIvariants\fR
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -231,6 +255,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;'>@@ -244,6 +269,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;'>@@ -257,6 +283,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;'>@@ -270,6 +297,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;'>@@ -281,6 +309,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;'>@@ -292,6 +321,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;'>@@ -303,6 +333,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;'>@@ -314,10 +345,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;'>@@ -327,6 +360,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;'>@@ -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> \fIrdepof\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> \fIrdepends\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> \fIdependentof\fR
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -371,12 +408,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;'>@@ -394,6 +433,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;'>@@ -405,6 +445,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;'>@@ -422,133 +463,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 TARGETS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Targets 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;'>@@ -559,10 +689,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;'>@@ -577,7 +712,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;'>@@ -593,54 +730,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;'>@@ -648,7 +818,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;'>@@ -661,17 +833,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;'>@@ -685,57 +864,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;'>@@ -747,13 +965,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;'>@@ -765,24 +990,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 target 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;'>@@ -811,8 +1047,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;'>@@ -824,9 +1062,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;'>@@ -838,9 +1078,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;'>@@ -852,12 +1094,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;'>@@ -889,9 +1134,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;'>@@ -902,10 +1149,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;'>@@ -916,10 +1168,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;'>@@ -929,7 +1185,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;'>@@ -943,7 +1201,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;'>@@ -955,7 +1215,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;'>@@ -966,10 +1228,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;'>@@ -977,7 +1244,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;'>@@ -989,16 +1258,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;'>@@ -1008,7 +1286,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;'>@@ -1021,15 +1301,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;'>@@ -1040,18 +1329,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;'>@@ -1063,14 +1362,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;'>@@ -1081,79 +1386,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 TARGETS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The targets 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;'>@@ -1164,111 +1524,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 TARGETS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
There are also targets 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 target 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;'>@@ -1279,36 +1712,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;'>@@ -1331,3 +1792,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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/portgroup.7 b/doc/portgroup.7
</span><span style='display:block; white-space:pre;color:#808080;'>index ff96aad..3111d3f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/portgroup.7
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/portgroup.7
</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 "PORTGROUP" "7" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORTGROUP" "7" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,9 +19,13 @@
</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"
portgroup \- MacPorts PortGroup command reference
.SH "SYNOPSIS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.nf
PortGroup gnustep 1\&.0
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -32,43 +36,71 @@ PortGroup python30 1\&.0
</span> PortGroup ruby 1\&.0
PortGroup xcode 1\&.0
.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
MacPorts defines the notion of PortGroup classes with the PortGroup command\&. These classes factorize the work for similar ports\&. Port maintainers willing to use PortGroup need to have some notion of Portfiles\&. See \fBportfile\fR(7)\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "XCODE PORTGROUP"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBPortGroup xcode\fR is here to easily port Xcode\-based opensource software\&. It handles configuration, build and destroot phases\&. It also defines some values for Xcode\-based software\&. A minimum Portfile using the \fBxcode PortGroup\fR class only defines the fetch and the checksum phases\&.
.sp
Using \fBPortGroup xcode\fR is a way to make your port more robust to Xcode version updates as the PortGroup is tested against all supported Mac OS X and Xcode versions\&.
.SS "XCODE PORTGROUP SUGAR"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Portfiles using \fBxcode PortGroup\fR do not need to define the following variables:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
categories
.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> \fBDefault:\fR
aqua
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
platforms
.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> \fBDefault:\fR
macosx
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
use_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> \fBDefault:\fR
no
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.sp
Moreover, Portfiles using \fBPortGroup xcode\fR do not need to define any build or destroot phase\&. Some options are provided for tailoring these phases to what the software requires\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SS "XCODE PORTGROUP SPECIFIC VARIABLES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Portfiles using \fBxcode PortGroup\fR may define the following variables:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
xcode\&.project
.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> Path (relative to ${build\&.dir} and ${destroot\&.dir}) of the Xcode project\&. If unset, let xcode tool figure it out\&. It usually succeeds if there is a single project in the directory\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -80,7 +112,9 @@ optional
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -91,10 +125,15 @@ xcode\&.project ${name}\&.xcode
</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
xcode\&.configuration
.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> Project configuration/buildstyle to use\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -112,7 +151,9 @@ Deployment
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -123,10 +164,15 @@ xcode\&.configuration Main
</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
xcode\&.target
.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 present, overrides build\&.target and destroot\&.target\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -138,10 +184,14 @@ optional
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
xcode\&.build\&.settings
.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> Additional settings passed to the xcode build tool during the build phase\&. These settings should be in the X=Y form\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -153,7 +203,9 @@ optional
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -164,10 +216,15 @@ xcode\&.build\&.settings FRAMEWORK_SEARCH_PATHS=${prefix}/Library/Frameworks
</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
xcode\&.destroot\&.type
.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> Type of project that will be installed\&. This tells Xcode PortGroup how to destroot the project\&. Correct values are application and framework\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -185,7 +242,9 @@ application
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -196,10 +255,15 @@ xcode\&.destroot\&.type framework
</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
xcode\&.destroot\&.path
.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> Where to install the build product\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -217,10 +281,14 @@ ${prefix}/Library/Frameworks or /Applications/MacPorts depending on xcode\&.dest
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
xcode\&.destroot\&.settings
.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> Additional settings passed to the xcode build tool during the destroot phase\&. These settings should be in the X=Y form\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -232,7 +300,9 @@ optional
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -243,32 +313,53 @@ xcode\&.destroot\&.settings SKIP_INSTALL=NO
</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
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SS "STANDARD PORTFILE VARIABLES AFFECTING XCODE PORTGROUP"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The following standard Portfile variables actually affect \fBxcode PortGroup\fR\&. In most cases, you will not need to set any of these variables in the Portfile\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .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> Where to destroot the project\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.cmd
.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 command to invoke to build the project\&.
\fBxcode PortGroup\fR
sets this variable to ${xcodebuildcmd}\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.target
.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 Xcode target to build\&.
\fBxcode PortGroup\fR
sets this variable to "", thus building all targets\&. This variable will be ignored if xcode\&.target is set\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.pre_args
.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> Additional parameters for ${build\&.cmd}\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -280,10 +371,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.args
.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> Main parameters for ${build\&.cmd}\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -295,10 +390,14 @@ build
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.post_args
.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> Additional parameters for ${build\&.cmd}\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -310,10 +409,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.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> Where to build the project from (i\&.e\&. where the Xcode project is)\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -325,24 +428,36 @@ ${worksrcpath}
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.cmd
.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 command to invoke to destroot the project\&.
\fBxcode PortGroup\fR
sets this variable to xcodebuildcmd\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.target
.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 Xcode target to install\&.
\fBxcode PortGroup\fR
sets this variable to "", thus installing all targets\&. This variable will be ignored if xcode\&.target is set\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.pre_args
.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> Additional parameters for ${destroot\&.cmd}\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -354,10 +469,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.args
.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> Main parameters for ${destroot\&.cmd}\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -369,10 +488,14 @@ install
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.post_args
.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> Additional parameters for ${destroot\&.cmd}\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -384,10 +507,14 @@ none
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.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> Where to destroot the project from (i\&.e\&. where the Xcode project is)\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -399,121 +526,207 @@ ${worksrcpath}
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "GNUSTEP PORTGROUP"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBPortGroup gnustep\fR is here to easily port GNUstep\-based opensource software using the GNU objective\- C runtime\&. It handles configuration, build and destroot phases\&. It also defines some values for GNUstep\-based software\&. A minimum Portfile using the \fBgnustep PortGroup\fR class only defines the fetch and the checksum phases\&.
.SS "GNUSTEP FILESYSTEM LAYOUTS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
PortGroup gnustep also supports both the traditionnal gnustep file layout and the new fhs file layout\&. However, the ports themselves do not necessarily support both\&. The Portfiles have access to many procedures in dealing with these two layouts:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
set_gnustep_make
.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> Sets GNUSTEP_MAKEFILES according to the FilesystemLayout
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
set_gnustep_env
.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> Sets DYLD_LIBRARY_PATH and PATH for the gnustep FilesystemLayout
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
gnustep_layout
.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> Returns true (1) if current file layout is gnustep
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
set_system_library
.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> Sets GNUSTEP_SYSTEM_LIBRARY according to the FilesystemLayout
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
set_local_library
.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> Sets GNUSTEP_LOCAL_LIBRARY according to the FilesystemLayout
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SS "GNUSTEP PORTGROUP SUGAR"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Portfiles using \fBgnustep PortGroup\fR do not need to define the following variables:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
categories
.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> \fBDefault:\fR
gnustep
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
homepage
.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> \fBDefault:\fR
\m[blue]\fBhttp://www\&.gnustep\&.org/\fR\m[]
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
master_sites
.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> \fBDefault:\fR
gnustep:core
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
depends_lib
.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> \fBDefault:\fR
gnustep\-core
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
use_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> \fBDefault:\fR
no
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
configure\&.env
.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> \fBDefault:\fR
DYLD_LIBRARY_PATH PATH
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
configure\&.pre_args\-append
.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> \fBDefault:\fR
CC=gcc\-mp\-4\&.2 GNUSTEP_MAKEFILES
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.type
.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> \fBDefault:\fR
gnu
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.env
.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> \fBDefault:\fR
DYLD_LIBRARY_PATH PATH
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
build\&.pre_args\-append
.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> \fBDefault:\fR
messages=yes
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.env
.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> \fBDefault:\fR
DYLD_LIBRARY_PATH PATH
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
destroot\&.pre_args\-append
.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> \fBDefault:\fR
messages=yes
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.sp
Moreover, Portfiles using \fBPortGroup gnustep\fR do not need to define any build or destroot phase\&. Some options are provided for tailoring these phases to what the software requires\&. A mechanism is also provided to ease the patch process\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SS "GNUSTEP PORTGROUP SPECIFIC VARIABLES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Portfiles using \fBgnustep PortGroup\fR may define the following variables:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
gnustep\&.post_flags
.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> an associative array which specifies the sub\-directories relative to ${worksrcpath} and the SHARED_LD_POSTFLAGS variables to be added to GNUmakefile\&.preamble in those sub\-directories\&. This helps making the patching process easier on Darwin\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -525,7 +738,9 @@ optional
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -540,10 +755,14 @@ platform darwin {
</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
gnustep\&.cc
.RS 4
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .TS
tab(:);
lt lt
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -560,7 +779,9 @@ gcc\-mp\-4\&.2
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -571,10 +792,15 @@ gnustep\&.cc gcc\-mp\-4\&.3
</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
variant with_docs
.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> Many GNUstep packages include a Documentation sub\-directory that is not built by default\&. Enabling this variant builds and installs the included documentation\&.
.TS
tab(:);
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -586,7 +812,9 @@ optional
</span> T}
.TE
.sp 1
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> \fBExample:\fR
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -597,11 +825,19 @@ port install gnustep\-gui +with_docs
</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
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBmacports.conf\fR(5), \fBportfile\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;'>@@ -615,3 +851,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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/portstyle.7 b/doc/portstyle.7
</span><span style='display:block; white-space:pre;color:#808080;'>index e3d7dba..493950d 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/portstyle.7
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/portstyle.7
</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 "PORTSTYLE" "7" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORTSTYLE" "7" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,15 +19,23 @@
</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"
portstyle \- style guide for Portfiles
.SH "DESCRIPTION"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
This man page previously documented the style of Portfiles\&. The canonical source for the formatting of Portfiles is now the \m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2, which also contains a section on \m[blue]\fBPort Style\fR\m[]\&\s-2\u[2]\d\s+2\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBportfile\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;'>@@ -39,6 +47,8 @@ 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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/portundocumented.7 b/doc/portundocumented.7
</span><span style='display:block; white-space:pre;color:#808080;'>index 2bc0434..614ca58 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/portundocumented.7
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/portundocumented.7
</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 "PORTUNDOCUMENTED" "7" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORTUNDOCUMENTED" "7" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,45 +19,77 @@
</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"
portundocumented \- A last\-resort man page for missing MacPorts documentation
.SH "DESCRIPTION"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Unfortunately, the requested topic is not yet documented in the MacPorts man pages\&. Sorry\&.
.sp
Further documentation on MacPorts can be found in the following places:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\m[blue]\fBThe MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2
.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> Detailed help and support guide
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBThe MacPorts Wiki\fR\m[]\&\s-2\u[2]\d\s+2
.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> MacPorts usage, development, and support
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBMailing Lists\fR\m[]\&\s-2\u[3]\d\s+2
.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> Ask questions on the mailing lists: macports\-dev for base and Portfile development, macports\-users for user support questions
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBFAQ\fR\m[]\&\s-2\u[4]\d\s+2
.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> Frequently Asked Questions
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\m[blue]\fBProblem Hotlist\fR\m[]\&\s-2\u[5]\d\s+2
.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> Solutions for the most common error messages and other problems
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "CONTRIBUTING"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
All sort of contributions to MacPorts base, ports and especially the documentation you were just looking for are welcome\&. If you care about MacPorts and would like to improve our documentation, please take a look at the source code of the man pages \m[blue]\fBin our repository\fR\m[]\&\s-2\u[6]\d\s+2 and get in touch with us on our \m[blue]\fBmailing lists\fR\m[]\&\s-2\u[3]\d\s+2\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1)
<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;'>@@ -69,6 +101,8 @@ 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> .SH "EXTERNAL REFERENCES"
.IP " 1." 4
The MacPorts Guide
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/pubkeys.conf.5 b/doc/pubkeys.conf.5
</span><span style='display:block; white-space:pre;color:#808080;'>index 3cffa9b..53b9aec 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/pubkeys.conf.5
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/pubkeys.conf.5
</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 "PUBKEYS\&.CONF" "5" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PUBKEYS\&.CONF" "5" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,11 +19,15 @@
</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"
pubkeys.conf \- public key configuration file of the MacPorts system
.SH "DESCRIPTION"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBpubkeys\&.conf\fR is the configuration file used by the MacPorts system to locate the public keys used to verify the integrity and authenticity of
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.RS 4
.ie n \{\
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -33,6 +37,7 @@ pubkeys.conf \- public key configuration file of the MacPorts system
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> the tree of port definitions,
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -44,6 +49,7 @@ the tree of port definitions,
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> downloaded pre\-built binary archives, and
.RE
.sp
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -55,24 +61,38 @@ downloaded pre\-built binary archives, and
</span> .sp -1
.IP \(bu 2.3
.\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> MacPorts updates\&.
.RE
.sp
The file is read by the \fBport\fR command\&. Lines beginning with \fI#\fR are comments, empty lines are ignored\&. All other lines must contain absolute paths of PEM\-encoded RSA public keys for use by OpenSSL\&.
.sp
MacPorts comes pre\-configured with its official public key\&. The authenticity of the public key file is provided by the MacPorts installer, which is cryptographically signed with an Apple Developer ID of one of the MacPorts developers\&. Unless you want to provide your own separate ports tree or your own pre\-built binary archives, there is no need to modify the \fBpubkeys\&.conf\fR file\&.
<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/pubkeys\&.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> Standard system\-wide MacPorts public key configuration file\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.sp
User\-specific configuration of public keys is not supported\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBmacports.conf\fR(5)
<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;'>@@ -84,3 +104,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/sources.conf.5 b/doc/sources.conf.5
</span><span style='display:block; white-space:pre;color:#808080;'>index e9f2be4..e40ccc5 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/sources.conf.5
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/sources.conf.5
</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 "SOURCES\&.CONF" "5" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "SOURCES\&.CONF" "5" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,11 +19,15 @@
</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"
sources.conf \- port definition configuration file of the MacPorts system
.SH "DESCRIPTION"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBsources\&.conf\fR is the configuration file used by the MacPorts system to locate its port definitions\&. The file is read by the \fBport\fR command to find available ports and how to install them\&. Lines beginning with \fI#\fR are comments, empty lines are ignored\&. Entries in this file are URIs optionally followed by flags in square brackets\&. Each source specification is given on a separate line\&. A grammar in EBNF is given below:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -36,27 +40,50 @@ space = \*(Aq \*(Aq | \*(Aq\et\*(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> .SH "URI FORMATS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
MacPorts supports a number of different protocols as source descriptions\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fIrsync://\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> Followed by a server name and a path on this server, this URI instructs MacPorts to fetch the contents of the file or directory referenced by this URI into a path of its own choosing\&. This is the default method of port tree synchronization and is generally recommended\&. MacPorts will derive a machine\- and architecture\-specific URI (in the subdirectory PortIndex_${platform}_${os_major}_${os_arch}/) and attempt to download a pre\-generated PortIndex (including the PortIndex\&.quick fi [...]
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBExample\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> rsync://rsync\&.macports\&.org/macports/release/tarballs/ports\&.tar
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBDefault\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> rsync://rsync\&.macports\&.org/macports/release/tarballs/ports\&.tar [default]
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fIfile://\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> Followed by an absolute path (which will result in
\fBthree\fR
slashes at the beginning of the URI) to a local directory that should be used as port tree\&. A port index will automatically be generated for this source\&. Note that MacPorts will try to determine whether the given path is under source control and attempt to update from the default remote server if it is\&. Currently, Subversion and Git (including git\-svn) are supported options\&. You can add the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -65,36 +92,61 @@ tag to avoid this behavior\&.
</span>
NOTE: The MacPorts user (usually called
\fImacports\fR) needs to be able to read and write to this location\&. This usually means your home directory is not a suitable place for a port tree, unless you adjust permissions accordingly\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fBExample\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> \m[blue]\fBfile:///opt/dports\fR\m[]
[nosync,default]
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fBDefault\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> none
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fIhttp://\fR, \fIhttps://\fR and \fIftp://\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> Followed by a server name and a path on this server, this URI instructs MacPorts to download a tarball snapshot of a ports tree from the URI and extract it to a path of its choice\&. This possibility is provided as a fallback to users that can use neither rsync nor subversion to sync the MacPorts port tree\&.
If the tarball contains a pre\-built PortIndex and PortIndex\&.quick file at PortIndex_${platform}_${os_major}_${os_arch}/, those will be used as default\&. If it does not, MacPorts will build a suitable port index for the local system automatically\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SOURCE FORMATS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Port definition trees can be either directories (e\&.g\&. for the \fIfile://\fR and rsync methods) or tarballs (for HTTP, HTTPS, FTP and rsync)\&. For the directory format, no additional verification is performed\&. Because transfers using rsync are not encrypted or authenticated, the use of this setup over rsync is discouraged\&.
.sp
If the URI ends with \fI\&.tar\fR, MacPorts assumes the source is a tarball and attempts to download an additional \fI\&.tar\&.rmd160\fR signature file\&. It then uses the public keys configured in \fBpubkeys.conf\fR(5) to verify this signature to ensure the source has not been tampered with\&. You are strongly encouraged to use this setup, and it has been the default for MacPorts since it has been introduced\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "FLAGS"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
Source specifications support a number of flags that modify the behavior of a source:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .PP
\fInosync\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> Skip this source when
\fBport sync\fR
or
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -102,21 +154,33 @@ or
</span> are used\&. You can use this flag to avoid updating your local ports tree managed by a source control system such as Git or Subversion\&. You are responsible for generating a current port index using the
\fBportindex\fR(1)
command for sources marked with this flag\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
.PP
\fIdefault\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> Mark this source as the default\&. The default source is used as a fallback to load additional files (such as PortGroups and mirror definitions) from the
\fI_resources/port1\&.0\fR
directory\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .RE
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "FILES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The path of the \fIsources\&.conf\fR file is specified in the \fBsources_conf\fR option of \fBmacports.conf\fR(5)\&. It defaults to \fI${prefix}/etc/macports/sources\&.conf\fR\&. There is no user\-specific \fIsources\&.conf\fR file, but support for this can be emulated by setting \fIsources\&.conf\fR in the user\-specific \fBmacports.conf\fR(5) file\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-selfupdate\fR(1), \fBport-sync\fR(1), \fBportindex\fR(1), \fBmacports.conf\fR(5)
<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;'>@@ -128,3 +192,6 @@ Clemens Lang <cal@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><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/variants.conf.5 b/doc/variants.conf.5
</span><span style='display:block; white-space:pre;color:#808080;'>index 96ce5b5..220cf7f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/variants.conf.5
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/variants.conf.5
</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 "VARIANTS\&.CONF" "5" "2016\-11\-06" "MacPorts 2\&.4\&.2" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "VARIANTS\&.CONF" "5" "2016\-11\-06" "MacPorts 2\&.4\&.3" "MacPorts Manual"
</span> .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,15 +19,19 @@
</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"
variants.conf \- Global variant configuration file of the MacPorts system
.SH "DESCRIPTION"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBvariants\&.conf\fR is the configuration file used to globally select or deselect certain variants on all ports installed by MacPorts\&. Changes in this file will affect all ports that are installed after the file was changed\&.
.sp
For a description of what variants are and how they work, see \fBport-variants\fR(1)\&.
.sp
\fBvariants\&.conf\fR is read by the \fBport\fR command\&. In the file, lines beginning with \fI#\fR are comments, empty lines are ignored\&. Each line in the file is a space\- or tab\-delimited list of zero or more variants, where each variant is either explicitly enabled or disabled using a leading \fI+\fR or \fI\-\fR\&. In EBNF:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -42,12 +46,17 @@ variant = ( \*(Aq+\*(Aq | \*(Aq\-\*(Aq ), name ;
</span> .\}
.sp
where \fIname\fR is the name of the variant\&. Variants that are not provided by a port (or no port at all) are silently ignored\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "FILES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
The path of the \fIvariants\&.conf\fR file is specified in the \fBvariants_conf\fR option of \fBmacports.conf\fR(5)\&. It defaults to \fI${prefix}/etc/macports/variants\&.conf\fR\&. There is no user\-specific \fIvariants\&.conf\fR file, but support for this can be emulated by setting \fIvariants\&.conf\fR in the user\-specific \fBmacports.conf\fR(5) file\&.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .SH "EXAMPLES"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
To prefer the \fI+quartz\fR variant over \fI+x11\fR, you can add the following line to your variants\&.conf:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -62,6 +71,7 @@ To prefer the \fI+quartz\fR variant over \fI+x11\fR, you can add the following l
</span> This will disable all x11 variants and enable the quartz variant, when it exists\&.
.sp
Similarly, if you want all your ports to support multiple architectures, you can enable the universal variant by default:
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
.if n \{\
.RS 4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -72,10 +82,16 @@ Similarly, if you want all your ports to support multiple architectures, you can
</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 "SEE ALSO"
<span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> .sp
\fBport\fR(1), \fBport-variants\fR(1)
<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;'>@@ -87,3 +103,6 @@ Clemens Lang <cal@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>