From 89c771728bc03623d78312c9d8035218f6a657d5 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Fri, 11 Apr 1997 18:31:38 +0000 Subject: [PATCH] (file-relative-name): Say correctly when the value is absolute. --- lispref/files.texi | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/lispref/files.texi b/lispref/files.texi index db196c8f7ee..950eea2c2af 100644 --- a/lispref/files.texi +++ b/lispref/files.texi @@ -1561,8 +1561,13 @@ variables; only @code{substitute-in-file-name} does that. @defun file-relative-name filename directory This function does the inverse of expansion---it tries to return a relative name that is equivalent to @var{filename} when interpreted -relative to @var{directory}. (If such a relative name would be longer -than the absolute name, it returns the absolute name instead.) +relative to @var{directory}. + +On some operating systems, an absolute file name begins with a device +name. On such systems, @var{filename} has no relative equivalent based +on @var{directory} if they start with two different device names. In +this case, @code{file-relative-name} returns @var{filename} in absolute +form. @example (file-relative-name "/foo/bar" "/foo/") -- 2.11.4.GIT