[PATCH] doc: Reduce the validation errors of the docbook input

[Bill Spitzak]

On 12/10/2014 04:53 PM, Bryce Harrington wrote:

> I had to look up what a <simpara> was.  Still not entirely certain what
> the point of it vs. <para>, but if it gets rid of validation errors, +1
> to that.  I suppose it must solve some layout issues.
>
> Sounds like places where we are using <para> for regular text we should
> rather be using <simpara>.

It seems to avoid putting a blank line before and after it, which I 
think make the variable lists look a lot nicer. <para> avoids the 
validation errors too, but put a lot of whitespace in the output.

I found it from the validation error message, which lists all the 
commands allowed at that point.

I don't think it should be used in regular text, use <para> there.