emacs-bug-tracker
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#58325: closed (28.1: Function-name error in documentation of M-j key


From: GNU bug Tracking System
Subject: bug#58325: closed (28.1: Function-name error in documentation of M-j key binding)
Date: Thu, 06 Oct 2022 07:35:03 +0000

Your message dated Thu, 6 Oct 2022 03:34:37 -0400
with message-id 
<CADwFkmm_HZvaZaRqG-R85qOK3b0JpS+tNYo7hUNtPsSVgVUSPQ@mail.gmail.com>
and subject line Re: bug#58325: 28.1: Function-name error in documentation of 
M-j key binding
has caused the debbugs.gnu.org bug report #58325,
regarding 28.1: Function-name error in documentation of M-j key binding
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs@gnu.org.)


-- 
58325: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=58325
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems
--- Begin Message --- Subject: 28.1: Function-name error in documentation of M-j key binding Date: Thu, 6 Oct 2022 02:18:13 +0000 (UTC)
1. In the Emacs info manual, (emacs) Comment Commands, there is
   the sentence:

`C-M-j'
`M-j'
     Like `<RET>' followed by inserting and aligning a comment
     (`comment-indent-new-line').

However, C-h c M-j reports (for numerous (all?) major modes)

    M-j runs the command default-indent-new-line

Although the function `comment-indent-new-line' exists, the key
sequences C-M-j and M-j are not bound to it.

So, the sentence in the Emacs info manual needs to have
`comment-indent-new-line' changed to `default-indent-new-line'.


2. In the Emacs info manual, (emacs) Multi-Line Comments, there
   is the sentence:

      If you are typing a comment and wish to continue it to
      another line, type `M-j' or `C-M-j'
      (`comment-indent-new-line').

This sentence, too, needs to be changed to list the correct
function name (`default-indent-new-line').


3. Note also that only the second instance of
   `comment-indent-new-line' is found with an index search, and
   the match is not the definition of the key binding:

   Found ‘comment-indent-new-line’ in Command Index.  (Only match)

With the fix described above, an index entry should be added to
find `default-indent-new-line' in (emacs) Comment Commands.

(End of report.)



--- End Message ---
--- Begin Message --- Subject: Re: bug#58325: 28.1: Function-name error in documentation of M-j key binding Date: Thu, 6 Oct 2022 03:34:37 -0400
Mark Harig via "Bug reports for GNU Emacs, the Swiss army knife of text
editors" <bug-gnu-emacs@gnu.org> writes:

> 1. In the Emacs info manual, (emacs) Comment Commands, there is
>    the sentence:
>
> `C-M-j'
> `M-j'
>      Like `<RET>' followed by inserting and aligning a comment
>      (`comment-indent-new-line').
>
> However, C-h c M-j reports (for numerous (all?) major modes)
>
>     M-j runs the command default-indent-new-line
>
> Although the function `comment-indent-new-line' exists, the key
> sequences C-M-j and M-j are not bound to it.
>
> So, the sentence in the Emacs info manual needs to have
> `comment-indent-new-line' changed to `default-indent-new-line'.
>
>
> 2. In the Emacs info manual, (emacs) Multi-Line Comments, there
>    is the sentence:
>
>       If you are typing a comment and wish to continue it to
>       another line, type `M-j' or `C-M-j'
>       (`comment-indent-new-line').
>
> This sentence, too, needs to be changed to list the correct
> function name (`default-indent-new-line').
>
>
> 3. Note also that only the second instance of
>    `comment-indent-new-line' is found with an index search, and
>    the match is not the definition of the key binding:
>
>    Found ‘comment-indent-new-line’ in Command Index.  (Only match)
>
> With the fix described above, an index entry should be added to
> find `default-indent-new-line' in (emacs) Comment Commands.

Thanks for the bug report.  This is now fixed on the emacs-28 branch.


--- End Message ---

reply via email to

[Prev in Thread] Current Thread [Next in Thread]