diff options
| author | Eli Zaretskii <eliz@gnu.org> | 2023-02-23 17:45:52 +0200 |
|---|---|---|
| committer | Eli Zaretskii <eliz@gnu.org> | 2023-02-23 17:45:52 +0200 |
| commit | a0b273ef300adabac0cb656fcc3657ebaf6ed528 (patch) | |
| tree | 17731e74f34af6e96cca3ddc108c55550a16dec3 /lisp/files.el | |
| parent | 5c2be6a2632052b39b49899d1b19df2942ac6453 (diff) | |
| download | emacs-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 'lisp/files.el')
| -rw-r--r-- | lisp/files.el | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/lisp/files.el b/lisp/files.el index 57e01340359..db3f348c4b5 100644 --- a/lisp/files.el +++ b/lisp/files.el @@ -8391,11 +8391,14 @@ as in \"og+rX-w\"." num-rights)) (defun file-modes-number-to-symbolic (mode &optional filetype) - "Return a string describing a file's MODE. + "Return a description of a file's MODE as a string of 10 letters and dashes. +The returned string is like the mode description produced by \"ls -l\". For instance, if MODE is #o700, then it produces `-rwx------'. -FILETYPE if provided should be a character denoting the type of file, -such as `?d' for a directory, or `?l' for a symbolic link and will override -the leading `-' char." +Note that this is NOT the same as the \"chmod\" style symbolic description +accepted by `file-modes-symbolic-to-number'. +FILETYPE, if provided, should be a character denoting the type of file, +such as `?d' for a directory, or `?l' for a symbolic link, and will override +the leading `-' character." (string (or filetype (pcase (ash mode -12) |