File name aliases in the Emacs manual

File name aliases in the Emacs manual

[Sven Joachim]

Section 23.6, "File Name Aliases" of the Emacs manual states:

,----
|    If you visit two names for the same file, normally Emacs makes two
| different buffers, but it warns you about the situation.
`----

This is not correct; what Emacs actually does is described in the
following paragraph.  It seems this sentence should simply be removed.
The following patch to man/files.texi fixes this and also describes
two other situations where multiple names refer to the same file.


*** files.texi~	2005-12-20 22:50:02.000000000 +0100
--- files.texi	2006-01-15 11:20:41.000000000 +0100
***************
*** 1150,1170 ****
   @file{foo} is just an alias.  More complex cases occur when symbolic
   links point to directories.

-   If you visit two names for the same file, normally Emacs makes
- two different buffers, but it warns you about the situation.
-
   @vindex find-file-existing-other-name
   @vindex find-file-suppress-same-file-warnings
!   Normally, if you visit a file which Emacs is already visiting under
! a different name, Emacs displays a message in the echo area and uses
! the existing buffer visiting that file.  This can happen on systems
! that support symbolic links, or if you use a long file name on a
! system that truncates long file names.  You can suppress the message by
! setting the variable @code{find-file-suppress-same-file-warnings} to a
! non-@code{nil} value.  You can disable this feature entirely by setting
! the variable @code{find-file-existing-other-name} to @code{nil}: then
! if you visit the same file under two different names, you get a separate
! buffer for each file name.

   @vindex find-file-visit-truename
   @cindex truenames of files
--- 1150,1168 ----
   @file{foo} is just an alias.  More complex cases occur when symbolic
   links point to directories.

   @vindex find-file-existing-other-name
   @vindex find-file-suppress-same-file-warnings
!   Normally, if you visit a file which Emacs is already visiting under a
! different name, Emacs displays a message in the echo area and uses the
! existing buffer visiting that file.  This can happen on systems that
! support hard or symbolic links, if you use a long file name on a system
! that truncates long file names, or on a case insensitive file system.
! You can suppress the message by setting the variable
! @code{find-file-suppress-same-file-warnings} to a non-@code{nil} value.
! You can disable this feature entirely by setting the variable
! @code{find-file-existing-other-name} to @code{nil}: then if you visit
! the same file under two different names, you get a separate buffer for
! each file name.

   @vindex find-file-visit-truename
   @cindex truenames of files


ChangeLog entry:

2006-01-15  Sven Joachim  <svenjoac@gmx.de>

	* files.texi (File Aliases): Clean up.


Can somebody please install this?