From: Glenn Morris <rgm@gnu.org>
Date: Thu, 19 Apr 2007 04:22:13 +0000 (+0000)
Subject: (File Name Expansion): Mention "superroot".
X-Git-Tag: emacs-pretest-22.0.99~176
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=34f23456fc6b4366f516bfee348d6d331c75cfea;p=emacs.git

(File Name Expansion): Mention "superroot".
---

diff --git a/lispref/files.texi b/lispref/files.texi
index f357b1f3814..e2bc57c5567 100644
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -1990,6 +1990,19 @@ canonical form:
 @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.