Changeset 129053


Ignore:
Timestamp:
Dec 4, 2014, 7:23:23 PM (5 years ago)
Author:
cal@…
Message:

base: regenerate port.1 manpage

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/base/doc/port.1

    r124480 r129053  
    11'\" t
    2 .TH "PORT" "1" "2014\-08\-21" "MacPorts 2\&.3\&.99" "MacPorts Manual"
     2.TH "PORT" "1" "2014\-11\-11" "MacPorts 2\&.3\&.99" "MacPorts Manual"
    33.\" -----------------------------------------------------------------
    44.\" * Define some portability stuff
     
    641641rdeps
    642642.RS 4
    643 Recursively lists the other ports that are required to build and run portname\&. To display the full dependency tree instead of only showing each port once, use \-\-full\&. To take dependency information from the PortIndex instead of the Portfile (faster, but does not take variant selections into account), use \-\-index\&. To exclude dependencies that are only needed at build time (i\&.e\&. depends_fetch, depends_extract, depends_build), use
     643Recursively lists the other ports that are required to build and run portname\&. To display the full dependency tree instead of only showing each port once, use
     644\fB\-\-full\fR\&. To take dependency information from the PortIndex instead of the Portfile (faster, but does not take variant selections into account), use
     645\fB\-\-index\fR\&. To exclude dependencies that are only needed at build time (i\&.e\&. depends_fetch, depends_extract, depends_build), use
    644646\fB\-\-no\-build\fR\&.
    645647.RE
     
    653655rdependents
    654656.RS 4
    655 Recursively lists the installed ports that depend on the port portname\&. To display the full tree of dependents instead of only showing each port once, use \-\-full\&.
     657Recursively lists the installed ports that depend on the port portname\&. To display the full tree of dependents instead of only showing each port once, use
     658\fB\-\-full\fR\&.
    656659.RE
    657660.PP
     
    668671ports, use
    669672\fB\-u\fR\&. To recursively uninstall all dependents of this port, use
    670 \fB\-\-follow\-dependents\fR\&. To uninstall portname and then recursively uninstall all ports it depended on, use \-\-follow\-dependencies\&. This will not uninstall dependencies that are marked as requested or that have other dependents\&.
     673\fB\-\-follow\-dependents\fR\&. To uninstall portname and then recursively uninstall all ports it depended on, use
     674\fB\-\-follow\-dependencies\fR\&. This will not uninstall dependencies that are marked as requested or that have other dependents\&.
    671675.sp
    672676For example:
     
    881885.ps -1
    882886.br
    883 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\&.
     887By 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
     888\fB\-\-enforce\-variants\fR, or deactivate the port and reinstall it with different variants\&.
    884889.sp .5v
    885890.RE
    886891\ \&
    887892.sp
    888 After the upgrade MacPorts will automatically run rev\-upgrade to check for broken ports that need to be rebuilt\&. If there are known problems with rev\-upgrade or other reasons why you would want to avoid running this step, you can disable it by running port upgrade with the \-\-no\-rev\-upgrade switch:
     893After the upgrade MacPorts will automatically run rev\-upgrade to check for broken ports that need to be rebuilt\&. If there are known problems with rev\-upgrade or other reasons why you would want to avoid running this step, you can disable it by running port upgrade with the
     894\fB\-\-no\-rev\-upgrade\fR
     895switch:
    889896.sp
    890897.if n \{\
     
    901908rev\-upgrade
    902909.RS 4
    903 Manually check for broken binaries and rebuild ports containing broken binaries\&. rev\-upgrade is usually automatically run after each upgrade, unless you specify the \-\-no\-rev\-upgrade option\&.
     910Manually check for broken binaries and rebuild ports containing broken binaries\&. rev\-upgrade is usually automatically run after each upgrade, unless you specify the
     911\fB\-\-no\-rev\-upgrade\fR
     912option\&.
    904913
    905 rev\-upgrade can run more checks against a special loadcommand in Mach\-O binaries that should always be referencing the file itself\&. This check is most helpful for maintainers to check whether their ports have been built correctly\&. It is disabled by default and can be enabled by passing \-\-id\- loadcmd\-check to rev\-upgrade\&.
     914rev\-upgrade can run more checks against a special loadcommand in Mach\-O binaries that should always be referencing the file itself\&. This check is most helpful for maintainers to check whether their ports have been built correctly\&. It is disabled by default and can be enabled by passing
     915\fB\-\-id\-loadcmd\-check\fR
     916to rev\-upgrade\&.
    906917
    907918See also:
     
    11391150edit
    11401151.RS 4
    1141 Opens Portfile with your default editor specified in your shell\(cqs environment variable\&. You can also use the \-\-editor flag on the command line to specify an alternative editor\&.
     1152Opens Portfile with your default editor specified in your shell\(cqs environment variable\&. You can also use the
     1153\fB\-\-editor\fR
     1154flag on the command line to specify an alternative editor\&.
    11421155.sp
    11431156For example:
Note: See TracChangeset for help on using the changeset viewer.