Re: [PATCH 14/29] qapi/block-core.json: Use explicit bulleted lists

[Markus Armbruster]

Peter Maydell <address@hidden> writes:

> A JSON block comment like this:
>  Returns: nothing on success
>           If @node is not a valid block device, DeviceNotFound
>           If @name is not found, GenericError with an explanation
>
> renders in the HTML and manpage like this:
>
>  Returns: nothing on success If node is not a valid block device,
>  DeviceNotFound If name is not found, GenericError with an explanation
>
> because whitespace is not significant.

Pretty much the same in plain text and PDF.  Unsurprising, as all are
generated from the same, flawed TexInfo.  Suggest "renders like this".

>
> Use an actual bulleted list, so that the formatting is correct.
>
> Signed-off-by: Peter Maydell <address@hidden>

Reviewed-by: Markus Armbruster <address@hidden>