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

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

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.