# HG changeset patch # User Karl Heuer # Date 821229457 0 # Node ID 271075f547942a3f00aedf409884e98aef26847a # Parent 787061ad42ba7537912fa007d076b40edff8840c (write-contents-hooks): Call make-variable-buffer-local. Doc fix. (local-write-file-hooks, write-file-hooks): Doc fixes. diff -r 787061ad42ba -r 271075f54794 lisp/files.el --- a/lisp/files.el Tue Jan 09 23:17:18 1996 +0000 +++ b/lisp/files.el Tue Jan 09 23:17:37 1996 +0000 @@ -194,15 +194,21 @@ and the rest are not called. These hooks are considered to pertain to the visited file. So this list is cleared if you change the visited file name. -See also `write-contents-hooks'. -Don't make this variable buffer-local; instead, use `local-write-file-hooks'.") + +Don't make this variable buffer-local; instead, use `local-write-file-hooks'. +See also `write-contents-hooks'.") ;;; However, in case someone does make it local... (put 'write-file-hooks 'permanent-local t) (defvar local-write-file-hooks nil "Just like `write-file-hooks', except intended for per-buffer use. The functions in this list are called before the ones in -`write-file-hooks'.") +`write-file-hooks'. + +This variable is meant to be used for hooks that have to do with a +particular visited file. Therefore, it is a permanent local, so that +changing the major mode does not clear it. However, calling +`set-visited-file-name' does clear it.") (make-variable-buffer-local 'local-write-file-hooks) (put 'local-write-file-hooks 'permanent-local t) @@ -210,10 +216,14 @@ "List of functions to be called before writing out a buffer to a file. If one of them returns non-nil, the file is considered already written and the rest are not called. -These hooks are considered to pertain to the buffer's contents, -not to the particular visited file; thus, `set-visited-file-name' does -not clear this variable, but changing the major mode does clear it. + +This variable is meant to be used for hooks that pertain to the +buffer's contents, not to the particular visited file; thus, +`set-visited-file-name' does not clear this variable; but changing the +major mode does clear it if you have made it buffer local. + See also `write-file-hooks'.") +(make-variable-buffer-local 'write-contents-hooks) (defconst enable-local-variables t "*Control use of local-variables lists in files you visit.