GNU bug report logs - #77124
[PATCH] Optionally display function docstring in eldoc

Previous Next

Full log

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Elijah Gabe Pérez <eg642616 <at> gmail.com>
Cc: 77124 <at> debbugs.gnu.org
Subject: Re: bug#77124: [PATCH] Optionally display function docstring in eldoc
Date: Thu, 20 Mar 2025 14:25:45 +0200

> From: Elijah Gabe Pérez <eg642616 <at> gmail.com>
> Date: Wed, 19 Mar 2025 12:32:15 -0600
> 
> This user option tell whether 'eldoc' should display elisp function docstring.
> If set to 'short' only display a short docstring, otherwise if set to
> 'full', display full docstring.
> If set to nil do not show function docstring.

Where will the doc string be shown?

If in the echo-area, then what will happen when eldoc shows the info
on the mode line instead?

> +(defcustom elisp-eldoc-show-function-docstring nil
> +  "Show function docstring in `eldoc-mode'.
> +If set to `short' only display a short docstring, otherwise if set to
> +`full', display full docstring.

This should explain what is the "short docstring".  Also, where the
documentation is shown.

> +If set to nil do not show function docstring."
> +  :type '(choice
> +          (const :tag "None")
> +          (const :tag "Short" short)
> +          (const :tag "Full" full))
> +  :group 'elisp)

The :version tag is missing.

Thanks.

P.S. For the next version of the patch, please remember mentioning the
bug number in the commit log message.

Previous Next

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