Changeset 123678


Ignore:
Timestamp:
Aug 12, 2014, 11:46:51 AM (5 years ago)
Author:
cal@…
Message:

base: document port-dependents.1, #44530

Location:
trunk/base/doc
Files:
1 added
1 edited
1 copied

Legend:

Unmodified
Added
Removed
  • trunk/base/doc/Makefile.in

    r123200 r123678  
    2828                port-contents.1 \
    2929                port-deactivate.1 \
     30                port-dependents.1 \
    3031                port-destroot.1 \
    3132                port-edit.1 \
  • trunk/base/doc/port-dependents.1.txt

    r123672 r123678  
    11// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
    2 port-cat(1)
    3 ===========
     2port-dependents(1)
     3==================
    44$Id$
    55
    66NAME
    77----
    8 port-cat - Print the contents of a Portfile
     8port-dependents - List ports that depend on a given (installed) port
    99
    1010SYNOPSIS
    1111--------
    1212[cmdsynopsis]
    13 *port* [*-D* 'portdir'] *cat*
     13*port* [*-D* 'portdir'] *dependents*
    1414     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
    1515
    1616DESCRIPTION
    1717-----------
    18 Print the 'Portfile' of the given port(s). Note that always the latest version
    19 in your local ports tree is printed.
     18*port dependents* reports which ports depend upon a given (installed) port, if
     19any. Note that *dependents* does not work for ports that are not installed on
     20your system. It uses the database of installed ports that MacPorts keeps
     21internally, which records the dependency relations at installation time. *port
     22dependents* prints this information.
     23
     24For this reason, *port dependents* does not work for ports that are not
     25installed on your system. If you want to find out which ports depend on a port
     26you haven't installed, you can use the *depends:* pseudo-portname selector:
     27
     28----
     29port echo depends:<portname>
     30----
     31
     32This command will, however, not cover dependencies that are only present in
     33non-default variants. For more information about pseudo-portname selectors, see
     34man:port[1].
     35
     36The dependency relations printed by *port dependents* are the same that are used
     37to determine if a port can be safely uninstalled. Ports that still have
     38dependents installed cannot be uninstalled without either the
     39*--follow-dependents* or the *-f* flag. See man:port-uninstall[1] for more
     40details.
     41
     42include::dependents-vs-dependencies.txt[]
    2043
    2144SEE ALSO
    2245--------
    23 man:port[1], man:port-selfupdate[1]
     46man:port[1], man:port-echo[1], man:port-deps[1], man:port-uninstall[1]
    2447
    2548AUTHORS
Note: See TracChangeset for help on using the changeset viewer.