Code

Documentation: update tar.umask default
authorRené Scharfe <rene.scharfe@lsrfire.ath.cx>
Tue, 21 Aug 2007 18:01:16 +0000 (20:01 +0200)
committerJunio C Hamano <gitster@pobox.com>
Wed, 22 Aug 2007 22:19:41 +0000 (15:19 -0700)
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>
Documentation/config.txt
Documentation/git-archive.txt
Documentation/git-tar-tree.txt

index 46f40ad4c25edb73bfa34c84cff7b11bf271eb48..462595cf8f8e58dd0b861333000ad4c6f77fabe5 100644 (file)
@@ -675,15 +675,11 @@ showbranch.default::
        See gitlink:git-show-branch[1].
 
 tar.umask::
-       By default, gitlink:git-tar-tree[1] sets file and directories modes
-       to 0666 or 0777. While this is both useful and acceptable for projects
-       such as the Linux Kernel, it might be excessive for other projects.
-       With this variable, it becomes possible to tell
-       gitlink:git-tar-tree[1] to apply a specific umask to the modes above.
-       The special value "user" indicates that the user's current umask will
-       be used. This should be enough for most projects, as it will lead to
-       the same permissions as gitlink:git-checkout[1] would use. The default
-       value remains 0, which means world read-write.
+       This variable can be used to restrict the permission bits of
+       tar archive entries.  The default is 0002, which turns off the
+       world write bit.  The special value "user" indicates that the
+       archiving user's umask will be used instead.  See umask(2) and
+       gitlink:git-archive[1].
 
 user.email::
        Your email address to be recorded in any newly created commits.
index 4da07c158053bd037f32ff74516c7b2dfeec723b..f2080eb6ad35282107fd5500eb9cba9290497cb9 100644 (file)
@@ -72,16 +72,13 @@ zip
 
 CONFIGURATION
 -------------
-By default, file and directories modes are set to 0666 or 0777 in tar
-archives.  It is possible to change this by setting the "umask" variable
-in the repository configuration as follows :
 
-[tar]
-        umask = 002    ;# group friendly
-
-The special umask value "user" indicates that the user's current umask
-will be used instead. The default value remains 0, which means world
-readable/writable files and directories.
+tar.umask::
+       This variable can be used to restrict the permission bits of
+       tar archive entries.  The default is 0002, which turns off the
+       world write bit.  The special value "user" indicates that the
+       archiving user's umask will be used instead.  See umask(2) for
+       details.
 
 EXAMPLES
 --------
index 2d01d9666fd2ab5f53ab2265ca701d56ea370f8b..434607bfb5d105cb2e1a9ce0bdf5a3261ec64e78 100644 (file)
@@ -42,16 +42,13 @@ OPTIONS
 
 CONFIGURATION
 -------------
-By default, file and directories modes are set to 0666 or 0777. It is
-possible to change this by setting the "umask" variable in the
-repository configuration as follows :
 
-[tar]
-        umask = 002    ;# group friendly
-
-The special umask value "user" indicates that the user's current umask
-will be used instead.  The default value is 002, which means group
-readable/writable files and directories.
+tar.umask::
+       This variable can be used to restrict the permission bits of
+       tar archive entries.  The default is 0002, which turns off the
+       world write bit.  The special value "user" indicates that the
+       archiving user's umask will be used instead.  See umask(2) for
+       details.
 
 EXAMPLES
 --------