[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bul
From: |
Markus Armbruster |
Subject: |
Re: [PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bulleted lists |
Date: |
Fri, 14 Feb 2020 15:23:30 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) |
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 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.
>
> Use an actual bulleted list, so that the formatting is correct.
>
> This commit gathers up the remaining json files which had
> places needing this fix.
>
> Signed-off-by: Peter Maydell <address@hidden>
Reviewed-by: Markus Armbruster <address@hidden>
What's the rationale for the split between
[PATCH v2 13/30] qapi/block-core.json: Use explicit bulleted lists
[PATCH v2 14/30] qapi/ui.json: Use explicit bulleted lists
[PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bulleted
lists
?
- [PATCH v2 14/30] qapi/ui.json: Use explicit bulleted lists, (continued)
- [PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bulleted lists, Peter Maydell, 2020/02/13
- Re: [PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bulleted lists,
Markus Armbruster <=
- Re: [PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bulleted lists, Peter Maydell, 2020/02/14
- Re: [PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bulleted lists, Markus Armbruster, 2020/02/14
- Re: [PATCH v2 15/30] qapi/{block, misc, tmp, net}.json: Use explicit bulleted lists, Peter Maydell, 2020/02/14
[PATCH v2 19/30] qapi/qapi-schema.json: Put headers in their own doc-comment blocks, Peter Maydell, 2020/02/13
[PATCH v2 17/30] qapi/migration.json: Replace _this_ with *this*, Peter Maydell, 2020/02/13
[PATCH v2 22/30] scripts/qapi: Move doc-comment whitespace stripping to doc.py, Peter Maydell, 2020/02/13
[PATCH v2 20/30] qapi/machine.json: Escape a literal '*' in doc comment, Peter Maydell, 2020/02/13