Fossil

Check-in [fbd77310b6]
Login

Check-in [fbd77310b6]

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Add documentation for the FOSSIL_REPOLIST_SHOW environment variable.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: fbd77310b65e0ce5c64c86e14d738795e32ad3f43e9f70ad7420230f9efe8882
User & Date: drh 2025-04-17 20:04:42.197
Context
2025-04-17
23:17
Defend against a possible infinite loop in forumpost_is_closed() that might occur if the forumpost table contains goofy data. ... (check-in: 923aa75345 user: drh tags: trunk)
20:04
Add documentation for the FOSSIL_REPOLIST_SHOW environment variable. ... (check-in: fbd77310b6 user: drh tags: trunk)
19:52
For the repolist page, if the environment variable FOSSIL_REPOLIST_SHOW contains the substring "description" then show the description column. If it contains the substring "login-group" then show the login-groups column. If the FOSSIL_REPOLIST_SHOW variable exists, it overwrites the show-repolist-desc and show-repolist-lg settings. ... (check-in: aca98b92e2 user: drh tags: trunk)
Changes
Unified Diff Ignore Whitespace Patch
Changes to src/main.c.
2363
2364
2365
2366
2367
2368
2369
2370







2371
2372
2373
2374
2375
2376
2377
**                             or "directory:"
**
**    notfound: URL            When in "directory:" mode, redirect to
**                             URL if no suitable repository is found.
**
**    repolist                 When in "directory:" mode, display a page
**                             showing a list of available repositories if
**                             the URL is "/".







**
**    localauth                Grant administrator privileges to connections
**                             from 127.0.0.1 or ::1.
**
**    nossl                    Signal that no SSL connections are available.
**
**    nocompress               Do not compress HTTP replies.







|
>
>
>
>
>
>
>







2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
**                             or "directory:"
**
**    notfound: URL            When in "directory:" mode, redirect to
**                             URL if no suitable repository is found.
**
**    repolist                 When in "directory:" mode, display a page
**                             showing a list of available repositories if
**                             the URL is "/".  Some control over the display
**                             is accomplished using environment variables.
**                             FOSSIL_REPOLIST_TITLE is the tital of the page.
**                             FOSSIL_REPOLIST_SHOW cause the "Description"
**                             column to display if it contains "description" as
**                             as a substring, and causes the Login-Group column
**                             to display if it contains the "login-group"
**                             substring.
**
**    localauth                Grant administrator privileges to connections
**                             from 127.0.0.1 or ::1.
**
**    nossl                    Signal that no SSL connections are available.
**
**    nocompress               Do not compress HTTP replies.
Changes to www/cgi.wiki.
77
78
79
80
81
82
83






84
85
86
87
88
89
90
[/help?cmd=repolist-skin|repolist-skin] setting.

If no repository has such a non-zero repolist-skin setting, then
the repository list is generic HTML without any decoration, with
the page title taken from the <tt>FOSSIL_REPOLIST_TITLE</tt>
environment variable. The variable can be defined in the CGI
control file using the [#setenv|<tt>setenv:</tt>] statement.







The repolist-generated page recurses into subdirectories and will list
all <tt>*.fossil</tt> files found, with the following exceptions:

   *  Filenames starting with a period are treated as "hidden" and skipped.

   *  Subdirectory names which match the base name of a fossil file in







>
>
>
>
>
>







77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
[/help?cmd=repolist-skin|repolist-skin] setting.

If no repository has such a non-zero repolist-skin setting, then
the repository list is generic HTML without any decoration, with
the page title taken from the <tt>FOSSIL_REPOLIST_TITLE</tt>
environment variable. The variable can be defined in the CGI
control file using the [#setenv|<tt>setenv:</tt>] statement.

The "Project Description" and "Login-Group" columns on the repolist page
are optional.  They are hidden by default.  Show them by putting value "1"
in the global settings "show-repolist-desc" and "show-repolist-lg", or
by setting the <tt>FOSSIL_REPOLIST_SHOW</tt> environment variable to
a string that contains substrings "description" and/or "login-group".

The repolist-generated page recurses into subdirectories and will list
all <tt>*.fossil</tt> files found, with the following exceptions:

   *  Filenames starting with a period are treated as "hidden" and skipped.

   *  Subdirectory names which match the base name of a fossil file in
Changes to www/env-opts.md.
151
152
153
154
155
156
157






158
159
160
161
162
163
164
See the [configuration database location][configloc] description
for additional information.

`FOSSIL_REPOLIST_TITLE`: The page title of the "Repository List" page
loaded by the `fossil all ui` or `fossil ui /` commands. Only used if
none of the listed repositories has the `repolist_skin` property set.
Can be set from the [CGI control file][cgictlfile].







`FOSSIL_USE_SEE_TEXTKEY`: If set, treat the encryption key string for
SEE as text to be hashed into the actual encryption key.  This has no
effect if Fossil was not compiled with SEE support enabled.


`FOSSIL_USER`: Name of the default user account if the checkout, local







>
>
>
>
>
>







151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
See the [configuration database location][configloc] description
for additional information.

`FOSSIL_REPOLIST_TITLE`: The page title of the "Repository List" page
loaded by the `fossil all ui` or `fossil ui /` commands. Only used if
none of the listed repositories has the `repolist_skin` property set.
Can be set from the [CGI control file][cgictlfile].

`FOSSIL_REPOLIST_SHOW`: If this variable exists and has a text value
that contains the substring "description", then the "Project Description"
column appears on the repolist page.  If it contains the substring
"login-group", then the Login-Group column appears on the repolist page.
Can be set from the [CGI control file][cgictlfile].

`FOSSIL_USE_SEE_TEXTKEY`: If set, treat the encryption key string for
SEE as text to be hashed into the actual encryption key.  This has no
effect if Fossil was not compiled with SEE support enabled.


`FOSSIL_USER`: Name of the default user account if the checkout, local