Fossil SCM

Add 'B' capability to www/caps/ref.html.

stephan 2026-05-25 07:55 UTC forum-attachments
Commit bca893460e29754b1bc0de2c78fd29134490bfaa411c4c9cc2920b93070ea2c1
1 file changed +45 -36
+45 -36
--- www/caps/ref.html
+++ www/caps/ref.html
@@ -56,28 +56,29 @@
5656
Admin users have <em>all</em> of the capabilities below except for
5757
<a href="#s">setup</a>, <a herf="#x">Private</a>, and <a href="#y">WrUnver</a>.
5858
See <a href="admin-v-setup.md">Admin vs. Setup</a> for a more
5959
nuanced discussion. Mnemonic: <b>a</b>dministrate.
6060
</td>
61
- </tr>
61
+ </tr>
6262
6363
<tr id="b">
6464
<th>b</th>
6565
<th>Attach</th>
6666
<td>
67
- Add attachments to wiki articles or tickets. Mnemonics: <b>b</b>ind,
68
- <b>b</b>utton, <b>b</b>ond, or <b>b</b>olt.
67
+ Add attachments to wiki articles, technotes, or tickets.
68
+ Mnemonics: <b>b</b>ind, <b>b</b>utton, <b>b</b>ond, or <b>b</b>olt.
69
+ See also: <a href='#B'>B</a>.
6970
</td>
70
- </tr>
71
+ </tr>
7172
7273
<tr id="c">
7374
<th>c</th>
7475
<th>ApndTkt</th>
7576
<td>
7677
Append comments to existing tickets. Mnemonic: <b>c</b>omment.
7778
</td>
78
- </tr>
79
+ </tr>
7980
8081
<tr id="d">
8182
<th>d</th>
8283
<th>n/a</th>
8384
<td>
@@ -100,21 +101,21 @@
100101
identifying information</a> (PII) about other users such as email
101102
addresses. Mnemonics: show <b>e</b>mail addresses; or
102103
<b>E</b>urope, home of <a
103104
href="https://en.wikipedia.org/wiki/General_Data_Protection_Regulation">GDPR</a>.
104105
</td>
105
- </tr>
106
+ </tr>
106107
107108
<tr id="f">
108109
<th>f</th>
109110
<th>NewWiki</th>
110111
<td>
111112
Create new wiki articles. Mnemonic: <b>f</b>ast, English
112113
translation of the Hawaiian word <a
113114
href="https://en.wikipedia.org/wiki/History_of_wikis#WikiWikiWeb,_the_first_wiki"><i>wiki</i></a>.
114115
</td>
115
- </tr>
116
+ </tr>
116117
117118
<tr id="g">
118119
<th>g</th>
119120
<th>Clone</th>
120121
<td>
@@ -121,11 +122,11 @@
121122
Clone the repository. Note that this is distinct from <a
122123
href="#o">check-out capability, <b>o</b></a>; and that upon cloning
123124
not just files, but also tickets, wikis, technotes and forum posts
124125
are tranferred. Mnemonic: <b>g</b>et.
125126
</td>
126
- </tr>
127
+ </tr>
127128
128129
<tr id="h">
129130
<th>h</th>
130131
<th>Hyperlink</th>
131132
<td>
@@ -134,11 +135,11 @@
134135
“nobody” category, to <a href="../antibot.wiki">prevent bots from
135136
wandering around aimlessly</a> in the site’s hyperlink web, <a
136137
href="../loadmgmt.md">chewing up server resources</a> to little
137138
good purpose. Mnemonic: <b>h</b>yperlink.
138139
</td>
139
- </tr>
140
+ </tr>
140141
141142
<tr id="i">
142143
<th>i</th>
143144
<th>Write</th>
144145
<td>
@@ -149,20 +150,20 @@
149150
Also note that not just files, but also tickets, wikis, technotes
150151
and forum posts will be accepted from clones upon syncronization.
151152
Granting this capability also grants <b>o (Read)</b> Mnemonics:
152153
<b>i</b>nput, check <b>i</b>n changes.
153154
</td>
154
- </tr>
155
+ </tr>
155156
156157
<tr id="j">
157158
<th>j</th>
158159
<th>RdWiki</th>
159160
<td>
160161
View wiki articles. Mnemonic: in<b>j</b>est page content. (All
161162
right, you critics, you do better, then.)
162163
</td>
163
- </tr>
164
+ </tr>
164165
165166
<tr id="k">
166167
<th>k</th>
167168
<th>WrWiki</th>
168169
<td>
@@ -169,11 +170,11 @@
169170
Edit wiki articles. Granting this capability also grants <a
170171
href="#j"><b>RdWiki</b></a> and <a href="#m"><b>ApndWiki</b></a>,
171172
but it does <em>not</em> grant <a href="#f"><b>NewWiki</b></a>!
172173
Mnemonic: <b>k</b>ontribute.
173174
</td>
174
- </tr>
175
+ </tr>
175176
176177
<tr id="l">
177178
<th>l</th>
178179
<th>ModWiki</th>
179180
<td>
@@ -180,63 +181,63 @@
180181
Moderate <a href="#m">wiki article appends</a>. Appends do not get
181182
saved permanently to the receiving repo’s block chain until <a
182183
href="#s">Setup</a> or someone with this cap approves it.
183184
Mnemonic: a<b>l</b>low.
184185
</td>
185
- </tr>
186
+ </tr>
186187
187188
<tr id="m">
188189
<th>m</th>
189190
<th>ApndWiki</th>
190191
<td>
191192
Append content to existing wiki articles. Mnemonic: a<b>m</b>end
192193
wiki
193194
</td>
194
- </tr>
195
+ </tr>
195196
196197
<tr id="n">
197198
<th>n</th>
198199
<th>NewTkt</th>
199200
<td>
200201
File new tickets. Mnemonic: <b>n</b>ew ticket.
201202
</td>
202
- </tr>
203
+ </tr>
203204
204205
<tr id="o">
205206
<th>o</th>
206207
<th>Read</th>
207208
<td>
208209
Read content and history of files from a remote Fossil instance over
209210
HTTP. See <a href="index.md#read-v-clone">Reading vs.
210211
Cloning</a>. Mnemonic: check <b>o</b>ut remote repo contents.
211212
</td>
212
- </tr>
213
+ </tr>
213214
214215
<tr id="p">
215216
<th>p</th>
216217
<th>Password</th>
217218
<td>
218219
Change one’s own password. Mnemonic: <b>p</b>assword.
219220
</td>
220
- </tr>
221
+ </tr>
221222
222223
<tr id="q">
223224
<th>q</th>
224225
<th>ModTkt</th>
225226
<td>
226227
Moderate tickets: delete comments appended to tickets. Mnemonic:
227228
<b>q</b>uash noise commentary.
228229
</td>
229
- </tr>
230
+ </tr>
230231
231232
<tr id="r">
232233
<th>r</th>
233234
<th>RdTkt</th>
234235
<td>
235236
View existing tickets. Mnemonic: <b>r</b>ead tickets.
236237
</td>
237
- </tr>
238
+ </tr>
238239
239240
<tr id="s">
240241
<th>s</th>
241242
<th>Setup</th>
242243
<td>
@@ -256,41 +257,41 @@
256257
because it is internally restricted to read-only queries on the
257258
tickets table only. (This restriction is done with an SQLite
258259
authorization hook, not by any method so weak as SQL text
259260
filtering.) Mnemonic: new <b>t</b>icket report.
260261
</td>
261
- </tr>
262
+ </tr>
262263
263264
<tr id="u">
264265
<th>u</th>
265266
<th>n/a</th>
266267
<td>
267268
Inherit all capabilities of the “reader” user category; does not
268269
have a dedicated flag internally within Fossil. Mnemonic:
269270
<a href="./index.md#ucat"><b>u</b>ser</a>
270271
</td>
271
- </tr>
272
+ </tr>
272273
273274
<tr id="v">
274275
<th>v</th>
275276
<th>n/a</th>
276277
<td>
277278
Inherit all capabilities of the “developer” user category; does
278279
not have a dedicated flag internally within Fossil. Mnemonic:
279280
de<b>v</b>eloper.
280281
</td>
281
- </tr>
282
+ </tr>
282283
283284
<tr id="w">
284285
<th>w</th>
285286
<th>WrTkt</th>
286287
<td>
287288
Edit existing tickets. Granting this capability also grants <a
288289
href="#r"><b>RdTkt</b></a>, <a href="#c"><b>ApndTkt</b></a>, and
289290
<a href="#n"><b>NewTkt</b></a>. Mnemonic: <b>w</b>rite to ticket.
290291
</td>
291
- </tr>
292
+ </tr>
292293
293294
<tr id="x">
294295
<th>x</th>
295296
<th>Private</th>
296297
<td>
@@ -298,21 +299,21 @@
298299
Mnemonic: e<b>x</b>clusivity; “x” connotes unknown material in
299300
many Western languages due to its <a
300301
href="https://en.wikipedia.org/wiki/La_Géométrie#The_text">traditional
301302
use in mathematics</a>.
302303
</td>
303
- </tr>
304
+ </tr>
304305
305306
<tr id="y">
306307
<th>y</th>
307308
<th>WrUnver</th>
308309
<td>
309310
Push <a href="../unvers.wiki">unversioned content</a>. Mnemonic:
310311
<b>y</b>ield, <a href="https://en.wiktionary.org/wiki/yield">sense
311312
4</a>: “hand over.”
312313
</td>
313
- </tr>
314
+ </tr>
314315
315316
<tr id="z">
316317
<th>z</th>
317318
<th>Zip</th>
318319
<td>
@@ -323,20 +324,20 @@
323324
expensive capability to grant, because creating such archives can
324325
put a large load on <a href="../server/">a Fossil server</a> which
325326
you may then need to <a href="../loadmgmt.md">manage</a>.
326327
Mnemonic: <b>z</b>ip file download.
327328
</td>
328
- </tr>
329
+ </tr>
329330
330331
<tr id="2">
331332
<th>2</th>
332333
<th>RdForum</th>
333334
<td>
334335
Read <a href="../forum.wiki">forum posts</a> by other users.
335336
Mnemonic: from thee <b>2</b> me.
336337
</td>
337
- </tr>
338
+ </tr>
338339
339340
<tr id="3">
340341
<th>3</th>
341342
<th>WrForum</th>
342343
<td>
@@ -346,20 +347,20 @@
346347
not appear in repo clones or syncs. Granting this capability also
347348
grants <a href="#2"><b>RdForum</b></a>. Mnemonic: post for
348349
<b>3</b> audiences: me, <a href="#5">the mods</a>, and <a
349350
href="https://en.wikipedia.org/wiki/The_Man">the Man</a>.
350351
</td>
351
- </tr>
352
+ </tr>
352353
353354
<tr id="4">
354355
<th>4</th>
355356
<th>WrTForum</th>
356357
<td>
357358
Extends <a href="#3"><b>WrForum</b></a>, bypassing the moderation
358359
and sync restrictions. Mnemonic: post <b>4</b> immediate release.
359360
</td>
360
- </tr>
361
+ </tr>
361362
362363
<tr id="5">
363364
<th>5</th>
364365
<th>ModForum</th>
365366
<td>
@@ -368,11 +369,11 @@
368369
href="#4"><b>WrTForum</b></a> and <a href="#2"><b>RdForum</b></a>,
369370
so a user with this cap never has to moderate their own posts.
370371
Mnemonic: “May I have <b>5</b> seconds of your time, honored
371372
Gatekeeper?”
372373
</td>
373
- </tr>
374
+ </tr>
374375
375376
<tr id="6">
376377
<th>6</th>
377378
<th>AdminForum</th>
378379
<td>
@@ -387,46 +388,54 @@
387388
currently revoke granted caps. Granting this capability also
388389
grants <a href="#5"><b>ModForum</b></a> and those it in turn
389390
grants. Mnemonic: “I’m <b>6</b> [sick] of hitting Approve on your
390391
posts!”
391392
</td>
392
- </tr>
393
+ </tr>
393394
394395
<tr id="7">
395396
<th>7</th>
396397
<th>EmailAlert</th>
397398
<td>
398399
User can sign up for <a href="../alerts.md">email alerts</a>.
399400
Mnemonic: <a href="https://en.wikipedia.org/wiki/Heaven_Can_Wait">Seven can
400401
wait</a>, I’ve got email to read now.
401402
</td>
402
- </tr>
403
+ </tr>
403404
404405
<tr id="A">
405406
<th>A</th>
406407
<th>Announce</th>
407408
<td>
408409
Send email announcements to users <a href="#7">signed up to
409410
receive them</a>. Mnemonic: <b>a</b>nnounce.
410411
</td>
411
- </tr>
412
+ </tr>
413
+
414
+ <tr id="B">
415
+ <th>B</th>
416
+ <th>Attach to Forum</th>
417
+ <td>
418
+ Add attachments to forum posts. See also: <a href='#b'>b</a>.
419
+ </td>
420
+ </tr>
412421
413422
<tr id="C">
414423
<th>C</th>
415424
<th>Chat</th>
416425
<td>
417426
Allow access to the <tt>/chat</tt> room.
418427
</td>
419
- </tr>
428
+ </tr>
420429
421430
<tr id="D">
422431
<th>D</th>
423432
<th>Debug</th>
424433
<td>
425434
Enable debugging features. Mnemonic: <b>d</b>ebug.
426435
</td>
427
- </tr>
436
+ </tr>
428437
429438
<tr id="L">
430439
<th>L</th>
431440
<th>Is-logged-in</th>
432441
<td>
@@ -433,13 +442,13 @@
433442
This is not a real capability, but is used in certain capability
434443
checks, e.g. via <a href="../th1.md#capexpr">capexpr</a>. It
435444
resolves to true if the current user is logged in.
436445
Mnemonic: <b>L</b>ogged in.
437446
</td>
438
- </tr>
447
+ </tr>
439448
440449
</table>
441450
442451
<hr/>
443452
444453
<p id="backlink"><a href="./"><em>Back to Administering User
445454
Capabilities</em></a></p>
446455
--- www/caps/ref.html
+++ www/caps/ref.html
@@ -56,28 +56,29 @@
56 Admin users have <em>all</em> of the capabilities below except for
57 <a href="#s">setup</a>, <a herf="#x">Private</a>, and <a href="#y">WrUnver</a>.
58 See <a href="admin-v-setup.md">Admin vs. Setup</a> for a more
59 nuanced discussion. Mnemonic: <b>a</b>dministrate.
60 </td>
61 </tr>
62
63 <tr id="b">
64 <th>b</th>
65 <th>Attach</th>
66 <td>
67 Add attachments to wiki articles or tickets. Mnemonics: <b>b</b>ind,
68 <b>b</b>utton, <b>b</b>ond, or <b>b</b>olt.
 
