GNU bug report logs - #38158
26.3; Function usage in docstring not documented

Previous Next

Package: emacs;

Reported by: Allen Li <darkfeline <at> felesatra.moe>

Date: Sun, 10 Nov 2019 09:49:01 UTC

Severity: normal

Found in version 26.3

Done: Allen Li <darkfeline <at> felesatra.moe>

Bug is archived. No further changes may be made.

Full log


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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Allen Li <darkfeline <at> felesatra.moe>
Cc: 38158 <at> debbugs.gnu.org
Subject: Re: bug#38158: 26.3; Function usage in docstring not documented
Date: Thu, 14 Nov 2019 11:51:44 +0200
> From: Allen Li <darkfeline <at> felesatra.moe>
> Date: Sun, 10 Nov 2019 12:11:49 +0000
> 
> On Sun, Nov 10, 2019 at 9:48 AM Allen Li <darkfeline <at> felesatra.moe> wrote:
> >
> > It is not documented in the Elisp info manual that a function docstring
> > ending with:
> >
> > \(fn SOME ARGS)
> >
> > will have a custom usage displayed by `describe-function'.
> >
> > It seems useful to document this.
> 
> Never mind, I found this documented under Function Documentation.  I
> somehow missed it the first time C-sing in the manual.

Can you describe how you looked for this?  Did you use the 'i' command
in Info?  It's possible that we need to improve the indexing.




This bug report was last modified 5 years and 185 days ago.

Previous Next


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