X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/9e2b495b7085a76d3d6ea521312d080aa6479965..eddd51c2807805e47aa70008234111b601e9a050:/lispref/files.texi

diff --git a/lispref/files.texi b/lispref/files.texi
index db196c8f7e..c951456951 100644
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -964,7 +964,10 @@ as in @samp{ls -l}.
 deleted and recreated; @code{nil} otherwise.
 
 @item
-The file's inode number.
+The file's inode number.  If possible, this is an integer.  If the inode
+number is too large to be represented as an integer in Emacs Lisp, then
+the value has the form @code{(@var{high} . @var{low})}, where @var{low}
+holds the low 16 bits.
 
 @item
 The file system number of the file system that the file is in.  This
@@ -1561,8 +1564,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/")