* text.texi (Special Properties): Clarify the definition of

	'fontified.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index ab3f92564a33d55d897f2b49ce0b2e02d962e7e4..c488c809a46e798cd574ebe2ba4fc304a71a8928 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -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.

diff --git a/lispref/text.texi b/lispref/text.texi
index c68a55bedc7fa4a554af2b3bfaa6660b6566d0f0..3a0d4f7a585645fec6be2fa80c9799b477ab690a 100644 (file)
--- a/lispref/text.texi
+++ b/lispref/text.texi
@@ -2994,9 +2994,25 @@ that all text between the character and where the mouse is have the same
 
 @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)}