emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] Changes to emacs/lispref/help.texi


From: Richard M. Stallman
Subject: [Emacs-diffs] Changes to emacs/lispref/help.texi
Date: Tue, 20 Dec 2005 15:39:36 +0000

Index: emacs/lispref/help.texi
diff -u emacs/lispref/help.texi:1.25 emacs/lispref/help.texi:1.26
--- emacs/lispref/help.texi:1.25        Wed Aug 10 14:29:00 2005
+++ emacs/lispref/help.texi     Tue Dec 20 15:39:36 2005
@@ -133,11 +133,17 @@
 (symbol-plist 'command-line-processed)
      @result{} (variable-documentation 188902)
 @end group
address@hidden
+(documentation-property 'emacs 'group-documentation)
+     @result{} "Customization of the One True Editor."
address@hidden group
 @end smallexample
 @end defun
 
 @defun documentation function &optional verbatim
 This function returns the documentation string of @var{function}.
address@hidden handles macros, named keyboard macros, and
+special forms, as well as ordinary functions.
 
 If @var{function} is a symbol, this function first looks for the
 @code{function-documentation} property of that symbol; if that has a
@@ -157,6 +163,11 @@
 @code{documentation} returns @code{nil}.
 @end defun
 
address@hidden face-documentation face
+This function returns the documentation string of @var{face} as a
+face.
address@hidden defun
+
 @c Wordy to prevent overfull hboxes.  --rjc 15mar92
 Here is an example of using the two functions, @code{documentation} and
 @code{documentation-property}, to display the documentation strings for
@@ -498,15 +509,28 @@
 about them, see @ref{Help, , Help, emacs, The GNU Emacs Manual}.  Here
 we describe some program-level interfaces to the same information.
 
address@hidden Command apropos regexp &optional do-all
address@hidden Command apropos pattern &optional do-all
 This function finds all ``meaningful'' symbols whose names contain a
-match for the regular expression @var{regexp}, and returns a list of
-them, with associated documentation (@pxref{Regular Expressions}).  It
-also displays the symbols in a buffer named @samp{*Apropos*}, each
-with a one-line description taken from the beginning of its
-documentation string.  A symbol is ``meaningful'' if it has a
+match for the apropos pattern @var{pattern}.  An apropos pattern is
+either a word to match, a space-separated list of words of which at
+least two must match, or a regular expression (if any special regular
+expression characters occur).  A symbol is ``meaningful'' if it has a
 definition as a function, variable, or face, or has properties.
 
+The function returns a list of elements that look like this:
+
address@hidden
+(@var{symbol} @var{score} @var{fn-doc} @var{var-doc} @var{plist-doc} 
@var{widget-doc} @var{face-doc} @var{group-doc})
address@hidden example
+
+Here, @var{score} is an integer measure of how important the symbol
+seems to be as a match, and the remaining elements are documentation
+strings for @var{symbol}'s various roles (or @code{nil}).
+
+It also displays the symbols in a buffer named @samp{*Apropos*}, each
+with a one-line description taken from the beginning of its
+documentation string.
+
 @c Emacs 19 feature
 If @var{do-all} is address@hidden, or if the user option
 @code{apropos-do-all} is address@hidden, then @code{apropos} also




reply via email to

[Prev in Thread] Current Thread [Next in Thread]