From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 21 Mar 2024 19:35:24 +0000 (+0200)
Subject: ; Improve documentation of 'backup-by-copying'
X-Git-Tag: archive/raspbian/1%29.4+1-4+rpi1~1^2~2^2~18^2~12
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=afb7a23e7b914b4c3b72172ae86a5f7e63f2cfde;p=emacs.git

; Improve documentation of 'backup-by-copying'

* doc/emacs/files.texi (Backup Copying): Recommend
'backup-by-copying' for files on file-hosting services.  (Bug#69930)
---

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 971483a6e4c..d074a55b762 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -779,6 +779,12 @@ operations typically break hard links, disconnecting the file name you
 visited from any alternate names for the same file.  This has nothing
 to do with Emacs---the version control system does it.
 
+  Some file storage services support @dfn{file versioning}: they
+record history of previous versions of files, and allow reverting to
+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.
+
 @node Customize Save
 @subsection Customizing Saving of Files