source: trunk/base/doc/port-upgrade.1 @ 134980

Last change on this file since 134980 was 134973, checked in by cal@…, 4 years ago

base: doc: (re-)generate roff from asciidoc, enable new manpages

File size: 4.3 KB
Line 
1'\" t
2.TH "PORT\-UPGRADE" "1" "2015\-04\-12" "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-upgrade \- Upgrade a port to the latest version
24.SH "SYNOPSIS"
25.sp
26.nf
27\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBupgrade\fR
28     [\-\-enforce\-variants] [\-\-force] [\-\-no\-replace] [\-\-no\-rev\-upgrade]
29     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
30     [+/\-variant \&...]
31.fi
32.SH "DESCRIPTION"
33.sp
34\fBport upgrade\fR will upgrade the given installed ports to the latest available version\&. To upgrade a port, MacPorts needs an updated port definition, which can be obtained using the \fBport-selfupdate\fR(1) command\&. You should regularly run \fBselfupdate\fR followed by \fBupgrade outdated\fR to make sure your system has the latest versions and bug fixes\&.
35.sp
36When specifying variants during upgrade, the order of precedence is
37.sp
38.RS 4
39.ie n \{\
40\h'-04' 1.\h'+01'\c
41.\}
42.el \{\
43.sp -1
44.IP "  1." 4.2
45.\}
46variants specified on the command line
47.RE
48.sp
49.RS 4
50.ie n \{\
51\h'-04' 2.\h'+01'\c
52.\}
53.el \{\
54.sp -1
55.IP "  2." 4.2
56.\}
57variants active in the latest installed version of the port
58.RE
59.sp
60.RS 4
61.ie n \{\
62\h'-04' 3.\h'+01'\c
63.\}
64.el \{\
65.sp -1
66.IP "  3." 4.2
67.\}
68variants specified in
69\fBvariants.conf\fR(5)
70.RE
71.sp
72In most cases, you should specify the \fBoutdated\fR pseudo\-port expression as argument to \fBport upgrade\fR to upgrade all ports where a newer version is available\&. See \fBport\fR(1) for more information on pseudo\-port expressions\&.
73.SH "OPTIONS"
74.PP
75\fB\-\-enforce\-variants\fR
76.RS 4
77Upgrade all given ports and their dependencies where the installed variants do not match those requested on the command line, even if those ports aren\(cqt outdated\&.
78.RE
79.PP
80\fB\-\-force\fR
81.RS 4
82Ignore circumstances that would normally cause ports to be skipped, such as not being outdated\&.
83.RE
84.PP
85\fB\-\-no\-replace\fR
86.RS 4
87Do not automatically install ports that replace a now\-obsolete port you have installed\&.
88.RE
89.PP
90\fB\-\-no\-rev\-upgrade\fR
91.RS 4
92Do not run rev\-upgrade after upgrading\&. See
93\fBport-rev-upgrade\fR(1)
94for more information\&.
95.RE
96.SH "GLOBAL OPTIONS"
97.sp
98Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
99.PP
100\fB\-f\fR
101.RS 4
102Upgrade a port, even if it is not outdated\&.
103.RE
104.PP
105\fB\-n\fR
106.RS 4
107Only upgrade the given ports and avoid upgrading their dependencies\&. This flag may be useful when combined with
108\fB\-\-enforce\-variants\fR\&.
109
110WARNING: Ports expect their dependencies to always be at the latest version, which is why MacPorts upgrades dependencies first\&. Do not specify this flag if you don\(cqt know what you are doing\&.
111.RE
112.PP
113\fB\-p\fR
114.RS 4
115Keep going and attempt to upgrade the next port when a port fails to build\&.
116
117WARNING: This option is harmful to
118\fBupgrade\fR
119and should be avoided at all cost\&. Often, MacPorts ports are only upgraded to rebuild them against updated dependencies\&. Specifying this flag will cause a spurious rebuild if a dependency of a port fails to build and leave your system in a broken state once the dependent port is fixed\&.
120.RE
121.SH "SEE ALSO"
122.sp
123\fBport\fR(1), \fBport-uninstall\fR(1), \fBport-info\fR(1), \fBport-variants\fR(1), \fBport-rev-upgrade\fR(1), \fBport-setrequested\fR(1), \fBvariants.conf\fR(5)
124.SH "AUTHORS"
125.sp
126.if n \{\
127.RS 4
128.\}
129.nf
130(C) 2015 The MacPorts Project
131Clemens Lang <cal@macports\&.org>
132.fi
133.if n \{\
134.RE
135.\}
Note: See TracBrowser for help on using the repository browser.