Subject: bug#42430: closed (Re: bug#42430: 26.3; Document `ring-next' and `ring-previous' in (elisp) Rings)

From: [email-masked] (GNU bug Tracking System)
Date: Fri, 24 Jul 2020 14:56:02 +0000

Your bug report

#42430: 26.3; Document `ring-next' and `ring-previous' in (elisp) Rings

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
42430: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=42430
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#42430: 26.3; Document `ring-next' and `ring-previous' in (elisp) Rings
From: Eli Zaretskii <[email-masked]>
To: Drew Adams <[email-masked]>
Cc: [email-masked]
Date: Fri, 24 Jul 2020 17:55:37 +0300
List-Id: <debbugs-submit.debbugs.gnu.org>

> Date: Sun, 19 Jul 2020 19:32:52 +0000 (UTC)
> From: Drew Adams <[email-masked]>
> 
> 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.

Subject: 26.3; Document `ring-next' and `ring-previous' in (elisp) Rings
From: Drew Adams <[email-masked]>
To: [email-masked]
Date: Sun, 19 Jul 2020 19:32:52 +0000 (UTC)
List-Id: <debbugs-submit.debbugs.gnu.org>

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''