From bb2391a96b2b120ba82d797fcfb4b21e045ace06 Mon Sep 17 00:00:00 2001 From: Richard Maw Date: Sat, 2 Jul 2016 15:23:20 +0100 Subject: [PATCH] Add documentation for repo.namespace Signed-off-by: Richard Maw --- cgitrc.5.txt | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) 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.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 -------------------