source: trunk/base/doc/port-contents.1 @ 123017

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

base: generate port-contents.1 using asciidoc

File size: 2.9 KB
Line 
1'\" t
2.TH "PORT\-CONTENTS" "1" "2014\-08\-03" "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-contents \- List the files installed by a given port
24.SH "SYNOPSIS"
25.sp
26.nf
27\fBport\fR [\fB\-q\fR] [\fB\-D\fR \fIportdir\fR] \fBcontents\fR
28     [\-\-size] [\-\-units \fBUNIT\fR]
29     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
30.fi
31.SH "DESCRIPTION"
32.sp
33\fBport contents\fR displays a list of all files that have been installed by a given port\&. You can only use \fBcontents\fR for ports that are \fIactive\fR and installed\&.
34.sp
35Common uses for \fBcontents\fR include finding the location of a port\(cqs executable after installing it\&. You can combine \fBport contents\fR with other tools to simplify this, e\&.g\&.
36.sp
37.if n \{\
38.RS 4
39.\}
40.nf
41port \-q contents asciidoc | grep \-E \*(Aq/s?bin/\*(Aq
42.fi
43.if n \{\
44.RE
45.\}
46.SH "OPTIONS"
47.PP
48\-\-size
49.RS 4
50Enable printing a human\-readable representation of the files\*(Aq sizes\&. The size output can be adjusted using the
51\fB\-\-units UNIT\fR
52flag\&.
53.RE
54.PP
55\-\-units UNIT
56.RS 4
57Used in conjunction with
58\fB\-\-size\fR
59to choose the unit in which the size is given\&. Valid values for
60\fIUNIT\fR
61are
62.PP
63B
64.RS 4
65List sizes in bytes\&.
66.RE
67.PP
68K, Ki, or KiB
69.RS 4
70List sizes in KiB, i\&.e\&., 1024 bytes\&.
71.RE
72.PP
73Mi, or MiB
74.RS 4
75List sizes in MiB, i\&.e\&., 1024 * 1024 bytes\&.
76.RE
77.PP
78Gi, or GiB
79.RS 4
80List sizes in GiB, i\&.e\&., 1024 * 1024 * 1024 bytes\&.
81.RE
82.PP
83k, or kB
84.RS 4
85List sizes in kB, i\&.e\&., 1000 bytes\&.
86.RE
87.PP
88M, or MB
89.RS 4
90List sizes in MB, i\&.e\&., 1000 * 1000 bytes\&.
91.RE
92.PP
93G, or GB
94.RS 4
95List sizes in GB, i\&.e\&., 1000 * 1000 * 1000 bytes\&.
96.RE
97.RE
98.SH "GLOBAL OPTIONS"
99.sp
100Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
101.PP
102\-q
103.RS 4
104Do not print the header line\&.
105.RE
106.SH "SEE ALSO"
107.sp
108port(1)
109.SH "AUTHORS"
110.sp
111.if n \{\
112.RS 4
113.\}
114.nf
115(C) 2014 The MacPorts Project
116Clemens Lang <cal@macports\&.org>
117.fi
118.if n \{\
119.RE
120.\}
Note: See TracBrowser for help on using the repository browser.