Elaborate on the normal operation with find-file-existing-other-name

set to t.

1 files changed, 5 insertions, 0 deletions

diff --git a/man/files.texi b/man/files.texi
index 62b1b9cc63f..6a7eb3349f6 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -975,6 +975,11 @@ links point to directories.
 two different buffers, but it warns you about the situation.
 
 @vindex find-file-existing-other-name 
+  Normally, if you visit a file which Emacs is already visiting under a
+different name, Emacs prints a message in the echo area and uses an
+existing buffer, where that file is visited under another name.  This
+can happen on systems that support symbolic links, or if you use a long
+file name on a system which truncates long file names.
 
   If Emacs should use different buffers when visiting the same file
 under different names, set the variable