hughsie / colord

Making color management just work
GNU General Public License v2.0
75 stars 51 forks source link

Remove dependency on docbook #98

Open krichter722 opened 5 years ago

krichter722 commented 5 years ago

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 command xsltproc --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 (like docbook-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.

hughsie commented 5 years ago

In fwupd we use help2man -- would that be a better option going forward?

krichter722 commented 5 years ago

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.