GNU bug report logs - #24222
24.5; Elisp `Standard Errors' and `Classifying Lists'

Previous Next

Full log

Message #13 received at 24222-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 24222-done <at> debbugs.gnu.org
Subject: Re: bug#24222: 24.5; Elisp `Standard Errors' and `Classifying Lists'
Date: Sat, 08 Oct 2016 17:21:37 +0300

> Date: Sat, 13 Aug 2016 19:37:57 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> `wrong-number-of-arguments' is an index entry, with target node `Argument List'.  Perhaps that would be a better target in `Standard Errors', instead of `Classifying Lists'.

I couldn't find a better place for this index entry.  Instead, I added
a cross-reference to "Standard Errors".

> In node `Standard Errors', for error `wrong-number-of-arguments', the only description is "See Classifying Lists."  OK, so we click that link to find out what this error type means...
> 
> Node `Classifying Lists' we see some odd introductory text telling us to expect that "below" (in this node, presumably, as that is all we see at this point) we will find descriptions of the three kinds of forms (function call, macro call, special form).
> 
> But there are no such descriptions.  Huh?
> 
> And just where do we find a description of a `wrong-number-of-arguments'
> error?
> 
> This doc bug is _very_ old, dating back to at least Emacs 20.

I changed the cross-reference to go to Argument List" instead.

Previous Next

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