GNU bug report logs - #3740
documentation of args to `documentation-property' differ info<-->docstring on 23.0.92.1 thru 23.0.95

Previous Next

Package: emacs;

Reported by: MON KEY <monkey <at> sandpframing.com>

Date: Thu, 2 Jul 2009 18:30:04 UTC

Severity: minor

Tags: wontfix

Merged with 7160

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

Bug is archived. No further changes may be made.

Full log

Message #18 received at 3740 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: martin rudalics <rudalics <at> gmx.at>
To: MON KEY <monkey <at> sandpframing.com>, 3740 <at> debbugs.gnu.org
Subject: Re: bug#3740: documentation of args to `documentation-property' differ
 info<-->docstring on 23.0.92.1 thru 23.0.95
Date: Fri, 03 Jul 2009 08:46:46 +0200

> The discrepancy - however trivial it  may be to _you_ - is none the
> less a discrepancy.
>
> Surely you don't hold this view for _all_ functions.
>
> Should one assume that consistent indication of the args to a function
> is of no importance across the board - or does this apply only for
> this particular inconsistency?

The current Elisp reference manual features more than 500 such
discrepancies.  Most of them would have to be fixed by changing the
specification, not the manual.  Changing the specification means check
for name clashes, reindent code, refill doc-strings and comments,
recompile, rebuild.  Doing this manually would get people busy for quite
some time.

martin
This bug report was last modified 13 years and 329 days ago.

Previous Next

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