From: Eli Zaretskii <eliz@gnu.org>
Date: Mon, 19 Oct 2015 05:31:58 +0000 (+0300)
Subject: Improve documentation of functions that change files
X-Git-Tag: emacs-25.0.90~1091
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=bca2bc4fe973d3b40b58805c4b426757f5c85dc8;p=emacs.git

Improve documentation of functions that change files

* doc/lispref/files.texi (Changing Files): Document that these
functions signal an error on failure.
---

diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index db2ecc08f95..4d2761ed419 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -1481,7 +1481,10 @@ in @code{exec-path}, and tries all the file-name extensions in
 @cindex setting modes of files
 
   The functions in this section rename, copy, delete, link, and set
-the modes (permissions) of files.
+the modes (permissions) of files.  They all signal a @code{file-error}
+error if they fail to perform their function, reporting the
+system-dependent error message that describes the reason for the
+failure.
 
   In the functions that have an argument @var{newname}, if a file by the
 name of @var{newname} already exists, the actions taken depend on the