[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/doc/lispref/text.texi,v
From: |
Miles Bader |
Subject: |
[Emacs-diffs] Changes to emacs/doc/lispref/text.texi,v |
Date: |
Tue, 08 Jan 2008 20:51:07 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Miles Bader <miles> 08/01/08 20:46:54
Index: doc/lispref/text.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/text.texi,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- doc/lispref/text.texi 18 Oct 2007 00:14:21 -0000 1.5
+++ doc/lispref/text.texi 8 Jan 2008 20:45:50 -0000 1.6
@@ -1,7 +1,7 @@
@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001,
address@hidden 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation,
Inc.
address@hidden 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software
Foundation, Inc.
@c See the file elisp.texi for copying conditions.
@setfilename ../../info/text
@node Text, Non-ASCII Characters, Markers, Top
@@ -2990,31 +2990,28 @@
@xref{Face Attributes}.
@item
-A cons cell with the form @code{(foreground-color . @var{color-name})} or
address@hidden(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
address@hidden(: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
address@hidden property, but its state of activation is controlled by
address@hidden 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.
address@hidden Fontification}.
-
-Strictly speaking, @code{font-lock-face} is not a built-in text
-property; rather, it is implemented in Font Lock mode using
address@hidden @xref{Examining Properties}.
+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,
address@hidden 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.
@@ -3634,7 +3631,7 @@
@defun mouse-on-link-p pos
This function returns address@hidden 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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] Changes to emacs/doc/lispref/text.texi,v,
Miles Bader <=