aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Eggert2016-09-11 15:09:04 -0700
committerPaul Eggert2016-09-11 15:44:05 -0700
commit073048d5de3ddc720fe11589cadaebab74e668df (patch)
tree5dbedcfd96610bbc878a22526a1ea4ee65cdf3ae
parentc417f08b16cd9e16451a6d3231097eeb4a804f2d (diff)
downloademacs-073048d5de3ddc720fe11589cadaebab74e668df.tar.gz
emacs-073048d5de3ddc720fe11589cadaebab74e668df.zip
Remove unnecessary ref to coreutils manual
* doc/lispref/files.texi: Document write-region-inhibit-fsync.
-rw-r--r--doc/lispref/files.texi16
1 files changed, 14 insertions, 2 deletions
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index b912d7bc8f5..9a56d0ada27 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,
661files that the user does not need to know about. 661files that the user does not need to know about.
662@end deffn 662@end deffn
663 663
664@defvar write-region-inhibit-fsync
665If this variable's value is @code{nil}, @code{write-region} uses the
666@code{fsync} system call after writing a file. Although this slows
667Emacs down, it lessens the risk of data loss after power failure. If
668the value is @code{t}, Emacs does not use @code{fsync}. The default
669value is @code{nil} when Emacs is interactive, and @code{t} when Emacs
670runs in batch mode. @xref{Files and Storage}.
671@end defvar
672
664@defmac with-temp-file file body@dots{} 673@defmac with-temp-file file body@dots{}
665@anchor{Definition of with-temp-file} 674@anchor{Definition of with-temp-file}
666The @code{with-temp-file} macro evaluates the @var{body} forms with a 675The @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
1812operating system might not write data to secondary storage 1821operating system might not write data to secondary storage
1813immediately, which will lose the data if power is lost. 1822immediately, which will lose the data if power is lost.
1814 1823
1824@findex write-region
1825@vindex write-region-inhibit-fsync
1815Although both sorts of failures can largely be avoided by a suitably 1826Although both sorts of failures can largely be avoided by a suitably
1816configured file system, such systems are typically more expensive or 1827configured file system, such systems are typically more expensive or
1817less efficient. In more-typical systems, to survive media failure you 1828less efficient. In more-typical systems, to survive media failure you
1818can copy the file to a different device, and to survive a power 1829can copy the file to a different device, and to survive a power
1819failure you can invoke the @command{sync} utility (@pxref{sync 1830failure you can use the @code{write-region} function with the
1820invocation,,, coreutils, The @sc{gnu} @code{Coreutils} Manual}). 1831@code{write-region-inhibit-fsync} variable set to @code{nil}.
1832@xref{Writing to Files}.
1821 1833
1822@node File Names 1834@node File Names
1823@section File Names 1835@section File Names