Re: "Command Discovery In Emacs "

[Stephen Berman]

On Mon, 16 Aug 2021 13:38:47 +0200 Lars Ingebrigtsen <larsi@gnus.org> wrote:

> Jean-Christophe Helary <lists@traduction-libre.org> writes:
>
>> That command discovery is really nice and I was wondering how to find
>> the proper way to annotate the various functions. How do we know what
>> modes are the functions are to be used in ? Is there an easy way to
>> find out ?
>
> See the "Command Modes" section in the Emacs Lisp manual.

This section is not listed in the Detailed Node Listing in the top node
of the manual, and it's also not indexed.  I'm not well-versed in
texinfo; is the following patch sufficient?

Steve Berman

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index b4a8b733a0..6d45099867 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -601,6 +601,9 @@ Interactive Examples

 @node Command Modes
 @subsection Specifying Modes For Commands
+@cindex commands, mode-specific
+@cindex commands, specify as mode-specific
+@cindex mode-specific commands

 Many commands in Emacs are general, and not tied to any specific mode.
 For instance, @kbd{M-x kill-region} can be used in pretty much any
diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi
index 8b440c7977..337c71c295 100644
--- a/doc/lispref/elisp.texi
+++ b/doc/lispref/elisp.texi
@@ -788,6 +788,7 @@ Top
 * Interactive Codes::       The standard letter-codes for reading arguments
                               in various ways.
 * Interactive Examples::    Examples of how to read interactive arguments.
+* Command Modes::            Specifying that commands are for a specific mode.
 * Generic Commands::        Select among command alternatives.