[Emacs-diffs] /srv/bzr/emacs/trunk r106740: doc: Use clearer notations for permissions.

[Paul Eggert]

------------------------------------------------------------
revno: 106740
committer: Paul Eggert <address@hidden>
branch nick: trunk
timestamp: Tue 2011-12-27 22:59:21 -0800
message:
  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.
modified:
  doc/lispref/ChangeLog
  doc/lispref/files.texi
  doc/misc/ChangeLog
  doc/misc/gnus.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-12-23 13:14:12 +0000
+++ b/doc/lispref/ChangeLog     2011-12-28 06:59:21 +0000
@@ -1,3 +1,8 @@
+2011-12-28  Paul Eggert  <address@hidden>
+
+       * files.texi (File Attributes, Changing Files):
+       Use a more-natural notation for octal numbers.
+
 2011-12-23  Juanma Barranquero  <address@hidden>
 
        * variables.texi (Variables with Restricted Values):

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2011-11-13 07:48:23 +0000
+++ b/doc/lispref/files.texi    2011-12-28 06:59:21 +0000
@@ -1115,16 +1115,11 @@
 @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.}
address@hidden group
-
address@hidden
 % ls -l diffs
   -rw-rw-rw-  1 lewis 0 3063 Oct 30 16:00 diffs
 @end group
@@ -1570,10 +1565,10 @@
 
 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

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2011-12-20 16:00:47 +0000
+++ b/doc/misc/ChangeLog        2011-12-28 06:59:21 +0000
@@ -1,3 +1,10 @@
+2011-12-28  Paul Eggert  <address@hidden>
+
+       * 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  <address@hidden>
 
        * cc-mode.texi: Update version string 5.31 -> 5.32.

=== modified file 'doc/misc/gnus.texi'
--- a/doc/misc/gnus.texi        2011-12-14 21:05:20 +0000
+++ b/doc/misc/gnus.texi        2011-12-28 06:59:21 +0000
@@ -15033,7 +15033,7 @@
 
 @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 @@
 
 @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