[Emacs-diffs] master bca2bc4: Improve documentation of functions that change files

[Eli Zaretskii]

branch: master
commit bca2bc4fe973d3b40b58805c4b426757f5c85dc8
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve documentation of functions that change files
    
    * doc/lispref/files.texi (Changing Files): Document that these
    functions signal an error on failure.
---
 doc/lispref/files.texi |    5 ++++-
 1 files changed, 4 insertions(+), 1 deletions(-)

diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index db2ecc0..4d2761e 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