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

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

[Drew Adams]

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

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

[Eli Zaretskii]

> Date: Sun, 19 Jul 2020 19:32:52 +0000 (UTC)
> From: Drew Adams <drew.adams@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.