Re: [PATCH v6 05/21] scripts/qapi/parser.py: improve doc comment indent handling

2020-09-29 Thread Markus Armbruster
Peter Maydell writes: > On Mon, 28 Sep 2020 at 20:16, Markus Armbruster wrote: >> >> Peter Maydell writes: >> > +Descriptions of arguments can span multiple lines. The description >> > +text can start on the line following the '@argname:', in which case >> > +it must not be indented at all. It

Re: [PATCH v6 05/21] scripts/qapi/parser.py: improve doc comment indent handling

2020-09-29 Thread Peter Maydell
On Mon, 28 Sep 2020 at 20:16, Markus Armbruster wrote: > > Peter Maydell writes: > > +Descriptions of arguments can span multiple lines. The description > > +text can start on the line following the '@argname:', in which case > > +it must not be indented at all. It can also start on the same

Re: [PATCH v6 05/21] scripts/qapi/parser.py: improve doc comment indent handling

2020-09-28 Thread Markus Armbruster
Peter Maydell writes: > Make the handling of indentation in doc comments more sophisticated, > so that when we see a section like: > > Notes: some text >some more text > indented line 3 > > we save it for the doc-comment processing code as: > > some text > some more text >

[PATCH v6 05/21] scripts/qapi/parser.py: improve doc comment indent handling

2020-09-25 Thread Peter Maydell
Make the handling of indentation in doc comments more sophisticated, so that when we see a section like: Notes: some text some more text indented line 3 we save it for the doc-comment processing code as: some text some more text indented line 3 and when we see a section