I just came down from the mountains, after a couple of days hacking on a tool-chain i’m proposing for including in OpenDaylight OVSDB for the Hydrogen release.
This toolchain takes AsciiDocs as a source, generates DocBooks XML (which is the OpenStack docs standard) and then generates HTML, PDF, Slidey from there. It is all run by Maven, which while powerful can have hidden and obtuse errors burred in the plugins it calls.
After all of this headache, I have christened Maven the holy hand grenade of open source. The Mavenized script from Monty Python is below -
[Holding the Holy POM.XML of Antioch]
King Arthur: How does it… um… how does it work?
Sir Lancelot: I know not, my liege.
King Arthur: Consult the Book of Armaments.
Brother Maynard: Armaments, chapter two, verses nine through twenty-one.
Cleric: [reading] And Saint Attila raised the POM.XML up on high, saying, “O Lord, bless this thy POM.XML, that with it thou mayst blow thine enemies to tiny bits, in thy mercy.” And the Lord did grin. And the people did feast upon the lambs and sloths, and carp and anchovies, and orangutans and breakfast cereals, and fruit-bats and large chu…
Brother Maynard: Skip a bit, Brother…
Cleric: And the Lord spake, saying, “First shalt thou take out the Holy Maven. Then shalt thou count to three, no more, no less. Three shall be the number thou shalt count, and the number of the counting shall be three. Four shalt thou not count, neither count thou two, excepting that thou then proceed to three. Five is right out. Once the number three, being the third number, be reached, then lobbest thou thy Holy POM.XML of Antioch towards thy foe, who, being naughty in my sight, shall snuff it.
Brother Maynard: Amen.
King Arthur: Right. One… two… five.
Galahad: Three, sir.
King Arthur: Three.