[Firebird-docs] Example of new documentation

[Mark R. <ma...@la...>]

I have published an PDF and HTML version of the Firebird 2.5 Language 
Reference built from asciidoc. I have used some elements of style from 
the old documentation, but a lot of it is based on the standard asciidoc 
styles.

Could you look at the overall style of things to see if there are things 
you really don't like.

https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25.html
https://www.lawinegevaar.nl/fbdocs/pdf/en/experiment/fblangref25.pdf

To be clear, the asciidoc sources of this document still contain various 
problems that I haven't addressed yet, so rendering of some parts might 
be weird or incorrect.

Examples of things that I know are weird:
- A lot of code blocks are rendered in italic and have a big double 
quote in front due to usage of blockquote
- Some tables are broken (wrong number of columns), the conversion tool 
doesn't handle multiple header rows with multiple spans, this needs to 
be fixed manually, and I only want to do that once on final conversion 
of a document
- Reserved words list is rendered incorrectly

I'm primarily interested in feedback on the overall style, but feel free 
to point out oddities.

Mark
-- 
Mark Rotteveel