GNU bug report logs - #6018
23.1.96; doc of version(-list)*

Previous Next

Full log

Message #40 received at 6018 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: cyd <at> stupidchicken.com, 6018 <at> debbugs.gnu.org, larsi <at> gnus.org
Subject: Re: bug#6018: 23.1.96; doc of version(-list)*
Date: Thu, 14 Jul 2011 18:58:13 +0300

> From: "Drew Adams" <drew.adams <at> oracle.com>
> Cc: <cyd <at> stupidchicken.com>, <larsi <at> gnus.org>, <6018 <at> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.