emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] master 073048d: Remove unnecessary ref to coreutils manual


From: Paul Eggert
Subject: [Emacs-diffs] master 073048d: Remove unnecessary ref to coreutils manual
Date: Sun, 11 Sep 2016 22:44:09 +0000 (UTC)

branch: master
commit 073048d5de3ddc720fe11589cadaebab74e668df
Author: Paul Eggert <address@hidden>
Commit: Paul Eggert <address@hidden>

    Remove unnecessary ref to coreutils manual
    
    * doc/lispref/files.texi: Document write-region-inhibit-fsync.
---
 doc/lispref/files.texi |   16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index b912d7b..9a56d0a 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -661,6 +661,15 @@ feature is useful for programs that use files for internal 
purposes,
 files that the user does not need to know about.
 @end deffn
 
address@hidden write-region-inhibit-fsync
+If this variable's value is @code{nil}, @code{write-region} uses the
address@hidden system call after writing a file.  Although this slows
+Emacs down, it lessens the risk of data loss after power failure.  If
+the value is @code{t}, Emacs does not use @code{fsync}.  The default
+value is @code{nil} when Emacs is interactive, and @code{t} when Emacs
+runs in batch mode.  @xref{Files and Storage}.
address@hidden defvar
+
 @defmac with-temp-file file address@hidden
 @anchor{Definition of with-temp-file}
 The @code{with-temp-file} macro evaluates the @var{body} forms with a
@@ -1812,12 +1821,15 @@ copy on secondary storage is lost due to media failure. 
 Second, the
 operating system might not write data to secondary storage
 immediately, which will lose the data if power is lost.
 
address@hidden write-region
address@hidden write-region-inhibit-fsync
 Although both sorts of failures can largely be avoided by a suitably
 configured file system, such systems are typically more expensive or
 less efficient.  In more-typical systems, to survive media failure you
 can copy the file to a different device, and to survive a power
-failure you can invoke the @command{sync} utility (@pxref{sync
-invocation,,, coreutils, The @sc{gnu} @code{Coreutils} Manual}).
+failure you can use the @code{write-region} function with the
address@hidden variable set to @code{nil}.
address@hidden to Files}.
 
 @node File Names
 @section File Names



reply via email to

[Prev in Thread] Current Thread [Next in Thread]