btrfs-progs: build: add support for asciidoctor doc generator
authorDavid Sterba <dsterba@suse.com>
Fri, 2 Feb 2018 19:51:25 +0000 (20:51 +0100)
committerDavid Sterba <dsterba@suse.com>
Fri, 2 Feb 2018 20:02:13 +0000 (21:02 +0100)
commit652544f4c01b8b1a2ab1705cec33af337ffae2ff
tree1cf2285c536c52af817dd444ab34cc347386c429
parent4523dc2776783ecd2fb1e3c72997f23ac2c3b975
btrfs-progs: build: add support for asciidoctor doc generator

We've been using asciidoc that's written in python2, which is going to
be phased out and deprecated next year. There's a replacement,
asciidoctor. Add a configure-time detection which tool is available,
update Documentation/Makefile.in.

The original asciidoc tool is still preferred as it produces slightly
better output. The file asciidoc.conf does not have a direct equivalten
in asciidoct and would need to be replaced by extension written in ruby.

The differences:

- the <literal> are not automatically underlined and are less visible in
  the generated manual page, but it's still acceptable
- the inline CSS for the html output looks subjectively worse, is less
  compact and colourful

Issue: #89
Signed-off-by: David Sterba <dsterba@suse.com>
Documentation/Makefile.in
configure.ac