gitolite/doc
Sitaram Chamarty 047790140a custom perm categories in setperms (WARNING: PLEASE READ FULL COMMIT MESSAGE)
THE COMPILED CONFIG FILE FORMAT CHANGES WITH THIS VERSION.  PLEASE DO
NOT MIX VERSIONS OR DOWNGRADE.  Upgrading using normal gitolite upgrade
means should be fine, though.

Originally, we only allowed "R" and "RW" as categories of users supplied
to the `setperms` command.  These map respectively to "READERS" and
"WRITERS" in the access rules.

Now:

  - we prefer READERS instead of R and WRITERS instead of RW
  - we allow the admin to define other categories as she wishes
    (example: MANAGERS, TESTERS, etc).  These do not have abbreviations,
    however, so they must be supplied in full.

PLEASE, *PLEASE*, read the section in doc/wildcard-repositories.mkd for
more info.  This is a VERY powerful feature and if you're not careful
you could mess up the ACLs nicely.

Backward compat note: you can continue to use the "R" and "RW"
categories when running the "setperms" command, and gitolite will
internally convert them to READERS and WRITERS categories.

----

implementation notes:

  - new RC var called GL_WILDREPOS_PERM_CATS that is a space-sep list of
    the allowed categories in a gl-perms file; defaults to "R RW" if not
    specified

  - wild_repo_rights no longer returns $c, $r, $wC, where $r = $user if
    "R $user", $r = '@all' if "R @all", and similarly with $w and "RW".

    Instead it returns $c and a new hash that effectively gives the same
    info, but expanded to include any other valid categories (listed in
    GL_WILDREPOS_PERM_CATS)

  - consequently, the arguments that parse_acl takes also change the
    same way

  - (side note: R and RW are quietly converted to READERS and WRITERS;
    however, new categories that you define yourself do not have
    abbreviations)

  - setperms validates perms to make sure only allowed categories are
    used; however even if someone changed them behind the scenes,
    wild_repo_rights will also check.  This is necessary in case the
    admin tightened up GL_WILDREPOS_PERM_CATS after someone had already
    setperms-d his repos.

  - as a bonus, we eliminate all the post-Dumper shenanigans, at least
    for READERS and WRITERS.  Those two now look, to the compile script,
    just like any other usernames.
2010-11-06 21:03:34 +05:30
..
1-INSTALL.mkd cbreak on #git: "I did bet that there are hundreds of sitaram admins out there" 2010-11-05 06:36:35 +05:30
2-admin.mkd (minor) a slew of little docfixes 2010-10-23 23:01:12 +05:30
3-faq-tips-etc.mkd (minor) a slew of little docfixes 2010-10-23 23:01:12 +05:30
admin-defined-commands.mkd a slew of adc changes; details below: 2010-10-28 16:43:04 +05:30
big-config.mkd pubkeys and the pareto principle! 2010-10-26 20:30:10 +05:30
CHANGELOG v1.5.7 2010-11-06 18:53:01 +05:30
COPYING reduce clutter by making src, doc, conf subdirectories 2009-08-27 14:00:00 +05:30
delegation.mkd (minor) a slew of little docfixes 2010-10-23 23:01:12 +05:30
gitolite-and-ssh.mkd more doc revamp; some notes below 2010-09-04 03:10:20 +05:30
hook-propagation.mkd more doc revamp; some notes below 2010-09-04 03:10:20 +05:30
http-backend.mkd (minor) a slew of little docfixes 2010-10-23 23:01:12 +05:30
install-transcript.mkd tighten permissions on install 2010-10-02 05:55:33 +05:30
migrate.mkd gitosis migr doc update to handle user@foo type keys 2010-09-28 11:46:39 +05:30
mirroring.mkd mirror code learns receive.fsckObjects 2010-10-26 20:30:10 +05:30
mob-branches.mkd mob branches document! (wow, that easy? hmm...) 2010-08-09 23:01:01 +05:30
monkeysphere.mkd Monkeysphere integration documentation. 2010-10-26 09:01:24 +05:30
overkill.mkd (minor) added overkill doc 2010-06-16 14:19:31 +05:30
packaging.mkd more doc revamp; some notes below 2010-09-04 03:10:20 +05:30
progit-article.mkd progit doc... 2010-10-04 19:30:55 +05:30
report-output.mkd more doc revamp; some notes below 2010-09-04 03:10:20 +05:30
shell-games.mkd added notes on how to do more things via admin push 2010-04-12 21:10:52 +05:30
ssh-troubleshooting.mkd (minor) doc fixes 2010-11-05 16:08:11 +05:30
uninstall.mkd more doc revamp; some notes below 2010-09-04 03:10:20 +05:30
who-uses-it.mkd (doc) who-uses-it 2010-09-28 20:26:26 +05:30
wildcard-repositories.mkd custom perm categories in setperms (WARNING: PLEASE READ FULL COMMIT MESSAGE) 2010-11-06 21:03:34 +05:30