source: trunk/base/doc/port-echo.1

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

base: regenerate roff from asciidoc source

File size: 2.4 KB
Line 
1'\" t
2.TH "PORT\-ECHO" "1" "2014\-08\-15" "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-echo \- Print the list of ports the argument expands to
24.SH "SYNOPSIS"
25.sp
26.nf
27\fBport\fR \fBecho\fR
28     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
29.fi
30.SH "DESCRIPTION"
31.sp
32\fBport echo\fR expands its argument list according to MacPorts\*(Aq rules and prints a list of ports that match the expression given as argument\&. It can be useful to see what a pseudo\-portname or a pseudo\-portname selector (see \fBport\fR(1)) expands to\&.
33.sp
34If \fBport echo\fR doesn\(cqt recognize an argument as port, it will still print it as\-is\&. You cannot use \fBport echo\fR to check whether a port exists:
35.sp
36.if n \{\
37.RS 4
38.\}
39.nf
40$ port echo nonexistentport
41nonexistentport
42.fi
43.if n \{\
44.RE
45.\}
46.SH "EXAMPLES"
47.sp
48Common use cases are:
49.sp
50.if n \{\
51.RS 4
52.\}
53.nf
54port echo depends:zlib
55port echo inactive
56port echo obsolete
57port echo requested
58port echo leaves
59port echo category:^mail$
60.fi
61.if n \{\
62.RE
63.\}
64.sp
65Note that \fBecho\fR is usually \fInot\fR used to list outdated ports, since a separate action \fBport-outdated\fR(1) exists for that\&. \fBport outdated\fR has the advantage compared to \fBport echo outdated\fR that it gives the reason why MacPorts considers the port outdated\&.
66.SH "SEE ALSO"
67.sp
68\fBport\fR(1), \fBport-outdated\fR(1)
69.SH "AUTHORS"
70.sp
71.if n \{\
72.RS 4
73.\}
74.nf
75(C) 2014 The MacPorts Project
76Clemens Lang <cal@macports\&.org>
77.fi
78.if n \{\
79.RE
80.\}
Note: See TracBrowser for help on using the repository browser.