From db3625badd5ad4688c97b62dcb1135fb7d8b81e7 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Fri, 4 Jan 2008 05:43:39 +0000 Subject: [PATCH] (Links and Mouse-1): Fix xref for commands.texi change. --- lispref/text.texi | 37 +++++++++++++++++-------------------- 1 file changed, 17 insertions(+), 20 deletions(-) diff --git a/lispref/text.texi b/lispref/text.texi index 906e51c513b..ed69b348737 100644 --- a/lispref/text.texi +++ b/lispref/text.texi @@ -2989,31 +2989,28 @@ time you want to specify a particular attribute for certain text. @xref{Face Attributes}. @item -A cons cell with the form @code{(foreground-color . @var{color-name})} or -@code{(background-color . @var{color-name})}. These elements specify -just the foreground color or just the background color. @xref{Color -Names}, for the supported forms of @var{color-name}. - -A cons cell of @code{(foreground-color . @var{color-name})} is equivalent to -specifying @code{(:foreground @var{color-name})}; likewise for the -background. +A cons cell with the form @code{(foreground-color . @var{color-name})} +or @code{(background-color . @var{color-name})}. These are older, +deprecated equivalents for @code{(:foreground @var{color-name})} and +@code{(:background @var{color-name})}. Please convert code that uses +them. @end itemize -You can use Font Lock Mode (@pxref{Font Lock Mode}), to dynamically -update @code{face} properties based on the contents of the text. +It works to use the latter two forms directly as the value +of the @code{face} property. + +Font Lock mode (@pxref{Font Lock Mode}) works in most buffers by +dynamically updating the @code{face} property of characters based on +the context. @item font-lock-face @kindex font-lock-face @r{(text property)} -The @code{font-lock-face} property is the same in all respects as the -@code{face} property, but its state of activation is controlled by -@code{font-lock-mode}. This can be advantageous for special buffers -which are not intended to be user-editable, or for static areas of -text which are always fontified in the same way. -@xref{Precalculated Fontification}. +The @code{font-lock-face} property is equivalent to the @code{face} +property when Font Lock mode is enabled. When Font Lock mode is disabled, +@code{font-lock-face} has no effect. -Strictly speaking, @code{font-lock-face} is not a built-in text -property; rather, it is implemented in Font Lock mode using -@code{char-property-alias-alist}. @xref{Examining Properties}. +The @code{font-lock-mode} property is useful for special modes that +implement their own highlighting. @xref{Precalculated Fontification}. This property is new in Emacs 22.1. @@ -3717,7 +3714,7 @@ a @key{Mouse-1} click shall be translated to @key{RET}: @defun mouse-on-link-p pos This function returns non-@code{nil} if position @var{pos} in the current buffer is on a link. @var{pos} can also be a mouse event -location, as returned by @code{event-start} (@pxref{Accessing Events}). +location, as returned by @code{event-start} (@pxref{Accessing Mouse}). @end defun @node Fields -- 2.39.2