asciidoc > 8.6.0 is a build requirement

Jason Azze jason at
Sat Jul 2 22:48:28 UTC 2016

I've researched the documentation build failure on CentOS 6. It looks
like the version of asciidoc (and a2x) is the culprit.

CentOS 6.8 has asciidoc version 8.4.5, which includes a2x version 1.0.0.

The build on stock CentOS 6.8 fails with:

asciidoc: FAILED: line 6: section title expected

CentOS 7.2 has asciidoc 8.6.8 (and a2x 8.6.8), and the build works fine.

I started to try every released asciidoc version between 8.4.5 and
8.6.8 from until I found
the version where the error disappeared. 8.6.0 is the winner.

Here's the command I ran for my analysis. (Note that I shortened the
paths to asciidoc.conf and below because they
only make sense on my test machine.)

/opt/asciidoc-alts/asciidoc-8.6.0/ --format manpage
--asciidoc-opts=--conf-file=asciidoc.conf --no-xmllint

I also discovered that version 8.5.2 of asciidoc works when I use this command:

/opt/asciidoc-alts/asciidoc-8.5.2/ --doctype=manpage
--conf-file=asciidoc.conf -d manpage -b docbook

More information about the devel mailing list