[66056] branches/new-help-system/base/doc/port.1.txt

raimue at macports.org raimue at macports.org
Mon Apr 5 06:30:12 PDT 2010


Revision: 66056
          http://trac.macports.org/changeset/66056
Author:   raimue at macports.org
Date:     2010-04-05 06:30:09 -0700 (Mon, 05 Apr 2010)
Log Message:
-----------
Resync from trunk port.1

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

Modified: branches/new-help-system/base/doc/port.1.txt
===================================================================
--- branches/new-help-system/base/doc/port.1.txt	2010-04-05 12:58:10 UTC (rev 66055)
+++ branches/new-help-system/base/doc/port.1.txt	2010-04-05 13:30:09 UTC (rev 66056)
@@ -31,7 +31,7 @@
 
 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 'active'.
+one of them can be 'active'. See man:portimages[7].
 
 When passing 'portnames' to an 'action', *port* recognizes various
 'pseudo-portnames' that will expand to the specified set of ports from the
@@ -54,6 +54,7 @@
 searchable keys used in a 'Portfile' are also accepted. Where applicable, both
 singular and plural forms are accepted.
 
+[options="compact"]
 .The 'pseudo-portname selectors' are:
     - 'name'
     - 'version'
@@ -116,7 +117,7 @@
 
 .Installation and upgrade
 -n::
-    Don't follow dependencies in upgrade (only for 'upgrade')
+    Don't follow dependencies in upgrade (affects 'upgrade' and 'install')
 
 -R::
     Also upgrade dependents (only for 'upgrade')
@@ -150,10 +151,6 @@
     Keep mode, do not autoclean after 'install'
 
 .Exit status
--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.
@@ -164,7 +161,8 @@
 
 -t::
     Enable trace mode debug facilities on platforms that support it, currently
-    only Mac OS X. + 
+    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
@@ -226,6 +224,10 @@
 port info --index python24
 --------
 
+notes::
+    Displays notes for 'portname' which usually contain useful information
+    concerning setup and use of the port.
+
 variants::
     Lists the variants available for 'portname'.
 
@@ -259,9 +261,8 @@
     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.
+    Show the installed version, variants and activation status for each
+    'portname'. If no arguments are given, all installed ports are displayed.
 
 location::
     Print the install location of a given port.
@@ -322,10 +323,10 @@
 port -R upgrade libiconv
 --------
 
-To force a rebuild use:
+To force a rebuild of 'portname' and all of its dependencies use:
 
 --------
-port -fn upgrade vim
+port upgrade --force vim
 --------
 
 To upgrade 'portname' without following its dependencies before, use *-n*.
@@ -337,12 +338,13 @@
 --------
 
 [NOTE]
-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 *-f*, 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.
 --
 
 clean::
@@ -350,8 +352,8 @@
     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*.
+    *--archive*. To remove log files for certain ports, pass *--logs*. To remove
+    the work files, distribution files, archives and logs pass *--all*.
 +
 --
 For example:
@@ -359,6 +361,7 @@
 --------
 port clean --dist vim
 port clean --archive vim
+port clean --logs vim
 --------
 
 To remove only certain version(s) of a port's archives (version is any
@@ -375,6 +378,17 @@
 --------
 --
 
+log::
+    Parses and shows log files for 'portname'. To filter log files by some
+    criterions use *--phase* to specify the phase you want to show and
+    *--verbosity* to specify message category (msg, info, debug).
++
+For example:
+--------
+port log --phase configure vim
+port log --phase fetch --verbosity debug vim
+--------
+
 echo::
     Writes to stdout the arguments passed to 'port'. This follows the expansion
     of 'pseudo-portnames', portname glob patterns, 'pseudo-portname selectors'
@@ -407,9 +421,6 @@
 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.
@@ -464,7 +475,7 @@
 
 url::
     Displays the URL for the path of the given portname, which can be passed as
-    'port-url'..
+    'port-url'.
 
 cat::
     Concatenates and prints the contents of 'Portfile' on stdout.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20100405/7159bf4d/attachment.html>


More information about the macports-changes mailing list