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.

Full log

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.
This bug report was last modified 4 years and 299 days ago.

Previous Next

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