[123014] trunk/base/doc

[cal at macports.org]

Revision: 123014
          https://trac.macports.org/changeset/123014
Author:   cal at macports.org
Date:     2014-08-03 13:36:53 -0700 (Sun, 03 Aug 2014)
Log Message:
-----------
base: document port rev-upgrade with the new help system

Modified Paths:
--------------
    trunk/base/doc/Makefile.in

Added Paths:
-----------
    trunk/base/doc/port-rev-upgrade.1.txt

Modified: trunk/base/doc/Makefile.in
===================================================================
--- trunk/base/doc/Makefile.in	2014-08-03 20:36:13 UTC (rev 123013)
+++ trunk/base/doc/Makefile.in	2014-08-03 20:36:53 UTC (rev 123014)
@@ -15,7 +15,7 @@
 ASCIIDOCFLAGS=	-f asciidoc.conf -a manversion=${MACPORTS_VERSION}
 XSLTFLAGS=	-nonet
 
-MAN1=		port.1 \
+MAN1=	\
 		port-activate.1 \
 		port-build.1 \
 		port-checksum.1 \
@@ -27,7 +27,10 @@
 		port-fetch.1 \
 		port-install.1 \
 		port-patch.1 \
-		port-uninstall.1
+		port-rev-upgrade.1 \
+		port-uninstall.1 \
+		port.1 \
+
 MAN5=		macports.conf.5
 MAN7=		portfile.7 portstyle.7 porthier.7 portgroup.7 portundocumented.7
 MAN=		${MAN1} ${MAN5} ${MAN7}

Copied: trunk/base/doc/port-rev-upgrade.1.txt (from rev 123002, trunk/base/doc/port-activate.1.txt)
===================================================================
--- trunk/base/doc/port-rev-upgrade.1.txt	                        (rev 0)
+++ trunk/base/doc/port-rev-upgrade.1.txt	2014-08-03 20:36:53 UTC (rev 123014)
@@ -0,0 +1,51 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-rev-upgrade(1)
+===================
+$Id$
+
+NAME
+----
+port-rev-upgrade - Check for linking inconsistencies and attempt to fix them
+automatically.
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* [*-vdy*] *rev-upgrade*
+     [--id-loadcmd-check]
+
+DESCRIPTION
+-----------
+*port rev-upgrade* 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, *rev-upgrade* will rebuild broken ports in
+an attempt to fix the problems.
+
+By default, *rev-upgrade* is run automatically after each installation or
+upgrade, unless you pass the *--no-rev-upgrade* option or disable this beahvior
+in man:macports.conf[5] using the *revupgrade_autorun* switch.
+
+
+OPTIONS
+-------
+
+--id-loadcmd-check::
+    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.
+
+
+include::global-flags.txt[]
+
+
+SEE ALSO
+--------
+man:port[1], man:macports.conf[5]
+
+AUTHORS
+-------
+ (C) 2014 The MacPorts Project
+ Clemens Lang <cal at macports.org>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20140803/bc093578/attachment.html>