mirror of
https://git.zx2c4.com/cgit
synced 2024-11-29 20:06:21 +00:00
Add documentation for repo.namespace
Signed-off-by: Richard Maw <richard.maw@gmail.com>
This commit is contained in:
parent
5c6966b0c8
commit
bb2391a96b
32
cgitrc.5.txt
32
cgitrc.5.txt
@ -570,6 +570,10 @@ repo.max-stats::
|
||||
repo.name::
|
||||
The value to show as repository name. Default value: <repo.url>.
|
||||
|
||||
repo.namespace::
|
||||
Set the git namespace, so that fetching and cloning only provide refs
|
||||
under refs/namespaces. Default value: none.
|
||||
|
||||
repo.owner::
|
||||
A value used to identify the owner of the repository. Default value:
|
||||
none.
|
||||
@ -772,6 +776,34 @@ Conversely, when a ttl value is zero, the cache is disabled for that
|
||||
particular page type, and the page type is never cached.
|
||||
|
||||
|
||||
NAMESPACES
|
||||
----------
|
||||
|
||||
A namespace may be created by creating a "HEAD" symbolic ref for the namespace,
|
||||
which may be done with the following command:
|
||||
|
||||
....
|
||||
git symbolic-ref $namespace_ref_base/HEAD $namespace_ref_base/refs/heads/master
|
||||
....
|
||||
|
||||
and adding "repo.namespace" for the repository.
|
||||
|
||||
For a namespace called "foo/bar", the base ref would be
|
||||
"refs/namespaces/foo/refs/namespaces/bar/",
|
||||
so the command to create the HEAD ref is:
|
||||
|
||||
....
|
||||
git symbolic-ref refs/namespaces/foo/refs/namespaces/bar/HEAD \
|
||||
refs/namespaces/foo/refs/namespaces/bar/refs/heads/master
|
||||
....
|
||||
|
||||
The config setting for this repository would be:
|
||||
|
||||
....
|
||||
repo.namespace = foo/bar
|
||||
....
|
||||
|
||||
|
||||
EXAMPLE CGITRC FILE
|
||||
-------------------
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user