[134967] trunk/base/doc/port-upgrade.1.txt

[cal at macports.org]

Revision: 134967
          https://trac.macports.org/changeset/134967
Author:   cal at macports.org
Date:     2015-04-12 12:06:08 -0700 (Sun, 12 Apr 2015)
Log Message:
-----------
base: document port upgrade, #44530

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

Copied: trunk/base/doc/port-upgrade.1.txt (from rev 133158, trunk/base/doc/port-install.1.txt)
===================================================================
--- trunk/base/doc/port-upgrade.1.txt	                        (rev 0)
+++ trunk/base/doc/port-upgrade.1.txt	2015-04-12 19:06:08 UTC (rev 134967)
@@ -0,0 +1,86 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-upgrade(1)
+===============
+$Id$
+
+NAME
+----
+port-upgrade - Upgrade a port to the latest version
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* [*-vdqysbckpotf*] [*-D* 'portdir'] *upgrade*
+     [--enforce-variants] [--force] [--no-replace] [--no-rev-upgrade]
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+     [+/-variant ...]
+
+DESCRIPTION
+-----------
+*port upgrade* 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 man:port-selfupdate[1] command. You should regularly run
+*selfupdate* followed by *upgrade outdated* to make sure your system has the
+latest versions and bug fixes.
+
+When specifying variants during upgrade, the order of precedence is
+
+. variants specified on the command line
+. variants active in the latest installed version of the port
+. variants specified in man:variants.conf[5]
+
+In most cases, you should specify the *outdated* pseudo-port expression as
+argument to *port upgrade* to upgrade all ports where a newer version is
+available. See man:port[1] for more information on pseudo-port expressions.
+
+OPTIONS
+-------
+*--enforce-variants*::
+    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't
+    outdated.
+
+*--force*::
+    Ignore circumstances that would normally cause ports to be skipped, such as
+    not being outdated.
+
+*--no-replace*::
+    Do not automatically install ports that replace a now-obsolete port you have
+    installed.
+
+*--no-rev-upgrade*::
+    Do not run rev-upgrade after upgrading. See man:port-rev-upgrade[1] for more
+    information.
+
+
+include::global-flags.txt[]
+
+*-f*::
+    Upgrade a port, even if it is not outdated.
+
+*-n*::
+    Only upgrade the given ports and avoid upgrading their dependencies. This
+    flag may be useful when combined with *--enforce-variants*.
+    +
+    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't know what you are doing.
+
+*-p*::
+    Keep going and attempt to upgrade the next port when a port fails to build.
+    +
+    WARNING: This option is harmful to *upgrade* 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.
+
+SEE ALSO
+--------
+man:port[1], man:port-uninstall[1], man:port-info[1], man:port-variants[1],
+man:port-rev-upgrade[1], man:port-setrequested[1], man:variants.conf[5]
+
+AUTHORS
+-------
+ (C) 2015 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/20150412/1e51a6ee/attachment.html>