Modified: trunk/base/doc/portfile.7 (86704 => 86705)

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