On Fri, Dec 20, 2024 at 9:23 AM Markus Armbruster <arm...@redhat.com> wrote:
> John Snow <js...@redhat.com> writes: > > > Keep a record of which entity we're working on documenting for the > > purposes of being able to change certain generative features > > conditionally and create stronger assertions. > > > > If you find yourself asking: "Wait, but where does the current entity > > actually get recorded?!", you're right! That part comes with the > > visit_entity() implementation, which gets added later. > > That's fine, except your title promises "record current documented > entity". Perhaps "Prepare to record entity being transmogrified". > Sometimes, I think I exist in a time and space that doesn't actually exist; a hallucination of multiple timelines that might exist only in my own consciousness. I'd be worried if I wasn't an ardent solipsist. --js > > > Signed-off-by: John Snow <js...@redhat.com> > > --- > > docs/sphinx/qapidoc.py | 6 ++++++ > > 1 file changed, 6 insertions(+) > > > > diff --git a/docs/sphinx/qapidoc.py b/docs/sphinx/qapidoc.py > > index 02f434c09ab..c731c597daf 100644 > > --- a/docs/sphinx/qapidoc.py > > +++ b/docs/sphinx/qapidoc.py > > @@ -74,9 +74,15 @@ def dedent(text: str) -> str: > > > > class Transmogrifier: > > def __init__(self, schema): > > + self._curr_ent = None > > self._result = StringList() > > self.indent = 0 > > > > + @property > > + def entity(self) -> QAPISchemaEntity: > > + assert self._curr_ent is not None > > + return self._curr_ent > > + > > # General-purpose rST generation functions > > > > def get_indent(self) -> str: > >
