Skip to content

Draft: Modernize docs toolchain

Jan Tojnar requested to merge jtojnar/fontconfig:docbook-unity into main

I wanted to switch fontconfig NixOS package over to Meson build system but we do not have docbook-utils so I could not build the docs. I could package them but they are dead (not even a working website) and appear to only support deprecated SGML syntax (DocBook 5 is XML only) so I did not bother. Instead I tried to use xsltproc, which is at least maintained (the XSLT 2.0 version of docbook-xsl stylesheets is pretty dead too but at least it has a working git repo).

The produced directory trees and, manpages and PDF outputs look mostly comparable to the previous ones.

Caveats:

  • No TXT output (maybe there is some stylesheet for that but I did not look too hard, at worst, we could use pandoc)
  • The pdf output depends on fop, which uses openjdk, which depends on fontconfig so bootstrapping might be annoying.
  • Did not touch autotools yet.
  • fonts.conf(5) is now the canonical manpage, not fonts-conf(5), keep the latter as alias.
  • HTML docs filenames are now case sensitive.

Not sure if this is a direction we want to go. Maybe porting to some more maintained alternative would be better but no docs toolchains are as well maintained as they would deserve and often bring huge number of extra dependencies.

Merge request reports