(Saving): Mention write-region-inhibit-fsync.

2 files changed, 13 insertions, 0 deletions

diff --git a/man/ChangeLog b/man/ChangeLog
index 69cf7458a7a..d4021e1428a 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,7 @@
+2005-09-14  Romain Francoise  <romain@orebokech.com>
+
+        * files.texi (Saving): Mention write-region-inhibit-fsync.
+
 2005-09-05  Chong Yidong  <cyd@stupidchicken.com>
 
         * custom.texi (Custom Themes): New node.
diff --git a/man/files.texi b/man/files.texi
index 912fc6f7bf9..b8e8d60c2f9 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -502,6 +502,15 @@ variable @code{require-final-newline} according to
 @code{mode-require-final-newline}.  By setting the latter variable,
 you can control how these modes handle final newlines.
 
+@vindex write-region-inhibit-fsync
+  When Emacs saves a file to disk, it issues an @code{fsync} call to the
+operating system to ensure that your data has indeed reached the media.
+This is important for safety if the system crashes or in case of power
+outage.  However, it can be disruptive on laptops using power saving
+because it forces the system to spin up the drive each time you save a
+file; the variable @code{write-region-inhibit-fsync} disables this
+synchronization.  This may result in data loss, use with care!
+
 @menu
 * Backup::              How Emacs saves the old version of your file.
 * Interlocking::        How Emacs protects against simultaneous editing