[PATCH 1/2] docs/devel/qapi-code-gen: Drop a duplicate paragraph

Markus Armbruster posted 2 patches 4 years, 3 months ago
Maintainers: Michael Roth <michael.roth@amd.com>, Markus Armbruster <armbru@redhat.com>
There is a newer version of this series
[PATCH 1/2] docs/devel/qapi-code-gen: Drop a duplicate paragraph
Posted by Markus Armbruster 4 years, 3 months ago
Commit 55ec69f8b1 "docs/devel/qapi-code-gen.txt: Update to new rST
backend conventions" accidentally duplicated a paragraph.  Drop it.

Cc: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
---
 docs/devel/qapi-code-gen.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/devel/qapi-code-gen.rst b/docs/devel/qapi-code-gen.rst
index b2569de486..1f6805a705 100644
--- a/docs/devel/qapi-code-gen.rst
+++ b/docs/devel/qapi-code-gen.rst
@@ -993,12 +993,6 @@ multiline argument descriptions.
 A 'Since: x.y.z' tagged section lists the release that introduced the
 definition.
 
-The text of a section can start on a new line, in
-which case it must not be indented at all.  It can also start
-on the same line as the 'Note:', 'Returns:', etc tag.  In this
-case if it spans multiple lines then second and subsequent
-lines must be indented to match the first.
-
 An 'Example' or 'Examples' section is automatically rendered
 entirely as literal fixed-width text.  In other sections,
 the text is formatted, and rST markup can be used.
-- 
2.31.1


Re: [PATCH 1/2] docs/devel/qapi-code-gen: Drop a duplicate paragraph
Posted by John Snow 4 years, 3 months ago
On Tue, Oct 26, 2021 at 7:10 AM Markus Armbruster <armbru@redhat.com> wrote:

> Commit 55ec69f8b1 "docs/devel/qapi-code-gen.txt: Update to new rST
> backend conventions" accidentally duplicated a paragraph.  Drop it.
>
>
Fixes: 55ec69f8b1
.... well, on second thought, that backport would have to go backwards
through a ReST conversion, so ... maybe not. Nevermind.


> Cc: Peter Maydell <peter.maydell@linaro.org>
> Signed-off-by: Markus Armbruster <armbru@redhat.com>
>

Reviewed-by: John Snow <jsnow@redhat.com>


> ---
>  docs/devel/qapi-code-gen.rst | 6 ------
>  1 file changed, 6 deletions(-)
>
> diff --git a/docs/devel/qapi-code-gen.rst b/docs/devel/qapi-code-gen.rst
> index b2569de486..1f6805a705 100644
> --- a/docs/devel/qapi-code-gen.rst
> +++ b/docs/devel/qapi-code-gen.rst
> @@ -993,12 +993,6 @@ multiline argument descriptions.
>  A 'Since: x.y.z' tagged section lists the release that introduced the
>  definition.
>
> -The text of a section can start on a new line, in
> -which case it must not be indented at all.  It can also start
> -on the same line as the 'Note:', 'Returns:', etc tag.  In this
> -case if it spans multiple lines then second and subsequent
> -lines must be indented to match the first.
> -
>  An 'Example' or 'Examples' section is automatically rendered
>  entirely as literal fixed-width text.  In other sections,
>  the text is formatted, and rST markup can be used.
> --
> 2.31.1
>
>
Re: [PATCH 1/2] docs/devel/qapi-code-gen: Drop a duplicate paragraph
Posted by Philippe Mathieu-Daudé 4 years, 3 months ago
On 10/26/21 13:10, Markus Armbruster wrote:
> Commit 55ec69f8b1 "docs/devel/qapi-code-gen.txt: Update to new rST
> backend conventions" accidentally duplicated a paragraph.  Drop it.
> 
> Cc: Peter Maydell <peter.maydell@linaro.org>
> Signed-off-by: Markus Armbruster <armbru@redhat.com>
> ---
>  docs/devel/qapi-code-gen.rst | 6 ------
>  1 file changed, 6 deletions(-)

Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>