Minor improvements of recent documentation changes

* src/editfns.c (Fwiden):
* doc/lispref/display.texi (Auto Faces):
* src/xdisp.c (syms_of_xdisp) <fontification-functions>:
* etc/NEWS: Clarify and improve wording of documentation changes.

2 files changed, 6 insertions, 5 deletions

diff --git a/src/editfns.c b/src/editfns.c
index 40e65dda0c9..d15d4dc68b9 100644
--- a/src/editfns.c
+++ b/src/editfns.c
@@ -2661,8 +2661,8 @@ DEFUN ("widen", Fwiden, Swiden, 0, 0, "",
 This allows the buffer's full text to be seen and edited.
 
 When called from Lisp inside a body form in which `narrow-to-region'
-was called with an optional argument LOCK non-nil, this does not
-produce any effect.  */)
+was called with an optional argument LOCK non-nil, this function does
+not produce any effect.  */)
   (void)
 {
   if (! NILP (Vrestrictions_locked))
diff --git a/src/xdisp.c b/src/xdisp.c
index 8867406c4e2..3ef3c0d3796 100644
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -36653,12 +36653,13 @@ The tool bar style must also show labels for this to have any effect, see
     doc: /* List of functions to call to fontify regions of text.
 Each function is called with one argument POS.  Functions must
 fontify a region starting at POS in the current buffer, and give
-fontified regions the property `fontified'.
+fontified regions the property `fontified' with a non-nil value.
 
 Note that, when the buffer contains one or more lines whose length is
-above `long-line-threshold', the restrictions of the buffer are locked
+above `long-line-threshold', the narrowing of the buffer is locked
 (see `narrow-to-region'), and these functions only have access to a
-small portion of the buffer around POS.  */);
+small portion of the buffer around POS and cannot use `widen' to gain
+access to other portions of buffer text.  */);
   Vfontification_functions = Qnil;
   Fmake_variable_buffer_local (Qfontification_functions);