From: Eli Zaretskii <eliz@gnu.org>
Date: Tue, 21 May 2024 12:34:50 +0000 (+0300)
Subject: ; Improve documentation of backing up files
X-Git-Tag: archive/raspbian/1%29.4+1-4+rpi1~1^2~2^2~17^2~27
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=5ab144c77cda1d56f0dd62606c316c712a0d2563;p=emacs.git

; Improve documentation of backing up files

* doc/emacs/files.texi (Backup Copying): Mention that
'backup-by-copying' is safer.  Document 'file-precious-flag'.
(Bug#71074)
---

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 393c4728422..01d22564f2e 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -786,6 +786,14 @@ those previous versions.  If you want to be able to do that with files
 hosted by those services when editing them with Emacs, customize
 @code{backup-by-copying} to a non-@code{nil} value.
 
+@vindex file-precious-flag
+  Copying the old file for backup is also useful when editing precious
+files, because it makes sure the old file keeps its name if something
+fails between the backup and the saving of your edits.  Alternatively,
+you can customize @code{file-precious-flag} to a non-@code{nil} value,
+which implies backups by copying and also protects against I/O errors
+while saving your edits.
+
 @node Customize Save
 @subsection Customizing Saving of Files