Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove dependency on docbook #98

Open
krichter722 opened this issue Sep 8, 2019 · 2 comments
Open

Remove dependency on docbook #98

krichter722 opened this issue Sep 8, 2019 · 2 comments

Comments

@krichter722
Copy link

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
Copy link
Owner

hughsie commented Sep 8, 2019

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

@krichter722
Copy link
Author

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants