diff options
| author | Paul Eggert <eggert@cs.ucla.edu> | 2011-12-27 22:59:21 -0800 |
|---|---|---|
| committer | Paul Eggert <eggert@cs.ucla.edu> | 2011-12-27 22:59:21 -0800 |
| commit | 8d80ef01d987f052dc8ee641cc65189299e230de (patch) | |
| tree | bf9ed2c837b81581c60897094a21e29e80b185b9 | |
| parent | 51281b3202901a846f7427e630a9615b1d55eac8 (diff) | |
| download | emacs-8d80ef01d987f052dc8ee641cc65189299e230de.tar.gz | |
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.
| -rw-r--r-- | doc/lispref/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/lispref/files.texi | 11 | ||||
| -rw-r--r-- | doc/misc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 6 |
4 files changed, 18 insertions, 11 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 5b90c2a1f9f..d4f9ab747ed 100644 --- 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 86ecfd122ef..b6d0b5c7ed2 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi @@ -1115,16 +1115,11 @@ 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 @end group @@ -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 dcf816e7fd3..3b0e5251d5e 100644 --- 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 8ed57699df5..86aaadf8ae8 100644 --- 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 |