Fossil SCM
Clarify the documentation: say explicitly that [/doc/trunk/www/caps/ref.html#g|Clone capability, "g"] provides read access to tickets, wiki and forum; and that [/doc/trunk/www/caps/ref.html#g|Write capability, "i"] implies that changes to tickets, wiki and forum are also accepted from clones upon syncronization.
Commit
6e5337e8303e178a0298519fa71a56f4d52296ad7d7375f2806131dc6c12e375
Parent
e50c3629b8cd6c8…
2 files changed
+6
-6
+6
-3
+6
-6
| --- www/caps/index.md | ||
| +++ www/caps/index.md | ||
| @@ -193,16 +193,16 @@ | ||
| 193 | 193 | The repo clone is completely under your user’s power at that point, |
| 194 | 194 | affected only by OS file permissions and such. If you need to prevent |
| 195 | 195 | that, you want to deny **Clone** capability instead. |
| 196 | 196 | |
| 197 | 197 | Withholding the **Read** capability has a different effect: it |
| 198 | -prevents a web client from viewing [embedded | |
| 199 | -documentation][edoc], using [the file | |
| 200 | -browser](/help?name=/dir), and pulling file content via the | |
| 201 | -[`/artifact`](/help?name=/artifact), [`/file`](/help?name=/file), and | |
| 202 | -[`/raw`](/help?name=/raw) URLs. | |
| 203 | -It is is common to withhold **Read** capability from low-status visitors | |
| 198 | +prevents a web client from viewing [embedded documentation][edoc], | |
| 199 | +using [the file browser](/help?name=/dir), | |
| 200 | +exploring the [history](/help?name=/timeline) of check-ins, | |
| 201 | +and pulling file content via the [`/artifact`](/help?name=/artifact), | |
| 202 | +[`/file`](/help?name=/file), and [`/raw`](/help?name=/raw) URLs. | |
| 203 | +It is common to withhold **Read** capability from low-status visitors | |
| 204 | 204 | on private or semi-private repos to prevent them from pulling individual |
| 205 | 205 | elements of the repo over the web one at a time, as someone may do when |
| 206 | 206 | denied the bulk **Clone** capability. |
| 207 | 207 | |
| 208 | 208 | [edoc]: ../embeddeddoc.wiki |
| 209 | 209 |
| --- www/caps/index.md | |
| +++ www/caps/index.md | |
| @@ -193,16 +193,16 @@ | |
| 193 | The repo clone is completely under your user’s power at that point, |
| 194 | affected only by OS file permissions and such. If you need to prevent |
| 195 | that, you want to deny **Clone** capability instead. |
| 196 | |
| 197 | Withholding the **Read** capability has a different effect: it |
| 198 | prevents a web client from viewing [embedded |
| 199 | documentation][edoc], using [the file |
| 200 | browser](/help?name=/dir), and pulling file content via the |
| 201 | [`/artifact`](/help?name=/artifact), [`/file`](/help?name=/file), and |
| 202 | [`/raw`](/help?name=/raw) URLs. |
| 203 | It is is common to withhold **Read** capability from low-status visitors |
| 204 | on private or semi-private repos to prevent them from pulling individual |
| 205 | elements of the repo over the web one at a time, as someone may do when |
| 206 | denied the bulk **Clone** capability. |
| 207 | |
| 208 | [edoc]: ../embeddeddoc.wiki |
| 209 |
| --- www/caps/index.md | |
| +++ www/caps/index.md | |
| @@ -193,16 +193,16 @@ | |
| 193 | The repo clone is completely under your user’s power at that point, |
| 194 | affected only by OS file permissions and such. If you need to prevent |
| 195 | that, you want to deny **Clone** capability instead. |
| 196 | |
| 197 | Withholding the **Read** capability has a different effect: it |
| 198 | prevents a web client from viewing [embedded documentation][edoc], |
| 199 | using [the file browser](/help?name=/dir), |
| 200 | exploring the [history](/help?name=/timeline) of check-ins, |
| 201 | and pulling file content via the [`/artifact`](/help?name=/artifact), |
| 202 | [`/file`](/help?name=/file), and [`/raw`](/help?name=/raw) URLs. |
| 203 | It is common to withhold **Read** capability from low-status visitors |
| 204 | on private or semi-private repos to prevent them from pulling individual |
| 205 | elements of the repo over the web one at a time, as someone may do when |
| 206 | denied the bulk **Clone** capability. |
| 207 | |
| 208 | [edoc]: ../embeddeddoc.wiki |
| 209 |
+6
-3
| --- www/caps/ref.html | ||
| +++ www/caps/ref.html | ||
| @@ -119,12 +119,13 @@ | ||
| 119 | 119 | <tr id="g"> |
| 120 | 120 | <th>g</th> |
| 121 | 121 | <th>Clone</th> |
| 122 | 122 | <td> |
| 123 | 123 | Clone the repository. Note that this is distinct from <a |
| 124 | - href="#o">check-out capability, <b>o</b></a>. Mnemonic: | |
| 125 | - <b>g</b>et. | |
| 124 | + href="#o">check-out capability, <b>o</b></a>; and that upon cloning | |
| 125 | + not just files, but also tickets, wikis, technotes and forum posts | |
| 126 | + are tranferred. Mnemonic: <b>g</b>et. | |
| 126 | 127 | </td> |
| 127 | 128 | </tr> |
| 128 | 129 | |
| 129 | 130 | <tr id="h"> |
| 130 | 131 | <th>h</th> |
| @@ -145,10 +146,12 @@ | ||
| 145 | 146 | <td> |
| 146 | 147 | Check changes into the repository. Note that a lack of this |
| 147 | 148 | capability does not prevent you from checking changes into your |
| 148 | 149 | local clone, only from syncing those changes up to the parent |
| 149 | 150 | repo, and then <a href="./basics.md#webonly">only over HTTP</a>. |
| 151 | + Also note that not just files, but also tickets, wikis, technotes | |
| 152 | + and forum posts will be accepted from clones upon syncronization. | |
| 150 | 153 | Granting this capability also grants <b>o (Read)</b> Mnemonics: |
| 151 | 154 | <b>i</b>nput, check <b>i</b>n changes. |
| 152 | 155 | </td> |
| 153 | 156 | </tr> |
| 154 | 157 | |
| @@ -202,11 +205,11 @@ | ||
| 202 | 205 | |
| 203 | 206 | <tr id="o"> |
| 204 | 207 | <th>o</th> |
| 205 | 208 | <th>Read</th> |
| 206 | 209 | <td> |
| 207 | - Read repository content from a remote Fossil instance over | |
| 210 | + Read content and history of files from a remote Fossil instance over | |
| 208 | 211 | HTTP. See <a href="index.md#read-v-clone">Reading vs. |
| 209 | 212 | Cloning</a>. Mnemonic: check <b>o</b>ut remote repo contents. |
| 210 | 213 | </td> |
| 211 | 214 | </tr> |
| 212 | 215 | |
| 213 | 216 |
| --- www/caps/ref.html | |
| +++ www/caps/ref.html | |
| @@ -119,12 +119,13 @@ | |
| 119 | <tr id="g"> |
| 120 | <th>g</th> |
| 121 | <th>Clone</th> |
| 122 | <td> |
| 123 | Clone the repository. Note that this is distinct from <a |
| 124 | href="#o">check-out capability, <b>o</b></a>. Mnemonic: |
| 125 | <b>g</b>et. |
| 126 | </td> |
| 127 | </tr> |
| 128 | |
| 129 | <tr id="h"> |
| 130 | <th>h</th> |
| @@ -145,10 +146,12 @@ | |
| 145 | <td> |
| 146 | Check changes into the repository. Note that a lack of this |
| 147 | capability does not prevent you from checking changes into your |
| 148 | local clone, only from syncing those changes up to the parent |
| 149 | repo, and then <a href="./basics.md#webonly">only over HTTP</a>. |
| 150 | Granting this capability also grants <b>o (Read)</b> Mnemonics: |
| 151 | <b>i</b>nput, check <b>i</b>n changes. |
| 152 | </td> |
| 153 | </tr> |
| 154 | |
| @@ -202,11 +205,11 @@ | |
| 202 | |
| 203 | <tr id="o"> |
| 204 | <th>o</th> |
| 205 | <th>Read</th> |
| 206 | <td> |
| 207 | Read repository content from a remote Fossil instance over |
| 208 | HTTP. See <a href="index.md#read-v-clone">Reading vs. |
| 209 | Cloning</a>. Mnemonic: check <b>o</b>ut remote repo contents. |
| 210 | </td> |
| 211 | </tr> |
| 212 | |
| 213 |
| --- www/caps/ref.html | |
| +++ www/caps/ref.html | |
| @@ -119,12 +119,13 @@ | |
| 119 | <tr id="g"> |
| 120 | <th>g</th> |
| 121 | <th>Clone</th> |
| 122 | <td> |
| 123 | Clone the repository. Note that this is distinct from <a |
| 124 | href="#o">check-out capability, <b>o</b></a>; and that upon cloning |
| 125 | not just files, but also tickets, wikis, technotes and forum posts |
| 126 | are tranferred. Mnemonic: <b>g</b>et. |
| 127 | </td> |
| 128 | </tr> |
| 129 | |
| 130 | <tr id="h"> |
| 131 | <th>h</th> |
| @@ -145,10 +146,12 @@ | |
| 146 | <td> |
| 147 | Check changes into the repository. Note that a lack of this |
| 148 | capability does not prevent you from checking changes into your |
| 149 | local clone, only from syncing those changes up to the parent |
| 150 | repo, and then <a href="./basics.md#webonly">only over HTTP</a>. |
| 151 | Also note that not just files, but also tickets, wikis, technotes |
| 152 | and forum posts will be accepted from clones upon syncronization. |
| 153 | Granting this capability also grants <b>o (Read)</b> Mnemonics: |
| 154 | <b>i</b>nput, check <b>i</b>n changes. |
| 155 | </td> |
| 156 | </tr> |
| 157 | |
| @@ -202,11 +205,11 @@ | |
| 205 | |
| 206 | <tr id="o"> |
| 207 | <th>o</th> |
| 208 | <th>Read</th> |
| 209 | <td> |
| 210 | Read content and history of files from a remote Fossil instance over |
| 211 | HTTP. See <a href="index.md#read-v-clone">Reading vs. |
| 212 | Cloning</a>. Mnemonic: check <b>o</b>ut remote repo contents. |
| 213 | </td> |
| 214 | </tr> |
| 215 | |
| 216 |