Documentation: update tar.umask default
As noted by Mike Hommey, the documentation for the config setting tar.umask is not up-to-date. Commit f08b3b0e2e9ad87767d80ff03b013c686e08ba4b changed the default from 0 to 2; this patch finally documents it. Signed-off-by: Rene Scharfe <rene.scharfe@lsrfire.ath.cx> Signed-off-by: Junio C Hamano <gitster@pobox.com>
René Scharfe committed
Aug 21, 2007 at 20:01 UTC
687157c736d7a1aac152866cbe20030aaa25513f
3 files changed
+17
-27
Documentation/config.txt
+5
-9
@@ -675,15 +675,11 @@ showbranch.default::
675
See gitlink:git-show-branch[1].
676
677
tar.umask::
678
- By default, gitlink:git-tar-tree[1] sets file and directories modes
679
- to 0666 or 0777. While this is both useful and acceptable for projects
680
- such as the Linux Kernel, it might be excessive for other projects.
681
- With this variable, it becomes possible to tell
682
- gitlink:git-tar-tree[1] to apply a specific umask to the modes above.
683
- The special value "user" indicates that the user's current umask will
684
- be used. This should be enough for most projects, as it will lead to
685
- the same permissions as gitlink:git-checkout[1] would use. The default
686
- value remains 0, which means world read-write.
678
+ This variable can be used to restrict the permission bits of
679
+ tar archive entries. The default is 0002, which turns off the
680
+ world write bit. The special value "user" indicates that the
681
+ archiving user's umask will be used instead. See umask(2) and
682
+ gitlink:git-archive[1].
683
684
user.email::
685
Your email address to be recorded in any newly created commits.
Documentation/git-archive.txt
+6
-9
@@ -72,16 +72,13 @@ zip
72
73
CONFIGURATION
74
-------------
75
-By default, file and directories modes are set to 0666 or 0777 in tar
76
-archives. It is possible to change this by setting the "umask" variable
77
-in the repository configuration as follows :
75
79
-[tar]
80
- umask = 002 ;# group friendly
81
-
82
-The special umask value "user" indicates that the user's current umask
83
-will be used instead. The default value remains 0, which means world
84
-readable/writable files and directories.
76
+tar.umask::
77
+ This variable can be used to restrict the permission bits of
78
+ tar archive entries. The default is 0002, which turns off the
79
+ world write bit. The special value "user" indicates that the
80
+ archiving user's umask will be used instead. See umask(2) for
81
+ details.
82
83
EXAMPLES
84
--------
Documentation/git-tar-tree.txt
+6
-9
@@ -42,16 +42,13 @@ OPTIONS
42
43
CONFIGURATION
44
-------------
45
-By default, file and directories modes are set to 0666 or 0777. It is
46
-possible to change this by setting the "umask" variable in the
47
-repository configuration as follows :
45
49
-[tar]
50
- umask = 002 ;# group friendly
51
-
52
-The special umask value "user" indicates that the user's current umask
53
-will be used instead. The default value is 002, which means group
54
-readable/writable files and directories.
46
+tar.umask::
47
+ This variable can be used to restrict the permission bits of
48
+ tar archive entries. The default is 0002, which turns off the
49
+ world write bit. The special value "user" indicates that the
50
+ archiving user's umask will be used instead. See umask(2) for
51
+ details.
52
53
EXAMPLES
54
--------