Re: emacs-28 47cbd10: * lisp/bindings.el (mode-line-position): Improve tooltip.

[Stefan Kangas]

Stefan Kangas <stefan@marxist.se> writes:

> Eli Zaretskii <eliz@gnu.org> writes:
>
> > This change is incorrect: the "All/Top/Bot/NN%" part is NOT "buffer
> > position".  If you have a suggestion for better description than "Size
> > indication mode", please tell; otherwise, let's leave the original
> > description intact.
>
> The original was even more incorrect, as it had nothing to do with
> "Size indication mode".  Let me think about an alternative.

The info node "(emacs) Mode Line" says "POS tells you whether there is
additional text above the top of the window, or below the bottom."
The info node "(emacs) Optional Mode Line" says "The buffer percentage
POS indicates the percentage of the buffer above the top of the
window."

In the doc string for mode-line-format we have:

  %p -- print percent of buffer above top of window, or Top, Bot or All.
  %P -- print percent of buffer above bottom of window, perhaps plus Top,
        or print Bottom or All.

I could not find any other documentation of this feature.  Did I miss something?

I guess "Percent of buffer above top of window, or Top, Bot or All" is
pretty hopeless as far as a user-facing description goes.  In
particular, it doesn't say what any of it means.

Based on the documentation I could find, I can only suggest "Buffer
Percentage Position" or, if you prefer, "Buffer Percentage POS", the
latter of which exactly matches the description of this in the info
node "(emacs) Optional Mode Line".  But I'm not sure that this is
better than "Buffer Position".