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

[andrew.cagney%gmail.com@localhost]

>Number:         57572
>Category:       pkg
>Synopsis:       documentation of sort order of foo-1.0nb1 vs foo-1.0pre202308008 for instance
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Aug 07 23:15:00 +0000 2023
>Originator:     Andrew
>Release:        pkgsrc-2023Q2
>Organization:
>Environment:
$ uname -a
NetBSD arm64 10.0_BETA NetBSD 10.0_BETA (GENERIC64) #1: Sat Jul  1 11:46:10 EDT 2023  cagney@fedora:/home/cagney/netbsd-build/10/evbarm64/sys/arch/evbarm/compile/GENERIC64 evbarm

>Description:
From IRC (much thanks for the help) I've found out that pkgsrc has some special tokens when sorting names.  For instance:

   foo-1.0pre1 < foo-1.0 < foo-1.0nb1

I believe.  I couldn't find anything in the documentation though.  For instance around where PKGNAME and DISTNAME are described.  Could this be added?  Even if it is a reference to the code as that contains the definitive sort order.

>How-To-Repeat:

>Fix: