bug#24222: 24.5; Elisp `Standard Errors' and `Classifying Lists'

bug#24222: 24.5; Elisp `Standard Errors' and `Classifying Lists'

[Drew Adams]

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.


In GNU Emacs 24.5.1 (i686-pc-mingw32)
 of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr --host=i686-pc-mingw32'

bug#24222: 24.5; Elisp `Standard Errors' and `Classifying Lists'

[Drew Adams]

`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'.

bug#24222: 24.5; Elisp `Standard Errors' and `Classifying Lists'

[Eli Zaretskii]

> Date: Sat, 13 Aug 2016 19:37:57 -0700 (PDT)
> From: Drew Adams <drew.adams@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.