Re: emacs-31 0818bb3eb38: ; * etc/NEWS: Presentational fixes and improvements.

Eli Zaretskii <[email protected]> writes:

Hi Eli,
 
>> > This change is incorrect, and should be reverted.  Our conventions are
>> > to up-case the function keys specified as <KEY>, as in <RIGHT> and
>> > <DOWN>.  This follows what makeinfo produces for these keys in the
>> > Info format.
>> 
>> I follow what describe-function shows:
>
> That's not Info.
>
>> I follow what the Elisp manual shows, for example in (info "(elisp)
>> Function Keys") or (info "(elisp) Changing Key Bindings").
>
> Which parts of that?

Sorry, I was unprecise. I meant (info "(elisp) Changing Key Bindings")

--8<---------------cut here---------------start------------->8---
‘H-<left>’
     The key named ‘left’ with the hyper modifier.
--8<---------------cut here---------------end--------------->8---

and (info "(elisp) Key Sequences")

--8<---------------cut here---------------start------------->8---
          (kbd "C-M-<down>") ⇒ [C-M-down]
--8<---------------cut here---------------end--------------->8---

> I alluded to what @key produces.  It sounds like you are looking at
> other markups.
>
> Please look at (info (emacs) Moving Point")

I have the impression, that the Emacs and Elisp manuals use slightly
different style. In the Emacs manual, we have capital letters like
<LEFT>, and in the Elips manual we haven't. Should it be sync'ed?

>> I follow what is the practice in etc/NEWS *since ever*, except one entry
>> in NEWS.27.
>
> Better late than never...
>
>> Btw, a plain revert would be wrong anyway. I've fixed also the wrong
>> keybindings for window-layout-flip-topdown and
>> window-layout-flip-leftright ('C-x w f ...' instaed of 'C-x w r ...').
>
> It's okay to revert only the part that deals with arrow keys.
>
> I can do it myself if you want.

Of course you can do this, you're the maintainer. But pls, add a
respective rule to admin/notes/documentation first, otherwise I have
good chances to forget.

Best regards, Michael.