changeset 69578:8d593746aa77

* text.texi (Special Properties): Clarify the definition of 'fontified.
author Alan Mackenzie <acm@muc.de>
date Sun, 19 Mar 2006 20:36:21 +0000
parents 6f5f6943cc47
children f53a6a5430a7
files lispref/ChangeLog lispref/text.texi
diffstat 2 files changed, 24 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/ChangeLog	Sun Mar 19 20:36:10 2006 +0000
+++ b/lispref/ChangeLog	Sun Mar 19 20:36:21 2006 +0000
@@ -1,3 +1,8 @@
+2006-03-19  Alan Mackenzie  <acm@muc.de>
+
+	* text.texi (Special Properties): Clarify the definition of
+	'fontified.
+
 2006-03-16  Richard Stallman  <rms@gnu.org>
 
 	* display.texi (Defining Images): Minor cleanup.
--- a/lispref/text.texi	Sun Mar 19 20:36:10 2006 +0000
+++ b/lispref/text.texi	Sun Mar 19 20:36:21 2006 +0000
@@ -2994,9 +2994,25 @@
 
 @item fontified
 @kindex fontified @r{(text property)}
-This property, if non-@code{nil}, says that text in the buffer has
-had faces assigned automatically by a feature such as Font-Lock mode.
-@xref{Auto Faces}.
+This property says whether the text has had faces assigned to it by
+font locking.  The display engine tests it to decide whether a buffer
+portion needs refontifying before display.  @xref{Auto Faces}.  It
+takes one of these three values---other values are invalid:
+
+@table @asis
+@item @code{nil}
+Font locking is disabled, or the @code{face} properties on the text,
+if any, are invalid.
+
+@item The symbol @code{defer}
+This value states that the text's @code{face} properties are invalid
+and marks it for deferred fontification.  It is used only when ``just
+in time'' font locking is enabled.
+
+@item @code{t}
+The @code{face} properties, or lack of them, on the text are currently
+valid.
+@end table
 
 @item display
 @kindex display @r{(text property)}