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

[Ryan Schmidt]

> On Aug 14, 2014, at 5:10 PM, cal at macports.org wrote:
> 
> Revision
> 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
> Diff
> 
> Copied: trunk/base/doc/port-distcheck.1.txt (from rev 123812, trunk/base/doc/port-dir.1.txt) (0 => 123826)
> 
> --- 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.

Should be "checks" (not "check"), to match "downloads".


> +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].

Yeah but then it would have to download the entire file. mtime and size can be verified just by checking the HTTP headers.


> +Meanwhile, you can use
> +
> http://trac.macports.org/browser/contrib/port-checkmirrors[port-checkmirrors]
> +from contrib to do that.

Should use https URL here.

I saw earlier a "guide:" "protocol" for referring to guide pages. Is there no equivalent for referring to Trac URLs?