* bug#53720: Documentation for emacs-version
@ 2022-02-02 10:03 goncholden via Bug reports for GNU Emacs, the Swiss army knife of text editors
2022-02-02 17:40 ` Eli Zaretskii
0 siblings, 1 reply; 2+ messages in thread
From: goncholden via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-02-02 10:03 UTC (permalink / raw)
To: drew.adams, 53720
‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐
On Tuesday, February 1st, 2022 at 5:49 PM, Drew Adams <drew.adams@oracle.com> wrote:
> I am looking up documentation for emacs-version. But cannot understand the
>
> meaning of
>
> If optional argument HERE is non-nil, insert string at point.
>
> Doc:
>
> (emacs-version &optional HERE)
>
> Probably introduced at or before Emacs version 19.20.
>
> Return string describing the version of Emacs that is running.
>
> If optional argument HERE is non-nil, insert string at point.
This is the doc string for Emacs 27.2 (the latest release):
Return string describing the version of Emacs that is running.
If optional argument HERE is non-nil, insert string at point.
Don’t use this function in programs to choose actions according
to the system configuration; look at ‘system-configuration’ instead.
But it's still a poor doc string. It should, first
of all, describe the interactive use. It should say:
With a prefix argument, insert string at point.
^^^^^^^^^^^^^^^^^^^^^^
Only after that interactive description should it
give the Emacs-Lisp description of argument HERE:
When called from Lisp, optional argument HERE
corresponds to the prefix argument.
Consider filing a (doc) bug report for this:
`M-x report-emacs-bug'.
^ permalink raw reply [flat|nested] 2+ messages in thread
* bug#53720: Documentation for emacs-version
2022-02-02 10:03 bug#53720: Documentation for emacs-version goncholden via Bug reports for GNU Emacs, the Swiss army knife of text editors
@ 2022-02-02 17:40 ` Eli Zaretskii
0 siblings, 0 replies; 2+ messages in thread
From: Eli Zaretskii @ 2022-02-02 17:40 UTC (permalink / raw)
To: goncholden; +Cc: 53720-done
> Date: Wed, 02 Feb 2022 10:03:29 +0000
> From: goncholden via "Bug reports for GNU Emacs,
> the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
>
> > (emacs-version &optional HERE)
> > Probably introduced at or before Emacs version 19.20.
> > Return string describing the version of Emacs that is running.
> > If optional argument HERE is non-nil, insert string at point.
>
> This is the doc string for Emacs 27.2 (the latest release):
>
> Return string describing the version of Emacs that is running.
> If optional argument HERE is non-nil, insert string at point.
> Don’t use this function in programs to choose actions according
> to the system configuration; look at ‘system-configuration’ instead.
> But it's still a poor doc string. It should, first
> of all, describe the interactive use. It should say:
> With a prefix argument, insert string at point.
> ^^^^^^^^^^^^^^^^^^^^^^
> Only after that interactive description should it
> give the Emacs-Lisp description of argument HERE:
> When called from Lisp, optional argument HERE
> corresponds to the prefix argument.
> Consider filing a (doc) bug report for this:
> `M-x report-emacs-bug'.
Thanks, I fixed the wording of the doc string.
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2022-02-02 17:40 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-02-02 10:03 bug#53720: Documentation for emacs-version goncholden via Bug reports for GNU Emacs, the Swiss army knife of text editors
2022-02-02 17:40 ` Eli Zaretskii
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).