How do I render a manual page from CGit's about page?

Gianni Ceccarelli dakkar at thenautilus.net
Thu Aug 27 16:10:18 UTC 2026


On Fri, 28 Aug 2026 00:58:04 +0900
Hee-Suk Kim <hskim at dilluti0n.com> wrote:

> Since there's nothing but the original man/pass.1 troff file in the
> tree
> - no .md or .html files at all - it looks like cgit is doing the troff
> rendering. I'm curious how I can set that up!

Guessing:

in the repository's own configuration, ``readme`` is set to
``:man/pass.1`` ("that file, from whatever commit/branch we're
currently rendering") see
https://git.zx2c4.com/cgit/tree/cgitrc.5.txt#n588

and ``about-filter`` is set to the path of a script that can render
manpages to HTML, see
https://git.zx2c4.com/cgit/tree/cgitrc.5.txt#n462

-- 
	Dakkar - <Mobilis in mobile>
	GPG public key fingerprint = A071 E618 DD2C 5901 9574
	                             6FE2 40EA 9883 7519 3F88
	                    key id = 0x75193F88



More information about the CGit mailing list