# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 821425019 0
# Node ID 9c9debb5950f0c42338d64a42510b50219e8d97d
# Parent  1087acbd29d7b828cf8392307eec78f98dd8c9c0
Clarify write-contents-hooks.

diff -r 1087acbd29d7 -r 9c9debb5950f lispref/files.texi
--- a/lispref/files.texi	Fri Jan 12 05:28:46 1996 +0000
+++ b/lispref/files.texi	Fri Jan 12 05:36:59 1996 +0000
@@ -348,8 +348,13 @@
 This works just like @code{write-file-hooks}, but it is intended for
 hooks that pertain to the contents of the file, as opposed to hooks that
 pertain to where the file came from.  Such hooks are usually set up by
-major modes, as buffer-local bindings for this variable.  Switching to a
-new major mode always resets this variable.
+major modes, as buffer-local bindings for this variable.
+
+This variable automatically becomes buffer-local whenever it is set;
+switching to a new major mode always resets this variable.  When you use
+@code{add-hooks} to add an element to this hook, you should @emph{not}
+specify a non-@code{nil} @var{local} argument, since this variable is
+used @emph{only} locally.
 @end defvar
 
 @c Emacs 19 feature