From 510f54dc22a4e3359ce0984c4940073a6cb03f68 Mon Sep 17 00:00:00 2001 From: Bryce Kwon Date: Sat, 31 Oct 2026 13:15:34 -0700 Subject: Say once which variables a macro can name --- MANUAL.txt | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/MANUAL.txt b/MANUAL.txt index d3282f9..0bdfee4 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -900,15 +900,11 @@ environment variable. Macro expansion will also happen on the content of $CGIT_CONFIG, if defined. -The set of available variables is not fixed by cgit. The options above are -expanded while the configuration is parsed, against whatever environment the web -server hands the cgit process, so any variable the server sets can be used. A -CGI server provides the standard request variables, among them $HTTP_HOST, -$HTTPS, $PATH_INFO, $QUERY_STRING, $REQUEST_METHOD, $SCRIPT_NAME, $SERVER_NAME -and $SERVER_PORT, and server directives such as SetEnv (Apache), fastcgi_param -(nginx) or setenv.add-environment (lighttpd) can add anything else. cgit unsets -$HOME and $XDG_CONFIG_HOME before reading its configuration, so those two never -expand. +The options above are expanded while the configuration is parsed. Any variable +in the environment the web server hands cgit can be used, from the CGI request +variables such as $HTTP_HOST to anything set with SetEnv (Apache), fastcgi_param +(nginx) or setenv.add-environment (lighttpd). cgit unsets $HOME and +$XDG_CONFIG_HOME before reading its configuration, so those two never expand. One usage of this feature is virtual hosting, which in its simplest form can be accomplished by adding a line like this one to /etc/cgitrc. -- cgit