Skip to content

Commit

Permalink
doc: Re-generate manpages
Browse files Browse the repository at this point in the history
  • Loading branch information
neverpanic committed Jun 6, 2020
1 parent 53bac7b commit 4fdcf6f
Show file tree
Hide file tree
Showing 2 changed files with 71 additions and 19 deletions.
65 changes: 58 additions & 7 deletions doc/macports.conf.5
Original file line number Diff line number Diff line change
Expand Up @@ -436,39 +436,90 @@ T}
.sp 1
.RE
.PP
rsync_server
release_version_url
.RS 4
Default rsync server to connect to when running "selfupdate" through the port com\- mand to update your base MacPorts infrastructure\&. While selfupdate also syncs the ports tree, it uses the settings from ${sources_conf} to do so\&.
URL that MacPorts attempts to download to find out whether a new version was released\&. Can be specified multiple times; only one of the URLs needs to be available\&. Downloads will be attempted in the specified order\&.
.TS
tab(:);
lt lt.
T{
\fBDefault:\fR
T}:T{
rsync\&.macports\&.org
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\m[blue]\fBhttps://raw\&.githubusercontent\&.com/macports/macports\-base/master/config/RELEASE_URL\fR\m[]
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\m[blue]\fBhttps://trac\&.macports\&.org/export/HEAD/macports\-base/config/RELEASE_URL\fR\m[]
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\m[blue]\fBhttps://distfiles\&.macports\&.org/MacPorts/RELEASE_URL\fR\m[]
.RE
.sp
T}
.TE
.sp 1
.RE
.PP
rsync_dir
release_url
.RS 4
Rsync directory from which to pull MacPorts sources from the rsync server\&.
URL where MacPorts will download a new source code archive, if the release_version_url indicates that the current version needs to be updated\&. In this URL,
\fB{version}\fR
will be replaced with the version number determined from release_version_url\&.

Additionally, "\&.sig" will be appended to this URL, downloaded, and used to verify a signature made with one of the keys in
\fB$prefix/share/macports/keys/base/\fR
using the signify(1) utility\&.

The list of distfile mirrors will automatically be appended to this option\&.
.TS
tab(:);
lt lt.
T{
\fBDefault:\fR
T}:T{
macports/release/base/ (which pulls sources for the currently shipping MacPorts release)
\fBhttps://github\&.com/macports/macports\-base/releases/download/v{version}/MacPorts\-{version}\&.tar\&.bz2\fR
T}
.TE
.sp 1
.RE
.PP
rsync_server
.RS 4
Obsolete\&. Remove this from your configuration\&.
.RE
.PP
rsync_dir
.RS 4
Obsolete\&. Remove this from your configuration\&.
.RE
.PP
rsync_options
.RS 4
Default rsync options to use when connecting to the rsync server\&.
Default rsync options to use when connecting to the rsync server to sync the ports tree\&.
.TS
tab(:);
lt lt.
Expand Down
25 changes: 13 additions & 12 deletions doc/port-selfupdate.1
Original file line number Diff line number Diff line change
Expand Up @@ -61,11 +61,11 @@ When no new versions are available, \fBselfupdate\fR looks like this:
.\}
.nf
$ sudo port selfupdate
\-\-\-> Updating MacPorts base sources using rsync
\-\-\-> Checking for newer releases of MacPorts
MacPorts base version 2\&.6\&.99 installed,
MacPorts base version 2\&.6\&.99 downloaded\&.
\-\-\-> Updating the ports tree
\-\-\-> MacPorts base is already the latest version
MacPorts base version 2\&.6\&.99 available\&.
\-\-\-> MacPorts base is already the latest version
\-\-\-> Updating the ports tree
.fi
.if n \{\
.RE
Expand All @@ -78,12 +78,13 @@ If \fBselfupdate\fR detects that a newer version of MacPorts is available, it at
.\}
.nf
$ sudo port selfupdate
\-\-\-> Updating MacPorts base sources using rsync
MacPorts base version 2\&.3\&.0 installed,
MacPorts base version 2\&.6\&.99 downloaded\&.
\-\-\-> Updating the ports tree
\-\-\-> MacPorts base is outdated, installing new version 2\&.6\&.99
Installing new MacPorts release in /opt/local as root:admin; permissions 755
\-\-\-> Checking for newer releases of MacPorts
MacPorts base version 2\&.6\&.0 installed,
MacPorts base version 2\&.6\&.99 available\&.
\-\-\-> MacPorts base is outdated, installing new version 2\&.6\&.99
\-\-\-> Attempting to fetch MacPorts 2\&.6\&.99 source code from https://github\&.com/macports/macports\-base/releases/download/v2\&.6\&.99/MacPorts\-2\&.6\&.99\&.tar\&.bz2
\-\-\-> Extracting MacPorts 2\&.6\&.99
\-\-\-> Installing new MacPorts release in /opt/local as root:admin; permissions 0755
.fi
.if n \{\
.RE
Expand All @@ -96,7 +97,7 @@ Network Problems
.RS 4
MacPorts uses the
\fIrsync\fR
protocol to update its sources to the latest version\&. This will fail if you are on a network that blocks TCP connections to the rsync port 873\&. Talk to your network administrators and ask them to allow connections to port 873 if this happens to you\&. Alternatively, you can just download a new installer \&.pkg from macports\&.org and run that to upgrade your installation\&.
protocol to update its ports tree to the latest version\&. This will fail if you are on a network that blocks TCP connections to the rsync port 873\&. Talk to your network administrators and ask them to allow connections to port 873 if this happens to you\&. Alternatively, you can just download a new installer \&.pkg from macports\&.org and run that to upgrade your installation\&.
.sp
Network connection problems might also affect you if you are in a country with US export restrictions\&. We suggest using one of our other
\m[blue]\fBmirrors\fR\m[]\&\s-2\u[1]\d\s+2
Expand Down Expand Up @@ -144,7 +145,7 @@ $ sudo port \-d selfupdate
.RS 4
.\}
.nf
(C) 2014 The MacPorts Project
(C) 2014\-2020 The MacPorts Project
Clemens Lang <cal@macports\&.org>
.fi
.if n \{\
Expand Down

0 comments on commit 4fdcf6f

Please sign in to comment.