source: trunk/base/doc/port-deps.1 @ 129855

Last change on this file since 129855 was 123682, checked in by cal@…, 5 years ago

base: generate roff from asciidoc

File size: 3.2 KB
Line 
1'\" t
2.TH "PORT\-DEPS" "1" "2014\-08\-12" "MacPorts 2\&.3\&.99" "MacPorts Manual"
3.\" -----------------------------------------------------------------
4.\" * Define some portability stuff
5.\" -----------------------------------------------------------------
6.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7.\" http://bugs.debian.org/507673
8.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10.ie \n(.g .ds Aq \(aq
11.el       .ds Aq '
12.\" -----------------------------------------------------------------
13.\" * set default formatting
14.\" -----------------------------------------------------------------
15.\" disable hyphenation
16.nh
17.\" disable justification (adjust text to left margin only)
18.ad l
19.\" -----------------------------------------------------------------
20.\" * MAIN CONTENT STARTS HERE *
21.\" -----------------------------------------------------------------
22.SH "NAME"
23port-deps, port-rdeps \- Display a dependency listing for the given port(s)
24.SH "SYNOPSIS"
25.sp
26.nf
27\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBdeps\fR
28     [\-\-index] [\-\-no\-build]
29     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
30.fi
31.sp
32.nf
33\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBrdeps\fR
34     [\-\-full] [\-\-index] [\-\-no\-build]
35     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
36.fi
37.SH "DESCRIPTION"
38.sp
39\fBport deps\fR lists all dependencies of the given port(s), i\&.e\&., the ports that need to be installed to build or use a port\&.
40.sp
41\fBport rdeps\fR recursively descends into the dependencies and displays a tree of dependencies for a given port\&.
42.SH "OPTIONS"
43.PP
44\fB\-\-full\fR
45.RS 4
46When using
47\fBrdeps\fR, display all branches of the dependency tree instead of listing each dependency only once\&.
48.RE
49.PP
50\fB\-\-index\fR
51.RS 4
52Do not read Portfiles, but instead rely solely on the PortIndex information\&. Note that this option will prevent the dependencies reported from reflecting the effects of any variants specified\&.
53.RE
54.PP
55\fB\-\-no\-build\fR
56.RS 4
57Exclude dependencies only required at build time, i\&.e\&., fetch, extract, and build dependencies\&.
58.RE
59.SH "GLOBAL OPTIONS"
60.sp
61Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
62.SH "DEPENDENCY RELATIONS"
63.sp
64Do not confuse \fIdependents\fR and \fIdependencies\fR (or, shortened, \fIdeps\fR)\&. Refer to the following example to understand the difference:
65.sp
66.if n \{\
67.RS 4
68.\}
69.nf
70portA \-\-> portB
71.fi
72.if n \{\
73.RE
74.\}
75.sp
76\fBportA\fR depends on \fBportB\fR, i\&.e\&., \fBportA\fR needs \fBportB\fR to run\&. Because of that, \fBportB\fR is a \fIdependency\fR (or \fIdep\fR) of \fBportA\fR\&. After installing \fBportA\fR, \fBportB\fR has been automatically installed\&. At this point, \fBportA\fR has become a \fIdependent\fR of \fBportB\fR\&. You can only uninstall \fBportB\fR once all of its dependents (i\&.e\&., including \fBportA\fR) have been uninstalled\&.
77.SH "SEE ALSO"
78.sp
79\fBport\fR(1), \fBport-variants\fR(1)
80.SH "AUTHORS"
81.sp
82.if n \{\
83.RS 4
84.\}
85.nf
86(C) 2014 The MacPorts Project
87Clemens Lang <cal@macports\&.org>
88.fi
89.if n \{\
90.RE
91.\}
Note: See TracBrowser for help on using the repository browser.