deac/gitolite
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

example conf: doc on NAME/ being a refex etc was not clear

Browse source
This commit is contained in:
Sitaram Chamarty 2010-02-08 09:59:27 +05:30
parent a6b7928bc1
commit 0e96c2f08a
1 changed files with 13 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
conf/example.conf
View file

@ -83,6 +83,7 @@
# If none of them match, it fails # If none of them match, it fails
# what's a refex? a regex to match against the ref being updated (get it?) # what's a refex? a regex to match against the ref being updated (get it?)
# See next section for more on refexes
# BASIC PERMISSIONS (repo level only; apply to all branches/tags in repo) # BASIC PERMISSIONS (repo level only; apply to all branches/tags in repo)
@ -114,13 +115,16 @@ repo @oss_repos
repo @all repo @all
RW+ = @admins RW+ = @admins
# ADVANCED PERMISSIONS USING REFEXES # SPECIFYING AND USING A REFEX
# - refexes are specified in perl regex syntax # - refexes are specified in perl regex syntax
# - refexes are matched without any anchoring, which means a refex like # - refexes are prefix-matched (they are internally anchored with "^"
# "refs/tags/v[0-9]" matches anything *containing* that pattern. There # before being used), which means a refex like "refs/tags/v[0-9]"
# may be text before and after it (example: refs/tags/v4-r3p7), and it # matches anything *starting with* that pattern. There may be text
# will still match # after it (example: refs/tags/v4-r3/p7), and it will still match
# ADVANCED PERMISSIONS USING REFEXES
# - if no refex appears, the rule applies to all refs in that repo # - if no refex appears, the rule applies to all refs in that repo
# - a refex is automatically prefixed by "refs/heads/" if it doesn't start # - a refex is automatically prefixed by "refs/heads/" if it doesn't start
# with "refs/" (so tags have to be explicitly named as # with "refs/" (so tags have to be explicitly named as
@ -191,7 +195,9 @@ repo foo
# Notes # Notes
# - the "NAME/" is part of the syntax; think of it as a keyword if you like # - the "NAME/" is part of the syntax; think of it as a keyword if you like.
# The rest of it is treated as a refex to match against each file being
# touched (see "SPECIFYING AND USING A REFEX" above for details)
# - file/dir NAME-based restrictions are *in addition* to normal (branch-name # - file/dir NAME-based restrictions are *in addition* to normal (branch-name
# based) restrictions; they are not a *replacement* for them. This is why # based) restrictions; they are not a *replacement* for them. This is why
@ -284,7 +290,7 @@ repo gitolite
repo EXTCMD/rsync repo EXTCMD/rsync
# grant permissions to files/dirs within the $RSYNC_BASE tree. A leading # grant permissions to files/dirs within the $RSYNC_BASE tree. A leading
# NAME/ is required as a prefix; the actual path starts after that. Matching # NAME/ is required as a prefix; the actual path starts after that. Matching
# follows the same rules as elsewhere in gitolite. # follows the same rules as given in "FILE/DIR NAME BASED RESTRICTIONS" above
RW NAME/ = sitaram RW NAME/ = sitaram
RW NAME/foo/ = user1 RW NAME/foo/ = user1
R NAME/bar/ = user2 R NAME/bar/ = user2