GNU bug report logs - #42430
26.3; Document `ring-next' and `ring-previous' in (elisp) Rings

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Sun, 19 Jul 2020 19:34:02 UTC

Severity: normal

Found in version 26.3

Done: Eli Zaretskii <eliz <at> gnu.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 42430 in the body.
You can then email your comments to 42430 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#42430; Package emacs. (Sun, 19 Jul 2020 19:34: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. (Sun, 19 Jul 2020 19:34:02 GMT) Full text and rfc822 format available.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; Document `ring-next' and `ring-previous' in (elisp) Rings
Date: Sun, 19 Jul 2020 19:32:52 +0000 (UTC)

See this question:

https://emacs.stackexchange.com/q/59726/105

As the asker notes, the doc refers to ring "rotation", but it says
nothing about how to rotate the ring (cycle to the next/previous
element.


In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''
Reply sent to Eli Zaretskii <eliz <at> gnu.org>:
You have taken responsibility. (Fri, 24 Jul 2020 14:56:02 GMT) Full text and rfc822 format available.
Notification sent to Drew Adams <drew.adams <at> oracle.com>:
bug acknowledged by developer. (Fri, 24 Jul 2020 14:56:02 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 42430-done <at> debbugs.gnu.org
Subject: Re: bug#42430: 26.3;
 Document `ring-next' and `ring-previous' in (elisp) Rings
Date: Fri, 24 Jul 2020 17:55:37 +0300

> Date: Sun, 19 Jul 2020 19:32:52 +0000 (UTC)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> See this question:
> 
> https://emacs.stackexchange.com/q/59726/105
> 
> As the asker notes, the doc refers to ring "rotation", but it says
> nothing about how to rotate the ring (cycle to the next/previous
> element.

The manual says:

     For yanking, one entry in the kill ring is designated the front of
  the ring.  Some yank commands rotate the ring by designating a different
  element as the front.  But this virtual rotation doesn’t change the list
  itself—the most recent entry always comes first in the list.

That's all.  I don't see any reason to expand this description of a
"virtual rotation", since that would require bringing many internal
details into the ELisp manual, with no apparent gain.

So I'm closing this bug.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sat, 22 Aug 2020 11:24:08 GMT) Full text and rfc822 format available.
This bug report was last modified 3 years and 240 days ago.

Previous Next

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