qemu/scripts/qapi
Markus Armbruster 3d035cd2cc qapi: Rewrite doc comment parser
QAPISchemaParser is a conventional recursive descent parser.  Except
QAPISchemaParser.get_doc() delegates most of the doc comment parsing
work to a state machine in QAPIDoc.  The state machine doesn't get
tokens like a recursive descent parser, it is fed tokens.

I find this state machine rather opaque and hard to maintain.

Replace it by a conventional parser, all in QAPISchemaParser.  Less
code, and (at least in my opinion) easier to understand.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240216145841.2099240-15-armbru@redhat.com>
Tested-by: Daniel P. Berrangé <berrange@redhat.com>
2024-02-26 10:43:56 +01:00
..
.flake8
.isort.cfg
__init__.py
commands.py qapi: Require boxed for conditional command and event arguments 2023-04-24 15:21:39 +02:00
common.py
error.py
events.py
expr.py
gen.py qapi: re-establish linting baseline 2023-10-19 07:02:29 +02:00
introspect.py qapi: Add feature flags to enum members 2021-10-27 17:18:55 +02:00
main.py
mypy.ini Python: Drop support for Python 3.7 2023-09-07 13:32:37 +02:00
parser.py qapi: Rewrite doc comment parser 2024-02-26 10:43:56 +01:00
pylintrc
schema.py qapi: Call QAPIDoc.check() always 2024-02-26 10:43:56 +01:00
source.py qapi: Require member documentation (with loophole) 2024-02-12 10:04:31 +01:00
types.py
visit.py