[123827] trunk/base/doc

[cal at macports.org]

Revision: 123827
          https://trac.macports.org/changeset/123827
Author:   cal at macports.org
Date:     2014-08-14 15:11:09 -0700 (Thu, 14 Aug 2014)
Log Message:
-----------
base: (re-)generate roff from asciidoc sources, enable port-distcheck manpage

Modified Paths:
--------------
    trunk/base/doc/Makefile.in
    trunk/base/doc/port-activate.1
    trunk/base/doc/port-dir.1

Added Paths:
-----------
    trunk/base/doc/port-distcheck.1

Modified: trunk/base/doc/Makefile.in
===================================================================
--- trunk/base/doc/Makefile.in	2014-08-14 22:10:27 UTC (rev 123826)
+++ trunk/base/doc/Makefile.in	2014-08-14 22:11:09 UTC (rev 123827)
@@ -31,6 +31,7 @@
 		port-deps.1 \
 		port-destroot.1 \
 		port-dir.1 \
+		port-distcheck.1 \
 		port-edit.1 \
 		port-extract.1 \
 		port-fetch.1 \

Modified: trunk/base/doc/port-activate.1
===================================================================
--- trunk/base/doc/port-activate.1	2014-08-14 22:10:27 UTC (rev 123826)
+++ trunk/base/doc/port-activate.1	2014-08-14 22:11:09 UTC (rev 123827)
@@ -1,5 +1,5 @@
 '\" t
-.TH "PORT\-ACTIVATE" "1" "2014\-08\-03" "MacPorts 2\&.3\&.99" "MacPorts Manual"
+.TH "PORT\-ACTIVATE" "1" "2014\-08\-14" "MacPorts 2\&.3\&.99" "MacPorts Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

Modified: trunk/base/doc/port-dir.1
===================================================================
--- trunk/base/doc/port-dir.1	2014-08-14 22:10:27 UTC (rev 123826)
+++ trunk/base/doc/port-dir.1	2014-08-14 22:11:09 UTC (rev 123827)
@@ -1,5 +1,5 @@
 '\" t
-.TH "PORT\-DEPS" "1" "2014\-08\-14" "MacPorts 2\&.3\&.99" "MacPorts Manual"
+.TH "PORT\-DIR" "1" "2014\-08\-14" "MacPorts 2\&.3\&.99" "MacPorts Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

Added: trunk/base/doc/port-distcheck.1
===================================================================
--- trunk/base/doc/port-distcheck.1	                        (rev 0)
+++ trunk/base/doc/port-distcheck.1	2014-08-14 22:11:09 UTC (rev 123827)
@@ -0,0 +1,63 @@
+'\" t
+.TH "PORT\-DEPS" "1" "2014\-08\-14" "MacPorts 2\&.3\&.99" "MacPorts Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+port-distcheck \- Check if a port can be fetched from all of its mirrors
+.SH "SYNOPSIS"
+.sp
+.nf
+\fBport\fR [\fB\-qvdy\fR] [\fB\-D\fR \fIportdir\fR] \fBdistcheck\fR
+     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
+.fi
+.SH "DESCRIPTION"
+.sp
+\fBport distcheck\fR downloads all source files for a given port from all available mirrors (including MacPorts\*(Aq mirror infrastructure) and check that the modification date of the file on the mirror is not more recent than the modification date of the Portfile\&.
+.sp
+Distcheck can be switched to verify the file size of the downloaded files instead by setting the \fIdistcheck\&.type\fR option to \fIfilesize\fR in the Portfile for the tested port\&.
+.SH "BUGS"
+.sp
+\fBport distcheck\fR should not rely on timestamps or file sizes but use the checksums available in the Portfile to verify the integrity of the files on the mirrors instead\&. See \fBport-checksum\fR(1)\&.
+.sp
+Meanwhile, you can use \m[blue]\fBport\-checkmirrors\fR\m[]\&\s-2\u[1]\d\s+2 from contrib to do that\&.
+.SH "GLOBAL OPTIONS"
+.sp
+Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
+.SH "SEE ALSO"
+.sp
+\fBport\fR(1), \fBport-checksum\fR(1)
+.SH "AUTHORS"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(C) 2014 The MacPorts Project
+Clemens Lang <cal at macports\&.org>
+.fi
+.if n \{\
+.RE
+.\}
+.SH "EXTERNAL REFERENCES"
+.IP " 1." 4
+port-checkmirrors
+.RS 4
+\%http://trac.macports.org/browser/contrib/port-checkmirrors
+.RE
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20140814/dddfe2b6/attachment.html>