Documentation: git-init: list items facelift
No textual change. Signed-off-by: Linus Arver <linusarver@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Linus Arver committed
Aug 8, 2014 at 10:29 UTC
ddeab3aea3c81783b13ff7091552c205d0884675
1 file changed
+28
-21
Documentation/git-init.txt
+28
-21
@@ -72,30 +72,37 @@ repository. When specified, the config variable "core.sharedRepository" is
72
set so that files and directories under `$GIT_DIR` are created with the
73
requested permissions. When not specified, Git will use permissions reported
74
by umask(2).
75
-
75
++
76
The option can have the following values, defaulting to 'group' if no value
77
is given:
78
++
79
+--
80
+'umask' (or 'false')::
81
+
82
+Use permissions reported by umask(2). The default, when `--shared` is not
83
+specified.
84
+
85
+'group' (or 'true')::
86
79
- - 'umask' (or 'false'): Use permissions reported by umask(2). The default,
80
- when `--shared` is not specified.
81
-
82
- - 'group' (or 'true'): Make the repository group-writable, (and g+sx, since
83
- the git group may be not the primary group of all users).
84
- This is used to loosen the permissions of an otherwise safe umask(2) value.
85
- Note that the umask still applies to the other permission bits (e.g. if
86
- umask is '0022', using 'group' will not remove read privileges from other
87
- (non-group) users). See '0xxx' for how to exactly specify the repository
88
- permissions.
89
-
90
- - 'all' (or 'world' or 'everybody'): Same as 'group', but make the repository
91
- readable by all users.
92
-
93
- - '0xxx': '0xxx' is an octal number and each file will have mode '0xxx'.
94
- '0xxx' will override users' umask(2) value (and not only loosen permissions
95
- as 'group' and 'all' does). '0640' will create a repository which is
96
- group-readable, but not group-writable or accessible to others. '0660' will
97
- create a repo that is readable and writable to the current user and group,
98
- but inaccessible to others.
87
+Make the repository group-writable, (and g+sx, since the git group may be not
88
+the primary group of all users). This is used to loosen the permissions of an
89
+otherwise safe umask(2) value. Note that the umask still applies to the other
90
+permission bits (e.g. if umask is '0022', using 'group' will not remove read
91
+privileges from other (non-group) users). See '0xxx' for how to exactly specify
92
+the repository permissions.
93
+
94
+'all' (or 'world' or 'everybody')::
95
+
96
+Same as 'group', but make the repository readable by all users.
97
+
98
+'0xxx'::
99
+
100
+'0xxx' is an octal number and each file will have mode '0xxx'. '0xxx' will
101
+override users' umask(2) value (and not only loosen permissions as 'group' and
102
+'all' does). '0640' will create a repository which is group-readable, but not
103
+group-writable or accessible to others. '0660' will create a repo that is
104
+readable and writable to the current user and group, but inaccessible to others.
105
+--
106
107
By default, the configuration flag `receive.denyNonFastForwards` is enabled
108
in shared repositories, so that you cannot force a non fast-forwarding push