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

Previous Next

Full log

Message #8 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: 6018 <at> debbugs.gnu.org
Subject: Re: bug#6018: 23.1.96; doc of version(-list)*
Date: Fri, 23 Apr 2010 23:39:10 +0300

> From: "Drew Adams" <drew.adams <at> oracle.com>
> Date: Fri, 23 Apr 2010 12:04:59 -0700
> Cc: 
> 
> There is no explanation (spec) of the elements in the *-list functions.

They are internal functions.  Perhaps we should say that explicitly in
the doc strings.

The doc strings that should be reviewed are those for version<,
version=, and version<=.  They are the ``entry points'' to this group
of functions.  The rest are internal subroutines.

> There is a little more info in the doc strings of `version-regexp-alist'
> and `version-to-list', but again, there are only examples, no
> explanation.  Please describe the _mapping_ between parts of version
> strings (e.g. the sub regexps "pre", "beta", "alpha" etc.) and negative
> integers as list elements.

What description is needed, given that you can see the value?

Previous Next

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