[123826] trunk/base/doc/port-distcheck.1.txt

[cal at macports.org]

Revision: 123826
          https://trac.macports.org/changeset/123826
Author:   cal at macports.org
Date:     2014-08-14 15:10:27 -0700 (Thu, 14 Aug 2014)
Log Message:
-----------
base: document port-distcheck, #44530

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

Copied: trunk/base/doc/port-distcheck.1.txt (from rev 123812, trunk/base/doc/port-dir.1.txt)
===================================================================
--- trunk/base/doc/port-distcheck.1.txt	                        (rev 0)
+++ trunk/base/doc/port-distcheck.1.txt	2014-08-14 22:10:27 UTC (rev 123826)
@@ -0,0 +1,46 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-deps(1)
+============
+$Id$
+
+NAME
+----
+port-distcheck - Check if a port can be fetched from all of its mirrors
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* [*-qvdy*] [*-D* 'portdir'] *distcheck*
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+
+DESCRIPTION
+-----------
+*port distcheck* downloads all source files for a given port from all available
+mirrors (including MacPorts' 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.
+
+Distcheck can be switched to verify the file size of the downloaded files
+instead by setting the 'distcheck.type' option to 'filesize' in the Portfile for
+the tested port.
+
+BUGS
+----
+*port distcheck* 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 man:port-checksum[1].
+
+Meanwhile, you can use
+http://trac.macports.org/browser/contrib/port-checkmirrors[port-checkmirrors]
+from contrib to do that.
+
+include::global-flags.txt[]
+
+SEE ALSO
+--------
+man:port[1], man:port-checksum[1]
+
+AUTHORS
+-------
+ (C) 2014 The MacPorts Project
+ Clemens Lang <cal at macports.org>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20140814/4bec1d38/attachment.html>