From: Chong Yidong <cyd@stupidchicken.com>
Date: Wed, 26 Nov 2008 05:31:08 +0000 (+0000)
Subject: (Misc File Ops): Document set-file-modes.
X-Git-Tag: emacs-pretest-23.0.90~1509
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=98c0fe50b74191aab3eb9422db78a7709f752ee4;p=emacs.git

(Misc File Ops): Document set-file-modes.
---

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index a393e837c91..ac072dbeaa5 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -1580,6 +1580,18 @@ a relative name as the target of the link.
   Not all systems support symbolic links; on systems that don't
 support them, this command is not defined.
 
+@findex set-file-modes
+@cindex file modes
+@cindex file permissions
+  @kbd{M-x set-file-modes} reads a file name followed by a @dfn{file
+mode}, and applies that file mode to the specified file.  File modes,
+also called @dfn{file permissions}, determine whether a file can be
+read, written to, or executed, and by whom.  This command reads file
+modes using the same symbolic or octal format accepted by the
+@command{chmod} command; for instance, @samp{u+x} means to add
+execution permission for the user who owns the file.  It has no effect
+on operating systems that do not support file modes.
+
 @node Compressed Files
 @section Accessing Compressed Files
 @cindex compression