; Improve documentation of 'backup-by-copying'

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

(cherry picked from commit afb7a23e7b914b4c3b72172ae86a5f7e63f2cfde)

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 86dbf50acb0e4f3b16f1f7969307fda9bc4a6d3a..d98b1936fe4b6fcaa72b2db793566c0625bd6ccd 100644 (file)
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -777,6 +777,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