# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1227677468 0
# Node ID 38651f6d4a22547a47240d4fee9b4e8c2d6f9728
# Parent  c1a4ae9a6c45aea5cca26b553cc7bd47d81bb363
(Misc File Ops): Document set-file-modes.

diff -r c1a4ae9a6c45 -r 38651f6d4a22 doc/emacs/files.texi
--- a/doc/emacs/files.texi	Wed Nov 26 05:30:59 2008 +0000
+++ b/doc/emacs/files.texi	Wed Nov 26 05:31:08 2008 +0000
@@ -1580,6 +1580,18 @@
   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