[86705] trunk/base/doc/portfile.7

[ryandesign at macports.org]

Revision: 86705
          http://trac.macports.org/changeset/86705
Author:   ryandesign at macports.org
Date:     2011-11-01 08:50:01 -0700 (Tue, 01 Nov 2011)
Log Message:
-----------
portfile.7: rewrite epoch section to remove the implication that using a large epoch value that looks like a date is a good idea

Modified Paths:
--------------
    trunk/base/doc/portfile.7

Modified: trunk/base/doc/portfile.7
===================================================================
--- trunk/base/doc/portfile.7	2011-11-01 15:39:40 UTC (rev 86704)
+++ trunk/base/doc/portfile.7	2011-11-01 15:50:01 UTC (rev 86705)
@@ -84,9 +84,14 @@
 If a port's version numbering changes such that a newer version looks
 older than the previous version, the
 .Ic epoch
-should be increased. Often the
+should be increased. Some
+.Nm Portfile
+authors have used large
 .Ic epoch
-is formatted like a date.
+values that look like a date, but there is no reason to do so. The
+.Ic epoch
+is simply an unsigned integer, and the only requirement is that it never be
+decreased.
 .br
 .Sy Type:
 .Em optional
@@ -95,7 +100,7 @@
 .Em 0
 .br
 .Sy Example:
-.Dl epoch 20041231
+.Dl epoch 1
 .It Ic description
 One line description of the software and what it does.  To appear in the
 description, brackets and semi-colons need to be escaped with a backslash (i.e.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20111101/3106c677/attachment.html>