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

	'fontified.

2 files changed, 24 insertions, 3 deletions

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index ab3f92564a3..c488c809a46 100644
--- 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 c68a55bedc7..3a0d4f7a585 100644
--- 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)}