Fossil SCM

Documentation updates for the robot-restrict changes of the previous check-in.

drh 2025-11-22 21:16 trunk
Commit 3481761e6c287237f1f38a5d18585de4ab1d97524d15952f5d41b91adb9588b2
--- www/changes.wiki
+++ www/changes.wiki
@@ -5,10 +5,12 @@
55
<li> The default configuration now allows robots to download any tarball
66
or similar, to better support of automated build systems.
77
<li> New special tag "zipX" for the [/help/robot-restrict|robot-restrict]
88
setting blocks robot access to tarballs, but with exceptions to support
99
automated build systems.
10
+ <li> Tags of the form "ext/PATH" in the robot-restrict setting block access
11
+ by robots to specific [./serverext.wiki|CGI extension] at PATH.
1012
<li> Enhancements to the default value for the
1113
[/help/robot-restrict|robot-restrict setting].
1214
</ol>
1315
<li> A drop-down menu of recent branches is now possible for the submenu, and
1416
is used in the [/dir?ci=trunk|code browser].
@@ -30,13 +32,13 @@
3032
detail section. There is an ellipsis that one can click on to see the
3133
full detail text.
3234
<li> The artifact hash in the detail section of each timeline entry is now
3335
emphasized (controlled by CSS) to make it easier to locate amid all
3436
the other text and links.
35
- <li> When clicking on the ellipsis in "Compact" or "Simple" views, the ellipsis
36
- is replaced by a left arrow ("←") which can be clicked to hide the extra
37
- detail again.
37
+ <li> When clicking on the ellipsis in "Compact" or "Simple" views, the
38
+ ellipsis is replaced by a left arrow ("←") which can be clicked to
39
+ hide the extra detail again.
3840
<li> New setting [/help/timeline-mark-leaves|timeline-mark-leaves] controls
3941
whether or not leaf check-ins are marked in the timeline.
4042
<li> "No-graph" timelines (using the "ng" query parameter) now show
4143
branch colors and bare check-in circles on the left. The check-in
4244
circles appear, but no lines connecting them.
4345
--- www/changes.wiki
+++ www/changes.wiki
@@ -5,10 +5,12 @@
5 <li> The default configuration now allows robots to download any tarball
6 or similar, to better support of automated build systems.
7 <li> New special tag "zipX" for the [/help/robot-restrict|robot-restrict]
8 setting blocks robot access to tarballs, but with exceptions to support
9 automated build systems.
 
 
10 <li> Enhancements to the default value for the
11 [/help/robot-restrict|robot-restrict setting].
12 </ol>
13 <li> A drop-down menu of recent branches is now possible for the submenu, and
14 is used in the [/dir?ci=trunk|code browser].
@@ -30,13 +32,13 @@
30 detail section. There is an ellipsis that one can click on to see the
31 full detail text.
32 <li> The artifact hash in the detail section of each timeline entry is now
33 emphasized (controlled by CSS) to make it easier to locate amid all
34 the other text and links.
35 <li> When clicking on the ellipsis in "Compact" or "Simple" views, the ellipsis
36 is replaced by a left arrow ("←") which can be clicked to hide the extra
37 detail again.
38 <li> New setting [/help/timeline-mark-leaves|timeline-mark-leaves] controls
39 whether or not leaf check-ins are marked in the timeline.
40 <li> "No-graph" timelines (using the "ng" query parameter) now show
41 branch colors and bare check-in circles on the left. The check-in
42 circles appear, but no lines connecting them.
43
--- www/changes.wiki
+++ www/changes.wiki
@@ -5,10 +5,12 @@
5 <li> The default configuration now allows robots to download any tarball
6 or similar, to better support of automated build systems.
7 <li> New special tag "zipX" for the [/help/robot-restrict|robot-restrict]
8 setting blocks robot access to tarballs, but with exceptions to support
9 automated build systems.
10 <li> Tags of the form "ext/PATH" in the robot-restrict setting block access
11 by robots to specific [./serverext.wiki|CGI extension] at PATH.
12 <li> Enhancements to the default value for the
13 [/help/robot-restrict|robot-restrict setting].
14 </ol>
15 <li> A drop-down menu of recent branches is now possible for the submenu, and
16 is used in the [/dir?ci=trunk|code browser].
@@ -30,13 +32,13 @@
32 detail section. There is an ellipsis that one can click on to see the
33 full detail text.
34 <li> The artifact hash in the detail section of each timeline entry is now
35 emphasized (controlled by CSS) to make it easier to locate amid all
36 the other text and links.
37 <li> When clicking on the ellipsis in "Compact" or "Simple" views, the
38 ellipsis is replaced by a left arrow ("←") which can be clicked to
39 hide the extra detail again.
40 <li> New setting [/help/timeline-mark-leaves|timeline-mark-leaves] controls
41 whether or not leaf check-ins are marked in the timeline.
42 <li> "No-graph" timelines (using the "ng" query parameter) now show
43 branch colors and bare check-in circles on the left. The check-in
44 circles appear, but no lines connecting them.
45
--- www/serverext.wiki
+++ www/serverext.wiki
@@ -338,10 +338,17 @@
338338
CGI programs that want to restrict access
339339
can examine the FOSSIL_CAPABILITIES and/or FOSSIL_USER environment variables.
340340
In other words, access control is the responsibility of the individual
341341
extension programs.
342342
343
+<h3>6.1 Restricting Robot Access To Extensions</h3>
344
+
345
+If the "ext" tag is found in the [/help/robot-restrict|robot-restrict setting]
346
+then clients are tested to see if they are robots before granting
347
+access to any extension. If the "ext" tag is omitted but a tag
348
+of the form "ext/PATH" is found on the robot-restrict setting, then
349
+robots are restricted from the particular extension at PATH.
343350
344351
<h2>7.0 Trouble-Shooting Hints</h2>
345352
346353
Remember that the /ext will return any file in the extroot directory
347354
hierarchy as static content if the file is readable but not executable.
348355
--- www/serverext.wiki
+++ www/serverext.wiki
@@ -338,10 +338,17 @@
338 CGI programs that want to restrict access
339 can examine the FOSSIL_CAPABILITIES and/or FOSSIL_USER environment variables.
340 In other words, access control is the responsibility of the individual
341 extension programs.
342
 
 
 
 
 
 
 
343
344 <h2>7.0 Trouble-Shooting Hints</h2>
345
346 Remember that the /ext will return any file in the extroot directory
347 hierarchy as static content if the file is readable but not executable.
348
--- www/serverext.wiki
+++ www/serverext.wiki
@@ -338,10 +338,17 @@
338 CGI programs that want to restrict access
339 can examine the FOSSIL_CAPABILITIES and/or FOSSIL_USER environment variables.
340 In other words, access control is the responsibility of the individual
341 extension programs.
342
343 <h3>6.1 Restricting Robot Access To Extensions</h3>
344
345 If the "ext" tag is found in the [/help/robot-restrict|robot-restrict setting]
346 then clients are tested to see if they are robots before granting
347 access to any extension. If the "ext" tag is omitted but a tag
348 of the form "ext/PATH" is found on the robot-restrict setting, then
349 robots are restricted from the particular extension at PATH.
350
351 <h2>7.0 Trouble-Shooting Hints</h2>
352
353 Remember that the /ext will return any file in the extroot directory
354 hierarchy as static content if the file is readable but not executable.
355

Keyboard Shortcuts

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