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

doc/3 last reorg missed moving some anchors and preamble text

Browse source
This commit is contained in:
Sitaram Chamarty 2010-02-16 04:57:14 +05:30
parent 83a017f884
commit 6f740339e4
1 changed files with 15 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
doc/3-faq-tips-etc.mkd
View file

@ -156,12 +156,18 @@ plain "git archive", because the Makefile adds a file called
make master.tar make master.tar
# or maybe "make pu.tar" # or maybe "make pu.tar"
<a name="diff"></a> <a name="features"></a>
## features ## features
Apart from the big ones listed in the top level README, and subjective ones
like "better config file format", gitolite has evolved to have many useful
fearures than the original goal of "gitosis + branch-level access control".
### syntax and normal usage ### syntax and normal usage
<a name="simpler_syntax"></a>
#### simpler syntax #### simpler syntax
The basic syntax is simpler and cleaner but it goes beyond that: **you can The basic syntax is simpler and cleaner but it goes beyond that: **you can
@ -205,6 +211,8 @@ do not worry that this causes some duplication or inefficiency. It doesn't
See the "specify gitweb/daemon access" section below for one more example. See the "specify gitweb/daemon access" section below for one more example.
<a name="multikeys"></a>
#### one user, many keys #### one user, many keys
I have a laptop and a desktop I need to access the server from. I have I have a laptop and a desktop I need to access the server from. I have
@ -250,6 +258,8 @@ corresponding derived usernames (which is what goes into the
### security, access control, and auditing ### security, access control, and auditing
<a name="two_levels"></a>
#### two levels of access rights checking #### two levels of access rights checking
Gitolite has two levels of access checks. The **first check** is what I will Gitolite has two levels of access checks. The **first check** is what I will
@ -285,12 +295,6 @@ any of the refexes match, the push succeeds. If none of them match, it fails.
Gitolite also allows "exclude" or "deny" rules. See later in this document Gitolite also allows "exclude" or "deny" rules. See later in this document
for details. for details.
Apart from the big ones listed in the top level README, and subjective ones
like "better config file format", gitolite has evolved to have many useful
fearures than the original goal of "gitosis + branch-level access control".
<a name="simpler_syntax"></a>
#### better logging #### better logging
If you have been too liberal with the permission to rewind, it has built-in If you have been too liberal with the permission to rewind, it has built-in
@ -317,8 +321,6 @@ The other parts of the log line are the name of the repo, the refname being
updated, the user updating it, and the refex pattern (from the config file) updated, the user updating it, and the refex pattern (from the config file)
that matched, in case you need to debug the config file itself. that matched, in case you need to debug the config file itself.
<a name="multikeys"></a>
#### "exclude" (or "deny") rules #### "exclude" (or "deny") rules
Here is an illustrative explanation of "deny" rules. However, please be sure Here is an illustrative explanation of "deny" rules. However, please be sure
@ -384,10 +386,10 @@ access control for their own pieces. See
[doc/5-delegation.mkd](http://github.com/sitaramc/gitolite/blob/pu/doc/5-delegation.mkd) [doc/5-delegation.mkd](http://github.com/sitaramc/gitolite/blob/pu/doc/5-delegation.mkd)
for details. for details.
<a name="gwd"></a>
### convenience features ### convenience features
<a name="myrights"></a>
#### what repos do I have access to? #### what repos do I have access to?
Sometimes there are too many repos, maybe even named similarly, or with the Sometimes there are too many repos, maybe even named similarly, or with the
@ -451,8 +453,6 @@ attempting to run git stuff.
Very easy, very simple, and completely transparent to the users :-) Very easy, very simple, and completely transparent to the users :-)
<a name="myrights"></a>
#### "personal" branches #### "personal" branches
"personal" branches are great for corporate environments, where "personal" branches are great for corporate environments, where
@ -513,6 +513,8 @@ You can specify hooks that you want to propagate to all repos, as well as
per-repo "gitconfig" settings. Please see `doc/2-admin.mkd` and per-repo "gitconfig" settings. Please see `doc/2-admin.mkd` and
`conf/example.conf` for details. `conf/example.conf` for details.
<a name="gitweb"></a>
### helping with gitweb ### helping with gitweb
Although gitweb is a completely separate program, gitolite can do quite a Although gitweb is a completely separate program, gitolite can do quite a