# HG changeset patch
# User Glenn Morris <rgm@gnu.org>
# Date 1176956533 0
# Node ID 95a196e2e4659098db2bdd95248a14a6a2dc8c4d
# Parent  db3b79cf4b09192adf4596b38e42c3d60f76dec4
(File Name Expansion): Mention "superroot".

diff -r db3b79cf4b09 -r 95a196e2e465 lispref/files.texi
--- a/lispref/files.texi	Thu Apr 19 04:22:04 2007 +0000
+++ b/lispref/files.texi	Thu Apr 19 04:22:13 2007 +0000
@@ -1990,6 +1990,19 @@
 @end group
 @end example
 
+In some cases, a leading @samp{..} can remain in the output:
+
+@example
+@group
+(expand-file-name "../home" "/")
+     @result{} "/../home"
+@end group
+@end example
+
+This is for use with filesystems that have the concept of a
+``superroot'' above the root directory @file{/}.  On other filesystems,
+@file{/../} is interpreted exactly the same as @file{/}.
+
 Note that @code{expand-file-name} does @emph{not} expand environment
 variables; only @code{substitute-in-file-name} does that.