Changeset 134967 for trunk/base


Ignore:
Timestamp:
Apr 12, 2015, 7:06:08 PM (5 years ago)
Author:
cal@…
Message:

base: document port upgrade, #44530

File:
1 copied

Legend:

Unmodified
Added
Removed
  • trunk/base/doc/port-upgrade.1.txt

    r133158 r134967  
    11// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
    2 port-install(1)
     2port-upgrade(1)
    33===============
    44$Id$
     
    66NAME
    77----
    8 port-install - Install a new port
     8port-upgrade - Upgrade a port to the latest version
    99
    1010SYNOPSIS
    1111--------
    1212[cmdsynopsis]
    13 *port* [*-vdqysbckpotf*] [*-D* 'portdir'] *install*
    14      [--no-rev-upgrade] [--unrequested]
     13*port* [*-vdqysbckpotf*] [*-D* 'portdir'] *upgrade*
     14     [--enforce-variants] [--force] [--no-replace] [--no-rev-upgrade]
    1515     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
    1616     [+/-variant ...]
     
    1818DESCRIPTION
    1919-----------
    20 *port install* will install a new port on your system. You can choose multiple
    21 variants, by specifying \+name, which indicates the variant is desired, or
    22 -name, indicating the contrary.
     20*port upgrade* will upgrade the given installed ports to the latest available
     21version. To upgrade a port, MacPorts needs an updated port definition, which can
     22be obtained using the man:port-selfupdate[1] command. You should regularly run
     23*selfupdate* followed by *upgrade outdated* to make sure your system has the
     24latest versions and bug fixes.
    2325
    24 Global variants will be applied as specified in man:variants.conf[5].
     26When specifying variants during upgrade, the order of precedence is
     27
     28. variants specified on the command line
     29. variants active in the latest installed version of the port
     30. variants specified in man:variants.conf[5]
     31
     32In most cases, you should specify the *outdated* pseudo-port expression as
     33argument to *port upgrade* to upgrade all ports where a newer version is
     34available. See man:port[1] for more information on pseudo-port expressions.
    2535
    2636OPTIONS
    2737-------
     38*--enforce-variants*::
     39    Upgrade all given ports and their dependencies where the installed variants
     40    do not match those requested on the command line, even if those ports aren't
     41    outdated.
     42
     43*--force*::
     44    Ignore circumstances that would normally cause ports to be skipped, such as
     45    not being outdated.
     46
     47*--no-replace*::
     48    Do not automatically install ports that replace a now-obsolete port you have
     49    installed.
     50
    2851*--no-rev-upgrade*::
    29 Do not run rev-upgrade after installation. See man:port-rev-upgrade[1] for more
    30 information.
    31 
    32 *--unrequested*::
    33 Do not mark the installed ports as requested. See man:port-setrequested[1] for
    34 more information.
     52    Do not run rev-upgrade after upgrading. See man:port-rev-upgrade[1] for more
     53    information.
    3554
    3655
    3756include::global-flags.txt[]
    3857
     58*-f*::
     59    Upgrade a port, even if it is not outdated.
     60
     61*-n*::
     62    Only upgrade the given ports and avoid upgrading their dependencies. This
     63    flag may be useful when combined with *--enforce-variants*.
     64    +
     65    WARNING: Ports expect their dependencies to always be at the latest version,
     66    which is why MacPorts upgrades dependencies first. Do not specify this flag
     67    if you don't know what you are doing.
     68
     69*-p*::
     70    Keep going and attempt to upgrade the next port when a port fails to build.
     71    +
     72    WARNING: This option is harmful to *upgrade* and should be avoided at all
     73    cost. Often, MacPorts ports are only upgraded to rebuild them against
     74    updated dependencies. Specifying this flag will cause a spurious rebuild if
     75    a dependency of a port fails to build and leave your system in a broken
     76    state once the dependent port is fixed.
    3977
    4078SEE ALSO
     
    4583AUTHORS
    4684-------
    47  (C) 2009 The MacPorts Project
    48  Rainer Mueller <raimue@macports.org>
     85 (C) 2015 The MacPorts Project
     86 Clemens Lang <cal@macports.org>
Note: See TracChangeset for help on using the changeset viewer.