All of lore.kernel.org
 help / color / mirror / Atom feed
From: Markus Armbruster <armbru@redhat.com>
To: John Snow <jsnow@redhat.com>
Cc: qemu-devel@nongnu.org,  Peter Maydell <peter.maydell@linaro.org>,
	Michael Roth <michael.roth@amd.com>
Subject: Re: [PATCH 17/23] docs/qapidoc: record current documented entity in transmogrifier
Date: Thu, 09 Jan 2025 11:35:53 +0100	[thread overview]
Message-ID: <87o70gs29i.fsf@pond.sub.org> (raw)
In-Reply-To: <CAFn=p-Y4AwYfgCVAWJ-tTCjnr0dwJ6EOnF4aNYXdd5VPTr__DQ@mail.gmail.com> (John Snow's message of "Wed, 8 Jan 2025 16:11:24 -0500")

John Snow <jsnow@redhat.com> writes:

> On Fri, Dec 20, 2024 at 9:23 AM Markus Armbruster <armbru@redhat.com> wrote:
>
>> John Snow <jsnow@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.

I'm glad I haven't caused you worry!  Perhaps I should try this
solipsism thing myself some day.

[...]



  reply	other threads:[~2025-01-09 10:36 UTC|newest]

Thread overview: 59+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-12-13  2:18 [PATCH 00/23] docs: add basic sphinx-domain rST generator to qapidoc John Snow
2024-12-13  2:18 ` [PATCH 01/23] docs/qapidoc: support header-less freeform sections John Snow
2024-12-16 13:15   ` Markus Armbruster
2025-01-13 19:12     ` John Snow
2025-01-14  9:19       ` Markus Armbruster
2024-12-13  2:18 ` [PATCH 02/23] qapi/parser: adjust info location for doc body section John Snow
2024-12-13  2:18 ` [PATCH 03/23] docs/qapidoc: remove example section support John Snow
2024-12-18 12:27   ` Markus Armbruster
2024-12-18 15:15     ` John Snow
2025-01-09  7:50       ` Markus Armbruster
2024-12-13  2:18 ` [PATCH 04/23] qapi: expand tags to all doc sections John Snow
2024-12-18 10:58   ` Markus Armbruster
2024-12-18 15:14     ` John Snow
2025-01-09  7:51       ` Markus Armbruster
2024-12-20 13:13   ` Markus Armbruster
2025-01-09 18:49     ` John Snow
2025-01-10  7:33       ` Markus Armbruster
2024-12-13  2:18 ` [PATCH 05/23] qapi/schema: add __repr__ to QAPIDoc.Section John Snow
2024-12-13  2:18 ` [PATCH 06/23] docs/qapidoc: add transmogrifier stub John Snow
2024-12-13  2:18 ` [PATCH 07/23] docs/qapidoc: add transmogrifier class stub John Snow
2024-12-13  2:18 ` [PATCH 08/23] docs/qapidoc: add visit_module() method John Snow
2024-12-13  2:18 ` [PATCH 09/23] qapi/source: allow multi-line QAPISourceInfo advancing John Snow
2024-12-20 13:22   ` Markus Armbruster
2025-01-08 21:18     ` John Snow
2025-01-09  8:00       ` Markus Armbruster
2025-01-09 17:19         ` John Snow
2025-01-10  7:37           ` Markus Armbruster
2024-12-13  2:18 ` [PATCH 10/23] docs/qapidoc: add visit_freeform() method John Snow
2024-12-20 13:25   ` Markus Armbruster
2025-01-13 20:14     ` John Snow
2024-12-13  2:18 ` [PATCH 11/23] docs/qapidoc: add preamble() method John Snow
2024-12-20 14:15   ` Markus Armbruster
2025-01-08 22:58     ` John Snow
2025-01-09 10:34       ` Markus Armbruster
2025-01-09 18:04         ` John Snow
2025-01-10 12:19           ` Markus Armbruster
2025-01-13 20:53             ` John Snow
2025-01-14  9:30               ` Markus Armbruster
2024-12-13  2:18 ` [PATCH 12/23] docs/qapidoc: add visit_paragraph() method John Snow
2024-12-13  2:18 ` [PATCH 13/23] docs/qapidoc: add visit_errors() method John Snow
2024-12-13  2:18 ` [PATCH 14/23] docs/qapidoc: add format_type() method John Snow
2024-12-13  2:18 ` [PATCH 15/23] docs/qapidoc: add add_field() and generate_field() helper methods John Snow
2024-12-13  2:18 ` [PATCH 16/23] docs/qapidoc: add visit_feature() method John Snow
2024-12-20 14:21   ` Markus Armbruster
2025-01-08 22:46     ` John Snow
2024-12-13  2:18 ` [PATCH 17/23] docs/qapidoc: record current documented entity in transmogrifier John Snow
2024-12-20 14:23   ` Markus Armbruster
2025-01-08 21:11     ` John Snow
2025-01-09 10:35       ` Markus Armbruster [this message]
2024-12-13  2:18 ` [PATCH 18/23] docs/qapidoc: add visit_returns() method John Snow
2024-12-13  2:18 ` [PATCH 19/23] docs/qapidoc: add visit_member() method John Snow
2024-12-13  2:18 ` [PATCH 20/23] docs/qapidoc: add visit_sections() method John Snow
2024-12-13  2:18 ` [PATCH 21/23] docs/qapidoc: add visit_entity() John Snow
2024-12-13  2:18 ` [PATCH 22/23] docs/qapidoc: implement transmogrify() method John Snow
2024-12-13  2:18 ` [PATCH 23/23] docs/qapidoc: add transmogrifier test document John Snow
2024-12-19 12:31 ` [PATCH 00/23] docs: add basic sphinx-domain rST generator to qapidoc Markus Armbruster
2025-01-08 21:08   ` John Snow
2025-01-09 11:48     ` Markus Armbruster
2025-01-09 17:26       ` John Snow

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87o70gs29i.fsf@pond.sub.org \
    --to=armbru@redhat.com \
    --cc=jsnow@redhat.com \
    --cc=michael.roth@amd.com \
    --cc=peter.maydell@linaro.org \
    --cc=qemu-devel@nongnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.