]> git.eshelyaron.com Git - emacs.git/commitdiff
*** empty log message ***
authorDave Love <fx@gnu.org>
Tue, 22 Aug 2000 18:49:28 +0000 (18:49 +0000)
committerDave Love <fx@gnu.org>
Tue, 22 Aug 2000 18:49:28 +0000 (18:49 +0000)
lispref/text.texi
man/abbrevs.texi

index ac157f70304acc8e952536513151e6699b63f25b..e2f094044472765214edf83af2fed48b3ec8cee1 100644 (file)
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000
 @c   Free Software Foundation, Inc. 
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/text
@@ -2654,10 +2654,41 @@ or shorter, higher or lower, wider or narrow, or replaced with an image.
 
 @item help-echo
 @kindex help-echo @r{(text property)}
+@anchor{Text help-echo}
 If text has a string as its @code{help-echo} property, then when you
 move the mouse onto that text, Emacs displays that string in the echo
-area, or in the tooltip window.  This feature is used in the mode line.
-It is available starting in Emacs 21.
+area, or in the tooltip window.
+
+If the value of the @code{help-echo property} is a function, that
+function is called with three arguments, @var{window}, @var{object} and
+@var{position} and should return a help string or nil for
+none.  The first argument, @var{window} is the window in which
+the help was found.  The second, @var{object}, is the buffer, overlay or
+string which had the @code{help-echo} property.  The @var{position}
+argument is as follows:
+
+@itemize @bullet{}
+@item
+If @var{object} is a buffer, @var{pos} is the position in the buffer
+where the @code{help-echo} text property was found.
+@item
+If @var{object} is an overlay, that overlay has a @code{help-echo}
+property, and @var{pos} is the position in the overlay's buffer under
+the mouse.
+@item
+If @var{object} is a string (an overlay string or a string displayed
+with the @code{display} property) @var{pos} is the position in that
+string under the mouse.
+@end itemize
+
+If the value of the @code{help-echo} property is neither a function nor
+a string, it is evaluated to obtain a help string.
+
+Variable @code{show-help-function} (@pxref{Help display}) provides a
+hook to alter the way help text is displayed.
+
+This feature is used in the mode line and for other active text.  It is
+available starting in Emacs 21.
 
 @item local-map
 @cindex keymap of character
@@ -2780,6 +2811,17 @@ property has no effect.  Do not set this variable globally; bind it with
 @code{let}.
 @end defvar
 
+@defvar show-help-function
+@tindex show-help-function
+@anchor{Help display}
+If this variable is non-@code{nil} it specifies a function called to
+display help strings.  These may be @code{help-echo} properties or menu
+(@pxref{Simple Menu Items}, @pxref{Extended Menu Items}) or tool bar
+(@pxref{Tool Bar}) help strings.  The specified function is called with
+one argument, the help string to display.  Tooltip mode
+(@pxref{(emacs)Tooltips}) provides an example.
+@end defvar
+
 @node Format Properties
 @subsection Formatted Text Properties
 
@@ -3560,7 +3602,7 @@ arguments specify a portion of the buffer including all of the changes
 made within the @code{combine-after-change-calls} body.
 
 @strong{Warning:} You must not alter the values of
-@code{after-change-functions} and @code{after-change-function} within
+@code{after-change-functions} within
 the body of a @code{combine-after-change-calls} form.
 
 @strong{Note:} If the changes you combine occur in widely scattered
@@ -3569,19 +3611,7 @@ because it may lead to inefficient behavior for some change hook
 functions.
 @end defmac
 
-@defvar before-change-function
-This obsolete variable holds one function to call before any buffer
-modification (or @code{nil} for no function).  It is called just like
-the functions in @code{before-change-functions}.
-@end defvar
-
-@defvar after-change-function
-This obsolete variable holds one function to call after any buffer modification
-(or @code{nil} for no function).  It is called just like the functions in
-@code{after-change-functions}.
-@end defvar
-
-The four variables above are temporarily bound to @code{nil} during the
+The two variables above are temporarily bound to @code{nil} during the
 time that any of these functions is running.  This means that if one of
 these functions changes the buffer, that change won't run these
 functions.  If you do want a hook function to make changes that run
index b15bfc04700ba1d63e44c8d1eef494a888bf7bc4..6588fdfd41b6763bf2714f3969fdfd5aa855fbe7 100644 (file)
@@ -348,9 +348,9 @@ in the buffer to search for an expansion.
 buffers, unless you have set @code{dabbrev-check-all-buffers} to
 @code{nil}.
 
-@vindex dabbrev-ignore-regexps
+@vindex dabbrev-ignored-regexps
   A more fine control on which buffers are scanned is possible by
-customizing the variable @code{dabbrev-ignore-regexps}, whch should
+customizing the variable @code{dabbrev-ignored-regexps}, whch should
 contain a list of regular expressions.  Buffers matching a regular
 expression from that list are not searched.