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
Timelines: family | ancestors | descendants | both | caps-doc
Files: files | file ages | folders
SHA3-256: 208ca0d713d93212e33d29805e55ad3e8555f05b53f42301c3d9bc558a9d0fa9
User & Date: wyoung 2019-08-27 01:55:32.989
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
Unified Diff 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
    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.







|
|
>
>
>
|
>
>
>
|
>
|
|
|
>
|







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
    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.
514
515
516
517
518
519
520

521
522
523
524
525
526
527

*   <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







>







522
523
524
525
526
527
528
529
530
531
532
533
534
535
536

*   <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