source: trunk/base/src/port/port.1 @ 2124

Last change on this file since 2124 was 2124, checked in by kevin, 17 years ago

Added -o flag to ignore modification times on state file and Portfile

  • Property svn:eol-style set to native
File size: 3.7 KB
Line 
1.\" port.1
2.\"
3.\" Copyright (c) 2002 Apple Computer, Inc.
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of Apple Computer, Inc. nor the names of its
15.\"    contributors may be used to endorse or promote products derived from
16.\"    this software without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
22.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd August 24, 2002
31.Dt PORTBUILD 1 "Apple Computer, Inc."
32.Os
33.Sh NAME
34.Nm port
35.Nd build darwin ports
36.Sh SYNOPSIS
37.Nm
38.Op Fl vdqo
39.Op Ar target
40.Op Ar portname
41.Op Fl D Ar portdir
42.Op Ar options ...
43.Op Ar variations ...
44.Sh DESCRIPTION
45.Nm
46is designed to read and execute the build instructions of a darwin port. If no
47.Ar portdir
48or
49.Ar portname
50is specified, the current working directory is assumed.
51If no
52.Ar target
53is specified, "build" is assumed.
54Port
55.Ar options
56are specified as key=value pairs and take precedence over individual port options and system-wide settings.
57Port
58.Ar variations
59are specified as +name, which indicates the variation is desired, and -name, which indicates the
60variation is not desired
61.Sh OPTIONS
62.Bl -tag -width -indent
63.It Fl v
64verbose mode (generate verbose messages)
65.It Fl d
66debug mode (generate debugging messages)
67.It Fl q
68quiet mode (suppress messages)
69.It Fl D
70specify
71.Ar portdir
72.It Fl o
73honor state files older than Portfile
74.El
75.Sh TARGETS
76.Nm
77knows several targets. The most important is the "install" target, which installs the supplied port.
78.Pp
79The other targets are:
80.Pp
81.Dl uninstall
82.Dl clean
83.Dl search
84.Pp
85Besides the main targets
86.Nm
87takes each single stage of the port building process as a possible target. These
88stages (besides "install") are:
89.Pp
90.Dl fetch
91.Dl extract
92.Dl patch
93.Dl configure
94.Dl build
95.Pp
96.Sh EXAMPLES
97Invoking
98.Nm
99with the "install" target on the "vim" port:
100.Pp
101.Dl "port install vim
102.Pp
103To uninstall a port, invoke
104.Nm
105with the "uninstall" target:
106.Pp
107.Dl "port uninstall vim
108.Pp
109To clean up after the port was build:
110.Pp
111.Dl "port clean vim
112.Pp
113Using
114.Nm
115to list all available ports:
116.Pp
117.Dl "port search .+
118.Pp
119To look for a specific port, supply a search string:
120.Pp
121.Dl "port search vim
122.Pp
123The following demonstrates invoking
124.Nm
125with the "extract" target on portdir "textproc/figlet" and extract.sufx set to ".tgz":
126.Pp
127.Dl "port extract -d textproc/figlet extract.sufx=.tgz"
128.Pp
129.Sh DIAGNOSTICS
130.Ex -std
131.Sh AUTHORS
132.An Landon Fuller Aq landonf@opendarwin.org
133.An Kevin Van Vechten Aq kevin@opendarwin.org
134.An Jordan K. Hubbard Aq jkh@opendarwin.org
Note: See TracBrowser for help on using the repository browser.