(file-precious-flag): Document that this flag is advisory.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 9110f890267b27cb768e9d267624f023ee27d2f4..478d0d8c52aa7e6f37f02cdfbc99bb64d2f834b1 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2008-11-14  Karl Fogel  <kfogel@red-bean.com>
+
+       * files.el (file-precious-flag): Document that this flag is
+       advisory.
+
 2008-11-14  Shigeru Fukaya  <shigeru.fukaya@gmail.com>
 
        * emacs-lisp/bytecomp.el (byte-compile-associative)

diff --git a/lisp/files.el b/lisp/files.el
index ff6d18475238755bd495181e7e2840178da31951..b36b0af8322cc62ba5e7b9f88b930b3ae7a19bd8 100644 (file)
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -239,7 +239,11 @@ and there is never any instant where the file is nonexistent.
 
 Note that this feature forces backups to be made by copying.
 Yet, at the same time, saving a precious file
-breaks any hard links between it and other files."
+breaks any hard links between it and other files.
+
+This feature is advisory: for example, if the directory in which the
+file is being saved is not writeable, Emacs may ignore a non-nil value
+of `file-precious-flag' and write directly into the file."
   :type 'boolean
   :group 'backup)