Subject: Re: bug#79128: 31.0.50; shortdoc doesn't always display the correct arglist

From: Robert Pluim <[email-masked]>
Date: Tue, 05 Aug 2025 09:41:48 +0200

>>>>> On Mon, 04 Aug 2025 16:10:09 -0400, Stefan Monnier <[email-masked]> said:

    >> which is defined as:
    >> 
    >> (cl-defgeneric seq-concatenate (type &rest sequences)
    >> "Concatenate SEQUENCES into a single sequence of type TYPE.
    >> TYPE must be one of following symbols: `vector', `string' or `list'.
    >> 
    >> \n(fn TYPE SEQUENCE...)"
    >> 
    >> The signature is correct, but doesnʼt obey the "(fn" thing, nor does
    >> it preserve the argument names.

    Stefan> The (fn TYPE SEQUENCE...) syntax is not a "proper" formal arglist, so
    Stefan> `help-function-arglist` explicitly rejects it.  I'd just delete the
    Stefan> `\n(fn TYPE SEQUENCE...)` from the docstring.

That format is very common though, so I donʼt think Iʼll be wholesale
deleting those.

Your patch is good to go as far as Iʼm concerned.

Robert
--