Hi,

It comes back every now and then. Do below sentences make sense?




Index: ./share/man/man7/packages-specs.7
===================================================================
RCS file: /cvs/src/share/man/man7/packages-specs.7,v
retrieving revision 1.24
diff -u -r1.24 packages-specs.7
--- ./share/man/man7/packages-specs.7   12 Oct 2012 16:17:02 -0000      1.24
+++ ./share/man/man7/packages-specs.7   2 Dec 2013 18:07:47 -0000
@@ -145,11 +145,21 @@
 .El
 .Pp
 In some rare cases, version numbering changes completely upstream.
-A version style marker, of the form
+A version style marker called epoch, of the form
 .Sq v0 ,
 .Sq v1 ...
 can be appended to the version number (after the patch level)
 to denote the new numbering scheme.
+Anything with
+.Sq v0
+is more recent than anything without it.
+Epoch marker is bumped only when version number goes backward,
+and is needed for the package tools to know that package should be updated,
+even if the version number is lower.
+Once added to the package it can never go away nor be bumped down.
+Besides using epoch marker when upstream changes numbering scheme,
+it can also be used when package needs to be rolled back to older upstream
+version.
 See
 .Ev EPOCH
 in
@@ -257,7 +267,7 @@
 .Pp
 If the flavor specification is left blank, any flavor will do.
 Note that most default package names don't contain flavor specification,
-which means that any flavor will do
+which means that any flavor will do.
 For instance, in
 .Bd -literal -offset indent
 LIB_DEPENDS = graphics/aalib


-- 
best regards
q#

Reply via email to