The request here is for the algorithm used by 'version-sort'
be included in sort's manpage. This should document
sort's features for reference and use by users who are using
the utility in its native, cmd-line environment.
If a coreutils' program implements a known standard,
it's not necessarily beneficial to include implementation details of
the standard, as this is available elsewhere.
For example, the manual for the "base64" program does not include
an explanation of what base64 is. Instead, it links to RFC4648:
https://www.gnu.org/software/coreutils/manual/html_node/base64-
invocation.html#base64-invocation
As your request is for a change in documentation, I'm marking this
as a wish-list item.
As always, concrete patches are welcomed and they go a long way towards
expediting any desired changes - if you have suggestions please do send
a patch.
Also of importance: that the documentation should be include with the
source and installable with the program executable.
When someone downloads coreutils' source, they automatically get
the manual (in texinfo format, easily convertible to HTML/PDF).
When they install coreutils (e.g. "make install"), the manual
is also installed (as an "info" file).
regards,
- assaf