Revision: 86705 http://trac.macports.org/changeset/86705 Author: ryandesign@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.