[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 03/15] qapi/block-core: Fix BlockLatencyHistogramInfo doc mar
From: |
Daniel P . Berrangé |
Subject: |
Re: [PATCH 03/15] qapi/block-core: Fix BlockLatencyHistogramInfo doc markup |
Date: |
Wed, 7 Feb 2024 08:18:42 +0000 |
User-agent: |
Mutt/2.2.12 (2023-09-09) |
On Mon, Feb 05, 2024 at 08:46:57AM +0100, Markus Armbruster wrote:
> The description of @bins ends with a literal block:
>
> # @bins: list of io request counts corresponding to histogram
> # intervals, one more element than @boundaries has. For the
> # example above, @bins may be something like [3, 1, 5, 2], and
> # corresponding histogram looks like:
> #
> # ::
> #
> # 5| *
>
> Except it actually ends *before* the block: the unindented '::' line
> starts a new section. Makes no sense.
>
> We could fix this by indenting the '::' line. Instead, double the
> colon at the end of the preceding paragraph, and drop the '::' line.
>
> This shifts the box for the literal block right in generated
> documentation, so it lines up with the description.
>
> Fixes: commit a0fcff383b34 (qapi: Use rST markup for literal blocks)
> Signed-off-by: Markus Armbruster <armbru@redhat.com>
> ---
> qapi/block-core.json | 4 +---
> 1 file changed, 1 insertion(+), 3 deletions(-)
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
With regards,
Daniel
--
|: https://berrange.com -o- https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org -o- https://fstop138.berrange.com :|
|: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
- [PATCH 00/15] qapi: Require member documentation (with loophole), Markus Armbruster, 2024/02/05
- [PATCH 08/15] qga/qapi-schema: Clean up documentation of guest-set-vcpus, Markus Armbruster, 2024/02/05
- [PATCH 03/15] qapi/block-core: Fix BlockLatencyHistogramInfo doc markup, Markus Armbruster, 2024/02/05
- Re: [PATCH 03/15] qapi/block-core: Fix BlockLatencyHistogramInfo doc markup,
Daniel P . Berrangé <=
- [PATCH 02/15] docs/devel/qapi-code-gen: Tweak doc comment whitespace, Markus Armbruster, 2024/02/05
- [PATCH 04/15] qapi: Indent tagged doc comment sections properly, Markus Armbruster, 2024/02/05
- [PATCH 15/15] qapi: Add missing union tag documentation, Markus Armbruster, 2024/02/05
- [PATCH 11/15] qapi/dump: Clean up documentation of DumpGuestMemoryCapability, Markus Armbruster, 2024/02/05
- [PATCH 06/15] qapi: Require member documentation (with loophole), Markus Armbruster, 2024/02/05