comparison lispref/text.texi @ 79681:3b1cb1535715

(Links and Mouse-1): Fix xref for commands.texi change.

79680:681c8988ee67

attribute.  With this feature, you do not need to create a face each
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.
@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.

@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}.

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}.

This property is new in Emacs 22.1.

@item mouse-face
@kindex mouse-face @r{(text property)}

@end smallexample

@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}).
@end defun

@node Fields
@subsection Defining and Using Fields
@cindex fields

79681:3b1cb1535715

attribute.  With this feature, you do not need to create a face each
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 are older,
deprecated equivalents for @code{(:foreground @var{color-name})} and
@code{(:background @var{color-name})}.  Please convert code that uses
them.
@end itemize

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 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.

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.

@item mouse-face
@kindex mouse-face @r{(text property)}

@end smallexample

@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 Mouse}).
@end defun

@node Fields
@subsection Defining and Using Fields
@cindex fields