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

set to t.

diff --git a/man/files.texi b/man/files.texi
index 62b1b9cc63f0f93f9125e4383ef2367ec046a59c..6a7eb3349f60e33ea1c0d9c2d3db34db2a97713d 100644 (file)
--- 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