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

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Fri, 23 Apr 2010 19:06:01 UTC

Severity: minor

Tags: wontfix

Done: Lars Magne Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log

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

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 'Lars Magne Ingebrigtsen' <larsi <at> gnus.org>, 6018 <at> debbugs.gnu.org,
	'Eli Zaretskii' <eliz <at> gnu.org>
Subject: Re: bug#6018: 23.1.96; doc of version(-list)*
Date: Sat, 16 Jul 2011 14:42:14 -0400

> 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".

"internal" means you shouldn't call them or rely on their existence.
It doesn't mean "we want to hide them as much as possible".

But just like the code of version-<foo> can call those internal
functions, their docstrings can refer to those internal functions's
docstrings (as long as those references are kept uptodate when the
internal functions change, of course).


        Stefan
This bug report was last modified 13 years and 168 days ago.

Previous Next

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