doc: enable documentation generation on RHEL with asciidoc

[yarda]

With this patch the documentation will be also generated on RHEL with now obsoleted asciidoc tool. The styling is a bit lame, but it's usable.

[zacikpa]

Cool! I think the asciidoc style is timeless :)

What's worse is that it cannot handle syntax such as [option]`skip_grub_config=VALUE`. TBH, I'm not sure what's the purpose of those in the manual anyway. Is that used in Red Hat product docs?

[yarda]

Cool! I think the asciidoc style is timeless :)

What's worse is that it cannot handle syntax such as [option]skip_grub_config=VALUE. TBH, I'm not sure what's the purpose of those in the manual anyway. Is that used in Red Hat product docs?

I don't know :). In the worst case we could drop it. Is it causing any problem now?

[zacikpa]

It displays literally when compiled by asciidoc:

[yarda]

It displays literally when compiled by asciidoc:

I think it's OK. It's the price for cross compatibility. On RHEL the reader could see the meta marks which could help her/him to better understand the text and on Fedora it will be nicely formatted. Also, later in RHEL, when they switch to up-to-date asciidoc tooling, it will be nicely formatted. IMHO in RHEL, there is some tooling improvement planned, but it could take a long time. I think it's better to have the asciidoc in the meantime at least.

[zacikpa]

Agreed.