source: trunk/base/doc/port-dir.1 @ 125257

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

base: regenerate roff from asciidoc source

File size: 3.8 KB
Line 
1'\" t
2.TH "PORT\-DIR" "1" "2014\-08\-16" "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-dir, port-url, port-file, port-location, port-work \- Print paths for certain properties of a port
24.SH "SYNOPSIS"
25.sp
26.nf
27\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBdir\fR
28     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
29.fi
30.sp
31.nf
32\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBurl\fR
33     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
34.fi
35.sp
36.nf
37\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBfile\fR
38     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
39.fi
40.sp
41.nf
42\fBport\fR [\fB\-q\fR] [\fB\-D\fR \fIportdir\fR] \fBlocation\fR
43     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
44.fi
45.sp
46.nf
47\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBwork\fR
48     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
49.fi
50.SH "DESCRIPTION"
51.sp
52These commands print a path for each given port\&. The meaning of the path differs by the command given:
53.sp
54\fBport dir\fR prints the directory that contains the \fIPortfile\fR for the given port expression\&. This can be quite handy in your shell, if you want to locate a \fIPortfile\fR:
55.sp
56.if n \{\
57.RS 4
58.\}
59.nf
60cd $(port dir <portname>)
61.fi
62.if n \{\
63.RE
64.\}
65.sp
66\fBport url\fR prints a unique URL for the given port expression\&. This command mostly exists for historical reasons and isn\(cqt of much use nowadays\&.
67.sp
68\fBport file\fR prints the path of the \fIPortfile\fR for the given port expression\&. This can be useful to locate a port\(cqs definition\&. Note that you can always get this by using \fBport dir\fR and appending \fIPortfile\fR\&. You could use \fBport file\fR in a shell to edit a Portfile, but note that you can also use \fBport-edit\fR(1) to achieve the same\&.
69.sp
70\fBport location\fR only works for installed ports and prints the location of the archive MacPorts internally uses to be able to deactivate and activate a port\&. See \fBport-activate\fR(1) for more details on that\&. This command might be useful for you if you want to setup a local binary mirror of MacPorts packages that are not available from our official infrastructure due to licensing reasons\&.
71.sp
72\fBport work\fR prints the path to the so\-called \fIwork\fR directory, i\&.e\&., the directory used by MacPorts to build a port\&. No output is generated if no build directory exists, e\&.g\&., because there is no unfinished build in progress for the given port\&. Work directories are deleted after successful installation or using \fBport-clean\fR(1)\&.
73.SH "GLOBAL OPTIONS"
74.sp
75Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
76.SH "SEE ALSO"
77.sp
78\fBport\fR(1), \fBport-edit\fR(1), \fBport-activate\fR(1), \fBport-clean\fR(1)
79.SH "AUTHORS"
80.sp
81.if n \{\
82.RS 4
83.\}
84.nf
85(C) 2014 The MacPorts Project
86Clemens Lang <cal@macports\&.org>
87.fi
88.if n \{\
89.RE
90.\}
Note: See TracBrowser for help on using the repository browser.