procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of set-default-file-modes

Browse source 
* src/fileio.c (Fset_default_file_modes): Doc fix.  (Bug#28875)

* doc/lispref/files.texi (Changing Files): Clarify how the bits in
the argument of set-default-file-modes are used for setting file
permissions.
This commit is contained in:
Eli Zaretskii 2017-10-27 16:53:16 +03:00
parent 933b3a3ee8
commit ec08d70b4f
2 changed files with 12 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
doc/lispref/files.texi
View file

@ -1821,7 +1821,9 @@ has these permissions, or a subset of them (@code{write-region} will
not grant execute permissions even if the default file permissions not grant execute permissions even if the default file permissions
allow execution). On GNU and other POSIX-like systems, the default allow execution). On GNU and other POSIX-like systems, the default
permissions are given by the bitwise complement of the @samp{umask} permissions are given by the bitwise complement of the @samp{umask}
value. value, i.e.@: each bit that is set in the argument @var{mode} will be
@emph{reset} in the default permissions with which Emacs creates
files.
The argument @var{mode} should be an integer which specifies the The argument @var{mode} should be an integer which specifies the
permissions, similar to @code{set-file-modes} above. Only the lowest permissions, similar to @code{set-file-modes} above. Only the lowest

10
src/fileio.c
View file

@ -3125,7 +3125,15 @@ symbolic notation, like the `chmod' command from GNU Coreutils. */)
DEFUN ("set-default-file-modes", Fset_default_file_modes, Sset_default_file_modes, 1, 1, 0, DEFUN ("set-default-file-modes", Fset_default_file_modes, Sset_default_file_modes, 1, 1, 0,
doc: /* Set the file permission bits for newly created files. doc: /* Set the file permission bits for newly created files.
The argument MODE should be an integer; only the low 9 bits are used. The argument MODE should be an integer; only the low 9 bits are used.
This setting is inherited by subprocesses. */) On Posix hosts, this setting is inherited by subprocesses.
This function works by setting the Emacs's file mode creation mask.
Each bit that is set in the mask means that the corresponding bit
in the the permissions of newly created files will be disabled.
Note that when `write-region' creates a file, it resets the
execute bit, even if the mask set by this function allows that bit
by having the corresponding bit in the mask reset. */)
(Lisp_Object mode) (Lisp_Object mode)
{ {
mode_t oldrealmask, oldumask, newumask; mode_t oldrealmask, oldumask, newumask;