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

Mon Apr 5 06:33:18 PDT 2010

Revision: 66058
          http://trac.macports.org/changeset/66058
Author:   raimue at macports.org
Date:     2010-04-05 06:33:17 -0700 (Mon, 05 Apr 2010)
Log Message:
-----------
Regenerate man pages

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

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

--- branches/new-help-system/base/doc/port-activate.1	2010-04-05 13:33:04 UTC (rev 66057)
+++ branches/new-help-system/base/doc/port-activate.1	2010-04-05 13:33:17 UTC (rev 66058)
@@ -31,6 +31,7 @@
 \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\&.
+.SH "PORT IMAGES"
 .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 \fIimages\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be hardlinked to their intended place in \fIprefix\fR\&.
 .sp

Modified: branches/new-help-system/base/doc/port.1
===================================================================
--- branches/new-help-system/base/doc/port.1	2010-04-05 13:33:04 UTC (rev 66057)
+++ branches/new-help-system/base/doc/port.1	2010-04-05 13:33:17 UTC (rev 66058)
@@ -25,7 +25,7 @@
 .sp
 Port \fIvariants\fR can be 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 in multiple versions and variant combinations, but only one of them can be \fIactive\fR\&.
+Installed ports can be activated or deactivated without being uninstalled\&. A port can be installed in multiple versions and variant combinations, but only one of them can be \fIactive\fR\&. See \fBportimages\fR(7)\&.
 .sp
 When passing \fIportnames\fR to an \fIaction\fR, \fBport\fR recognizes various \fIpseudo\-portnames\fR that will expand to the specified set of ports from the available port tree(s)\&. These may be used in the same way as a \fIportname\fR\&.
 .PP
@@ -395,8 +395,10 @@
 .PP
 \-n
 .RS 4
-Don\(cqt follow dependencies in upgrade (only for
-\fIupgrade\fR)
+Don\(cqt follow dependencies in upgrade (affects
+\fIupgrade\fR
+and
+\fIinstall\fR)
 .RE
 .PP
 \-R
@@ -447,11 +449,6 @@
 .PP
 \fBExit status\fR
 .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\&.
@@ -546,6 +543,13 @@
 .\}
 .RE
 .PP
+notes
+.RS 4
+Displays notes for
+\fIportname\fR
+which usually contain useful information concerning setup and use of the port\&.
+.RE
+.PP
 variants
 .RS 4
 Lists the variants available for
@@ -606,7 +610,7 @@
 .PP
 installed
 .RS 4
-Lists all installed ports\&. Outputs name, composite version and activation status for each passed
+Show the installed version, variants and activation status for each
 \fIportname\fR\&. If no arguments are given, all installed ports are displayed\&.
 .RE
 .PP
@@ -711,13 +715,15 @@
 .RE
 .\}
 .sp
-To force a rebuild use:
+To force a rebuild of
+\fIportname\fR
+and all of its dependencies use:
 .sp
 .if n \{\
 .RS 4
 .\}
 .nf
-port \-fn upgrade vim
+port upgrade \-\-force vim
 .fi
 .if n \{\
 .RE
@@ -751,8 +757,7 @@
 \fBNote\fR
 .ps -1
 .br
-By 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
-\fB\-f\fR, or deactivate the port and reinstall it with different variants\&.
+By 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 \-\-enforce\-variants, or deactivate the port and reinstall it with different variants\&.
 .sp .5v
 .RE
 .RE
@@ -764,7 +769,8 @@
 \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\-\-archive\fR\&. To remove log files for certain ports, pass
+\fB\-\-logs\fR\&. To remove the work files, distribution files, archives and logs pass
 \fB\-\-all\fR\&.
 .sp
 For example:
@@ -775,6 +781,7 @@
 .nf
 port clean \-\-dist vim
 port clean \-\-archive vim
+port clean \-\-logs vim
 .fi
 .if n \{\
 .RE
@@ -805,6 +812,29 @@
 .\}
 .RE
 .PP
+log
+.RS 4
+Parses and shows log files for
+\fIportname\fR\&. To filter log files by some criterions use
+\fB\-\-phase\fR
+to specify the phase you want to show and
+\fB\-\-verbosity\fR
+to specify message category (msg, info, debug)\&.
+.sp
+For example:
+.RE
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+port log \-\-phase configure vim
+port log \-\-phase fetch \-\-verbosity debug vim
+.fi
+.if n \{\
+.RE
+.\}
+.PP
 echo
 .RS 4
 Writes to stdout the arguments passed to
@@ -855,11 +885,6 @@
 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\&.
@@ -945,7 +970,7 @@
 url
 .RS 4
 Displays the URL for the path of the given portname, which can be passed as
-\fIport\-url\fR\&.\&.
+\fIport\-url\fR\&.
 .RE
 .PP
 cat
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20100405/bdca39df/attachment.html>
