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

From: Chong Yidong <[email-masked]>
Date: Wed, 13 Jul 2011 22:04:39 -0400

"Drew Adams" <[email-masked]> writes:

>> The doc strings to these functions look fine to me, so I'm closing
>> this report.
>
> AFAICT, none of the questions raised here have been answered, and the
> original bug is still there.
>
>
> The doc string of `version-regexp-alist' refers to the
> `version-list-*' functions, saying to consult their doc, so they
> cannot be said be "internal".
>
> And the doc string of `version-to-list' refers to that of
> `version-regexp-alist'.
>
> Nothing has been specified (no mapping), to help an Emacs-Lisp
> programmer use these various functions.

Really?  I looked again at the docstrings of version-to-list and
version-regexp-alist, and it seems pretty clear to me.  Even if an Emacs
Lisp programmer is ignorant of what an EBNF is, it's pretty obvious from
the context what the docstring is talking about.

You have to be more specific about what's confusing you.