GNU bug report logs - #35433
27.0.50; 'function' docstring: tell more about advantages?

Previous Next

Package: emacs;

Reported by: Michael Heerdegen <michael_heerdegen <at> web.de>

Date: Fri, 26 Apr 2019 03:41:01 UTC

Severity: wishlist

Found in version 27.0.50

Done: Michael Heerdegen <michael_heerdegen <at> web.de>

Bug is archived. No further changes may be made.

Full log

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

From: Michael Heerdegen <michael_heerdegen <at> web.de>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 35433 <at> debbugs.gnu.org
Subject: Re: bug#35433: 27.0.50;
 'function' docstring: tell more about advantages?
Date: Sat, 27 Apr 2019 10:30:28 +0200

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

> I think these details belong first and foremost to the ELisp manual.
> We could also add a shortened version to the doc string, but I'd like
> first to see the full version in the manual.

Maybe we could just change the wording in the docstring to something
like

  "In byte compilation, `function' causes its argument to be handled by
  the by compiler."

and tell the rest in the manual.  Currently it only says "compiling the
argument" which only covers the lambda-form case, and this is even the
less interesting case, because lambda function-quotes itself nowadays.

Michael.
This bug report was last modified 6 years ago.

Previous Next

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