/
port-deps.1
91 lines (91 loc) · 3.2 KB
/
port-deps.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
'\" t
.TH "PORT\-DEPS" "1" "2\&.5\&.0" "MacPorts 2\&.5\&.0" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
port-deps, port-rdeps \- Display a dependency listing for the given port(s)
.SH "SYNOPSIS"
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBdeps\fR
[\-\-index] [\-\-no\-build]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBrdeps\fR
[\-\-full] [\-\-index] [\-\-no\-build]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.SH "DESCRIPTION"
.sp
\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\&.
.sp
\fBport rdeps\fR recursively descends into the dependencies and displays a tree of dependencies for a given port\&.
.SH "OPTIONS"
.PP
\fB\-\-full\fR
.RS 4
When using
\fBrdeps\fR, display all branches of the dependency tree instead of listing each dependency only once\&.
.RE
.PP
\fB\-\-index\fR
.RS 4
Do 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\&.
.RE
.PP
\fB\-\-no\-build\fR
.RS 4
Exclude dependencies only required at build time, i\&.e\&., fetch, extract, and build dependencies\&.
.RE
.SH "GLOBAL OPTIONS"
.sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
.SH "DEPENDENCY RELATIONS"
.sp
Do not confuse \fIdependents\fR and \fIdependencies\fR (or, shortened, \fIdeps\fR)\&. Refer to the following example to understand the difference:
.sp
.if n \{\
.RS 4
.\}
.nf
portA \-\-> portB
.fi
.if n \{\
.RE
.\}
.sp
\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\&.
.SH "SEE ALSO"
.sp
\fBport\fR(1), \fBport-variants\fR(1)
.SH "AUTHORS"
.sp
.if n \{\
.RS 4
.\}
.nf
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports\&.org>
.fi
.if n \{\
.RE
.\}