summaryrefslogtreecommitdiff
path: root/doc/lispref/files.texi
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2023-02-23 17:45:52 +0200
committerEli Zaretskii <eliz@gnu.org>2023-02-23 17:45:52 +0200
commita0b273ef300adabac0cb656fcc3657ebaf6ed528 (patch)
tree17731e74f34af6e96cca3ddc108c55550a16dec3 /doc/lispref/files.texi
parent5c2be6a2632052b39b49899d1b19df2942ac6453 (diff)
downloademacs-a0b273ef300adabac0cb656fcc3657ebaf6ed528.tar.gz
emacs-a0b273ef300adabac0cb656fcc3657ebaf6ed528.tar.bz2
emacs-a0b273ef300adabac0cb656fcc3657ebaf6ed528.zip
; Clarify documentation of 'file-modes-number-to-symbolic'
* doc/lispref/files.texi (Changing Files): * lisp/files.el (file-modes-number-to-symbolic): Clarify the confusion with "symbolic" forms of file modes. (Bug#61709)
Diffstat (limited to 'doc/lispref/files.texi')
-rw-r--r--doc/lispref/files.texi6
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 5062b1697b5..f8781d4895b 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -1985,7 +1985,11 @@ all.
@defun file-modes-number-to-symbolic modes
This function converts a numeric file mode specification in
-@var{modes} into the equivalent symbolic form.
+@var{modes} into the equivalent string form. The string which this
+function returns is in the same format produced by the shell command
+@kbd{ls -l} and by @code{file-attributes}, @emph{not} the symbolic
+form accepted by @code{file-modes-symbolic-to-number} and the
+@command{chmod} shell command.
@end defun
@defun set-file-times filename &optional time flag