bug#6018: 23.1.96; doc of version(-list)*

[Eli Zaretskii]

> From: "Drew Adams" <drew.adams@oracle.com>
> Cc: <cyd@stupidchicken.com>, <larsi@gnus.org>, <6018@debbugs.gnu.org>
> Date: Thu, 14 Jul 2011 07:05:57 -0700
> 
> > And version-regexp-alist is itself an internal variable, so this is
> > not an evidence to the effect you want it to be.  The doc string of
> > version-regexp-alist is for developers of this group of functions, not
> > for users of their advertised APIs.
> 
> Really?  What about these parts of the doc string of `version-to-list':

Irrelevant, see below.

> Or are you now claiming that `version-to-list' is also internal, like you
> claimed for `version-list*'?

Of course!

> > > > nothing is said about the comparison of strings with digits
> > > > other than zero. And that's arguably the most important and
> > > > most up for grabs.
> > 
> > You mean, it isn't obviously clear that 3 is greater than 2 and less
> > than 4?  It needs to be documented in a doc string?
> 
> A digit is not a string of digits.  And as you know full well (or should 
> know),
> there are various ways to order strings of digits.

But the default (and TRT) order is well known, especially in the
context of version numbers.  They are called "numbers" for a reason.

> How are strings containing digits compared?

As one expects.  We don't document where Sun rises this morning,
either.

> What about case sensitivity?

Ditto.

> Does `case-fold-search' affect that or not?

Ditto.