[PATCH] doc: Reduce the validation errors of the docbook input
spitzak at gmail.com
Wed Dec 10 17:34:22 PST 2014
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.
More information about the wayland-devel