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

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

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

File size: 2.7 KB
Line 
1'\" t
2.TH "PORT\-SYNC" "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-sync \- Update the port definition files
24.SH "SYNOPSIS"
25.sp
26.nf
27\fBport\fR [\fB\-qvd\fR] \fBsync\fR
28.fi
29.SH "DESCRIPTION"
30.sp
31\fBport sync\fR updates the local port definitions (the so\-called ports tree) to the latest state so you have the latest versions of ports available\&. You should normally not run \fBport sync\fR directly, but use \fBport selfupdate\fR, which updates MacPorts itself and then proceeds to do the same operation as \fBsync\fR does\&. You can, however, use \fBport sync\fR if you know that \fBselfupdate\fR does not work on your system or in your network environment, for example because your network administrator blocks outbound rsync connections and you have changed your \fBsources.conf\fR(5) to use a different method of obtaining the ports tree\&.
32.sp
33Running \fBsync\fR is required to get updated software with bug fixes and new features\&.
34.if n \{\
35.sp
36.\}
37.RS 4
38.it 1 an-trap
39.nr an-no-space-flag 1
40.nr an-break-flag 1
41.br
42.ps +1
43\fBWarning\fR
44.ps -1
45.br
46.sp
47When you use \fBport sync\fR, it is your responsibility to check whether new updates are available for MacPorts itself, and update them, when necessary\&. The MacPorts project will start to use new features in port definitions one week after the release of the new version, and you may run into problems when your MacPorts version has not been updated\&.
48.sp .5v
49.RE
50.SH "GLOBAL OPTIONS"
51.sp
52Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
53.PP
54\fB\-q\fR
55.RS 4
56Supress status output, be as silent as possible\&.
57.RE
58.SH "SEE ALSO"
59.sp
60\fBport\fR(1), \fBport-selfupdate\fR(1)
61.SH "AUTHORS"
62.sp
63.if n \{\
64.RS 4
65.\}
66.nf
67(C) 2015 The MacPorts Project
68Clemens Lang <cal@macports\&.org>
69.fi
70.if n \{\
71.RE
72.\}
Note: See TracBrowser for help on using the repository browser.