; 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 971483a6e4cf8e41ba41f1f997d44d41980fc2fc..d074a55b76211087edb899b194cdaa86fe1c3890 100644 (file)
--- 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