Skip to content

Commit d661146

Browse files
jnarebgitster
authored andcommitted
gitweb: Add info about $projectroot and $projects_list to gitweb/README
Those two configuration variables are important enough that it is worth to explicitely write about them in the "Gitweb config file variables" section even if they are usually set during build by GITWEB_PROJECTROOT and GITWEB_LIST build (Makefile) configuration variables. Signed-off-by: Jakub Narebski <jnareb@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
1 parent a5d86f7 commit d661146

1 file changed

Lines changed: 15 additions & 2 deletions

File tree

gitweb/README

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -129,17 +129,30 @@ descriptions.
129129
Gitweb config file variables
130130
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
131131

132-
You can set, among others, the following variables in gitweb config files:
132+
You can set, among others, the following variables in gitweb config files
133+
(with the exception of $projectroot and $projects_list this list does
134+
not include variables usually directly set during build):
133135
* $GIT
134136
Cure git executable to use. By default set to "$GIT_BINDIR/git", which
135137
in turn is by default set to "$(bindir)/git". If you use git from binary
136138
package, set this to "/usr/bin/git". This can just be "git" if your
137139
webserver has a sensible PATH. If you have multiple git versions
138-
installed it is / can be used to choose which one to use.
140+
installed it can be used to choose which one to use.
139141
* $version
140142
Gitweb version, set automatically when creating gitweb.cgi from
141143
gitweb.perl. You might want to modify it if you are running modified
142144
gitweb.
145+
* $projectroot
146+
Absolute filesystem path which will be prepended to project path;
147+
the path to repository is $projectroot/$project. Set to
148+
$GITWEB_PROJECTROOT during installation. This variable have to be
149+
set correctly for gitweb to find repositories.
150+
* $projects_list
151+
Source of projects list, either directory to scan, or text file
152+
with list of repositories (in the "<URI-encoded repository path> SPC
153+
<URI-encoded repository owner>" format). Set to $GITWEB_LIST
154+
during installation. If empty, $projectroot is used to scan for
155+
repositories.
143156
* $my_url, $my_uri
144157
URL and absolute URL of gitweb script; you might need to set those
145158
variables if you are using 'pathinfo' feature: see also below.

0 commit comments

Comments
 (0)