Peter Maydell <peter.mayd...@linaro.org> 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 <peter.mayd...@linaro.org> Reviewed-by: Markus Armbruster <arm...@redhat.com>