|
779ddef…
|
wyoung
|
1 |
<div class='fossil-doc' data-title="User Capability Reference"> |
|
779ddef…
|
wyoung
|
2 |
|
|
779ddef…
|
wyoung
|
3 |
<style type="text/css"> |
|
779ddef…
|
wyoung
|
4 |
p#backlink { |
|
779ddef…
|
wyoung
|
5 |
/* Make empty space below the table so hyperlinks to named anchors |
|
779ddef…
|
wyoung
|
6 |
near the bottom of the table still scroll that row to the top of |
|
779ddef…
|
wyoung
|
7 |
the user's browser, even on tall screens. */ |
|
779ddef…
|
wyoung
|
8 |
margin-bottom: 75em; |
|
779ddef…
|
wyoung
|
9 |
} |
|
779ddef…
|
wyoung
|
10 |
|
|
779ddef…
|
wyoung
|
11 |
tr > th { |
|
779ddef…
|
wyoung
|
12 |
background-color: #e8e8e8; |
|
779ddef…
|
wyoung
|
13 |
vertical-align: top; |
|
779ddef…
|
wyoung
|
14 |
} |
|
5d8e5ee…
|
stephan
|
15 |
body.fossil-dark-style tr > th { |
|
5d8e5ee…
|
stephan
|
16 |
color: #000; |
|
5d8e5ee…
|
stephan
|
17 |
opacity: 0.85; |
|
5d8e5ee…
|
stephan
|
18 |
} |
|
779ddef…
|
wyoung
|
19 |
|
|
779ddef…
|
wyoung
|
20 |
tr.cols th { |
|
779ddef…
|
wyoung
|
21 |
white-space: nowrap; |
|
779ddef…
|
wyoung
|
22 |
} |
|
779ddef…
|
wyoung
|
23 |
|
|
779ddef…
|
wyoung
|
24 |
td, th { |
|
779ddef…
|
wyoung
|
25 |
padding: 0.4em; |
|
779ddef…
|
wyoung
|
26 |
} |
|
779ddef…
|
wyoung
|
27 |
</style> |
|
779ddef…
|
wyoung
|
28 |
|
|
779ddef…
|
wyoung
|
29 |
<p>Here we document each currently-defined user capability character in |
|
779ddef…
|
wyoung
|
30 |
more detail than the brief summary on the <a |
|
fd1282e…
|
drh
|
31 |
href="/setup_ucap_list">“key” page</a> in the Fossil user editor. Each |
|
779ddef…
|
wyoung
|
32 |
row gives the capability letter used in the Fossil user editor followed |
|
fd1282e…
|
drh
|
33 |
by the C code’s name for that cap within the <tt>FossilUserPerms</tt> |
|
779ddef…
|
wyoung
|
34 |
object, so you can use this reference both from the UI down and from the |
|
779ddef…
|
wyoung
|
35 |
C code up.</p> |
|
779ddef…
|
wyoung
|
36 |
|
|
779ddef…
|
wyoung
|
37 |
<p>The <a href="https://en.wikipedia.org/wiki/Mnemonic">mnemonics</a> |
|
779ddef…
|
wyoung
|
38 |
given here vary from obviously-correct to <i>post facto</i> |
|
779ddef…
|
wyoung
|
39 |
rationalizations to the outright fanciful. To <a |
|
779ddef…
|
wyoung
|
40 |
href="./impl.md#choices">some extent</a>, this is unavoidable.</p> |
|
779ddef…
|
wyoung
|
41 |
|
|
779ddef…
|
wyoung
|
42 |
|
|
779ddef…
|
wyoung
|
43 |
<h2>Reference</h2> |
|
779ddef…
|
wyoung
|
44 |
|
|
779ddef…
|
wyoung
|
45 |
<table> |
|
779ddef…
|
wyoung
|
46 |
<tr class="cols"> |
|
779ddef…
|
wyoung
|
47 |
<th>?</th> |
|
779ddef…
|
wyoung
|
48 |
<th>Name</th> |
|
779ddef…
|
wyoung
|
49 |
<th style="text-align: left">Description</th> |
|
779ddef…
|
wyoung
|
50 |
</tr> |
|
779ddef…
|
wyoung
|
51 |
|
|
779ddef…
|
wyoung
|
52 |
<tr id="a"> |
|
779ddef…
|
wyoung
|
53 |
<th>a</th> |
|
779ddef…
|
wyoung
|
54 |
<th>Admin</th> |
|
779ddef…
|
wyoung
|
55 |
<td> |
|
779ddef…
|
wyoung
|
56 |
Admin users have <em>all</em> of the capabilities below except for |
|
8a77f45…
|
wyoung
|
57 |
<a href="#s">setup</a>, <a herf="#x">Private</a>, and <a href="#y">WrUnver</a>. |
|
779ddef…
|
wyoung
|
58 |
See <a href="admin-v-setup.md">Admin vs. Setup</a> for a more |
|
779ddef…
|
wyoung
|
59 |
nuanced discussion. Mnemonic: <b>a</b>dministrate. |
|
779ddef…
|
wyoung
|
60 |
</td> |
|
fd1282e…
|
drh
|
61 |
</tr> |
|
779ddef…
|
wyoung
|
62 |
|
|
779ddef…
|
wyoung
|
63 |
<tr id="b"> |
|
779ddef…
|
wyoung
|
64 |
<th>b</th> |
|
779ddef…
|
wyoung
|
65 |
<th>Attach</th> |
|
779ddef…
|
wyoung
|
66 |
<td> |
|
779ddef…
|
wyoung
|
67 |
Add attachments to wiki articles or tickets. Mnemonics: <b>b</b>ind, |
|
779ddef…
|
wyoung
|
68 |
<b>b</b>utton, <b>b</b>ond, or <b>b</b>olt. |
|
779ddef…
|
wyoung
|
69 |
</td> |
|
fd1282e…
|
drh
|
70 |
</tr> |
|
779ddef…
|
wyoung
|
71 |
|
|
779ddef…
|
wyoung
|
72 |
<tr id="c"> |
|
779ddef…
|
wyoung
|
73 |
<th>c</th> |
|
779ddef…
|
wyoung
|
74 |
<th>ApndTkt</th> |
|
779ddef…
|
wyoung
|
75 |
<td> |
|
779ddef…
|
wyoung
|
76 |
Append comments to existing tickets. Mnemonic: <b>c</b>omment. |
|
779ddef…
|
wyoung
|
77 |
</td> |
|
fd1282e…
|
drh
|
78 |
</tr> |
|
779ddef…
|
wyoung
|
79 |
|
|
779ddef…
|
wyoung
|
80 |
<tr id="d"> |
|
779ddef…
|
wyoung
|
81 |
<th>d</th> |
|
1274054…
|
drh
|
82 |
<th>n/a</th> |
|
779ddef…
|
wyoung
|
83 |
<td> |
|
1274054…
|
drh
|
84 |
Legacy capability letter from Fossil's forebear <a |
|
1274054…
|
drh
|
85 |
href="http://cvstrac.org/">CVSTrac</a>, which has no useful |
|
ad47a44…
|
wyoung
|
86 |
meaning in Fossil due to the nature of its durable Merkle tree design. |
|
ad47a44…
|
wyoung
|
87 |
We recommend that you remove it in case we |
|
1274054…
|
drh
|
88 |
ever reuse this letter for another purpose. See <a |
|
1274054…
|
drh
|
89 |
href="https://fossil-scm.org/forum/forumpost/43c78f4bef">this |
|
1274054…
|
drh
|
90 |
post</a> for details. |
|
779ddef…
|
wyoung
|
91 |
</td> |
|
1274054…
|
drh
|
92 |
</tr> |
|
779ddef…
|
wyoung
|
93 |
|
|
779ddef…
|
wyoung
|
94 |
<tr id="e"> |
|
779ddef…
|
wyoung
|
95 |
<th>e</th> |
|
779ddef…
|
wyoung
|
96 |
<th>RdAddr</th> |
|
779ddef…
|
wyoung
|
97 |
<td> |
|
779ddef…
|
wyoung
|
98 |
View <a |
|
779ddef…
|
wyoung
|
99 |
href="https://en.wikipedia.org/wiki/Personal_data">personal |
|
779ddef…
|
wyoung
|
100 |
identifying information</a> (PII) about other users such as email |
|
779ddef…
|
wyoung
|
101 |
addresses. Mnemonics: show <b>e</b>mail addresses; or |
|
779ddef…
|
wyoung
|
102 |
<b>E</b>urope, home of <a |
|
779ddef…
|
wyoung
|
103 |
href="https://en.wikipedia.org/wiki/General_Data_Protection_Regulation">GDPR</a>. |
|
779ddef…
|
wyoung
|
104 |
</td> |
|
fd1282e…
|
drh
|
105 |
</tr> |
|
779ddef…
|
wyoung
|
106 |
|
|
779ddef…
|
wyoung
|
107 |
<tr id="f"> |
|
779ddef…
|
wyoung
|
108 |
<th>f</th> |
|
779ddef…
|
wyoung
|
109 |
<th>NewWiki</th> |
|
779ddef…
|
wyoung
|
110 |
<td> |
|
779ddef…
|
wyoung
|
111 |
Create new wiki articles. Mnemonic: <b>f</b>ast, English |
|
779ddef…
|
wyoung
|
112 |
translation of the Hawaiian word <a |
|
779ddef…
|
wyoung
|
113 |
href="https://en.wikipedia.org/wiki/History_of_wikis#WikiWikiWeb,_the_first_wiki"><i>wiki</i></a>. |
|
779ddef…
|
wyoung
|
114 |
</td> |
|
779ddef…
|
wyoung
|
115 |
</tr> |
|
779ddef…
|
wyoung
|
116 |
|
|
779ddef…
|
wyoung
|
117 |
<tr id="g"> |
|
779ddef…
|
wyoung
|
118 |
<th>g</th> |
|
779ddef…
|
wyoung
|
119 |
<th>Clone</th> |
|
779ddef…
|
wyoung
|
120 |
<td> |
|
779ddef…
|
wyoung
|
121 |
Clone the repository. Note that this is distinct from <a |
|
6e5337e…
|
george
|
122 |
href="#o">check-out capability, <b>o</b></a>; and that upon cloning |
|
6e5337e…
|
george
|
123 |
not just files, but also tickets, wikis, technotes and forum posts |
|
6e5337e…
|
george
|
124 |
are tranferred. Mnemonic: <b>g</b>et. |
|
779ddef…
|
wyoung
|
125 |
</td> |
|
fd1282e…
|
drh
|
126 |
</tr> |
|
779ddef…
|
wyoung
|
127 |
|
|
779ddef…
|
wyoung
|
128 |
<tr id="h"> |
|
779ddef…
|
wyoung
|
129 |
<th>h</th> |
|
779ddef…
|
wyoung
|
130 |
<th>Hyperlink</th> |
|
779ddef…
|
wyoung
|
131 |
<td> |
|
779ddef…
|
wyoung
|
132 |
Get hyperlinks in generated HTML which link you to other parts of |
|
779ddef…
|
wyoung
|
133 |
the repository. This capability exists so we can deny it to the |
|
fd1282e…
|
drh
|
134 |
“nobody” category, to <a href="../antibot.wiki">prevent bots from |
|
fd1282e…
|
drh
|
135 |
wandering around aimlessly</a> in the site’s hyperlink web, <a |
|
779ddef…
|
wyoung
|
136 |
href="../loadmgmt.md">chewing up server resources</a> to little |
|
779ddef…
|
wyoung
|
137 |
good purpose. Mnemonic: <b>h</b>yperlink. |
|
779ddef…
|
wyoung
|
138 |
</td> |
|
fd1282e…
|
drh
|
139 |
</tr> |
|
779ddef…
|
wyoung
|
140 |
|
|
779ddef…
|
wyoung
|
141 |
<tr id="i"> |
|
779ddef…
|
wyoung
|
142 |
<th>i</th> |
|
779ddef…
|
wyoung
|
143 |
<th>Write</th> |
|
779ddef…
|
wyoung
|
144 |
<td> |
|
779ddef…
|
wyoung
|
145 |
Check changes into the repository. Note that a lack of this |
|
779ddef…
|
wyoung
|
146 |
capability does not prevent you from checking changes into your |
|
779ddef…
|
wyoung
|
147 |
local clone, only from syncing those changes up to the parent |
|
779ddef…
|
wyoung
|
148 |
repo, and then <a href="./basics.md#webonly">only over HTTP</a>. |
|
6e5337e…
|
george
|
149 |
Also note that not just files, but also tickets, wikis, technotes |
|
6e5337e…
|
george
|
150 |
and forum posts will be accepted from clones upon syncronization. |
|
779ddef…
|
wyoung
|
151 |
Granting this capability also grants <b>o (Read)</b> Mnemonics: |
|
779ddef…
|
wyoung
|
152 |
<b>i</b>nput, check <b>i</b>n changes. |
|
779ddef…
|
wyoung
|
153 |
</td> |
|
fd1282e…
|
drh
|
154 |
</tr> |
|
779ddef…
|
wyoung
|
155 |
|
|
779ddef…
|
wyoung
|
156 |
<tr id="j"> |
|
779ddef…
|
wyoung
|
157 |
<th>j</th> |
|
779ddef…
|
wyoung
|
158 |
<th>RdWiki</th> |
|
779ddef…
|
wyoung
|
159 |
<td> |
|
779ddef…
|
wyoung
|
160 |
View wiki articles. Mnemonic: in<b>j</b>est page content. (All |
|
779ddef…
|
wyoung
|
161 |
right, you critics, you do better, then.) |
|
779ddef…
|
wyoung
|
162 |
</td> |
|
fd1282e…
|
drh
|
163 |
</tr> |
|
779ddef…
|
wyoung
|
164 |
|
|
779ddef…
|
wyoung
|
165 |
<tr id="k"> |
|
779ddef…
|
wyoung
|
166 |
<th>k</th> |
|
779ddef…
|
wyoung
|
167 |
<th>WrWiki</th> |
|
779ddef…
|
wyoung
|
168 |
<td> |
|
779ddef…
|
wyoung
|
169 |
Edit wiki articles. Granting this capability also grants <a |
|
779ddef…
|
wyoung
|
170 |
href="#j"><b>RdWiki</b></a> and <a href="#m"><b>ApndWiki</b></a>, |
|
779ddef…
|
wyoung
|
171 |
but it does <em>not</em> grant <a href="#f"><b>NewWiki</b></a>! |
|
779ddef…
|
wyoung
|
172 |
Mnemonic: <b>k</b>ontribute. |
|
779ddef…
|
wyoung
|
173 |
</td> |
|
fd1282e…
|
drh
|
174 |
</tr> |
|
779ddef…
|
wyoung
|
175 |
|
|
779ddef…
|
wyoung
|
176 |
<tr id="l"> |
|
779ddef…
|
wyoung
|
177 |
<th>l</th> |
|
779ddef…
|
wyoung
|
178 |
<th>ModWiki</th> |
|
779ddef…
|
wyoung
|
179 |
<td> |
|
779ddef…
|
wyoung
|
180 |
Moderate <a href="#m">wiki article appends</a>. Appends do not get |
|
fd1282e…
|
drh
|
181 |
saved permanently to the receiving repo’s block chain until <a |
|
779ddef…
|
wyoung
|
182 |
href="#s">Setup</a> or someone with this cap approves it. |
|
779ddef…
|
wyoung
|
183 |
Mnemonic: a<b>l</b>low. |
|
779ddef…
|
wyoung
|
184 |
</td> |
|
fd1282e…
|
drh
|
185 |
</tr> |
|
779ddef…
|
wyoung
|
186 |
|
|
779ddef…
|
wyoung
|
187 |
<tr id="m"> |
|
779ddef…
|
wyoung
|
188 |
<th>m</th> |
|
779ddef…
|
wyoung
|
189 |
<th>ApndWiki</th> |
|
779ddef…
|
wyoung
|
190 |
<td> |
|
779ddef…
|
wyoung
|
191 |
Append content to existing wiki articles. Mnemonic: a<b>m</b>end |
|
779ddef…
|
wyoung
|
192 |
wiki |
|
779ddef…
|
wyoung
|
193 |
</td> |
|
fd1282e…
|
drh
|
194 |
</tr> |
|
779ddef…
|
wyoung
|
195 |
|
|
779ddef…
|
wyoung
|
196 |
<tr id="n"> |
|
779ddef…
|
wyoung
|
197 |
<th>n</th> |
|
779ddef…
|
wyoung
|
198 |
<th>NewTkt</th> |
|
779ddef…
|
wyoung
|
199 |
<td> |
|
779ddef…
|
wyoung
|
200 |
File new tickets. Mnemonic: <b>n</b>ew ticket. |
|
779ddef…
|
wyoung
|
201 |
</td> |
|
fd1282e…
|
drh
|
202 |
</tr> |
|
779ddef…
|
wyoung
|
203 |
|
|
779ddef…
|
wyoung
|
204 |
<tr id="o"> |
|
779ddef…
|
wyoung
|
205 |
<th>o</th> |
|
779ddef…
|
wyoung
|
206 |
<th>Read</th> |
|
779ddef…
|
wyoung
|
207 |
<td> |
|
6e5337e…
|
george
|
208 |
Read content and history of files from a remote Fossil instance over |
|
779ddef…
|
wyoung
|
209 |
HTTP. See <a href="index.md#read-v-clone">Reading vs. |
|
779ddef…
|
wyoung
|
210 |
Cloning</a>. Mnemonic: check <b>o</b>ut remote repo contents. |
|
779ddef…
|
wyoung
|
211 |
</td> |
|
fd1282e…
|
drh
|
212 |
</tr> |
|
779ddef…
|
wyoung
|
213 |
|
|
779ddef…
|
wyoung
|
214 |
<tr id="p"> |
|
779ddef…
|
wyoung
|
215 |
<th>p</th> |
|
779ddef…
|
wyoung
|
216 |
<th>Password</th> |
|
779ddef…
|
wyoung
|
217 |
<td> |
|
fd1282e…
|
drh
|
218 |
Change one’s own password. Mnemonic: <b>p</b>assword. |
|
779ddef…
|
wyoung
|
219 |
</td> |
|
fd1282e…
|
drh
|
220 |
</tr> |
|
779ddef…
|
wyoung
|
221 |
|
|
779ddef…
|
wyoung
|
222 |
<tr id="q"> |
|
779ddef…
|
wyoung
|
223 |
<th>q</th> |
|
779ddef…
|
wyoung
|
224 |
<th>ModTkt</th> |
|
779ddef…
|
wyoung
|
225 |
<td> |
|
779ddef…
|
wyoung
|
226 |
Moderate tickets: delete comments appended to tickets. Mnemonic: |
|
779ddef…
|
wyoung
|
227 |
<b>q</b>uash noise commentary. |
|
779ddef…
|
wyoung
|
228 |
</td> |
|
fd1282e…
|
drh
|
229 |
</tr> |
|
779ddef…
|
wyoung
|
230 |
|
|
779ddef…
|
wyoung
|
231 |
<tr id="r"> |
|
779ddef…
|
wyoung
|
232 |
<th>r</th> |
|
779ddef…
|
wyoung
|
233 |
<th>RdTkt</th> |
|
779ddef…
|
wyoung
|
234 |
<td> |
|
779ddef…
|
wyoung
|
235 |
View existing tickets. Mnemonic: <b>r</b>ead tickets. |
|
779ddef…
|
wyoung
|
236 |
</td> |
|
fd1282e…
|
drh
|
237 |
</tr> |
|
779ddef…
|
wyoung
|
238 |
|
|
779ddef…
|
wyoung
|
239 |
<tr id="s"> |
|
779ddef…
|
wyoung
|
240 |
<th>s</th> |
|
779ddef…
|
wyoung
|
241 |
<th>Setup</th> |
|
779ddef…
|
wyoung
|
242 |
<td> |
|
779ddef…
|
wyoung
|
243 |
The <a href="./admin-v-setup.md#apsu">all-powerful Setup user</a>. |
|
779ddef…
|
wyoung
|
244 |
Mnemonics: <b>s</b>etup or <b>s</b>uperuser. |
|
779ddef…
|
wyoung
|
245 |
</td> |
|
779ddef…
|
wyoung
|
246 |
</tr> |
|
779ddef…
|
wyoung
|
247 |
|
|
779ddef…
|
wyoung
|
248 |
<tr id="t"> |
|
779ddef…
|
wyoung
|
249 |
<th>t</th> |
|
779ddef…
|
wyoung
|
250 |
<th>TktFmt</th> |
|
779ddef…
|
wyoung
|
251 |
<td> |
|
779ddef…
|
wyoung
|
252 |
Create new ticket report formats. Note that although this allows |
|
fd1282e…
|
drh
|
253 |
the user to provide SQL code to be run in the server’s context, |
|
fd1282e…
|
drh
|
254 |
and this capability is given to the untrusted “anonymous” user |
|
779ddef…
|
wyoung
|
255 |
category by default, this is a safe capability to give to users |
|
779ddef…
|
wyoung
|
256 |
because it is internally restricted to read-only queries on the |
|
c0654b1…
|
brickviking
|
257 |
tickets table only. (This restriction is done with an SQLite |
|
779ddef…
|
wyoung
|
258 |
authorization hook, not by any method so weak as SQL text |
|
779ddef…
|
wyoung
|
259 |
filtering.) Mnemonic: new <b>t</b>icket report. |
|
779ddef…
|
wyoung
|
260 |
</td> |
|
fd1282e…
|
drh
|
261 |
</tr> |
|
779ddef…
|
wyoung
|
262 |
|
|
779ddef…
|
wyoung
|
263 |
<tr id="u"> |
|
779ddef…
|
wyoung
|
264 |
<th>u</th> |
|
779ddef…
|
wyoung
|
265 |
<th>n/a</th> |
|
779ddef…
|
wyoung
|
266 |
<td> |
|
fd1282e…
|
drh
|
267 |
Inherit all capabilities of the “reader” user category; does not |
|
779ddef…
|
wyoung
|
268 |
have a dedicated flag internally within Fossil. Mnemonic: |
|
779ddef…
|
wyoung
|
269 |
<a href="./index.md#ucat"><b>u</b>ser</a> |
|
779ddef…
|
wyoung
|
270 |
</td> |
|
fd1282e…
|
drh
|
271 |
</tr> |
|
779ddef…
|
wyoung
|
272 |
|
|
779ddef…
|
wyoung
|
273 |
<tr id="v"> |
|
779ddef…
|
wyoung
|
274 |
<th>v</th> |
|
779ddef…
|
wyoung
|
275 |
<th>n/a</th> |
|
779ddef…
|
wyoung
|
276 |
<td> |
|
fd1282e…
|
drh
|
277 |
Inherit all capabilities of the “developer” user category; does |
|
779ddef…
|
wyoung
|
278 |
not have a dedicated flag internally within Fossil. Mnemonic: |
|
779ddef…
|
wyoung
|
279 |
de<b>v</b>eloper. |
|
779ddef…
|
wyoung
|
280 |
</td> |
|
fd1282e…
|
drh
|
281 |
</tr> |
|
779ddef…
|
wyoung
|
282 |
|
|
779ddef…
|
wyoung
|
283 |
<tr id="w"> |
|
779ddef…
|
wyoung
|
284 |
<th>w</th> |
|
779ddef…
|
wyoung
|
285 |
<th>WrTkt</th> |
|
779ddef…
|
wyoung
|
286 |
<td> |
|
779ddef…
|
wyoung
|
287 |
Edit existing tickets. Granting this capability also grants <a |
|
779ddef…
|
wyoung
|
288 |
href="#r"><b>RdTkt</b></a>, <a href="#c"><b>ApndTkt</b></a>, and |
|
779ddef…
|
wyoung
|
289 |
<a href="#n"><b>NewTkt</b></a>. Mnemonic: <b>w</b>rite to ticket. |
|
779ddef…
|
wyoung
|
290 |
</td> |
|
fd1282e…
|
drh
|
291 |
</tr> |
|
779ddef…
|
wyoung
|
292 |
|
|
779ddef…
|
wyoung
|
293 |
<tr id="x"> |
|
779ddef…
|
wyoung
|
294 |
<th>x</th> |
|
779ddef…
|
wyoung
|
295 |
<th>Private</th> |
|
779ddef…
|
wyoung
|
296 |
<td> |
|
779ddef…
|
wyoung
|
297 |
Push or pull <a href="../private.wiki">private branches</a>. |
|
fd1282e…
|
drh
|
298 |
Mnemonic: e<b>x</b>clusivity; “x” connotes unknown material in |
|
779ddef…
|
wyoung
|
299 |
many Western languages due to its <a |
|
fd1282e…
|
drh
|
300 |
href="https://en.wikipedia.org/wiki/La_Géométrie#The_text">traditional |
|
779ddef…
|
wyoung
|
301 |
use in mathematics</a>. |
|
779ddef…
|
wyoung
|
302 |
</td> |
|
fd1282e…
|
drh
|
303 |
</tr> |
|
779ddef…
|
wyoung
|
304 |
|
|
779ddef…
|
wyoung
|
305 |
<tr id="y"> |
|
779ddef…
|
wyoung
|
306 |
<th>y</th> |
|
779ddef…
|
wyoung
|
307 |
<th>WrUnver</th> |
|
779ddef…
|
wyoung
|
308 |
<td> |
|
779ddef…
|
wyoung
|
309 |
Push <a href="../unvers.wiki">unversioned content</a>. Mnemonic: |
|
779ddef…
|
wyoung
|
310 |
<b>y</b>ield, <a href="https://en.wiktionary.org/wiki/yield">sense |
|
fd1282e…
|
drh
|
311 |
4</a>: “hand over.” |
|
779ddef…
|
wyoung
|
312 |
</td> |
|
fd1282e…
|
drh
|
313 |
</tr> |
|
779ddef…
|
wyoung
|
314 |
|
|
779ddef…
|
wyoung
|
315 |
<tr id="z"> |
|
779ddef…
|
wyoung
|
316 |
<th>z</th> |
|
779ddef…
|
wyoung
|
317 |
<th>Zip</th> |
|
779ddef…
|
wyoung
|
318 |
<td> |
|
779ddef…
|
wyoung
|
319 |
Pull archives of particular repository versions via <a |
|
c64f28d…
|
drh
|
320 |
href="/help/www/zip"><tt>/zip</tt></a>, <a |
|
c64f28d…
|
drh
|
321 |
href="/help/www/tarball"><tt>/tarball</tt></a>, and <a |
|
c64f28d…
|
drh
|
322 |
href="/help/www/sqlar"><tt>/sqlar</tt></a> URLs. This is an |
|
779ddef…
|
wyoung
|
323 |
expensive capability to grant, because creating such archives can |
|
779ddef…
|
wyoung
|
324 |
put a large load on <a href="../server/">a Fossil server</a> which |
|
779ddef…
|
wyoung
|
325 |
you may then need to <a href="../loadmgmt.md">manage</a>. |
|
779ddef…
|
wyoung
|
326 |
Mnemonic: <b>z</b>ip file download. |
|
779ddef…
|
wyoung
|
327 |
</td> |
|
fd1282e…
|
drh
|
328 |
</tr> |
|
779ddef…
|
wyoung
|
329 |
|
|
779ddef…
|
wyoung
|
330 |
<tr id="2"> |
|
779ddef…
|
wyoung
|
331 |
<th>2</th> |
|
779ddef…
|
wyoung
|
332 |
<th>RdForum</th> |
|
779ddef…
|
wyoung
|
333 |
<td> |
|
779ddef…
|
wyoung
|
334 |
Read <a href="../forum.wiki">forum posts</a> by other users. |
|
779ddef…
|
wyoung
|
335 |
Mnemonic: from thee <b>2</b> me. |
|
779ddef…
|
wyoung
|
336 |
</td> |
|
fd1282e…
|
drh
|
337 |
</tr> |
|
779ddef…
|
wyoung
|
338 |
|
|
779ddef…
|
wyoung
|
339 |
<tr id="3"> |
|
779ddef…
|
wyoung
|
340 |
<th>3</th> |
|
779ddef…
|
wyoung
|
341 |
<th>WrForum</th> |
|
779ddef…
|
wyoung
|
342 |
<td> |
|
779ddef…
|
wyoung
|
343 |
Create new forum threads, reply to threads created by others, and |
|
fd1282e…
|
drh
|
344 |
edit one’s own posts. New posts are <a |
|
779ddef…
|
wyoung
|
345 |
href="../forum.wiki#moderation">held for moderation</a> and do |
|
779ddef…
|
wyoung
|
346 |
not appear in repo clones or syncs. Granting this capability also |
|
779ddef…
|
wyoung
|
347 |
grants <a href="#2"><b>RdForum</b></a>. Mnemonic: post for |
|
779ddef…
|
wyoung
|
348 |
<b>3</b> audiences: me, <a href="#5">the mods</a>, and <a |
|
779ddef…
|
wyoung
|
349 |
href="https://en.wikipedia.org/wiki/The_Man">the Man</a>. |
|
779ddef…
|
wyoung
|
350 |
</td> |
|
fd1282e…
|
drh
|
351 |
</tr> |
|
779ddef…
|
wyoung
|
352 |
|
|
779ddef…
|
wyoung
|
353 |
<tr id="4"> |
|
779ddef…
|
wyoung
|
354 |
<th>4</th> |
|
779ddef…
|
wyoung
|
355 |
<th>WrTForum</th> |
|
779ddef…
|
wyoung
|
356 |
<td> |
|
779ddef…
|
wyoung
|
357 |
Extends <a href="#3"><b>WrForum</b></a>, bypassing the moderation |
|
779ddef…
|
wyoung
|
358 |
and sync restrictions. Mnemonic: post <b>4</b> immediate release. |
|
779ddef…
|
wyoung
|
359 |
</td> |
|
fd1282e…
|
drh
|
360 |
</tr> |
|
779ddef…
|
wyoung
|
361 |
|
|
779ddef…
|
wyoung
|
362 |
<tr id="5"> |
|
779ddef…
|
wyoung
|
363 |
<th>5</th> |
|
779ddef…
|
wyoung
|
364 |
<th>ModForum</th> |
|
779ddef…
|
wyoung
|
365 |
<td> |
|
779ddef…
|
wyoung
|
366 |
<a href="../forum.wiki#moderation">Moderate forum posts</a>. |
|
779ddef…
|
wyoung
|
367 |
Granting this capability also grants <a |
|
779ddef…
|
wyoung
|
368 |
href="#4"><b>WrTForum</b></a> and <a href="#2"><b>RdForum</b></a>, |
|
779ddef…
|
wyoung
|
369 |
so a user with this cap never has to moderate their own posts. |
|
fd1282e…
|
drh
|
370 |
Mnemonic: “May I have <b>5</b> seconds of your time, honored |
|
fd1282e…
|
drh
|
371 |
Gatekeeper?” |
|
779ddef…
|
wyoung
|
372 |
</td> |
|
fd1282e…
|
drh
|
373 |
</tr> |
|
779ddef…
|
wyoung
|
374 |
|
|
779ddef…
|
wyoung
|
375 |
<tr id="6"> |
|
779ddef…
|
wyoung
|
376 |
<th>6</th> |
|
779ddef…
|
wyoung
|
377 |
<th>AdminForum</th> |
|
779ddef…
|
wyoung
|
378 |
<td> |
|
779ddef…
|
wyoung
|
379 |
Users with this capability see a checkbox on unmoderated forum |
|
fd1282e…
|
drh
|
380 |
posts labeled “Trust user X so that future posts by user X do not |
|
fd1282e…
|
drh
|
381 |
require moderation.” Checking that box and then clicking the |
|
fd1282e…
|
drh
|
382 |
moderator-only “Approve” button on that post grants <a |
|
fd1282e…
|
drh
|
383 |
href="#4"><b>WrTForum</b></a> capability to that post’s author. |
|
779ddef…
|
wyoung
|
384 |
There is currently no UI for a user with this cap to |
|
779ddef…
|
wyoung
|
385 |
<em>revoke</em> trust from a user once it is granted; only <a |
|
779ddef…
|
wyoung
|
386 |
href="#a"><b>Admin</b></a> and <a href="#s"><b>Setup</b></a> can |
|
779ddef…
|
wyoung
|
387 |
currently revoke granted caps. Granting this capability also |
|
779ddef…
|
wyoung
|
388 |
grants <a href="#5"><b>ModForum</b></a> and those it in turn |
|
fd1282e…
|
drh
|
389 |
grants. Mnemonic: “I’m <b>6</b> [sick] of hitting Approve on your |
|
fd1282e…
|
drh
|
390 |
posts!” |
|
779ddef…
|
wyoung
|
391 |
</td> |
|
fd1282e…
|
drh
|
392 |
</tr> |
|
779ddef…
|
wyoung
|
393 |
|
|
779ddef…
|
wyoung
|
394 |
<tr id="7"> |
|
779ddef…
|
wyoung
|
395 |
<th>7</th> |
|
779ddef…
|
wyoung
|
396 |
<th>EmailAlert</th> |
|
779ddef…
|
wyoung
|
397 |
<td> |
|
779ddef…
|
wyoung
|
398 |
User can sign up for <a href="../alerts.md">email alerts</a>. |
|
779ddef…
|
wyoung
|
399 |
Mnemonic: <a href="https://en.wikipedia.org/wiki/Heaven_Can_Wait">Seven can |
|
fd1282e…
|
drh
|
400 |
wait</a>, I’ve got email to read now. |
|
779ddef…
|
wyoung
|
401 |
</td> |
|
fd1282e…
|
drh
|
402 |
</tr> |
|
779ddef…
|
wyoung
|
403 |
|
|
779ddef…
|
wyoung
|
404 |
<tr id="A"> |
|
779ddef…
|
wyoung
|
405 |
<th>A</th> |
|
779ddef…
|
wyoung
|
406 |
<th>Announce</th> |
|
779ddef…
|
wyoung
|
407 |
<td> |
|
779ddef…
|
wyoung
|
408 |
Send email announcements to users <a href="#7">signed up to |
|
779ddef…
|
wyoung
|
409 |
receive them</a>. Mnemonic: <b>a</b>nnounce. |
|
779ddef…
|
wyoung
|
410 |
</td> |
|
fd1282e…
|
drh
|
411 |
</tr> |
|
fd1282e…
|
drh
|
412 |
|
|
3fcb967…
|
wyoung
|
413 |
<tr id="C"> |
|
3fcb967…
|
wyoung
|
414 |
<th>C</th> |
|
3fcb967…
|
wyoung
|
415 |
<th>Chat</th> |
|
3fcb967…
|
wyoung
|
416 |
<td> |
|
3fcb967…
|
wyoung
|
417 |
Allow access to the <tt>/chat</tt> room. |
|
3fcb967…
|
wyoung
|
418 |
</td> |
|
3fcb967…
|
wyoung
|
419 |
</tr> |
|
3fcb967…
|
wyoung
|
420 |
|
|
779ddef…
|
wyoung
|
421 |
<tr id="D"> |
|
779ddef…
|
wyoung
|
422 |
<th>D</th> |
|
779ddef…
|
wyoung
|
423 |
<th>Debug</th> |
|
779ddef…
|
wyoung
|
424 |
<td> |
|
779ddef…
|
wyoung
|
425 |
Enable debugging features. Mnemonic: <b>d</b>ebug. |
|
779ddef…
|
wyoung
|
426 |
</td> |
|
fd1282e…
|
drh
|
427 |
</tr> |
|
e5240c9…
|
stephan
|
428 |
|
|
e5240c9…
|
stephan
|
429 |
<tr id="L"> |
|
e5240c9…
|
stephan
|
430 |
<th>L</th> |
|
e5240c9…
|
stephan
|
431 |
<th>Is-logged-in</th> |
|
e5240c9…
|
stephan
|
432 |
<td> |
|
e5240c9…
|
stephan
|
433 |
This is not a real capability, but is used in certain capability |
|
e5240c9…
|
stephan
|
434 |
checks, e.g. via <a href="../th1.md#capexpr">capexpr</a>. It |
|
e5240c9…
|
stephan
|
435 |
resolves to true if the current user is logged in. |
|
e5240c9…
|
stephan
|
436 |
Mnemonic: <b>L</b>ogged in. |
|
e5240c9…
|
stephan
|
437 |
</td> |
|
e5240c9…
|
stephan
|
438 |
</tr> |
|
e5240c9…
|
stephan
|
439 |
|
|
779ddef…
|
wyoung
|
440 |
</table> |
|
779ddef…
|
wyoung
|
441 |
|
|
779ddef…
|
wyoung
|
442 |
<hr/> |
|
779ddef…
|
wyoung
|
443 |
|
|
779ddef…
|
wyoung
|
444 |
<p id="backlink"><a href="./"><em>Back to Administering User |
|
779ddef…
|
wyoung
|
445 |
Capabilities</em></a></p> |