Fossil

Check-in [208ca0d7]
Login

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

Overview
Comment:Rewrote explanation of "o" cap.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | caps-doc
Files: files | file ages | folders
SHA3-256: 208ca0d713d93212e33d29805e55ad3e8555f05b53f42301c3d9bc558a9d0fa9
User & Date: wyoung 2019-08-27 01:55:32
Context
2019-08-27
03:56
Grepped the Fossil source code for C code that checks for Setup caps exclusively to preotect functions and listed those in the Reference section of capablities.md. Also expanded the coverage of the "caps affect Fossil web interfaces only" section, which plays into this. check-in: 689f7683 user: wyoung tags: caps-doc
01:55
Rewrote explanation of "o" cap. check-in: 208ca0d7 user: wyoung tags: caps-doc
01:40
Disentangled discussion of "developer" vs "reader" in capabilities.md. check-in: 869494eb user: wyoung tags: caps-doc
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to www/capabilities.md.

411
412
413
414
415
416
417
418
419
420
421







422
423

424

425
426
427
428
429
430
431
432
...
514
515
516
517
518
519
520

521
522
523
524
525
526
527
    Mnemonic: a**l**low.

*   <a name="m"></a>**m (ApndWiki)** — Append content to existing wiki articles.
    Mmnemonics: a**m**end or **m**odify.

*   <a name="n"></a>**n (NewTkt)** — File new tickets. Mnemonic: **n**ew ticket.

*   <a name="o"></a>**o (Read)** — Check data out from Fossil. This capability
    has nothing to do with the ability to “open” a local repo clone or
    switch branches in that clone. It only controls whether similar
    operations over HTTP to a remote repo are allowed. You must have







    this capability to view [embedded documentation][edoc], for example,
    since that basically amounts to opening a file in the remote repo.

    This capability also controls the [`/artifact`][au], [`/file`][fu],

    and [`/raw`][ru] URLs.  Mnemonic: check **o**ut file.

*   <a name="p"></a>**p (Password)** — Change one’s own password.  Mnemonic:
    **p**assword.

*   <a name="q"></a>**q (ModTkt)** — Moderate tickets: comments appended to
    tickets can be deleted by users with this capability. Mnemonic:
    **q**uash noise commentary.
................................................................................

*   <a name="D"></a>**D (Debug)** — Enable debugging features. Mnemonic:
    **d**ebug.


[ale]:  ./alerts.md
[au]:   /help?cmd=/artifact

[edoc]: ./embeddeddoc.wiki
[fmod]: ./forum.wiki#moderation
[for]:  ./forum.wiki
[fu]:   /help?cmd=/file
[gdpr]: https://en.wikipedia.org/wiki/General_Data_Protection_Regulation
[lgrd]: https://en.wikipedia.org/wiki/La_Géométrie#The_text
[load]: ./loadmgmt.md







|
|
|
|
>
>
>
>
>
>
>
|
<
>
|
>
|







 







>







411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429

430
431
432
433
434
435
436
437
438
439
440
...
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
    Mnemonic: a**l**low.

*   <a name="m"></a>**m (ApndWiki)** — Append content to existing wiki articles.
    Mmnemonics: a**m**end or **m**odify.

*   <a name="n"></a>**n (NewTkt)** — File new tickets. Mnemonic: **n**ew ticket.

*   <a name="o"></a>**o (Read)** — Read repository content from a remote
    Fossil instance over HTTP. This capability has nothing to do with
    reading data from a local repository, because [caps affect Fossil’s
    web interfaces only](#fssync). Once you’ve cloned a remote
    repository to your local machine, you can do any reading you want on
    that repository irrespective of whether your user has **o**
    capability; the repo clone is completely under your user’s power at
    that point, affectted only by OS file permissions and such. (To
    prevent cloning, see [**g**](#g).)

    It is common to withhold this capability from low-status visitors to
    prevent them from viewing [embedded documentation][edoc], seeing

    [the file browser][du], and pulling file content via the
    [`/artifact`][au], [`/file`][fu], and [`/raw`][ru] URLs.

    Mnemonic: check **o**ut remote repo contents.

*   <a name="p"></a>**p (Password)** — Change one’s own password.  Mnemonic:
    **p**assword.

*   <a name="q"></a>**q (ModTkt)** — Moderate tickets: comments appended to
    tickets can be deleted by users with this capability. Mnemonic:
    **q**uash noise commentary.
................................................................................

*   <a name="D"></a>**D (Debug)** — Enable debugging features. Mnemonic:
    **d**ebug.


[ale]:  ./alerts.md
[au]:   /help?cmd=/artifact
[du]:   /help?cmd=/dir
[edoc]: ./embeddeddoc.wiki
[fmod]: ./forum.wiki#moderation
[for]:  ./forum.wiki
[fu]:   /help?cmd=/file
[gdpr]: https://en.wikipedia.org/wiki/General_Data_Protection_Regulation
[lgrd]: https://en.wikipedia.org/wiki/La_Géométrie#The_text
[load]: ./loadmgmt.md