[49345] branches/new-help-system/base/doc

[raimue at macports.org]

Revision: 49345
          http://trac.macports.org/changeset/49345
Author:   raimue at macports.org
Date:     2009-04-07 20:58:44 -0700 (Tue, 07 Apr 2009)
Log Message:
-----------
doc:
Converted port.1 to asciidoc syntax in port.1.txt. Has some rough edges, but
contains everything from the old man page.

Modified Paths:
--------------
    branches/new-help-system/base/doc/port.1

Added Paths:
-----------
    branches/new-help-system/base/doc/port.1.txt

Modified: branches/new-help-system/base/doc/port.1
===================================================================
--- branches/new-help-system/base/doc/port.1	2009-04-08 03:55:51 UTC (rev 49344)
+++ branches/new-help-system/base/doc/port.1	2009-04-08 03:58:44 UTC (rev 49345)
@@ -1,638 +1,1520 @@
-.\" port.1
+.\"     Title: port
+.\"    Author: [see the "AUTHORS" section]
+.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
+.\"      Date: 04/08/2009
+.\"    Manual: MacPorts Manual
+.\"    Source: MacPorts 1.8.0
+.\"  Language: English
 .\"
-.\" Copyright (c) 2002 Apple Computer, Inc.
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in the
-.\"    documentation and/or other materials provided with the distribution.
-.\" 3. Neither the name of Apple Computer, Inc. nor the names of its
-.\"    contributors may be used to endorse or promote products derived from
-.\"    this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd April 29, 2007
-.Dt PORT 1 "MacPorts"
-.Os
-.Sh NAME
-.Nm port
-.Nd operate on individual or multiple Mac
-.Ar ports
-.Sh SYNOPSIS
-.Nm
-.Op Fl vdqfonRusbckixpyt
-.Op Fl D Ar portdir
-.Op Fl F Ar cmdfile
-.Op Ar action
-.Op Ar actionflags
-.Op Oo Ar portname | pseudo-portname | port-url Oc
-.Op Oo Ar @version Oc Oo +/-variant ... Oc ... Oo option=value ... Oc
-.Sh DESCRIPTION
-.Nm
-is designed to operate on individual or multiple Mac
-.Ar ports ,
-optionally within a single call, based on the requested
-.Ar action .
-If no
-.Ar portdir
-or
-.Ar portname
-is specified, the current working directory is assumed; if no
-.Ar action
-is specified the port command enters interactive mode, in which commands are read via stdin. Batch commands may be
-passed via a
-.Ar cmdfile .
-Port 
-.Ar options 
-are passed as key=value pairs and take precedence over individual
-.Ar portname
-options as specified in its Portfile and system-wide settings.
-.Pp
-Port
-.Ar variants
-can specified as
-.Ar +name ,
-which indicates the variant is desired, or
-.Ar -name ,
-indicating the contrary. In case of ambiguities, a port can be fully specified with the
-.Ar @version_revision+variants
-format.
-.Pp
-Installed ports can be activated or deactivated without being uninstalled. A port can be installed if all other
-version/variant(s) combinations installed at any given moment are deactivated.
-.Pp
-The
-.Nm
-command knows various
-.Ar pseudo-portnames
-that will expand to the specified set of ports from the available ports tree(s). These may be used in place of a
-.Ar portname .
-Common options are:
-.Pp
-.Bl -bullet -offset indent -compact
-.It
-.Ar all :
-all the ports in each ports tree listed in
-.Ar sources.conf
-.Pp
-.It
-.Ar current :
-the port in the current working directory.
-.Pp
-.It
-.Ar active :
-set of installed and active ports.
-.Pp
-.It
-.Ar inactive :
-set of installed but inactive ports.
-.Pp
-.It
-.Ar installed :
-set of all installed ports.
-.Pp
-.It
-.Ar uninstalled :
-ports in the ports tree(s) that aren't installed.
-.Pp
-.It
-.Ar outdated :
-installed ports that are out of date with respect to their current version/revision in the ports tree(s)
-.Pp
-.It
-.Ar obsolete :
-set of ports that are installed but no longer exist in any port tree
-.Pp
-.El
-Other options, also known as
-.Ar pseudo-portname selectors ,
-matching the most common keys used in a
-.Ar Portfile
-are also accepted, in both singular and plural form where applicable. These are:
-.Pp
-.Bl -bullet -offset indent -compact
-.It
-.Ar name
-.It
-.Ar version
-.It
-.Ar revision
-.It
-.Ar epoch
-.It
-.Ar variant
-.It
-.Ar variants
-.It
-.Ar category
-.It
-.Ar categories
-.It
-.Ar maintainer
-.It
-.Ar maintainers
-.It
-.Ar platform
-.It
-.Ar platforms
-.It
-.Ar description
-.It
-.Ar long_description
-.It
-.Ar homepage
-.It
-.Ar portdir
-.El
-.Pp
-Search strings that will expand to a set of matching ports can be constructed based on the 
-.Ar \(rqpseudo-portname selector\(lq:regex
-combination used.
-.Ar portnames
-containing valid UNIX glob patterns will also expand to the set of matching ports. Any
-.Ar action
-passed to
-.Nm
-will be invoked on each of them. For example:
-.Pp
-.Dl port list variant:no_ssl
-.Dl port uninstall name:sql
-.\" COMMENT: glob pattern expansion in portnames:
-.\" write an example here that illustrats better glob pattern expansion in portnames, but that does not employ
-.\" logical operators (and, or, not, !) because I still haven't gotten to them yet.
-.Dl port echo apache*
-.Pp
-Logical operators "and", "or", "not", "!", "(" and ")" may be used to combine individual
-.Ar portnames ,
-port glob patterns and/or
-.Ar pseudo-portnames
-to construct complex port expressions that expand to the set of matching ports. For example:
-.Pp
-.Dl port upgrade installed and "apache*"
-.Dl port echo maintainer:jberry and uninstalled and \e(\ category:java and not commons*\ \e)
-.\" COMMENT: more complex exmaples here would be useful.
-.\" PENDING: port-url explanation. Proposed text:
-.\".Pp
-.\"A
-.\".Ar portname
-.\"may also be specified as a URL pointing to the location of the
-.\".Ar portdir
-.\" ...
-.Pp
-The
-.Nm
-command also recognizes several command line flags and
-.Ar targets :
-.Sh OPTIONS
-.Bl -tag -width -indent
-.It Fl v
-verbose mode (generate verbose messages)
-.It Fl d
-debug mode (generate debugging messages, implies
-.Fl v )
-.It Fl q
-quiet mode (suppress messages)
-.It Fl n
-don't follow dependencies in upgrade (only for upgrading)
-.It Fl R
-also upgrade dependents (only for upgrading)
-.It Fl u
-uninstall non-active ports when upgrading and uninstalling
-.It Fl f
-force mode (ignore state file)
-.It Fl o
-honor state files older than Portfile
-.It Fl s
-source-only mode (build and install from source, ignore all binary archives, do not create/recreate binary archives) (only applies when archive mode is enabled)
-.It Fl b
-binary-only mode (build and install from binary archives, ignore source, abort if no archive present; do not create/recreate binary archives from source) (only applies when archive mode is enabled)
-.It Fl c
-autoclean mode (execute clean after install)
-.It Fl k
-keep mode (don't autoclean after install)
-.It Fl D
-specify
-.Ar portdir
-.It Fl F
+.TH "PORT" "1" "04/08/2009" "MacPorts 1\&.8\&.0" "MacPorts Manual"
+.\" -----------------------------------------------------------------
+.\" * (re)Define some macros
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" toupper - uppercase a string (locale-aware)
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de toupper
+.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
+\\$*
+.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH-xref - format a cross-reference to an SH section
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de SH-xref
+.ie n \{\
+.\}
+.toupper \\$*
+.el \{\
+\\$*
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH - level-one heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SH
+.\" put an extra blank line of space above the head in non-TTY output
+.if t \{\
+.sp 1
+.\}
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[an-margin]u
+.ti 0
+.HTML-TAG ".NH \\n[an-level]"
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+\." make the size of the head bigger
+.ps +3
+.ft B
+.ne (2v + 1u)
+.ie n \{\
+.\" if n (TTY output), use uppercase
+.toupper \\$*
+.\}
+.el \{\
+.nr an-break-flag 0
+.\" if not n (not TTY), use normal case (not uppercase)
+\\$1
+.in \\n[an-margin]u
+.ti 0
+.\" if not n (not TTY), put a border/line under subheading
+.sp -.6
+\l'\n(.lu'
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SS - level-two heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SS
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[IN]u
+.ti \\n[SN]u
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.ps \\n[PS-SS]u
+\." make the size of the head bigger
+.ps +2
+.ft B
+.ne (2v + 1u)
+.if \\n[.$] \&\\$*
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BB/BE - put background/screen (filled box) around block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BB
+.if t \{\
+.sp -.5
+.br
+.in +2n
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EB
+.if t \{\
+.if "\\$2"adjust-for-leading-newline" \{\
+.sp -1
+.\}
+.br
+.di
+.in
+.ll
+.gcolor
+.nr BW \\n(.lu-\\n(.i
+.nr BH \\n(dn+.5v
+.ne \\n(BHu+.5v
+.ie "\\$2"adjust-for-leading-newline" \{\
+\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.el \{\
+\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.in 0
+.sp -.5v
+.nf
+.BX
+.in
+.sp .5v
+.fi
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BM/EM - put colored marker in margin next to block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BM
+.if t \{\
+.br
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EM
+.if t \{\
+.br
+.di
+.ll
+.gcolor
+.nr BH \\n(dn
+.ne \\n(BHu
+\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
+.in 0
+.nf
+.BX
+.in
+.fi
+.\}
+..
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "Name"
+port \- operate on individual or multiple Mac \'ports\'
+.SH "Synopsis"
+.sp
+.fam C
+.ps -1
+.nf
+\fBport\fR [\fB\-vdqfonRusbckixpt\fR] [\fB\-D\fR \fIportdir\fR] [\fB\-F\fR \fIcmdfile\fR] [\fIaction\fR] [\fIactionflags\fR]
+     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-url\fR]]
+     [[\fI at version\fR] [+/\-variant \&...] \&... [option=value \&...]]
+.fi
+.fam
+.ps +1
+.SH "DESCRIPTION"
+.sp
+port is designed to operate on individual or multiple Mac \fIports\fR, optionally within a single call, based on the requested \fIaction\fR\&. If no \fIportdir\fR or \fIportname\fR is specified, the current working directory is assumed; if no \fIaction\fR is specified the port command enters interactive mode, in which commands are read via stdin\&. Batch commands may be passed via a \fIcmdfile\fR\&. Port \fIoptions\fR are passed as key=value pairs and take precedence over individual \fIportname\fR options as specified in its Portfile and system\-wide settings\&.
+.sp
+Port \fIvariants\fR can specified as \fI+name\fR, which indicates the variant is desired, or \fI\-name\fR, indicating the contrary\&. In case of ambiguities, a port can be fully specified with the \fI at version_revision+variants\fR format\&.
+.sp
+Installed ports can be activated or deactivated without being uninstalled\&. A port can be installed if all other version/variant(s) combinations installed at any given moment are deactivated\&.
+.sp
+The \fBport\fR command knows various \fIpseudo\-portnames\fR that will expand to the specified set of ports from the available port tree(s)\&. These may be used in place of a \fIportname\fR\&.
+.PP
+\fBCommon options are:\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIall\fR: all the ports in each ports tree listed in
+\fIsources\&.conf\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIcurrent\fR: the port in the current working directory
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIactive\fR: set of installed and active ports
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIinactive\fR: set of installed but inactive ports
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIinstalled\fR: set of all installed ports
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIuninstalled\fR: ports in the ports tree(s) that are not installed
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIoutdated\fR: installed ports that are out of date with respect to their current version/revision in the ports tree(s)
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIobsolete\fR: set of ports that are installed but no longer exist in any port tree
+.RE
+.sp
+Other options, also known as \fIpseudo\-portname\fR \fIselectors\fR, matching the most common keys used in a \fIPortfile\fR are also accepted, in both singular and plural form where applicable\&. These are:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIname\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIversion\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIrevision\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIepoch\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIvariant\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIvariants\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIcategory\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIcategories\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fImaintainer\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fImaintainers\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIplatform\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIplatforms\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIdescription\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIlong_description\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIhomepage\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fIportdir\fR
+.RE
+.sp
+Search strings that will expand to a set of matching ports can be constructed based on the "\fIpseudo\-portname\fR selector":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\&. For example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+port list variant:no_ssl
+port uninstall name:sql
+port echo apache*
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+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 port expressions that expand to the set of matching ports\&. For example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+port upgrade installed and apache*
+port echo maintainer:jberry and uninstalled and \e( category:java and not commons* \e)
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.SH "OPTIONS"
+.sp
+The port command also recognizes several command line flags and targets:
+.PP
+\-v
+.RS 4
+Verbose mode, generates verbose messages
+.RE
+.PP
+\-d
+.RS 4
+Debug mode, generate debugging messages, implies \-v
+.RE
+.PP
+\-q
+.RS 4
+Quiet mode, suppress informational messages to a minimum
+.RE
+.PP
+\-n
+.RS 4
+Don\(cqt follow dependencies in upgrade (only for
+\fIupgrade\fR)
+.RE
+.PP
+\-R
+.RS 4
+Also upgrade dependents (only for
+\fIupgrade\fR)
+.RE
+.PP
+\-u
+.RS 4
+Uninstall inactive ports when upgrading and uninstalling
+.RE
+.PP
+\-f
+.RS 4
+Force mode, ignore state file
+.RE
+.PP
+\-o
+.RS 4
+Honor state files older than Portfile
+.RE
+.PP
+\-s
+.RS 4
+Source\-only mode, build and install from source, ignore any existing binary archives; do not create/recreate binary archives\&. (Applies only when
+\fIarchive mode\fR
+is enabled)
+.RE
+.PP
+\-b
+.RS 4
+Binary\-only mode, build and install from binary archives, ignore source, abort if no archive present; do not create/recreate binary archives from source\&. (Applies only when
+\fIarchive mode\fR
+is enabled)
+.RE
+.PP
+\-c
+.RS 4
+Autoclean mode, execute clean after
+\fIinstall\fR
+.RE
+.PP
+\-k
+.RS 4
+Keep mode, do not autoclean after
+\fIinstall\fR
+.RE
+.PP
+\-D
+.RS 4
+Specfiy
+\fIportdir\fR
+.RE
+.PP
+\-F
+.RS 4
 Read and process the
-.Ar file
-of commands specified by the argument. If the argument is '-', then read commands from stdin. If the option is given multiple times, then multiple files will be read.
-.It Fl x
-In batch and interactive mode, exit on the first error encountered. Otherwise, errors during batch execution are simply reported.
-.It Fl p
-Despite any errors encountered, proceed to process multiple ports and commands.
-.It Fl y
-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).
-.It Fl t
-enable trace mode debug facilities on platforms that support it (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}).
-.El
-.Sh USER TARGETS
+\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\&.
+.RE
+.PP
+\-x
+.RS 4
+In batch and interactive mode, exit on the first error encountered\&. Otherwise, errors during batch execution are simply reported\&.
+.RE
+.PP
+\-p
+.RS 4
+Despite any errors encountered, proceed to process multiple ports and commands\&.
+.RE
+.PP
+\-y
+.RS 4
+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)\&.
+.RE
+.PP
+\-t
+.RS 4
+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
+.RE
+.SH "USER TARGETS"
+.sp
 Targets most commonly used by regular MacPorts users are:
-.Ss search
-Search for an available port whose name matches a regular expression. For example:
-.Pp
-.Dl "port search vim"
-.Pp
-.Ss info
-Displays meta-information available for
-.Ar portname .
-Specific meta-information may be requested through an option such as
-.Fl -maintainer
+.PP
+search
+.RS 4
+Search for an available port whose name matches a regular expression\&. For example:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port search vim
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+info
+.RS 4
+Displays meta\-information available for
+\fIportname\fR\&. Specific meta\-information may be requested through an option such as
+\fB\-\-maintainer\fR
 or
-.Fl -category
-(recognized field names are those from the PortIndex, see "port help
-info" for a complete list). If no specific fields are specified, a
-useful default collection of fields will be displayed. If the global option
-.Fl q
-is in effect, the meta-info fields will not be labeled.
-If the option
-.Fl -line
-is provided, all such data will be consolidated into a single line per port,
-suitable for processing in a pipe of commands.
-If the option
-.Fl -pretty
-is provided, the information will be formatted in a somewhat more
-attractive fashion for human readers. This is the default when no
-options at all are specified to info.
-If the option
-.Fl -index
-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).
-.Pp
+\fB\-\-category\fR\&. Recognized field names are those from the PortIndex, see \(lqport help info\(rq for a complete list\&. If no specific fields are specified, a useful default collection of fields will be displayed\&. If the global option
+\fB\-q\fR
+is in effect, the meta\-info fields will not be labeled\&. If the option
+\fB\-\-line\fR
+is provided, all such data will be consolidated into a single line per port, suitable for processing in a pipe of commands\&. If the option
+\fB\-\-pretty\fR
+is provided, the information will be formatted in a somewhat more attractive fashion for human readers\&. This is the default when no options at all are specified to info\&. If the option
+\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\&.
+
 For example:
-.br
-.Dl "port info vim +ruby"
-.Dl "port info --category --name apache*"
-.Dl "port -q info --category --name --version category:java"
-.Dl "port info --line --category --name all"
-.Dl "port info --pretty --fullname --depends gtk2"
-.Dl "port info --index python24"
-.Ss variants
-Lists the build variants available for
-.Ar portname .
-.Ss deps
-Lists the other ports that are required to build and run
-.Ar portname .
-This is simply an alias for "info --pretty --fullname --depends".
-.Ss dependents
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port info vim +ruby
+    port info \-\-category \-\-name apache*
+    port \-q info \-\-category \-\-name \-\-version category:java
+    port info \-\-line \-\-category \-\-name all
+    port info \-\-pretty \-\-fullname \-\-depends gtk2
+    port info \-\-index python24
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+variants
+.RS 4
+Lists the variants available for
+\fIportname\fR\&.
+.RE
+.PP
+deps
+.RS 4
+Lists the other ports that are required to build and run portname\&. This is simply an alias for \(lqinfo \-\-pretty \-\-fullname \-\-depends\(rq\&.
+.RE
+.PP
+dependents
+.RS 4
 Lists the installed ports that depend on the port
-.Ar portname .
-.Ss install
+\fIportname\fR\&.
+.RE
+.PP
+install
+.RS 4
 Install and activate
-.Ar portname .
-.Ss uninstall
-Deactivate and uninstall
-.Ar portname .
-To uninstall all installed but inactive ports, use
-.Fl u .
-To recursively uninstall all dependents of this port, use
-.Fl -follow-dependents .
-.Pp
+\fIportname\fR\&.
+.RE
+.PP
+uninstall
+.RS 4
+Deactivate and uninstall portname\&. To uninstall all installed but
+\fIinactive\fR
+ports, use
+\fB\-u\fR\&. To recursively uninstall all dependents of this port, use
+\fB\-\-follow\-dependents\fR\&.
+
 For example:
-.Pp
-.Dl "port uninstall vim"
-.Dl "port -u uninstall"
-.Dl "port uninstall --follow-dependents python24"
-.Ss activate
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port uninstall vim
+    port \-u uninstall
+    port uninstall \-\-follow\-dependents python24
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+activate
+.RS 4
 Activate the installed
-.Ar portname .
-.Ss deactivate
+\fIportname\fR\&.
+.RE
+.PP
+deactivate
+.RS 4
 Deactivate the installed
-.Ar portname .
-.Ss installed
-List all installed ports.
-.Ss location
-Print the install location of a given port.
-.Ss contents
+\fIportname\fR\&.
+.RE
+.PP
+installed
+.RS 4
+Lists all installed ports\&. Outputs name, composite version and activation status for each passed
+\fIportname\fR\&. If no arguments are given, all installed ports are displayed\&.
+.RE
+.PP
+location
+.RS 4
+Print the install location of a given port\&.
+.RE
+.PP
+contents
+.RS 4
 Lists the files installed by
-.Ar portname .
-.Ss provides
-Determines which port owns a given file and can take either a relative or absolute path. For example:
-.Pp
-.Dl "port provides /opt/local/etc/irssi.conf"
-.Dl "port provides include/tiff.h"
-.Ss sync
-Performs a sync operation only on the ports tree of a MacPorts installation, pulling in the latest
-revision available of the
-.Ar Portfiles
-from the MacPorts rsync server. To update you would normally do:
-.Pp
-.Dl "sudo port -d sync"
-.Pp
-If any of the ports tree(s) uses a file: URL that points to a local subversion working copy,
-.Ic sync
-will perform an
-.Ic "svn update"
-on the working copy with the user set to the owner of the working copy.
-.Ss outdated
-List the installed ports that need upgrading.
-.Ss upgrade
-The upgrade target works on a port and its dependencies. If you
-want to change this behaviour, look at the switches for n (no
-dependencies) and R (dependents) below.
-.Pp    
+\fIportname\fR\&.
+.RE
+.PP
+provides
+.RS 4
+Determines which port owns a given file and can take either a relative or absolute path\&. For example:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port provides /opt/local/etc/irssi\&.conf
+    port provides include/tiff\&.h
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+sync
+.RS 4
+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\&. To update you would normally do:
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+sudo port \-d sync
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+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\&.
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.RE
+.PP
+outdated
+.RS 4
+Lists the installed ports which need a
+\fIupgrade\fR\&.
+.RE
+.PP
+upgrade
+.RS 4
+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\&.
+
 Upgrade the installed
-.Ar portname .
+\fIportname\fR\&. For example:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port upgrade vim
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+To upgrade all outdated ports:
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port upgrade outdated
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+To upgrade \'portname\' and the ports that depend on it:
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port \-R upgrade libiconv
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+To force a rebuild use:
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port \-fn upgrade vim
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+To upgrade \'portname\' without following its dependencies before, use *\-n*\&.
 For example:
-.Pp
-.Dl "port upgrade vim"
-.Pp
-To upgrade all installed ports:
-.Pp
-.Dl "port upgrade installed"
-.Pp
-To upgrade
-.Ar portname
-and the ports that depend on it:
-.Pp
-.Dl "port -R upgrade libiconv"
-.Pp
-To force an upgrade (rebuild) use:
-.Pp
-.Dl "port -f upgrade vim"
-.Pp
-To upgrade
-.Ar portname
-without following its dependencies, use
-.Fl n .
-For example:
-.Pp
-.Dl "port -n upgrade wireshark"
-.Pp  
-Note that in selecting the variants to use in the upgraded build of the 
-port, any variants specified on the command line take highest precedence, 
-then the variants active in the latest installed version of the port, and 
-finally the global variants specified in variants.conf, if any.  Note that 
-upgrade will not normally rebuild a port only to change the selected 
-variants; you can either specify -f, or deactivate the port and reinstall it 
-with different variants. 
-.Ss clean
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port \-n upgrade wireshark
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+Note that in selecting the variants to use in the upgraded build of the
+port, any variants specified on the command line take highest precedence,
+then the variants active in the latest installed version of the port, and
+finally the global variants specified in variants\&.conf, if any\&.  Note that
+upgrade will not normally rebuild a port only to change the selected
+variants; you can either specify *\-f*, or deactivate the port and reinstall
+it with different variants\&.
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+clean
+.RS 4
 Clean the files used for building
-.Ar portname .
-To just remove the work files, use the
-.Fl -work
-.Ar actionflag .
-This is the default when no flag is given.
-To remove the distribution files (tarballs, etc), specify
-.Fl -dist .
-To remove the archive(s) for the current version of a port, pass
-.Fl -archive .
-To remove the work files, distribution files and archives, pass
-.Fl -all .
-For example:
-.Pp
-.Dl "port clean --dist vim"
-.Dl "port clean --archive vim"
-.Pp
-To remove only certain version(s) of a port's archives (
-.Ar version
-is any valid UNIX glob pattern), you can use:
-.Pp
-.Dl "port clean --archive vim 6.2.114"
-.Pp
+\fIportname\fR\&. To just remove the work files, use the
+\fB\-\-work\fR
+\fIactionflag\fR\&. This is the default when no flag is given\&. To remove the distribution files (fetched tarballs, patches, etc), specify
+\fB\-\-dist\fR\&. To remove the archive(s) for the current version of a port, pass
+\fB\-\-archive\fR\&. To remove the work files, distribution files and archives, pass
+\fB\-\-all\fR\&. For example:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port clean \-\-dist vim
+    port clean \-\-archive vim
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+To remove only certain version(s) of a port\'s archives (version is any
+valid UNIX glob pattern), you can use:
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port clean \-\-archive vim 6\&.2\&.114
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
 or:
-.Pp
-.Dl "port clean --archive vim '6.*'"
-.Ss echo
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port clean \-\-archive vim \'6\&.*\'
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+echo
+.RS 4
 Writes to stdout the arguments passed to
-.Nm .
-This follows the expansion of
-.Ar pseudo-portnames ,
-portname glob patterns,
-.Ar pseudo-portname selectors
-and the evaluation of port expressions.
-.Nm echo 
-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. For example:
-.Pp
-.Dl port echo category:net
-.Dl port echo maintainer:jmpp and name:netw
-.Dl port echo maintainer:jmpp and \e(\ net* or category:text\ \e)
-.Pp
-.Ss list
-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.
-.Ss mirror
-Create/update a local mirror of distfiles used for ports given on the command line.  The filemap database can be reset by using the
-.Fl -new
-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
-.Ar pseudo-portnames ,
-eg,
-.Ar all ,
-to mirror everything.  Note that if you use
-.Ar all ,
-you'll most likely want to use
-.Fl p
+\fIport\fR\&. This follows the expansion of
+\fIpseudo\-portnames\fR, portname glob patterns,
+\fIpseudo\-portname selectors\fR
+and the evaluation of port expressions\&.
+\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\&. For example:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port echo category:net
+    port echo maintainer:jmpp and name:netw
+    port echo maintainer:jmpp and \e( net* or category:text \e)
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+list
+.RS 4
+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\&.
+.RE
+.PP
+mirror
+.RS 4
+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
+\fIpseudo\-portnames\fR, e\&.g\&.
+\fIall\fR, to mirror everything\&. Note that if you use
+\fIall\fR, you\(cqll most likely want to use
+\fB\-p\fR
 so
-.Nm
-doesn't quit on the first download failure.
-.Ss version
-Display the release number of the installed MacPorts infrastructure.
-.Ss platform
-Display the platform information for the current system.
-.Ss selfupdate
-Updates the MacPorts system, ports tree(s) and base tools if needed, from the MacPorts rsync server,
-installing the newest infrastructure available. To update you would typically do:
-.Pp
-.Dl "sudo port -d selfupdate"
-.Pp
-See
-.Ic sync
-for more information about updating ports tree(s).
-.Ss load
-Provides a shortcut to using launchctl to load a port's daemon (as installed
-in /Library/LaunchDaemons).  It runs:
-.Pp
-.Dl launchctl load -w /Library/LaunchDaemons/org.macports.${port}.plist
-.Ss unload
-A shortcut to launchctl, like load, but unloads the daemon.
-.Ss platform
-Prints out the current platform information for the running system.
-.Ss gohome
-Loads the home page for the given 
-.Ar portname 
-in the default web browser.
-.Ss usage
-Displays a condensed usage summary.
-.Ss help
-Displays a summary of all available actions and port command syntax on stdout.
-.Sh DEVELOPER TARGETS
-The targets that are often used by Port developers are intended to provide access to the different phases of a Port's build process:
-.Ss dir
+\fBport\fR
+doesn\(cqt quit on the first download failure\&.
+.RE
+.PP
+version
+.RS 4
+Display the release number of the installed MacPorts infrastructure\&.
+.RE
+.PP
+platform
+.RS 4
+Display the platform information for the current system\&.
+.RE
+.PP
+selfupdate
+.RS 4
+Updates the MacPorts system, ports tree(s) and base tools if needed, from the MacPorts rsync server, installing the newest infrastructure available\&. To update you would typ\- ically do:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    sudo port \-d selfupdate
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+See \'sync\' for more information about updating ports tree(s)\&.
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+load
+.RS 4
+Provides a shortcut to using launchctl to load a port\(cqs daemon (as installed in /Library/LaunchDaemons)\&. It runs:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    launchctl load \-w /Library/LaunchDaemons/org\&.macports\&.${port}\&.plist
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+unload
+.RS 4
+A shortcut to launchctl, like load, but unloads the daemon\&.
+.RE
+.PP
+gohome
+.RS 4
+Loads the home page for the given portname in the default web browser\&.
+.RE
+.PP
+usage
+.RS 4
+Displays a condensed usage summary\&.
+.RE
+.PP
+help
+.RS 4
+Displays a summary of all available actions and port command syntax on stdout\&.
+.RE
+.SH "DEVELOPER TARGETS"
+.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:
+.PP
+dir
+.RS 4
 Displays the path to the directory containing
-.Ar portname .
-.Ss work
+\fIportname\fR\&.
+.RE
+.PP
+work
+.RS 4
 Displays the path to the work directory for
-.Ar portname .
-.Ss cd
-Changes the current working directory to the one containing
-.Ar portname .
-Only useful in interactive mode.
-.Ss file
+\fIportname\fR\&.
+.RE
+.PP
+cd
+.RS 4
+Changes the current working directory to the one containing portname\&. Only useful in interactive mode\&.
+.RE
+.PP
+file
+.RS 4
 Displays the path to the Portfile for
-.Ar portname .
-.Ss url
-Displays the URL for the path of the given
-.Ar portname ,
-which can be passed as port-url
-.Ss cat
+\fIportname\fR\&.
+.RE
+.PP
+url
+.RS 4
+Displays the URL for the path of the given portname, which can be passed as
+\fIport\-url\fR\&.\&.
+.RE
+.PP
+cat
+.RS 4
 Concatenates and prints the contents of
-.Ar Portfile
-on stdout.
-.Ss edit
-Opens
-.Ar Portfile 
-with your default editor specified in your shell's environment variable. Alias
-.Ar ed
-also invokes this command.
-.Pp
-You can also use the
-.Fl -editor
-flag on the command line to specify an alternative editor. For example:
-.Dl port edit --editor nano apache2
-.Pp
-.Ss ed
-An alias for
-.Ic edit .
-.Ss unarchive
-Unpack the port from a pre-built binary archive. When archive mode is enabled, this command is called automatically, prior to
-.Ar fetch ,
-to check for an existing binary archive to unpack. If found, it is unpacked and all stages up to
-.Ar install
-are then skipped.
-.Ss fetch
+\fIPortfile\fR
+on stdout\&.
+.RE
+.PP
+edit, ed
+.RS 4
+Opens Portfile with your default editor specified in your shell\(cqs environment variable\&. Alias
+\fIed\fR
+also invokes this command\&.
+
+You can also use the \-\-editor flag on the command line to specify an alternative edi\- tor\&. For example:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+    port edit \-\-editor nano apache2
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.PP
+unarchive
+.RS 4
+Unpack the port from a pre\-built binary archive\&. When archive mode is enabled, this command is called automatically, prior to
+\fIfetch\fR, to check for an existing binary archive to unpack\&. If found, it is unpacked and all stages up to
+\fIinstall\fR
+are then skipped\&.
+.RE
+.PP
+fetch
+.RS 4
 Fetches the distribution files required to build
-.Ar portname .
-.Ss checksum
-Compute the checksums of the distribution files for 
-.Ar portname ,
-and compare them to the checksums listed in 
-.Ar Portfile .
-.Ss extract
+\fIportname\fR\&.
+.RE
+.PP
+checksum
+.RS 4
+Compute the checksums of the distribution files for
+\fIportname\fR, and compare them to the checksums listed in
+\fIPortfile\fR\&.
+.RE
+.PP
+extract
+.RS 4
 Extracts the distribution files for
-.Ar portname .
-.Ss patch
-Applies any required patches to 
-.Ar portname's
-extracted distribution files.
-.Ss configure
+\fIportname\fR\&.
+.RE
+.PP
+patch
+.RS 4
+Applies any required patches to
+\fIportname\(cqs\fR
+extracted distribution files\&.
+.RE
+.PP
+configure
+.RS 4
 Runs any configure process for
-.Ar portname .
-.Ss build
+\fIportname\fR\&.
+.RE
+.PP
+build
+.RS 4
 Build
-.Ar portname .
-.Ss destroot
+\fIportname\fR\&.
+.RE
+.PP
+destroot
+.RS 4
 Installs
-.Ar portname
-to a temporary directory.
-.Ss test
+\fIportname\fR
+to a temporary directory\&.
+.RE
+.PP
+test
+.RS 4
 Tests
-.Ar portname .
-.Ss lint
-Verifies Portfile for
-.Ar portname .
-To nitpick about whitespace and patchfile names, use
-.Fl -nitpick .
-.Ss archive
-Archive the port for a later
-.Ar unarchive .
-When archive mode is enabled, binary archives will be created automatically whenever an
-.Ar install
-is performed, or when the
-.Ar archive
-target is called explicitly.
-.Ss distcheck
-Check if the distfiles haven't changed and can be fetched.
-.Ss distfiles
-Display each distfile, its checksums, and the URLs used to fetch it.
-.Ss livecheck
-Check if the software hasn't been updated since the Portfile was last modified.
-.Sh PACKAGING TARGETS
+\fIportname\fR\&.
+.RE
+.PP
+lint
+.RS 4
+Verifies Portfile for portname\&. To nitpick about whitespace and patchfile names, use
+\fB\-\-nitpick\fR\&.
+.RE
+.PP
+archive
+.RS 4
+Archive the port for a later unarchive\&. When archive mode is enabled, binary archives will be created automatically whenever an install is performed, or when the archive target is called explicitly\&.
+.RE
+.PP
+distcheck
+.RS 4
+Check if the distfiles haven\(cqt changed and can be fetched\&.
+.RE
+.PP
+distfiles
+.RS 4
+Display each distfile, its checksums, and the URLs used to fetch it\&.
+.RE
+.PP
+livecheck
+.RS 4
+Check if the software hasn\(cqt been updated since the Portfile was last modified\&.
+.RE
+.SH "PACKAGING TARGETS"
+.sp
 There are also targets for producing installable packages of ports:
-.Pp
-.Ss pkg
+.PP
+pkg
+.RS 4
 Creates an OS X installer package of
-.Ar portname.
-.Ss mpkg
-Creates an OS X installer metapackage of 
-.Ar portname
-and its dependencies.
-.Ss dmg
-Creates an internet-enabled disk image containing an OS X package of
-.Ar portname .
-.Ss mdmg
-Creates an internet-enabled disk image containing an OS X metapackage of
-.Ar portname
-and its dependencies.
-.Ss rpm
+\fIportname\fR\&.
+.RE
+.PP
+mpkg
+.RS 4
+Creates an OS X installer metapackage of
+\fIportname\fR
+and its dependencies\&.
+.RE
+.PP
+dmg
+.RS 4
+Creates an internet\-enabled disk image containing an OS X package of
+\fIportname\fR\&.
+.RE
+.PP
+mdmg
+.RS 4
+Creates an internet\-enabled disk image containing an OS X metapackage of
+\fIportname\fR
+and its dependencies\&.
+.RE
+.PP
+rpm
+.RS 4
 Creates an RPM binary package of
-.Ar portname ,
-similar to a tgz "archive".
-.Ss srpm
+\fIportname\fR, similar to a tgz \(lqarchive\(rq\&.
+.RE
+.PP
+srpm
+.RS 4
 Creates a SRPM source package of
-.Ar portname ,
-similar to a xar "portpkg".
-.Ss dpkg
+\fIportname\fR, similar to a xar \(lqportpkg\(rq\&.
+.RE
+.PP
+dpkg
+.RS 4
 Creates a DEB binary package of
-.Ar portname .
-.Sh EXAMPLES
-The following demonstrates invoking
-.Nm
-with the
-.Ar extract
-target on
-.Ar portdir
-\&"textproc/figlet" and extract.suffix set to ".tgz":
-.Pp
-.Dl "port extract -D textproc/figlet extract.suffix=.tgz"
-.Pp
-.Sh FILES
-.Bl -tag -width
-.It Va ${prefix}/etc/macports/macports.conf
-Global configuration file for the MacPorts system.
-.It Va ${prefix}/etc/macports/sources.conf
-Global listing of the ports trees used by MacPorts. This file also enables rsync synchronization.
-.It Va ${prefix}/etc/macports/variants.conf
-Global variants used when a port is installed.
-.It Va ~/.macports/macports.conf
-User configuration file for the MacPorts system. It overrides the global
-.Ar macports.conf
-file.
-.El
-.Sh DIAGNOSTICS
-.Ex -std
-.Sh SEE ALSO
-.Xr macports.conf 5 ,
-.Xr portfile 7 ,
-.Xr portgroup 7 ,
-.Xr portstyle 7 ,
-.Xr porthier 7
-.Sh AUTHORS
-.An "Landon Fuller" Aq landonf at macports.org
-.An "James Berry" Aq jberry at macports.org
-.An "Jordan K. Hubbard" Aq jkh at macports.org
-.An "Juan Manuel Palacios" Aq jmpp at macports.org
-.An "Kevin Van Vechten" Aq kevin at opendarwin.org
-.An "Ole Guldberg Jensen" Aq olegb at opendarwin.org
-.An "Robert Shaw" Aq rshaw at opendarwin.org
-.An "Chris Ridd" Aq cjr at opendarwin.org
-.An "Matt Anton" Aq matt at opendarwin.org
-.An "Joe Auty" Aq joe at opendarwin.org
+\fIportname\fR\&.
+.RE
+.SH "EXAMPLES"
+.sp
+The following demonstrates invoking port with the extract target on portdir \(lqtextproc/figlet\(rq and extract\&.suffix set to \(lq\&.tgz\(rq:
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+port extract \-D textproc/figlet extract\&.suffix=\&.tgz
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
+.SH "FILES"
+.PP
+.RS 4
+Global configuration file for the MacPorts system\&.
+.RE
+.PP
+.RS 4
+Global listing of the ports trees used by MacPorts\&. This file also enables rsync synchronization\&.
+.RE
+.PP
+.RS 4
+Global variants used when a port is installed\&.
+.RE
+.PP
+~/\&.macports/macports\&.conf
+.RS 4
+User configuration file for the MacPorts system\&. It overrides the global
+\fImacports\&.conf(5)\fR
+file\&.
+.RE
+.SH "DIAGNOSTICS"
+.sp
+The \fBport\fR utility exits 0 on success, and >0 if an error occurs\&.
+.SH "SEE ALSO"
+.sp
+macports\&.conf(5), portfile(7), portgroup(7), portstyle(7), porthier(7)
+.SH "COPYRIGHT"
+.sp
+\(co 2009 The MacPorts Project
+.SH "AUTHORS"
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
+.nf
+.BB lightgray
+Landon Fuller <landonf at macports\&.org>
+James Berry <jberry at macports\&.org>
+Jordan K\&. Hubbard <jkh at macports\&.org>
+Juan Manuel Palacios <jmpp at macports\&.org>
+Kevin Van Vechten <kevin at opendarwin\&.org>
+Ole Guldberg Jensen <olegb at opendarwin\&.org>
+Robert Shaw <rshaw at opendarwin\&.org>
+Chris Ridd <cjr at opendarwin\&.org>
+Matt Anton <matt at opendarwin\&.org>
+Joe Auty <joe at opendarwin\&.org>
+Rainer Mueller <raimue at macports\&.org>
+.EB lightgray
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}

Added: branches/new-help-system/base/doc/port.1.txt
===================================================================
--- branches/new-help-system/base/doc/port.1.txt	                        (rev 0)
+++ branches/new-help-system/base/doc/port.1.txt	2009-04-08 03:58:44 UTC (rev 49345)
@@ -0,0 +1,560 @@
+// $Id$
+// vim: set et sw=4 ts=8 syntax=asciidoc tw=80:
+port(1)
+=======
+
+NAME
+----
+port - operate on individual or multiple Mac 'ports'
+
+SYNOPSIS
+--------
+[verse]
+*port* [*-vdqfonRusbckixpt*] [*-D* 'portdir'] [*-F* 'cmdfile'] ['action'] ['actionflags']
+     [['portname' | 'pseudo-portname' | 'port-url']]
+     [['@version'] [+/-variant ...] ... [option=value ...]]
+
+DESCRIPTION
+-----------
+port is designed to operate on individual or multiple Mac 'ports', optionally
+within a single call, based on the requested 'action'.  If no 'portdir' or
+'portname' is specified, the current working directory is assumed; if no
+'action' is specified the port command enters interactive mode, in which
+commands are read via stdin. Batch commands may be passed via a 'cmdfile'.
+Port 'options' are passed as key=value pairs and take precedence over
+individual 'portname' options as specified in its Portfile and system-wide
+settings.
+
+Port 'variants' can specified as '+name', which indicates the variant is
+desired, or '-name', indicating the contrary. In case of ambiguities, a port
+can be fully specified with the '@version_revision+variants' format.
+
+Installed ports can be activated or deactivated without being uninstalled. A
+port can be installed if all other version/variant(s) combinations installed
+at any given moment are deactivated.
+
+The *port* command knows various 'pseudo-portnames' that will expand to the
+specified set of ports from the available port tree(s). These may be used in
+place of a 'portname'.
+
+.Common options are:
+
+    - 'all': all the ports in each ports tree listed in 'sources.conf'
+    - 'current': the port in the current working directory
+    - 'active': set of installed and active ports
+    - 'inactive': set of installed but inactive ports
+    - 'installed': set of all installed ports
+    - 'uninstalled': ports in the ports tree(s) that are not installed
+    - 'outdated': installed ports that are out of date with respect to their 
+      current version/revision in the ports tree(s)
+    - 'obsolete': set of ports that are installed but no longer exist in any
+      port tree
+
+Other options, also known as 'pseudo-portname' 'selectors', matching the most
+common keys used in a 'Portfile' are also accepted, in both singular and plural
+form where applicable. These are:
+
+    - 'name'
+    - 'version'
+    - 'revision'
+    - 'epoch'
+    - 'variant'
+    - 'variants'
+    - 'category'
+    - 'categories'
+    - 'maintainer'
+    - 'maintainers'
+    - 'platform'
+    - 'platforms'
+    - 'description'
+    - 'long_description'
+    - 'homepage'
+    - 'portdir'
+
+Search strings that will expand to a set of matching ports can be constructed
+based on the "'pseudo-portname' selector":regex combination used. 'portnames''
+containing valid UNIX glob patterns will also expand to the set of matching
+ports. Any action passed to port will be invoked on each of them. For example:
+--------
+port list variant:no_ssl
+port uninstall name:sql
+port echo apache*
+--------
+Logical operators "and", "or", "not", "!", "(" and ")" may be used to combine
+individual 'portnames', port glob patterns and/or 'pseudo-portnames' to
+construct complex port expressions that expand to the set of matching ports. For
+example:
+--------
+port upgrade installed and apache*
+port echo maintainer:jberry and uninstalled and \( category:java and not commons* \)
+--------
+
+OPTIONS
+-------
+
+The port command also recognizes several command line flags and targets:
+
+-v::
+    Verbose mode, generates verbose messages
+
+-d::
+    Debug mode, generate debugging messages, implies -v
+
+-q::
+    Quiet mode, suppress informational messages to a minimum
+
+-n::
+    Don't follow dependencies in upgrade (only for 'upgrade')
+
+-R::
+    Also upgrade dependents (only for 'upgrade')
+
+-u::
+    Uninstall inactive ports when upgrading and uninstalling
+
+-f::
+    Force mode, ignore state file
+
+-o::
+    Honor state files older than Portfile
+
+-s::
+    Source-only mode, build and install from source, ignore any existing binary
+    archives; do not create/recreate binary archives. (Applies only when
+    'archive mode' is enabled)
+
+-b::
+    Binary-only mode, build and install from binary archives, ignore source,
+    abort if no archive present; do not create/recreate binary archives from
+    source. (Applies only when 'archive mode' is enabled)
+
+-c::
+    Autoclean mode, execute clean after 'install'
+
+-k::
+    Keep mode, do not autoclean after 'install'
+
+-D::
+    Specfiy 'portdir'
+
+-F::
+    Read and process the 'file' of commands specified by the argument. If the
+    argument is '-', then read commands from stdin. If the option is given
+    multiple times, then multiple files will be read.
+
+-x::
+    In batch and interactive mode, exit on the first error encountered.
+    Otherwise, errors during batch execution are simply reported.
+
+-p::
+    Despite any errors encountered, proceed to process multiple ports and
+    commands.
+
+-y::
+    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).
+
+-t::
+    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
+    direc- tories (temporary directories and ${workpath}).
+
+USER TARGETS
+------------
+
+Targets most commonly used by regular MacPorts users are:
+
+search::
+    Search for an available port whose name matches a regular expression.
+    For example:
+--------
+    port search vim
+--------
+
+info::
+    Displays meta-information available for 'portname'.  Specific meta-information
+    may be requested through an option such as *--maintainer* or *--category*.
+    Recognized field names are those from the PortIndex, see ``port help info''
+    for a complete list. If no specific fields are specified, a useful
+    default collection of fields will be displayed. If the global option *-q*
+    is in effect, the meta-info fields will not be labeled.  If the option
+    *--line* is provided, all such data will be consolidated into a single
+    line per port, suitable for processing in a pipe of commands.  If the
+    option *--pretty* is provided, the information will be formatted in a
+    somewhat more attractive fashion for human readers. This is the default
+    when no options at all are specified to info. If the option *--index* 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. +
+    For example:
+--------
+    port info vim +ruby
+    port info --category --name apache*
+    port -q info --category --name --version category:java
+    port info --line --category --name all
+    port info --pretty --fullname --depends gtk2
+    port info --index python24
+--------
+
+variants::
+    Lists the variants available for 'portname'.
+
+deps::
+    Lists the other ports that are required to build and run portname. This is
+    simply an alias for ``info --pretty --fullname --depends''.
+
+dependents::
+    Lists the installed ports that depend on the port 'portname'.
+
+install::
+    Install and activate 'portname'.
+
+uninstall::
+    Deactivate and uninstall portname. To uninstall all installed but
+    'inactive' ports, use *-u*. To recursively uninstall all dependents of
+    this port, use *--follow-dependents*. +
+    For example:
+--------
+    port uninstall vim
+    port -u uninstall
+    port uninstall --follow-dependents python24
+--------
+
+activate::
+    Activate the installed 'portname'.
+
+deactivate::
+    Deactivate the installed 'portname'.
+
+installed::
+    Lists all installed ports. Outputs name, composite version and activation
+    status for each passed 'portname'. If no arguments are given, all installed
+    ports are displayed.
+
+location::
+    Print the install location of a given port.
+
+contents::
+    Lists the files installed by 'portname'.
+
+provides::
+    Determines which port owns a given file and can take either a relative or
+    absolute path. For example:
+--------
+    port provides /opt/local/etc/irssi.conf
+    port provides include/tiff.h
+--------
+
+sync::
+    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. To update you would normally do:
+    
+        sudo port -d sync
+    
+    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.
+
+outdated::
+    Lists the installed ports which need a 'upgrade'.
+
+upgrade::
+    The upgrade target works on a port and its dependencies. If you want to
+    change this behavior, look at the switches for *-n* (no dependencies) and
+    *-R* (dependents) above. +
+    Upgrade the installed 'portname'. For example:
+--------
+    port upgrade vim
+--------
+
+    To upgrade all outdated ports:
+--------
+    port upgrade outdated
+--------
+
+    To upgrade 'portname' and the ports that depend on it:
+--------
+    port -R upgrade libiconv
+--------
+
+    To force a rebuild use:
+--------
+    port -fn upgrade vim
+--------
+
+    To upgrade 'portname' without following its dependencies before, use *-n*.
+    For example:
+--------
+    port -n upgrade wireshark
+--------
+
+     Note that in selecting the variants to use in the upgraded build of the
+     port, any variants specified on the command line take highest precedence,
+     then the variants active in the latest installed version of the port, and
+     finally the global variants specified in variants.conf, if any.  Note that
+     upgrade will not normally rebuild a port only to change the selected
+     variants; you can either specify *-f*, or deactivate the port and reinstall
+     it with different variants.
+
+clean::
+    Clean the files used for building 'portname'. To just remove the work files,
+    use the *--work* 'actionflag'.  This is the default when no flag is given.
+    To remove the distribution files (fetched tarballs, patches, etc), specify
+    *--dist*. To remove the archive(s) for the current version of a port, pass
+    *--archive*. To remove the work files, distribution files and archives, pass
+    *--all*. For example:
+--------
+    port clean --dist vim
+    port clean --archive vim
+--------
+    To remove only certain version(s) of a port's archives (version is any
+    valid UNIX glob pattern), you can use:
+--------
+    port clean --archive vim 6.2.114
+--------
+
+    or:
+
+--------
+    port clean --archive vim '6.*'
+--------
+
+echo::
+    Writes to stdout the arguments passed to 'port'. This follows the expansion
+    of 'pseudo-portnames', portname glob patterns, 'pseudo-portname selectors'
+    and the evaluation of port expressions.  *echo* 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. For example:
+--------
+    port echo category:net
+    port echo maintainer:jmpp and name:netw
+    port echo maintainer:jmpp and \( net* or category:text \)
+--------
+
+list::
+    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.
+
+mirror::
+    Create/update a local mirror of distfiles used for ports given on the
+    command line. The filemap database can be reset by using the *--new* 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 'pseudo-portnames', e.g. 'all', to mirror
+    everything.  Note that if you use 'all', you'll most likely want to use *-p* so
+    *port* doesn't quit on the first download failure.
+
+version::
+    Display the release number of the installed MacPorts infrastructure.
+
+platform::
+    Display the platform information for the current system.
+
+selfupdate::
+    Updates the MacPorts system, ports tree(s) and base tools if needed, from
+    the MacPorts rsync server, installing the newest infrastructure available.
+    To update you would typ- ically do:
+--------
+    sudo port -d selfupdate
+--------
+    See 'sync' for more information about updating ports tree(s).
+
+load::
+    Provides a shortcut to using launchctl to load a port's daemon (as installed
+    in /Library/LaunchDaemons). It runs:
+--------
+    launchctl load -w /Library/LaunchDaemons/org.macports.${port}.plist
+--------
+
+unload::
+    A shortcut to launchctl, like load, but unloads the daemon.
+
+gohome::
+    Loads the home page for the given portname in the default web browser.
+
+usage::
+    Displays a condensed usage summary.
+
+help::
+    Displays a summary of all available actions and port command syntax on
+    stdout.
+
+DEVELOPER TARGETS
+-----------------
+
+The targets that are often used by Port developers are intended to provide
+access to the different phases of a Port's build process:
+
+dir::
+    Displays the path to the directory containing 'portname'.
+
+work::
+    Displays the path to the work directory for 'portname'.
+
+cd::
+    Changes the current working directory to the one containing portname. Only
+    useful in interactive mode.
+
+file::
+    Displays the path to the Portfile for 'portname'.
+
+url::
+    Displays the URL for the path of the given portname, which can be passed as
+    'port-url'..
+
+cat::
+    Concatenates and prints the contents of 'Portfile' on stdout.
+
+edit::
+ed::
+    Opens Portfile with your default editor specified in your shell's
+    environment variable. Alias 'ed' also invokes this command. +
+    You can also use the --editor flag on the command line to specify an alternative edi-
+    tor. For example:
+--------
+    port edit --editor nano apache2
+--------
+
+unarchive::
+    Unpack the port from a pre-built binary archive. When archive mode is
+    enabled, this command is called automatically, prior to 'fetch', to check for
+    an existing binary archive to unpack. If found, it is unpacked and all
+    stages up to 'install' are then skipped.
+
+fetch::
+    Fetches the distribution files required to build 'portname'.
+
+checksum::
+    Compute the checksums of the distribution files for 'portname', and compare
+    them to the checksums listed in 'Portfile'.
+
+extract::
+    Extracts the distribution files for 'portname'.
+
+patch::
+    Applies any required patches to 'portname's' extracted distribution files.
+
+configure::
+    Runs any configure process for 'portname'.
+
+build::
+    Build 'portname'.
+
+destroot::
+    Installs 'portname' to a temporary directory.
+
+test::
+    Tests 'portname'.
+
+lint::
+    Verifies Portfile for portname. To nitpick about whitespace and patchfile
+    names, use *--nitpick*.
+
+archive::
+    Archive the port for a later unarchive. When archive mode is enabled,
+    binary archives will be created automatically whenever an install is
+    performed, or when the archive target is called explicitly.
+
+distcheck::
+    Check if the distfiles haven't changed and can be fetched.
+
+distfiles::
+    Display each distfile, its checksums, and the URLs used to fetch it.
+
+livecheck::
+    Check if the software hasn't been updated since the Portfile was last
+    modified.
+
+
+PACKAGING TARGETS
+-----------------
+
+There are also targets for producing installable packages of ports:
+
+pkg::
+    Creates an OS X installer package of 'portname'.
+
+mpkg::
+    Creates an OS X installer metapackage of 'portname' and its dependencies.
+
+dmg::
+    Creates an internet-enabled disk image containing an OS X package of
+    'portname'.
+
+mdmg::
+    Creates an internet-enabled disk image containing an OS X metapackage of
+    'portname' and its dependencies.
+
+rpm::
+    Creates an RPM binary package of 'portname', similar to a tgz ``archive''.
+
+srpm::
+    Creates a SRPM source package of 'portname', similar to a xar ``portpkg''.
+
+dpkg::
+    Creates a DEB binary package of 'portname'.
+
+
+EXAMPLES
+--------
+The following demonstrates invoking port with the extract target on portdir
+``textproc/figlet'' and extract.suffix set to ``.tgz'':
+--------
+port extract -D textproc/figlet extract.suffix=.tgz
+--------
+
+FILES
+-----
+
+${prefix}/etc/macports/macports.conf::
+    Global configuration file for the MacPorts system.
+
+${prefix}/etc/macports/sources.conf::
+    Global listing of the ports trees used by MacPorts. This file also enables
+    rsync synchronization.
+
+${prefix}/etc/macports/variants.conf::
+    Global variants used when a port is installed.
+
+~/.macports/macports.conf::
+    User configuration file for the MacPorts system. It overrides the global
+    'macports.conf(5)' file.
+
+DIAGNOSTICS
+-----------
+The *port* utility exits 0 on success, and >0 if an error occurs.
+
+
+SEE ALSO
+--------
+macports.conf(5), portfile(7), portgroup(7), portstyle(7), porthier(7)
+
+
+COPYRIGHT
+---------
+(C) 2009 The MacPorts Project
+
+
+AUTHORS
+-------
+ Landon Fuller <landonf at macports.org>
+ James Berry <jberry at macports.org>
+ Jordan K. Hubbard <jkh at macports.org>
+ Juan Manuel Palacios <jmpp at macports.org>
+ Kevin Van Vechten <kevin at opendarwin.org>
+ Ole Guldberg Jensen <olegb at opendarwin.org>
+ Robert Shaw <rshaw at opendarwin.org>
+ Chris Ridd <cjr at opendarwin.org>
+ Matt Anton <matt at opendarwin.org>
+ Joe Auty <joe at opendarwin.org>
+ Rainer Mueller <raimue at macports.org>


Property changes on: branches/new-help-system/base/doc/port.1.txt
___________________________________________________________________
Added: svn:keywords
   + Id
Added: svn:eol-style
   + native
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20090407/177c658c/attachment-0001.html>