Alex Vong <alexvong1...@gmail.com> writes: >> PS. regarding the man page, I believe Debian mostly generated this >> page from the capnp tool's help text. I'd accept a patch to >> c++/src/kj/main.c++ which adds some code to generate man XML format >> directly, so that we don't have to maintain the same text in multiple >> places. > > I want to ask what is meant by man XML format? Do you mean to generate > man page? As far as I know, there are at least 2 ways to generate a man > page. One way is to use help2man, which is probably the Debian's > approach. Another way is to write the man page in pod (perl's plain old > documentation) and use pod2man to translate it into a man page. Would > you accept any of these approaches?
I think Kenton is referring to the Debian manual, which is in XML format: https://github.com/thomaslee/capnproto-debian/blob/master/debian/capnp.1.xml But you are right, it would be better to convert it to a standard format and simply add a make target for it. Cheers, Marius
