summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2015-10-19 08:31:58 +0300
committerEli Zaretskii <eliz@gnu.org>2015-10-19 08:31:58 +0300
commitbca2bc4fe973d3b40b58805c4b426757f5c85dc8 (patch)
tree8edc41308d1e6c9d3a7e504f2cb20a625b1c827e
parentb03150f6ebea1a49f7061a3caf184c6e7e6490c7 (diff)
downloademacs-bca2bc4fe973d3b40b58805c4b426757f5c85dc8.tar.gz
Improve documentation of functions that change files
* doc/lispref/files.texi (Changing Files): Document that these functions signal an error on failure.
-rw-r--r--doc/lispref/files.texi5
1 files changed, 4 insertions, 1 deletions
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