cgitrc.5: document new signature notes

Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
This commit is contained in:
Jason A. Donenfeld 2018-07-03 20:44:08 +02:00
parent 7ba41963dd
commit c4167cbd65

View File

@ -759,7 +759,7 @@ the environment variables defined in "FILTER API":
CACHE CACHE
------ -----
All cache ttl values are in minutes. Negative ttl values indicate that a page All cache ttl values are in minutes. Negative ttl values indicate that a page
type will never expire, and thus the first time a URL is accessed, the result type will never expire, and thus the first time a URL is accessed, the result
@ -767,6 +767,22 @@ will be cached indefinitely, even if the underlying git repository changes.
Conversely, when a ttl value is zero, the cache is disabled for that Conversely, when a ttl value is zero, the cache is disabled for that
particular page type, and the page type is never cached. particular page type, and the page type is never cached.
SIGNATURES
----------
Cgit can host .asc signatures corresponding to various snapshot formats,
through use of git notes. For example, the following command may be used to
add a signature to a .tar.xz archive:
git notes --ref=refs/notes/signatures/tar.xz add -C "$(
gpg --output - --armor --detach-sign cgit-1.1.tar.xz |
git hash-object -w --stdin
)" v1.1
If it is instead desirable to attach a signature of the underlying .tar, this
will be linked, as a special case, beside a .tar.* link that does not have its
own signature.
EXAMPLE CGITRC FILE EXAMPLE CGITRC FILE
------------------- -------------------