diff options
| author | Eli Zaretskii <eliz@gnu.org> | 2021-08-21 10:58:24 +0300 |
|---|---|---|
| committer | Eli Zaretskii <eliz@gnu.org> | 2021-08-21 10:58:24 +0300 |
| commit | beb54dc1b2b00cb4541b82acf6ead8a8075c3011 (patch) | |
| tree | 59ca4dc09bc48246f8c7e38460520ddd9d288e39 /doc/emacs/files.texi | |
| parent | 4b03998458475d98ceabc5b4d0a6279913e77e3a (diff) | |
| download | emacs-beb54dc1b2b00cb4541b82acf6ead8a8075c3011.tar.gz emacs-beb54dc1b2b00cb4541b82acf6ead8a8075c3011.tar.bz2 emacs-beb54dc1b2b00cb4541b82acf6ead8a8075c3011.zip | |
Improve documentation of 'file-preserve-symlinks-on-save'
* lisp/files.el (file-precious-flag): Mention
'file-preserve-symlinks-on-save' in the doc string.
* doc/lispref/files.texi (Saving Buffers): Move the description of
'file-preserve-symlinks-on-save' from here...
* doc/emacs/files.texi (Customize Save): ...to here. Improve
wording.
* etc/NEWS: Fix wording of 'file-preserve-symlinks-on-save' entry.
Diffstat (limited to 'doc/emacs/files.texi')
| -rw-r--r-- | doc/emacs/files.texi | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index 207c951a875..9aae0e9a0b3 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -742,6 +742,17 @@ always supposed to end in newlines. Such major modes set the variable setting the latter variable, you can control how these modes handle final newlines. +@vindex file-preserve-symlinks-on-save +If this option is non-@code{nil} and you're visiting a file via a +symbolic link, Emacs will break the symbolic link upon saving the +buffer, and will write the buffer to a file with the same name as the +symbolic link, if the value of @code{file-precious-flag} is +non-@code{nil} (@pxref{Saving Buffers, file-precious-flag,, elisp, The +Emacs Lisp Reference Manual}). If you want Emacs to save the buffer +to the file the symbolic link points to (thereby preserving the link) +in these cases, customize the variable +@code{file-preserve-symlinks-on-save} to @code{t}. + @vindex write-region-inhibit-fsync Normally, when a program writes a file, the operating system briefly caches the file's data in main memory before committing the data to |