Fossil SCM

Document the new FOSSIL_REPOLIST_TITLE environment variable.

florian 2025-03-24 07:18 trunk
Commit c591bbe0adc3f7b8b4ab8f8926a3ddb33f0a7350b25a5ae6eb29c9f2174ac35e
+2 -1
--- src/db.c
+++ src/db.c
@@ -5067,11 +5067,12 @@
50675067
**
50685068
** All repositories are searched (in lexicographical order) and the first
50695069
** repository with a non-zero "repolist-skin" value is used as the skin
50705070
** for the repository list page. If none of the repositories on the list
50715071
** have a non-zero "repolist-skin" setting then the repository list is
5072
-** displayed using unadorned HTML ("skinless").
5072
+** displayed using unadorned HTML ("skinless"), with the page title taken
5073
+** from the FOSSIL_REPOLIST_TITLE environment variable.
50735074
**
50745075
** If repolist-skin has a value of 2, then the repository is omitted from
50755076
** the list in use cases 1 through 4, but not for 5 and 6.
50765077
*/
50775078
/*
50785079
--- src/db.c
+++ src/db.c
@@ -5067,11 +5067,12 @@
5067 **
5068 ** All repositories are searched (in lexicographical order) and the first
5069 ** repository with a non-zero "repolist-skin" value is used as the skin
5070 ** for the repository list page. If none of the repositories on the list
5071 ** have a non-zero "repolist-skin" setting then the repository list is
5072 ** displayed using unadorned HTML ("skinless").
 
5073 **
5074 ** If repolist-skin has a value of 2, then the repository is omitted from
5075 ** the list in use cases 1 through 4, but not for 5 and 6.
5076 */
5077 /*
5078
--- src/db.c
+++ src/db.c
@@ -5067,11 +5067,12 @@
5067 **
5068 ** All repositories are searched (in lexicographical order) and the first
5069 ** repository with a non-zero "repolist-skin" value is used as the skin
5070 ** for the repository list page. If none of the repositories on the list
5071 ** have a non-zero "repolist-skin" setting then the repository list is
5072 ** displayed using unadorned HTML ("skinless"), with the page title taken
5073 ** from the FOSSIL_REPOLIST_TITLE environment variable.
5074 **
5075 ** If repolist-skin has a value of 2, then the repository is omitted from
5076 ** the list in use cases 1 through 4, but not for 5 and 6.
5077 */
5078 /*
5079
+5 -1
--- www/cgi.wiki
+++ www/cgi.wiki
@@ -73,12 +73,16 @@
7373
of available Fossil repositories.
7474
7575
The "skin" of the reply is determined by the first
7676
repository in the list that has a non-zero
7777
[/help?cmd=repolist-skin|repolist-skin] setting.
78
+
7879
If no repository has such a non-zero repolist-skin setting, then
79
-the repository list is generic HTML without any decoration.
80
+the repository list is generic HTML without any decoration, with
81
+the page title taken from the <tt>FOSSIL_REPOLIST_TITLE</tt>
82
+environment variable. The variable can be defined in the CGI
83
+control file using the [#setenv|<tt>setenv:</tt>] statement.
8084
8185
The repolist-generated page recurses into subdirectories and will list
8286
all <tt>*.fossil</tt> files found, with the following exceptions:
8387
8488
* Filenames starting with a period are treated as "hidden" and skipped.
8589
--- www/cgi.wiki
+++ www/cgi.wiki
@@ -73,12 +73,16 @@
73 of available Fossil repositories.
74
75 The "skin" of the reply is determined by the first
76 repository in the list that has a non-zero
77 [/help?cmd=repolist-skin|repolist-skin] setting.
 
78 If no repository has such a non-zero repolist-skin setting, then
79 the repository list is generic HTML without any decoration.
 
 
 
80
81 The repolist-generated page recurses into subdirectories and will list
82 all <tt>*.fossil</tt> files found, with the following exceptions:
83
84 * Filenames starting with a period are treated as "hidden" and skipped.
85
--- www/cgi.wiki
+++ www/cgi.wiki
@@ -73,12 +73,16 @@
73 of available Fossil repositories.
74
75 The "skin" of the reply is determined by the first
76 repository in the list that has a non-zero
77 [/help?cmd=repolist-skin|repolist-skin] setting.
78
79 If no repository has such a non-zero repolist-skin setting, then
80 the repository list is generic HTML without any decoration, with
81 the page title taken from the <tt>FOSSIL_REPOLIST_TITLE</tt>
82 environment variable. The variable can be defined in the CGI
83 control file using the [#setenv|<tt>setenv:</tt>] statement.
84
85 The repolist-generated page recurses into subdirectories and will list
86 all <tt>*.fossil</tt> files found, with the following exceptions:
87
88 * Filenames starting with a period are treated as "hidden" and skipped.
89
--- www/env-opts.md
+++ www/env-opts.md
@@ -148,10 +148,15 @@
148148
149149
150150
`FOSSIL_HOME`: Location of [configuration database][configdb].
151151
See the [configuration database location][configloc] description
152152
for additional information.
153
+
154
+`FOSSIL_REPOLIST_TITLE`: The page title of the "Repository List" page
155
+loaded by the `fossil all ui` or `fossil ui /` commands. Only used if
156
+none of the listed repositories has the `repolist_skin` property set.
157
+Can be set from the [CGI control file][cgictlfile].
153158
154159
`FOSSIL_USE_SEE_TEXTKEY`: If set, treat the encryption key string for
155160
SEE as text to be hashed into the actual encryption key. This has no
156161
effect if Fossil was not compiled with SEE support enabled.
157162
@@ -493,5 +498,6 @@
493498
On Windows platforms, it assumes that `start` is the command to open
494499
a URL in the user's configured default browser.
495500
496501
[configdb]: ./tech_overview.wiki#configdb
497502
[configloc]: ./tech_overview.wiki#configloc
503
+[cgictlfile]: ./cgi.wiki
498504
--- www/env-opts.md
+++ www/env-opts.md
@@ -148,10 +148,15 @@
148
149
150 `FOSSIL_HOME`: Location of [configuration database][configdb].
151 See the [configuration database location][configloc] description
152 for additional information.
 
 
 
 
 
153
154 `FOSSIL_USE_SEE_TEXTKEY`: If set, treat the encryption key string for
155 SEE as text to be hashed into the actual encryption key. This has no
156 effect if Fossil was not compiled with SEE support enabled.
157
@@ -493,5 +498,6 @@
493 On Windows platforms, it assumes that `start` is the command to open
494 a URL in the user's configured default browser.
495
496 [configdb]: ./tech_overview.wiki#configdb
497 [configloc]: ./tech_overview.wiki#configloc
 
498
--- www/env-opts.md
+++ www/env-opts.md
@@ -148,10 +148,15 @@
148
149
150 `FOSSIL_HOME`: Location of [configuration database][configdb].
151 See the [configuration database location][configloc] description
152 for additional information.
153
154 `FOSSIL_REPOLIST_TITLE`: The page title of the "Repository List" page
155 loaded by the `fossil all ui` or `fossil ui /` commands. Only used if
156 none of the listed repositories has the `repolist_skin` property set.
157 Can be set from the [CGI control file][cgictlfile].
158
159 `FOSSIL_USE_SEE_TEXTKEY`: If set, treat the encryption key string for
160 SEE as text to be hashed into the actual encryption key. This has no
161 effect if Fossil was not compiled with SEE support enabled.
162
@@ -493,5 +498,6 @@
498 On Windows platforms, it assumes that `start` is the command to open
499 a URL in the user's configured default browser.
500
501 [configdb]: ./tech_overview.wiki#configdb
502 [configloc]: ./tech_overview.wiki#configloc
503 [cgictlfile]: ./cgi.wiki
504

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button