[PATCH v3 18/21] Add documentation for repo.namespace

Richard Maw richard.maw at gmail.com
Mon Aug 1 23:35:50 CEST 2016

Signed-off-by: Richard Maw <richard.maw at gmail.com>
 cgitrc.5.txt | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index 9fcf445..0de14a4 100644
--- a/cgitrc.5.txt
+++ b/cgitrc.5.txt
@@ -570,6 +570,11 @@ repo.max-stats::
 	The value to show as repository name. Default value: <repo.url>.
+	Set the git namespace, so that fetching, cloning, listing branches only
+	provide refs in the namespace, and only git notes in that namespace are shown
+	for commits in that namespace. Default value: none.
 	A value used to identify the owner of the repository. Default value:
@@ -772,6 +777,34 @@ Conversely, when a ttl value is zero, the cache is disabled for that
 particular page type, and the page type is never cached.
+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
+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

More information about the CGit mailing list