GNU bug report logs - #79128
31.0.50; shortdoc doesn't always display the correct arglist

Previous Next

Package: emacs;

Reported by: Robert Pluim <rpluim <at> gmail.com>

Date: Wed, 30 Jul 2025 13:27:02 UTC

Severity: normal

Found in version 31.0.50

Done: Eli Zaretskii <eliz <at> gnu.org>

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Robert Pluim <rpluim <at> gmail.com>
Subject: bug#79128: closed (Re: bug#79128: 31.0.50; shortdoc doesn't
 always display the correct arglist)
Date: Sat, 09 Aug 2025 12:47:02 +0000
[Message part 1 (text/plain, inline)]
Your bug report

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

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 79128 <at> debbugs.gnu.org.

-- 
79128: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=79128
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: 79128-done <at> debbugs.gnu.org, rpluim <at> gmail.com
Subject: Re: bug#79128: 31.0.50; shortdoc doesn't always display the correct
 arglist
Date: Sat, 09 Aug 2025 15:46:29 +0300
> From: Stefan Monnier <monnier <at> iro.umontreal.ca>
> Cc: Eli Zaretskii <eliz <at> gnu.org>,  79128 <at> debbugs.gnu.org
> Date: Thu, 07 Aug 2025 13:50:50 -0400
> 
> >>>>>> On Sat, 02 Aug 2025 15:35:44 -0400, Stefan Monnier <monnier <at> iro.umontreal.ca> said:
> >     >>> >> (seq-empty-p arg &rest args)
> >     Stefan> Hmm... I suggest the patch below.
> > That fixes `seq-empty-p',
> 
> Thanks, pushed to `master.

Thanks, closing.

[Message part 3 (message/rfc822, inline)]
From: Robert Pluim <rpluim <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 31.0.50; shortdoc doesn't always display the correct arglist
Date: Wed, 30 Jul 2025 15:26:08 +0200
emacs -Q
(require 'shortdoc)
(shortdoc 'sequence)

The entry for e.g. `seq-empty-p' says:

    (seq-empty-p arg &rest args)
      Return non-nil if the SEQUENCE is empty, nil otherwise.
      (seq-empty-p [])
        ⇒ t

But C-h f seq-empty-p says:

    seq-empty-p is a byte-code-function in ‘seq.el’.

    (seq-empty-p SEQUENCE)

    Return non-nil if the SEQUENCE is empty, nil otherwise.

      Other relevant functions are documented in the sequence group.


    This is a generic function.

    Implementations:

    (seq-empty-p (LIST list)) in ‘seq.el’.

    Optimized implementation of ‘seq-empty-p’ for lists.

    (seq-empty-p SEQUENCE) in ‘seq.el’.

    Undocumented

I imagine this is some interaction between `cl-defgeneric' with an
implementation body, `cl-defmethod', and `help-function-arglist' (other
functions in  the 'sequence group are also affected). C-h f gets it
right, but I couldnʼt find a simple function in help-fns.el to get me
the actual arglist.

Robert

In GNU Emacs 31.0.50 (build 61, x86_64-pc-linux-gnu, X toolkit, cairo
 version 1.16.0) of 2025-07-28 built on rltb
Repository revision: d895d8d06e54ec741d495d23b7cdedf978f85da8
Repository branch: master
System Description: Debian GNU/Linux 12 (bookworm)

Configured using:
 'configure --without-toolkit-scroll-bars --with-x-toolkit=lucid
 --with-xinput2 'CFLAGS=-Og -ggdb''



This bug report was last modified 7 days ago.

Previous Next


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