# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1224179974 0
# Node ID 05eaa923b9eb3c2079c6a3a77eff016c56f27995
# Parent  33743665b315a932483999ce71ebccf16771557e
(Fexpand_file_name): Doc fix.

diff -r 33743665b315 -r 05eaa923b9eb src/fileio.c
--- a/src/fileio.c	Thu Oct 16 17:59:24 2008 +0000
+++ b/src/fileio.c	Thu Oct 16 17:59:34 2008 +0000
@@ -819,7 +819,13 @@
 file names in the file system.
 An initial `~/' expands to your home directory.
 An initial `~USER/' expands to USER's home directory.
-See also the function `substitute-in-file-name'.  */)
+See also the function `substitute-in-file-name'.
+
+For technical reasons, this function can return correct but
+non-intuitive results for the root directory; for instance,
+\(expand-file-name ".." "/") returns "/..".  For this reason, use
+(directory-file-name (file-name-directory dirname)) to traverse a
+filesystem tree, not (expand-file-name ".."  dirname).  */)
      (name, default_directory)
      Lisp_Object name, default_directory;
 {