Subject: RE: bug#16074: 24.3.50; enhancement request: Remove "pop" from command names & doc for `C-(u|x) C-SPC'

From: Drew Adams <[email-masked]>
Date: Sun, 25 Aug 2019 15:03:07 -0700 (PDT)

> > The enhancement request is to fix this wrong
> > terminology wrt BOTH `global-mark-ring' and
> > `mark-ring'.
> 
> And `yank' doesn't yank, and `kill' doesn't kill literally.
> What is the most important is that docstrings should describe
> the behavior in all details.  The name is more a matter of taste.

Irrelevant.  Emacs _has_ "pop" in its terminology,
just like it has "yank" and "kill" (buffer, text).

This mistaken use of "pop" doesn't fit Emacs's use
of the word (or even typical outside uses of it).

And Emacs _has_ a term, "cycle", for the behavior
here.  "Cycle" is the term Emacs uses for rings.

And it's not just about the name.  It's also about
the doc, which incorrectly tells users that the
behavior is to "pop" the mark/position "off" the
ring.

That's wrong; it's not what happens.  That doesn't
"describe the behavior in all details".  Instead,
it describes a different behavior, which doesn't
happen.

Hand-waving alone can't justify this misleading.

On the other hand, as I replied to Eli, you can
decide whether fixing this is "worth the necessary
time, energy, VC resources and your whatnot."
That's up to you.