69 </td>
70 </tr>
71
72 <tr id="c">
73 <th>c</th>
74 <th>ApndTkt</th>
75 <td>
76 Append comments to existing tickets. Mnemonic: <b>c</b>omment.
77 </td>
78 </tr>
79
80 <tr id="d">
81 <th>d</th>
82 <th>n/a</th>
83 <td>
@@ -100,21 +101,21 @@
100 identifying information</a> (PII) about other users such as email
101 addresses. Mnemonics: show <b>e</b>mail addresses; or
102 <b>E</b>urope, home of <a
103 href="https://en.wikipedia.org/wiki/General_Data_Protection_Regulation">GDPR</a>.
104 </td>
105 </tr>
106
107 <tr id="f">
108 <th>f</th>
109 <th>NewWiki</th>
110 <td>
111 Create new wiki articles. Mnemonic: <b>f</b>ast, English
112 translation of the Hawaiian word <a
113 href="https://en.wikipedia.org/wiki/History_of_wikis#WikiWikiWeb,_the_first_wiki"><i>wiki</i></a>.
114 </td>
115 </tr>
116
117 <tr id="g">
118 <th>g</th>
119 <th>Clone</th>
120 <td>
@@ -121,11 +122,11 @@
121 Clone the repository. Note that this is distinct from <a
122 href="#o">check-out capability, <b>o</b></a>; and that upon cloning
123 not just files, but also tickets, wikis, technotes and forum posts
124 are tranferred. Mnemonic: <b>g</b>et.
125 </td>
126 </tr>
127
128 <tr id="h">
129 <th>h</th>
130 <th>Hyperlink</th>
131 <td>
@@ -134,11 +135,11 @@
134 “nobody” category, to <a href="../antibot.wiki">prevent bots from
135 wandering around aimlessly</a> in the site’s hyperlink web, <a
136 href="../loadmgmt.md">chewing up server resources</a> to little
137 good purpose. Mnemonic: <b>h</b>yperlink.
138 </td>
139 </tr>
140
141 <tr id="i">
142 <th>i</th>
143 <th>Write</th>
144 <td>
@@ -149,20 +150,20 @@
149 Also note that not just files, but also tickets, wikis, technotes
150 and forum posts will be accepted from clones upon syncronization.
151 Granting this capability also grants <b>o (Read)</b> Mnemonics:
152 <b>i</b>nput, check <b>i</b>n changes.
153 </td>
154 </tr>
155
156 <tr id="j">
157 <th>j</th>
158 <th>RdWiki</th>
159 <td>
160 View wiki articles. Mnemonic: in<b>j</b>est page content. (All
161 right, you critics, you do better, then.)
162 </td>
163 </tr>
164
165 <tr id="k">
166 <th>k</th>
167 <th>WrWiki</th>
168 <td>
@@ -169,11 +170,11 @@
169 Edit wiki articles. Granting this capability also grants <a
170 href="#j"><b>RdWiki</b></a> and <a href="#m"><b>ApndWiki</b></a>,
171 but it does <em>not</em> grant <a href="#f"><b>NewWiki</b></a>!
172 Mnemonic: <b>k</b>ontribute.
173 </td>
174 </tr>
175
176 <tr id="l">
177 <th>l</th>
178 <th>ModWiki</th>
179 <td>
@@ -180,63 +181,63 @@
180 Moderate <a href="#m">wiki article appends</a>. Appends do not get
181 saved permanently to the receiving repo’s block chain until <a
182 href="#s">Setup</a> or someone with this cap approves it.
183 Mnemonic: a<b>l</b>low.
184 </td>
185 </tr>
186
187 <tr id="m">
188 <th>m</th>
189 <th>ApndWiki</th>
190 <td>
191 Append content to existing wiki articles. Mnemonic: a<b>m</b>end
192 wiki
193 </td>
194 </tr>
195
196 <tr id="n">
197 <th>n</th>
198 <th>NewTkt</th>
199 <td>
200 File new tickets. Mnemonic: <b>n</b>ew ticket.
201 </td>
202 </tr>
203
204 <tr id="o">
205 <th>o</th>
206 <th>Read</th>
207 <td>
208 Read content and history of files from a remote Fossil instance over
209 HTTP. See <a href="index.md#read-v-clone">Reading vs.
210 Cloning</a>. Mnemonic: check <b>o</b>ut remote repo contents.
211 </td>
212 </tr>
213
214 <tr id="p">
215 <th>p</th>
216 <th>Password</th>
217 <td>
218 Change one’s own password. Mnemonic: <b>p</b>assword.
219 </td>
220 </tr>
221
222 <tr id="q">
223 <th>q</th>
224 <th>ModTkt</th>
225 <td>
226 Moderate tickets: delete comments appended to tickets. Mnemonic:
227 <b>q</b>uash noise commentary.
228 </td>
229 </tr>
230
231 <tr id="r">
232 <th>r</th>
233 <th>RdTkt</th>
234 <td>
235 View existing tickets. Mnemonic: <b>r</b>ead tickets.
236 </td>
237 </tr>
238
239 <tr id="s">
240 <th>s</th>
241 <th>Setup</th>
242 <td>
@@ -256,41 +257,41 @@
256 because it is internally restricted to read-only queries on the
257 tickets table only. (This restriction is done with an SQLite
258 authorization hook, not by any method so weak as SQL text
259 filtering.) Mnemonic: new <b>t</b>icket report.
260 </td>
261 </tr>
262
263 <tr id="u">
264 <th>u</th>
265 <th>n/a</th>
266 <td>
267 Inherit all capabilities of the “reader” user category; does not
268 have a dedicated flag internally within Fossil. Mnemonic:
269 <a href="./index.md#ucat"><b>u</b>ser</a>
270 </td>
271 </tr>
272
273 <tr id="v">
274 <th>v</th>
275 <th>n/a</th>
276 <td>
277 Inherit all capabilities of the “developer” user category; does
278 not have a dedicated flag internally within Fossil. Mnemonic:
279 de<b>v</b>eloper.
280 </td>
281 </tr>
282
283 <tr id="w">
284 <th>w</th>
285 <th>WrTkt</th>
286 <td>
287 Edit existing tickets. Granting this capability also grants <a
288 href="#r"><b>RdTkt</b></a>, <a href="#c"><b>ApndTkt</b></a>, and
289 <a href="#n"><b>NewTkt</b></a>. Mnemonic: <b>w</b>rite to ticket.
290 </td>
291 </tr>
292
293 <tr id="x">
294 <th>x</th>
295 <th>Private</th>
296 <td>
@@ -298,21 +299,21 @@
298 Mnemonic: e<b>x</b>clusivity; “x” connotes unknown material in
299 many Western languages due to its <a
300 href="https://en.wikipedia.org/wiki/La_Géométrie#The_text">traditional
301 use in mathematics</a>.
302 </td>
303 </tr>
304
305 <tr id="y">
306 <th>y</th>
307 <th>WrUnver</th>
308 <td>
309 Push <a href="../unvers.wiki">unversioned content</a>. Mnemonic:
310 <b>y</b>ield, <a href="https://en.wiktionary.org/wiki/yield">sense
311 4</a>: “hand over.”
312 </td>
313 </tr>
314
315 <tr id="z">
316 <th>z</th>
317 <th>Zip</th>
318 <td>
@@ -323,20 +324,20 @@
323 expensive capability to grant, because creating such archives can
324 put a large load on <a href="../server/">a Fossil server</a> which
325 you may then need to <a href="../loadmgmt.md">manage</a>.
326 Mnemonic: <b>z</b>ip file download.
327 </td>
328 </tr>
329
330 <tr id="2">
331 <th>2</th>
332 <th>RdForum</th>
333 <td>
334 Read <a href="../forum.wiki">forum posts</a> by other users.
335 Mnemonic: from thee <b>2</b> me.
336 </td>
337 </tr>
338
339 <tr id="3">
340 <th>3</th>
341 <th>WrForum</th>
342 <td>
@@ -346,20 +347,20 @@
346 not appear in repo clones or syncs. Granting this capability also
347 grants <a href="#2"><b>RdForum</b></a>. Mnemonic: post for
348 <b>3</b> audiences: me, <a href="#5">the mods</a>, and <a
349 href="https://en.wikipedia.org/wiki/The_Man">the Man</a>.
350 </td>
351 </tr>
352
353 <tr id="4">
354 <th>4</th>
355 <th>WrTForum</th>
356 <td>
357 Extends <a href="#3"><b>WrForum</b></a>, bypassing the moderation
358 and sync restrictions. Mnemonic: post <b>4</b> immediate release.
359 </td>
360 </tr>
361
362 <tr id="5">
363 <th>5</th>
364 <th>ModForum</th>
365 <td>
@@ -368,11 +369,11 @@
368 href="#4"><b>WrTForum</b></a> and <a href="#2"><b>RdForum</b></a>,
369 so a user with this cap never has to moderate their own posts.
370 Mnemonic: “May I have <b>5</b> seconds of your time, honored
371 Gatekeeper?”
372 </td>
373 </tr>
374
375 <tr id="6">
376 <th>6</th>
377 <th>AdminForum</th>
378 <td>
@@ -387,46 +388,54 @@
387 currently revoke granted caps. Granting this capability also
388 grants <a href="#5"><b>ModForum</b></a> and those it in turn
389 grants. Mnemonic: “I’m <b>6</b> [sick] of hitting Approve on your
390 posts!”
391 </td>
392 </tr>
393
394 <tr id="7">
395 <th>7</th>
396 <th>EmailAlert</th>
397 <td>
398 User can sign up for <a href="../alerts.md">email alerts</a>.
399 Mnemonic: <a href="https://en.wikipedia.org/wiki/Heaven_Can_Wait">Seven can
400 wait</a>, I’ve got email to read now.
401 </td>
402 </tr>
403
404 <tr id="A">
405 <th>A</th>
406 <th>Announce</th>
407 <td>
408 Send email announcements to users <a href="#7">signed up to
409 receive them</a>. Mnemonic: <b>a</b>nnounce.
410 </td>
411 </tr>
 
 
 
 
 
 
 
 
412
413 <tr id="C">
414 <th>C</th>
415 <th>Chat</th>
416 <td>
417 Allow access to the <tt>/chat</tt> room.
418 </td>
419 </tr>
420
421 <tr id="D">
422 <th>D</th>
423 <th>Debug</th>
424 <td>
425 Enable debugging features. Mnemonic: <b>d</b>ebug.
426 </td>
427 </tr>
428
429 <tr id="L">
430 <th>L</th>
431 <th>Is-logged-in</th>
432 <td>
@@ -433,13 +442,13 @@
433 This is not a real capability, but is used in certain capability
434 checks, e.g. via <a href="../th1.md#capexpr">capexpr</a>. It
435 resolves to true if the current user is logged in.
436 Mnemonic: <b>L</b>ogged in.
437 </td>
438 </tr>
439
440 </table>
441
442 <hr/>
443
444 <p id="backlink"><a href="./"><em>Back to Administering User
445 Capabilities</em></a></p>
446
--- www/caps/ref.html
+++ www/caps/ref.html
@@ -56,28 +56,29 @@
56 Admin users have <em>all</em> of the capabilities below except for
57 <a href="#s">setup</a>, <a herf="#x">Private</a>, and <a href="#y">WrUnver</a>.
58 See <a href="admin-v-setup.md">Admin vs. Setup</a> for a more
59 nuanced discussion. Mnemonic: <b>a</b>dministrate.
60 </td>
61 </tr>
62
63 <tr id="b">
64 <th>b</th>
65 <th>Attach</th>
66 <td>
67 Add attachments to wiki articles, technotes, or tickets.
68 Mnemonics: <b>b</b>ind, <b>b</b>utton, <b>b</b>ond, or <b>b</b>olt.
69 See also: <a href='#B'>B</a>.
70 </td>
71 </tr>
72
73 <tr id="c">
74 <th>c</th>
75 <th>ApndTkt</th>
76 <td>
77 Append comments to existing tickets. Mnemonic: <b>c</b>omment.
78 </td>
79 </tr>
80
81 <tr id="d">
82 <th>d</th>
83 <th>n/a</th>
84 <td>
@@ -100,21 +101,21 @@
101 identifying information</a> (PII) about other users such as email
102 addresses. Mnemonics: show <b>e</b>mail addresses; or
103 <b>E</b>urope, home of <a
104 href="https://en.wikipedia.org/wiki/General_Data_Protection_Regulation">GDPR</a>.
105 </td>
106 </tr>
107
108 <tr id="f">
109 <th>f</th>
110 <th>NewWiki</th>
111 <td>
112 Create new wiki articles. Mnemonic: <b>f</b>ast, English
113 translation of the Hawaiian word <a
114 href="https://en.wikipedia.org/wiki/History_of_wikis#WikiWikiWeb,_the_first_wiki"><i>wiki</i></a>.
115 </td>
116 </tr>
117
118 <tr id="g">
119 <th>g</th>
120 <th>Clone</th>
121 <td>
@@ -121,11 +122,11 @@
122 Clone the repository. Note that this is distinct from <a
123 href="#o">check-out capability, <b>o</b></a>; and that upon cloning
124 not just files, but also tickets, wikis, technotes and forum posts
125 are tranferred. Mnemonic: <b>g</b>et.
126 </td>
127 </tr>
128
129 <tr id="h">
130 <th>h</th>
131 <th>Hyperlink</th>
132 <td>
@@ -134,11 +135,11 @@
135 “nobody” category, to <a href="../antibot.wiki">prevent bots from
136 wandering around aimlessly</a> in the site’s hyperlink web, <a
137 href="../loadmgmt.md">chewing up server resources</a> to little
138 good purpose. Mnemonic: <b>h</b>yperlink.
139 </td>
140 </tr>
141
142 <tr id="i">
143 <th>i</th>
144 <th>Write</th>
145 <td>
@@ -149,20 +150,20 @@
150 Also note that not just files, but also tickets, wikis, technotes
151 and forum posts will be accepted from clones upon syncronization.
152 Granting this capability also grants <b>o (Read)</b> Mnemonics:
153 <b>i</b>nput, check <b>i</b>n changes.
154 </td>
155 </tr>
156
157 <tr id="j">
158 <th>j</th>
159 <th>RdWiki</th>
160 <td>
161 View wiki articles. Mnemonic: in<b>j</b>est page content. (All
162 right, you critics, you do better, then.)
163 </td>
164 </tr>
165
166 <tr id="k">
167 <th>k</th>
168 <th>WrWiki</th>
169 <td>
@@ -169,11 +170,11 @@
170 Edit wiki articles. Granting this capability also grants <a
171 href="#j"><b>RdWiki</b></a> and <a href="#m"><b>ApndWiki</b></a>,
172 but it does <em>not</em> grant <a href="#f"><b>NewWiki</b></a>!
173 Mnemonic: <b>k</b>ontribute.
174 </td>
175 </tr>
176
177 <tr id="l">
178 <th>l</th>
179 <th>ModWiki</th>
180 <td>
@@ -180,63 +181,63 @@
181 Moderate <a href="#m">wiki article appends</a>. Appends do not get
182 saved permanently to the receiving repo’s block chain until <a
183 href="#s">Setup</a> or someone with this cap approves it.
184 Mnemonic: a<b>l</b>low.
185 </td>
186 </tr>
187
188 <tr id="m">
189 <th>m</th>
190 <th>ApndWiki</th>
191 <td>
192 Append content to existing wiki articles. Mnemonic: a<b>m</b>end
193 wiki
194 </td>
195 </tr>
196
197 <tr id="n">
198 <th>n</th>
199 <th>NewTkt</th>
200 <td>
201 File new tickets. Mnemonic: <b>n</b>ew ticket.
202 </td>
203 </tr>
204
205 <tr id="o">
206 <th>o</th>
207 <th>Read</th>
208 <td>
209 Read content and history of files from a remote Fossil instance over
210 HTTP. See <a href="index.md#read-v-clone">Reading vs.
211 Cloning</a>. Mnemonic: check <b>o</b>ut remote repo contents.
212 </td>
213 </tr>
214
215 <tr id="p">
216 <th>p</th>
217 <th>Password</th>
218 <td>
219 Change one’s own password. Mnemonic: <b>p</b>assword.
220 </td>
221 </tr>
222
223 <tr id="q">
224 <th>q</th>
225 <th>ModTkt</th>
226 <td>
227 Moderate tickets: delete comments appended to tickets. Mnemonic:
228 <b>q</b>uash noise commentary.
229 </td>
230 </tr>
231
232 <tr id="r">
233 <th>r</th>
234 <th>RdTkt</th>
235 <td>
236 View existing tickets. Mnemonic: <b>r</b>ead tickets.
237 </td>
238 </tr>
239
240 <tr id="s">
241 <th>s</th>
242 <th>Setup</th>
243 <td>
@@ -256,41 +257,41 @@
257 because it is internally restricted to read-only queries on the
258 tickets table only. (This restriction is done with an SQLite
259 authorization hook, not by any method so weak as SQL text
260 filtering.) Mnemonic: new <b>t</b>icket report.
261 </td>
262 </tr>
263
264 <tr id="u">
265 <th>u</th>
266 <th>n/a</th>
267 <td>
268 Inherit all capabilities of the “reader” user category; does not
269 have a dedicated flag internally within Fossil. Mnemonic:
270 <a href="./index.md#ucat"><b>u</b>ser</a>
271 </td>
272 </tr>
273
274 <tr id="v">
275 <th>v</th>
276 <th>n/a</th>
277 <td>
278 Inherit all capabilities of the “developer” user category; does
279 not have a dedicated flag internally within Fossil. Mnemonic:
280 de<b>v</b>eloper.
281 </td>
282 </tr>
283
284 <tr id="w">
285 <th>w</th>
286 <th>WrTkt</th>
287 <td>
288 Edit existing tickets. Granting this capability also grants <a
289 href="#r"><b>RdTkt</b></a>, <a href="#c"><b>ApndTkt</b></a>, and
290 <a href="#n"><b>NewTkt</b></a>. Mnemonic: <b>w</b>rite to ticket.
291 </td>
292 </tr>
293
294 <tr id="x">
295 <th>x</th>
296 <th>Private</th>
297 <td>
@@ -298,21 +299,21 @@
299 Mnemonic: e<b>x</b>clusivity; “x” connotes unknown material in
300 many Western languages due to its <a
301 href="https://en.wikipedia.org/wiki/La_Géométrie#The_text">traditional
302 use in mathematics</a>.
303 </td>
304 </tr>
305
306 <tr id="y">
307 <th>y</th>
308 <th>WrUnver</th>
309 <td>
310 Push <a href="../unvers.wiki">unversioned content</a>. Mnemonic:
311 <b>y</b>ield, <a href="https://en.wiktionary.org/wiki/yield">sense
312 4</a>: “hand over.”
313 </td>
314 </tr>
315
316 <tr id="z">
317 <th>z</th>
318 <th>Zip</th>
319 <td>
@@ -323,20 +324,20 @@
324 expensive capability to grant, because creating such archives can
325 put a large load on <a href="../server/">a Fossil server</a> which
326 you may then need to <a href="../loadmgmt.md">manage</a>.
327 Mnemonic: <b>z</b>ip file download.
328 </td>
329 </tr>
330
331 <tr id="2">
332 <th>2</th>
333 <th>RdForum</th>
334 <td>
335 Read <a href="../forum.wiki">forum posts</a> by other users.
336 Mnemonic: from thee <b>2</b> me.
337 </td>
338 </tr>
339
340 <tr id="3">
341 <th>3</th>
342 <th>WrForum</th>
343 <td>
@@ -346,20 +347,20 @@
347 not appear in repo clones or syncs. Granting this capability also
348 grants <a href="#2"><b>RdForum</b></a>. Mnemonic: post for
349 <b>3</b> audiences: me, <a href="#5">the mods</a>, and <a
350 href="https://en.wikipedia.org/wiki/The_Man">the Man</a>.
351 </td>
352 </tr>
353
354 <tr id="4">
355 <th>4</th>
356 <th>WrTForum</th>
357 <td>
358 Extends <a href="#3"><b>WrForum</b></a>, bypassing the moderation
359 and sync restrictions. Mnemonic: post <b>4</b> immediate release.
360 </td>
361 </tr>
362
363 <tr id="5">
364 <th>5</th>
365 <th>ModForum</th>
366 <td>
@@ -368,11 +369,11 @@
369 href="#4"><b>WrTForum</b></a> and <a href="#2"><b>RdForum</b></a>,
370 so a user with this cap never has to moderate their own posts.
371 Mnemonic: “May I have <b>5</b> seconds of your time, honored
372 Gatekeeper?”
373 </td>
374 </tr>
375
376 <tr id="6">
377 <th>6</th>
378 <th>AdminForum</th>
379 <td>
@@ -387,46 +388,54 @@
388 currently revoke granted caps. Granting this capability also
389 grants <a href="#5"><b>ModForum</b></a> and those it in turn
390 grants. Mnemonic: “I’m <b>6</b> [sick] of hitting Approve on your
391 posts!”
392 </td>
393 </tr>
394
395 <tr id="7">
396 <th>7</th>
397 <th>EmailAlert</th>
398 <td>
399 User can sign up for <a href="../alerts.md">email alerts</a>.
400 Mnemonic: <a href="https://en.wikipedia.org/wiki/Heaven_Can_Wait">Seven can
401 wait</a>, I’ve got email to read now.
402 </td>
403 </tr>
404
405 <tr id="A">
406 <th>A</th>
407 <th>Announce</th>
408 <td>
409 Send email announcements to users <a href="#7">signed up to
410 receive them</a>. Mnemonic: <b>a</b>nnounce.
411 </td>
412 </tr>
413
414 <tr id="B">
415 <th>B</th>
416 <th>Attach to Forum</th>
417 <td>
418 Add attachments to forum posts. See also: <a href='#b'>b</a>.
419 </td>
420 </tr>
421
422 <tr id="C">
423 <th>C</th>
424 <th>Chat</th>
425 <td>
426 Allow access to the <tt>/chat</tt> room.
427 </td>
428 </tr>
429
430 <tr id="D">
431 <th>D</th>
432 <th>Debug</th>
433 <td>
434 Enable debugging features. Mnemonic: <b>d</b>ebug.
435 </td>
436 </tr>
437
438 <tr id="L">
439 <th>L</th>
440 <th>Is-logged-in</th>
441 <td>
@@ -433,13 +442,13 @@
442 This is not a real capability, but is used in certain capability
443 checks, e.g. via <a href="../th1.md#capexpr">capexpr</a>. It
444 resolves to true if the current user is logged in.
445 Mnemonic: <b>L</b>ogged in.
446 </td>
447 </tr>
448
449 </table>
450
451 <hr/>
452
453 <p id="backlink"><a href="./"><em>Back to Administering User
454 Capabilities</em></a></p>
455

Keyboard Shortcuts

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