diff options
| author | Paul Eggert | 2016-09-11 15:09:04 -0700 |
|---|---|---|
| committer | Paul Eggert | 2016-09-11 15:44:05 -0700 |
| commit | 073048d5de3ddc720fe11589cadaebab74e668df (patch) | |
| tree | 5dbedcfd96610bbc878a22526a1ea4ee65cdf3ae | |
| parent | c417f08b16cd9e16451a6d3231097eeb4a804f2d (diff) | |
| download | emacs-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.texi | 16 |
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, | |||
| 661 | files that the user does not need to know about. | 661 | files that the user does not need to know about. |
| 662 | @end deffn | 662 | @end deffn |
| 663 | 663 | ||
| 664 | @defvar write-region-inhibit-fsync | ||
| 665 | If this variable's value is @code{nil}, @code{write-region} uses the | ||
| 666 | @code{fsync} system call after writing a file. Although this slows | ||
| 667 | Emacs down, it lessens the risk of data loss after power failure. If | ||
| 668 | the value is @code{t}, Emacs does not use @code{fsync}. The default | ||
| 669 | value is @code{nil} when Emacs is interactive, and @code{t} when Emacs | ||
| 670 | runs 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} |
| 666 | The @code{with-temp-file} macro evaluates the @var{body} forms with a | 675 | 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 | |||
| 1812 | operating system might not write data to secondary storage | 1821 | operating system might not write data to secondary storage |
| 1813 | immediately, which will lose the data if power is lost. | 1822 | immediately, which will lose the data if power is lost. |
| 1814 | 1823 | ||
| 1824 | @findex write-region | ||
| 1825 | @vindex write-region-inhibit-fsync | ||
| 1815 | Although both sorts of failures can largely be avoided by a suitably | 1826 | Although both sorts of failures can largely be avoided by a suitably |
| 1816 | configured file system, such systems are typically more expensive or | 1827 | configured file system, such systems are typically more expensive or |
| 1817 | less efficient. In more-typical systems, to survive media failure you | 1828 | less efficient. In more-typical systems, to survive media failure you |
| 1818 | can copy the file to a different device, and to survive a power | 1829 | can copy the file to a different device, and to survive a power |
| 1819 | failure you can invoke the @command{sync} utility (@pxref{sync | 1830 | failure you can use the @code{write-region} function with the |
| 1820 | invocation,,, 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 |