[Emacs-diffs] emacs/doc/lispref files.texi

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    09/10/07 10:19:21

Modified files:
        doc/lispref    : files.texi 

Log message:
        (Directory Names) <abbreviate-file-name>: Document that root home
        directories are not replaced with "~".

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/files.texi?cvsroot=emacs&r1=1.27&r2=1.28

Patches:
Index: files.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/files.texi,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
--- files.texi  5 Oct 2009 11:49:32 -0000       1.27
+++ files.texi  7 Oct 2009 10:19:21 -0000       1.28
@@ -1957,9 +1957,13 @@
 @defun abbreviate-file-name filename
 @anchor{Definition of abbreviate-file-name}
 This function applies abbreviations from @code{directory-abbrev-alist}
-to its argument, and substitutes @samp{~} for the user's home
-directory.  You can use it for directory names and for file names,
-because it recognizes abbreviations even as part of the name.
+to its argument, and also substitutes @samp{~} for the user's home
+directory if the argument names a file in the home directory or one of
+its subdirectories.  (If the home directory is a root directory, it is
+not replaced with @samp{~}, because this does not make the result
+shorter on many systems.)  You can use it for directory names and for
+file names, because it recognizes abbreviations even as part of the
+name.
 @end defun
 
 @node File Name Expansion