make some assumptions more explicit, after some confusion...

1 files changed, 18 insertions, 3 deletions

diff --git a/share/man/man7/packages-specs.7 b/share/man/man7/packages-specs.7
index eaaa21e5af5..1450ff82313 100644
--- a/share/man/man7/packages-specs.7
+++ b/share/man/man7/packages-specs.7
@@ -1,4 +1,4 @@
-.\" $OpenBSD: packages-specs.7,v 1.22 2011/11/21 12:36:34 espie Exp $
+.\" $OpenBSD: packages-specs.7,v 1.23 2012/10/12 15:00:25 espie Exp $
 .\"
 .\" Copyright (c) 2001 Marc Espie
 .\"
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: November 21 2011 $
+.Dd $Mdocdate: October 12 2012 $
 .Dt PACKAGES-SPECS 7
 .Os
 .Sh NAME
@@ -52,7 +52,17 @@ part starts at the first digit that follows a
 .Sq - ,
 and goes on up to the following
 .Sq - ,
-or to the end of the package name, if no flavor modifier is present.
+or to the end of the package name, whichever comes first.
+.Pp
+It is followed by the (possibly empty) 
+.Op - Ns Ar flavors
+part.
+.Pp
+Thus, version numbers should always start with a digit and cannot contain
+a
+.Sq - ,
+whereas flavors should never start with a digit.
+.Pp
 All packages must have a version number.
 Normally, the version number directly matches the original software
 distribution version number, or release date.
@@ -80,6 +90,11 @@ Version comparison is done using the dewey notation with a few specific rules.
 .It
 The version number is cut into separate parts on each dot
 .Sq \&. .
+Therefore, replace other upstream separators such as
+.Sq _
+or
+.Sq -
+with dots.
 .It
 Comparison checks each part in turn, the first part that differs yields
 a comparison result.