# HG changeset patch # User Richard M. Stallman # Date 1056969766 0 # Node ID 82502bf293e0a56d2b09ea60037eb30f4edf7fbb # Parent 080a8041fef70b86085e3ca23b72e253f45c4936 (Buffer Contents): Document current-word. (Change Hooks): Not called for *Messages*. diff -r 080a8041fef7 -r 82502bf293e0 lispref/text.texi --- a/lispref/text.texi Mon Jun 30 10:40:27 2003 +0000 +++ b/lispref/text.texi Mon Jun 30 10:42:46 2003 +0000 @@ -224,6 +224,21 @@ @end example @end defun +@tindex current-word +@defun current-word &optional strict really-word +This function returns the symbol (or word) at or near point, as a string. +The return value includes no text properties. + +The optional argument @var{really-word} is non-@code{nil}, it finds a +word; otherwise, it finds a symbol (which includes word characters and +both symbol constituent characters). + +If the optional argument @var{strict} is non-@code{nil}, then point +must be in or next to the symbol or word---if no symbol or word is +there, the function returns @code{nil}. Otherwise, a nearby symbol or +word on the same line is acceptable. +@end defun + @defun thing-at-point thing Return the @var{thing} around or next to point, as a string. @@ -2322,7 +2337,7 @@ This variable holds an alist which maps property names to a list of alternative property names. If a character does not specify a direct value for a property, the alternative property names are consulted in -order; the first non-nil value is used. This variable takes +order; the first non-@code{nil} value is used. This variable takes precedence over @code{default-text-properties}, and @code{category} properties take precedence over this variable. @end defvar @@ -3296,7 +3311,7 @@ You can cause @code{constrain-to-field} to ignore all field boundaries (and so never constrain anything) by binding the variable -@code{inhibit-field-text-motion} to a non-nil value. +@code{inhibit-field-text-motion} to a non-@code{nil} value. @end defun @node Not Intervals @@ -3715,6 +3730,9 @@ arguments. @end defvar + Output of messges into the @samp{*Messages*} buffer does not +call these functions. + @defmac combine-after-change-calls body... The macro executes @var{body} normally, but arranges to call the after-change functions just once for a series of several changes---if