Re: Autogenerate some wait events code and documentation

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: "Drouvot, Bertrand" <bertranddrouvot(dot)pg(at)gmail(dot)com>
Cc: Andres Freund <andres(at)anarazel(dot)de>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>, Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
Subject: Re: Autogenerate some wait events code and documentation
Date: 2023-07-13 01:26:54
Message-ID: ZK9S3jFEV1X797Ll@paquier.xyz
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Mon, Jul 10, 2023 at 07:52:23AM +0200, Drouvot, Bertrand wrote:
> On 7/10/23 7:20 AM, Michael Paquier wrote:
>> Hmm. Something like that could be done, for instance:
>>
>> # src/backend/utils/activity/wait_event_types.h
>> -# typedef enum definitions for wait events.
>> +# typedef enum definitions for wait events, generated from the first
>> +# field.
>
> Yeah, it looks a good place for it.

I am not sure where we are on that based on the objection from Alvaro
to not remove the first column in wait_event_names.txt about
greppability. Anyway, I am not seeing any objections behind my
suggestion to simplify the second column and remove the quotes from
the event names, either. Besides, the suggestion of Andres to improve
the error message on parsing and show the line information is
something useful in itself.

Hence, attached is a rebased patch set that separates the work into
more patches:
- 0001 removes the quotes from the second column, improving the
readability of the .txt file.
- 0002 fixes the report from Andres to improve the error message on
parsing.
- 0003 is the rename of the wait events, in preparation for...
- 0004 that removes entirely the first column (enum element names)
from wait_event_names.txt.

I would like to apply 0001 and 0002 to improve the format if there are
no objections. 0003 and 0004 are still here for discussion, as it
does not seem like a consensus has been reached for that yet. Getting
more opinions would be a good next step for the last two patches, I
assume.

So, any comments?
--
Michael

Attachment Content-Type Size
v2-0001-Remove-quotes-from-second-column-of-wait_event_na.patch text/x-diff 57.3 KB
v2-0002-Add-information-about-line-contents-on-parsing-fa.patch text/x-diff 1.1 KB
v2-0003-Rename-wait-events-with-more-consistent-camelcase.patch text/x-diff 18.8 KB
v2-0004-Remove-column-for-enum-elements-in-wait_event_nam.patch text/x-diff 52.3 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Masahiko Sawada 2023-07-13 01:27:41 Re: doc: improve the restriction description of using indexes on REPLICA IDENTITY FULL table.
Previous Message Masahiro Ikeda 2023-07-13 01:26:35 Re: Support to define custom wait events for extensions