Open krichter722 opened 5 years ago
In fwupd we use help2man
-- would that be a better option going forward?
Seems to be maintained and certainly easy to install (given the fact that it's standardized GNU software). I just filed a few issues with docbook. Their CI is broken and the build system is outdated. If that's fixed, I'll take a look at improvements which make the docbook build system reliable and standardized. It's a longer shot, but might save you the time to migrate to help2man.
Docbook doesn't seem to be a well maintained software:
Furthermore the relation between all these projects and forks and relaunchs seem unclear and uncoordinated.
colord
checks the return code of the commandxsltproc --nonet http://docbook.sourceforge.net/release/xsl-ns/current/manpages/docbook.xsl
which causes the build to fail if it doesn't return with 0. The file can easily be provided on popular OS by installing a system package (likedocbook-xsl-ns
on Ubuntu 19.04), however building from source is close to impossible due to the chaotic situation sketched above.Maybe there's a change to migrate to a better maintained documentation build tool.