doc: Use clearer notations for permissions.

* doc/lispref/files.texi (File Attributes, Changing Files):
Use a more-natural notation for octal numbers.
* doc/misc/gnus.texi (Mail Source Customization, Mail Back End Variables):
Use octal notation for file permissions, which are normally
thought of in octal.
(Mail Back End Variables): Use more-plausible modes in example.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 5b90c2a1f9fd5da15a3b5bd9967129cd7e702a2b..d4f9ab747edce82d0315863eeaceea817d98a399 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-12-28  Paul Eggert  <eggert@cs.ucla.edu>
+
+       * files.texi (File Attributes, Changing Files):
+       Use a more-natural notation for octal numbers.
+
 2011-12-23  Juanma Barranquero  <lekktu@gmail.com>
 
        * variables.texi (Variables with Restricted Values):

diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 86ecfd122ef2ee3d514d7a2edd0f164c823e3fcd..b6d0b5c7ed2c8d8a5121617242340d105c879d96 100644 (file)
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -1115,15 +1115,10 @@ This function recursively follows symbolic links at all levels.
 @end group
 
 @group
-(set-file-modes "~/junk/diffs" 438)
+(set-file-modes "~/junk/diffs" #o666)
      @result{} nil
 @end group
 
-@group
-(format "%o" 438)
-     @result{} "666"             ; @r{Convert to octal.}
-@end group
-
 @group
 % ls -l diffs
   -rw-rw-rw-  1 lewis 0 3063 Oct 30 16:00 diffs
@@ -1570,10 +1565,10 @@ the bitwise complement of the ``umask'' value.
 
 The argument @var{mode} must be an integer.  On most systems, only the
 low 9 bits of @var{mode} are meaningful.  You can use the Lisp construct
-for octal character codes to enter @var{mode}; for example,
+for octal numbers to enter @var{mode}; for example,
 
 @example
-(set-default-file-modes ?\644)
+(set-default-file-modes #o644)
 @end example
 
 Saving a modified version of an existing file does not count as creating

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index dcf816e7fd3718109b040cf7b953e4104aabbda5..3b0e5251d5e13b8ad65628b4dc4ed863ce25acd9 100644 (file)
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,10 @@
+2011-12-28  Paul Eggert  <eggert@cs.ucla.edu>
+
+       * gnus.texi (Mail Source Customization, Mail Back End Variables):
+       Use octal notation for file permissions, which are normally
+       thought of in octal.
+       (Mail Back End Variables): Use more-plausible modes in example.
+
 2011-12-20  Alan Mackenzie  <acm@muc.de>
 
        * cc-mode.texi: Update version string 5.31 -> 5.32.

diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 8ed57699df5c598a943b6d04c2645efe4790fab9..86aaadf8ae8412b456d92efffc8f818fbacf4f63 100644 (file)
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -15033,7 +15033,7 @@ number.
 
 @item mail-source-default-file-modes
 @vindex mail-source-default-file-modes
-All new mail files will get this file mode.  The default is 384.
+All new mail files will get this file mode.  The default is @code{#o600}.
 
 @item mail-source-movemail-program
 @vindex mail-source-movemail-program
@@ -15123,10 +15123,10 @@ default file modes the new mail files get:
 
 @lisp
 (add-hook 'nnmail-pre-get-new-mail-hook
-          (lambda () (set-default-file-modes 511)))
+          (lambda () (set-default-file-modes #o700)))
 
 (add-hook 'nnmail-post-get-new-mail-hook
-          (lambda () (set-default-file-modes 551)))
+          (lambda () (set-default-file-modes #o775)))
 @end lisp
 
 @item nnmail-use-long-file-names