--- a/man/lispref/files.texi	Mon Aug 13 09:00:04 2007 +0200
+++ b/man/lispref/files.texi	Mon Aug 13 09:02:59 2007 +0200
@@ -455,8 +455,8 @@
 @deffn Command append-to-file start end filename
 This function appends the contents of the region delimited by
 @var{start} and @var{end} in the current buffer to the end of file
-@var{filename}.  If that file does not exist, it is created.  If that
-file exists it is overwritten.  This function returns @code{nil}.
+@var{filename}.  If that file does not exist, it is created.  This
+function returns @code{nil}.
 
 An error is signaled if @var{filename} specifies a nonwritable file,
 or a nonexistent file in a directory where files cannot be created.
@@ -1567,7 +1567,8 @@
 @defun file-relative-name filename &optional 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}.
+relative to @var{directory}.  (If such a relative name would be longer
+than the absolute name, it returns the absolute name instead.)
 
 @c XEmacs feature?
 If @var{directory} is @code{nil} or omitted, the value of
@@ -1577,7 +1578,7 @@
 (file-relative-name "/foo/bar" "/foo/")
      @result{} "bar")
 (file-relative-name "/foo/bar" "/hack/")
-     @result{} "../foo/bar")
+     @result{} "/foo/bar")
 @end example
 @end defun