Some of you may be familiar with the scdoc format for writing man pages; the standard implementation for this is available at <https://git.sr.ht/~sircmpwn/scdoc>.
The newly released program "mancia" performs the same function as scdoc but, in addition to the roff format, offers the option to generate rst files.
Alongside the command-line utility, mancia also provides Python integration (via NimPy) and a Sphinx extension (I needed the rst format for that).
Although the implementation has been around for a while, I have now created an initial release: <https://github.com/heuer/mancia/releases/tag/0.1.0>
Since we eat our own dogfood, the project's homepage at <https://mancia.readthedocs.io/en/latest/> is utilizing the Sphinx extension and the man pages in the dist archives are generated by mancia.
The Python bindings (and the Sphinx extension) are available via pip
pip install manciaThe code sat unchanged for months; no sooner had I published it than I discovered a bug 🙄
Mancia accepted spaces instead of tabs in some cases, whereas scdoc rejected them as errors.
It wasn't a major issue, but since the goal is 100% conformance with scdoc, it was fixed.
Mancia can now also be installed via nimble, thanks to the Nim packages project!