]> git.eshelyaron.com Git - emacs.git/commitdiff
; * doc/emacs/help.texi (Help, Apropos): Improve text and indexing.
authorEli Zaretskii <eliz@gnu.org>
Sat, 8 Jun 2024 11:10:10 +0000 (14:10 +0300)
committerEshel Yaron <me@eshelyaron.com>
Sat, 8 Jun 2024 13:01:06 +0000 (15:01 +0200)
(cherry picked from commit 53e9caa23ef0843337afcb5db4e16ef911d2e78d)

doc/emacs/help.texi

index 1f3948c97c154ce70e3a5e46af10db0f5f88e6a3..afbb2dfe6e716aba8e09d345af2cfcd3cfd11584 100644 (file)
@@ -35,22 +35,27 @@ window displaying the @samp{*Help*} buffer will be reused instead.
 @cindex searching documentation efficiently
 @cindex looking for a subject in documentation
   If you are looking for a certain feature, but don't know what it is
-called or where to look, we recommend three methods.  First, try an
-apropos command, then try searching the manual index, then look in the
+called or where to look, we recommend three methods.  First, try
+apropos commands, then try searching the manual index, then look in the
 FAQ and the package keywords, and finally try listing external packages.
 
 @table @kbd
 @item C-h a @var{topics} @key{RET}
 This searches for commands whose names match the argument
-@var{topics}.  The argument can be a keyword, a list of keywords, or a
-regular expression (@pxref{Regexps}).  @xref{Apropos}.
+@var{topics}.  The argument can be a keyword, a list of keywords
+separated by whitespace, or a regular expression (@pxref{Regexps}).
+@xref{Apropos}.
 
-@item C-h i d m emacs @key{RET} i @var{topic} @key{RET}
+@item C-h d @var{topics} @key{RET}
+Similar, but searches the @emph{text} of the documentation strings
+rather than the names of commands and functions.
+
+@item C-h r i @var{topic} @key{RET}
 This searches for @var{topic} in the indices of the Emacs Info manual,
 displaying the first match found.  Press @kbd{,} to see subsequent
 matches.  You can use a regular expression as @var{topic}.
 
-@item C-h i d m emacs @key{RET} s @var{topic} @key{RET}
+@item C-h r s @var{topic} @key{RET}
 Similar, but searches the @emph{text} of the manual rather than the
 indices.
 
@@ -364,10 +369,12 @@ Emacs Lisp Reference Manual}.
 @section Apropos
 @cindex apropos
 
+@cindex apropos pattern
+@cindex apropos commands, list of keywords
   The @dfn{apropos} commands answer questions like, ``What are the
 commands for working with files?''  More precisely, you specify your
 query as an @dfn{apropos pattern}, which is either a word, a list of
-words, or a regular expression.
+words separated by whitespace, or a regular expression.
 
   Each of the following apropos commands reads an apropos pattern in
 the minibuffer, searches for items that match the pattern, and