From 244d99b1e0b774c01d8990fc564a6096c1dd709e Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 8 Jun 2024 14:10:10 +0300 Subject: [PATCH] ; * doc/emacs/help.texi (Help, Apropos): Improve text and indexing. (cherry picked from commit 53e9caa23ef0843337afcb5db4e16ef911d2e78d) --- doc/emacs/help.texi | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/doc/emacs/help.texi b/doc/emacs/help.texi index 1f3948c97c1..afbb2dfe6e7 100644 --- a/doc/emacs/help.texi +++ b/doc/emacs/help.texi @@ -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 -- 2.39.5