From: Tom Lane <tgl@sss.pgh.pa.us>
To: Michael Paquier <michael@paquier.xyz>
cc: Tatsuo Ishii <ishii@sraoss.co.jp>, pavel.stehule@gmail.com,
        aleksander@timescale.com, pgsql-hackers@lists.postgresql.org
Subject: Re: Wrong usage of pqMsg_Close message code?
In-reply-to: <ZO2gx/W5bs/HpcBt@paquier.xyz>
References: <CAFj8pRBKa2ey+Nm_drj_5Fk-3_zBP7uezP2OrQT1pHeBO7m=6A@mail.gmail.com> <20230829.061200.192005411012654565.t-ishii@sranhm.sra.co.jp> <ZO0lcXlwln/Ir09S@paquier.xyz> <20230829.100424.623781851282219189.t-ishii@sranhm.sra.co.jp> <ZO2gx/W5bs/HpcBt@paquier.xyz>
Comments: In-reply-to Michael Paquier <michael@paquier.xyz>
	message dated "Tue, 29 Aug 2023 16:39:51 +0900"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1004808.1693317707.1@sss.pgh.pa.us>
Date: Tue, 29 Aug 2023 10:01:47 -0400
Message-ID: <1004809.1693317707@sss.pgh.pa.us>
Archived-At: <https://www.postgresql.org/message-id/1004809.1693317707%40sss.pgh.pa.us>
Precedence: bulk

Michael Paquier <michael@paquier.xyz> writes:
> Actually, this may be OK as well as it stands.  One can also say that
> the parallel processing is out of this scope, being used only
> internally.  I cannot keep wondering whether we should put more
> efforts in documenting the parallel worker/leader protocol.  That's
> internal to the backend and out of the scope of this thread, still..

Yeah.  I'm not sure whether the leader/worker protocol needs better
documentation, but the parts of it that are not common with the
frontend protocol should NOT be documented in protocol.sgml.
That would just confuse authors of frontend code.

I don't mind having constants for the leader/worker protocol in
protocol.h, as long as they're in a separate section that's clearly
marked as relevant only for server-internal parallelism.

			regards, tom lane