README, doc/3: gitweb "description" feature

This commit is contained in:
Sitaram Chamarty 2009-11-18 07:18:05 +05:30
parent e8270e9b72
commit 05a06a2c75
2 changed files with 19 additions and 11 deletions

View file

@ -73,8 +73,8 @@ detail [here][gsdiff].
* config file syntax gets checked upfront, and much more thoroughly * config file syntax gets checked upfront, and much more thoroughly
* if your requirements are still too complex, you can split up the config * if your requirements are still too complex, you can split up the config
file and delegate authority over parts of it file and delegate authority over parts of it
* easier to specify gitweb/daemon access, and easier to link gitweb * easier to specify gitweb "description" and gitweb/daemon access
authorisation with gitolite * easier to sync gitweb (http) authorisation with gitolite's access config
* more comprehensive logging [aka: management does not think "blame" is just * more comprehensive logging [aka: management does not think "blame" is just
a synonym for "annotate" :-)] a synonym for "annotate" :-)]
* "personal namespace" prefix for each dev * "personal namespace" prefix for each dev

View file

@ -11,7 +11,7 @@ In this document:
* two levels of access rights checking * two levels of access rights checking
* error checking the config file * error checking the config file
* delegating parts of the config file * delegating parts of the config file
* easier to specify gitweb/daemon access * easier to specify gitweb "description" and gitweb/daemon access
* easier to link gitweb authorisation with gitolite * easier to link gitweb authorisation with gitolite
* better logging * better logging
* one user, many keys * one user, many keys
@ -196,17 +196,25 @@ for details.
<a name="gwd"></a> <a name="gwd"></a>
#### easier to specify gitweb/daemon access #### easier to specify gitweb "description" and gitweb/daemon access
Which of your repos should be accessible via plain HTTP or the `git://` To enable access to a repo via gitweb *and* create a "description" for it to
protocols (gitweb and git daemon, respectively)? show up on the webpage, just add a line like this, anywhere in the config
file:
Specifying gitweb and/or daemon access for a repo is simple: give "read" reponame = "one line of description"
permissions to two special usernames: `gitweb` and `daemon`.
You can also keep these pieces separate from the detailed, branch level access To enable access to one or more repos via git daemon, just give "read"
for each repo, if you like, since you can write the access control specs in permissions to the special username `daemon`.
bits and pieces. Here's an example, using short repo names for convenience:
There is also a special user called `gitweb` to specify gitweb access; useful
if you don't care about specifying individual descriptions for each repo and
just want to quickly enable gitweb access to one or more repos.
Remember gitolite lets you specify the access control specs in bits and
pieces, so you can keep all the daemon/gitweb access in one place, even if
each repo has more specific branch-level access config specified elsewhere.
Here's an example, using really short reponames because I'm lazy:
# maybe near the top of the file, for ease of access: # maybe near the top of the file, for ease of access: