aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRichard Maw <richard.maw@gmail.com>2016-07-02 14:23:20 +0000
committerRichard Maw <richard.maw@gmail.com>2016-07-13 19:09:37 +0000
commitbb2391a96b2b120ba82d797fcfb4b21e045ace06 (patch)
tree6131b6b7fffd17656710f4a5199362daff5d36a1
parent5c6966b0c82b019b2b09c1eedbca2dbac8d7c9b9 (diff)
downloadcgit-bb2391a96b2b120ba82d797fcfb4b21e045ace06.tar
cgit-bb2391a96b2b120ba82d797fcfb4b21e045ace06.tar.gz
cgit-bb2391a96b2b120ba82d797fcfb4b21e045ace06.zip
Add documentation for repo.namespace
Signed-off-by: Richard Maw <richard.maw@gmail.com>
-rw-r--r--cgitrc.5.txt32
1 files changed, 32 insertions, 0 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index 9fcf445..6116d1b 100644
--- a/cgitrc.5.txt
+++ b/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
-------------------