changeset 32276:49a967404304

(Help): Describe an orderly procedure to find features in the docs.
author Eli Zaretskii <eliz@gnu.org>
date Sun, 08 Oct 2000 09:14:38 +0000
parents 30abf11e1b8e
children d589b182b25a
files man/help.texi
diffstat 1 files changed, 36 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/man/help.texi	Sun Oct 08 08:53:46 2000 +0000
+++ b/man/help.texi	Sun Oct 08 09:14:38 2000 +0000
@@ -36,6 +36,42 @@
 hyperlinks to more help on cross-referenced names, Info nodes,
 customization buffers and the like.  @xref{Help Mode}.
 
+@cindex searching documentation efficiently
+@cindex looking for a subject in documentation
+  If you are looking for a certain feature, but don't know where exactly
+it is documented, and aren't even sure what is the name of the related
+command or option, we recommend the following procedure:
+
+@table @kbd
+@item C-h a @var{topic} @key{RET}
+This searches the built-in short documentation of each command for
+strings which match @var{topic}.  @var{topic} can be a regular
+expression (@pxref{Regexps}).  Browse the buffer popped up by Emacs, to
+find what you are looking for.
+
+@item M-x apropos @var{topic} @key{RET}
+This works like @kbd{C-h a}, but it also searches the documentation of
+user options and other variables, in case the feature you are looking
+for is controlled by an option, not a command.
+
+@item C-h i emacs @key{RET} i @var{topic} @key{RET}
+This looks up @var{topic} in the indices of the Emacs on-line manual.
+Press @key{,} repetitively until you find what you are looking for.
+
+@item C-h i emacs @key{RET} s @var{topic} @key{RET}
+This works like the previous command, but it searches for @var{topic}
+(which can be a regular expression) in the @emph{text} of the manual
+rather than in its indices.
+
+@item C-h F
+This brings up the Emacs FAQ, where you can use the usual search
+commands (@pxref{Search}) to find the information.
+
+@item M-x finder-by-keyword
+Finally, you can try looking up a suitable package using keywords
+pertinent to the feature you need.
+@end table
+
 @menu
 * Help Summary::	Brief list of all Help commands.
 * Key Help::		Asking what a key does in Emacs.