GNU bug report logs - #58325
28.1: Function-name error in documentation of M-j key binding

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Mark Harig <idirectscm <at> aim.com>
Subject: bug#58325: closed (Re: bug#58325: 28.1: Function-name error in
 documentation of M-j key binding)
Date: Thu, 06 Oct 2022 07:35:03 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#58325: 28.1: Function-name error in documentation of M-j key binding

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 58325 <at> debbugs.gnu.org.

-- 
58325: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=58325
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Mark Harig <idirectscm <at> aim.com>, 58325-done <at> debbugs.gnu.org
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 <at> 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.

[Message part 3 (message/rfc822, inline)]

From: Mark Harig <idirectscm <at> aim.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
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.)

Previous Next

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