diff options
| author |   Markus Armbruster <armbru@redhat.com> | 2024-02-16 15:58:38 +0100 |
|---|---|---|
| committer | Markus Armbruster <armbru@redhat.com> | 2024-02-26 10:43:56 +0100 |
| commit | 3d035cd2cca66488f6f478a93b231c302466116b (patch) | |
| tree | efc6a66a887adae344e23ccd0b9c42fde6c2224b /docs/conf.py | |
| parent | qapi: Merge adjacent untagged sections (diff) | |
| download | qemu-3d035cd2cca66488f6f478a93b231c302466116b.tar.xz qemu-3d035cd2cca66488f6f478a93b231c302466116b.zip | |
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>
Diffstat (limited to 'docs/conf.py')
0 files changed, 0 insertions, 0 deletions