3 ms·
adoc is fine and is more widely supported. Linux (the kernel) documentation is written in adoc, along with man pages for many projects like git: https://github
by homebrewer 2y ago
adoc is fine and is more widely supported. Linux (the kernel) documentation is written in adoc, along with man pages for many projects like git:
https://github.com/git/git/blob/master/Documentation/git-rm.adoc?plain=1 https://github.com/git/git/blob/master/Documentation/git-rm....
- packetlost 2y agoI wasn't aware AsciiDoc could be used to generate man docs. I'm not a huge fan of AsciiDoc's syntax, but I can see that being preferable to other options.
- WhyNotHugo 2y agoAsciidoc doesn't support links in man pages. It can only link to URLs. If you check the repo which you linked, you'll see they use some perl code to actually inject links.