Re: pkg/57572: documentation of sort order of foo-1.0nb1 vs foo-1.0pre202308008 for instance

[Andrew Cagney <andrew.cagney%gmail.com@localhost>]

The following reply was made to PR pkg/57572; it has been noted by GNATS.

From: Andrew Cagney <andrew.cagney%gmail.com@localhost>
To: gnats-bugs%netbsd.org@localhost
Cc: pkg-manager%netbsd.org@localhost, gnats-admin%netbsd.org@localhost, pkgsrc-bugs%netbsd.org@localhost
Subject: Re: pkg/57572: documentation of sort order of foo-1.0nb1 vs
 foo-1.0pre202308008 for instance
Date: Wed, 9 Aug 2023 21:56:34 -0400

 On Wed, 9 Aug 2023 at 19:10, David H. Gutteridge <david%gutteridge.ca@localhost> wrote:
 >
 > The following reply was made to PR pkg/57572; it has been noted by GNATS.
 >
 > From: "David H. Gutteridge" <david%gutteridge.ca@localhost>
 > To: gnats-bugs%netbsd.org@localhost
 > Cc:
 > Subject: Re: pkg/57572: documentation of sort order of foo-1.0nb1 vs
 >  foo-1.0pre202308008 for instance
 > Date: Wed, 09 Aug 2023 19:09:16 -0400
 >
 >  > It and `pkg_admin` help.  With those I came up with
 >  > foo-5.0pre0.20230808
 >  > (pre0 leaves space for more official rc1)  So a pointer to either of
 >  > those
 >  > from the guide would be just as useful.  Also some guidance on what is
 >  > considered best practice.
 >
 >  It's unclear from this ticket what sort of guidance you're seeking?
 >  (This to me is a somewhat obscure question I'm not sure would normally
 >  be addressed in the guide.)
 
 Naming a snapshot or a pre-release in a way that doesn't trump the
 official release is a common problem and something easy to screw up.
 It turns out I do this using  "pre" or "rc",  but this isn't mentioned
 in the guide.
 
 To me that is a gap.  There should minimally be something mentioning
 that "pre", et.al. exist (and point to pkg_info for more information),
 and preferably an example of how the pkgsrc maintainers think they
 should be used.