Some distributions like Gentoo still haven't packaged Publican, so building the documentation gets tricky. The entry to building documentation should be especially low, as it encourages contributions, and we are lacking a lot of documentation.
Evaluate whether Publican really offers us added benefits, or could we just migrate to a more plain docbook(?) based documentation generator.
Created attachment 105579 [details] [review]
first attempt, turns out that we can just switch to xmlto for the html documentation. tested the pdf one but it failed with a missing cfg file and I haven't looked into that yet.
for the html documentation though it's quite easy, most of this is just making sure the file lists are updated.
it looks a bit different but that shouldn't matter much. And since we now ship the css files ourselves it'd be trivial to change that if anyone is motivated.
Probably worth adding the "stop excessive rebuilds" patch here too. Might conflict though, not sure.
The patch is on the mailing list, and scheduled for 1.7.
Author: Peter Hutterer <firstname.lastname@example.org>
Date: Thu Sep 4 17:32:10 2014 +1000
doc: replace publican with xmlto