GNU bug report logs -
#37016
26.2; `pushnew' doc string (minor)
Previous Next
Reported by: Drew Adams <drew.adams <at> oracle.com>
Date: Tue, 13 Aug 2019 04:14:02 UTC
Severity: minor
Tags: fixed
Found in version 26.2
Fixed in version 27.1
Done: Lars Ingebrigtsen <larsi <at> mouse.gnus.org>
Bug is archived. No further changes may be made.
To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 37016 in the body.
You can then email your comments to 37016 AT debbugs.gnu.org in the normal way.
Toggle the display of automated, internal messages from the tracker.
Report forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#37016
; Package
emacs
.
(Tue, 13 Aug 2019 04:14:02 GMT)
Full text and
rfc822 format available.
Acknowledgement sent
to
Drew Adams <drew.adams <at> oracle.com>
:
New bug report received and forwarded. Copy sent to
bug-gnu-emacs <at> gnu.org
.
(Tue, 13 Aug 2019 04:14:02 GMT)
Full text and
rfc822 format available.
Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):
1. Why does the first line of the doc string start with the calling
sequence (it's on the same line as the start of the doc string).
2. The first "sentence" is a bit misleading. It actually says that X is
inserted at the head of the list if it is not already at the head of
the list, which is not right. It should say something like "if not
already in the list", or "if not already a member of the list".
3. The doc string doesn't say what PLACE is, except that you can guess
from the description that it must be a list. To really understand
you need to consult the doc of `push'. The doc of `pushnew' could
say what is said in the doc of `push', without being longer than it
is now.
4. Even the doc string of `push' should say that a _list_ is stored in
PLACE.
http://clhs.lisp.se/Body/m_push.htm
In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32)
of 2019-04-13
Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749
Windowing system distributor `Microsoft Corp.', version 10.0.17763
Configured using:
`configure --without-dbus --host=x86_64-w64-mingw32
--without-compress-install 'CFLAGS=-O2 -static -g3''
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#37016
; Package
emacs
.
(Fri, 23 Aug 2019 04:14:02 GMT)
Full text and
rfc822 format available.
Message #8 received at 37016 <at> debbugs.gnu.org (full text, mbox):
Drew Adams <drew.adams <at> oracle.com> writes:
> 1. Why does the first line of the doc string start with the calling
> sequence (it's on the same line as the start of the doc string).
>
> 2. The first "sentence" is a bit misleading. It actually says that X is
> inserted at the head of the list if it is not already at the head of
> the list, which is not right. It should say something like "if not
> already in the list", or "if not already a member of the list".
>
> 3. The doc string doesn't say what PLACE is, except that you can guess
> from the description that it must be a list. To really understand
> you need to consult the doc of `push'. The doc of `pushnew' could
> say what is said in the doc of `push', without being longer than it
> is now.
>
> 4. Even the doc string of `push' should say that a _list_ is stored in
> PLACE.
I've now clarified the doc string as you suggest on the trunk.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
Added tag(s) fixed.
Request was from
Lars Ingebrigtsen <larsi <at> mouse.gnus.org>
to
control <at> debbugs.gnu.org
.
(Fri, 23 Aug 2019 04:14:02 GMT)
Full text and
rfc822 format available.
bug marked as fixed in version 27.1, send any further explanations to
37016 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com>
Request was from
Lars Ingebrigtsen <larsi <at> mouse.gnus.org>
to
control <at> debbugs.gnu.org
.
(Fri, 23 Aug 2019 04:14:02 GMT)
Full text and
rfc822 format available.
bug archived.
Request was from
Debbugs Internal Request <help-debbugs <at> gnu.org>
to
internal_control <at> debbugs.gnu.org
.
(Fri, 20 Sep 2019 11:24:05 GMT)
Full text and
rfc822 format available.
This bug report was last modified 4 years and 213 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.