Subject: bug#66928: [PATCH 2/2] Update names to match the docstring

From: Stefan Monnier <[email-masked]>
Date: Sun, 05 Nov 2023 09:09:57 -0500

> One question, the elisp manual mentions that the \(fn ARGLIST) facility
> is particularly useful for macros.
>
> Why would we use this for defuns?

We use it for some defuns where ELisp's arglist functionality is not
refined enough to express the intention of the programmer.
For example, the "real" arglist may be

    name args &optional docstring &rest body

but the intended arglist is

    name args [docstring] &rest body

i.e. if `docstring` is not a string it's taken as the first instruction
of `body`.

        Stefan