Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1ubNAP-0004IR-5u
	for pgsql-docs@arkaria.postgresql.org; Mon, 14 Jul 2025 17:40:41 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.94.2)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1ubNAN-00AScx-0F
	for pgsql-docs@arkaria.postgresql.org; Mon, 14 Jul 2025 17:40:39 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1ubNAM-00AScm-Ok
	for pgsql-docs@lists.postgresql.org; Mon, 14 Jul 2025 17:40:39 +0000
Received: from sss.pgh.pa.us ([68.162.161.243])
	by makus.postgresql.org with esmtps  (TLS1.3) tls
 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.96)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1ubNAL-007GwT-2W
	for pgsql-docs@lists.postgresql.org;
	Mon, 14 Jul 2025 17:40:38 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 56EHeZdx702139;
	Mon, 14 Jul 2025 13:40:35 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: Laurenz Albe <laurenz.albe@cybertec.at>, petermittere@gmail.com,
        pgsql-docs@lists.postgresql.org
Subject: Re: please define 'statement' in the glossary
In-reply-to: 
 <CAKFQuwbmoYJ8OOZDo1Wn5sBDRk-1jEA+v7Kz2fnGCuvG0g-TvQ@mail.gmail.com>
References: 
 <175223006802.3157505.14764328206246105568@wrigleys.postgresql.org>
 <15139c5d218754350e4870062f90ff0e85490290.camel@cybertec.at>
 <270191.1752420426@sss.pgh.pa.us>
 <097e693ea6cc3541cbcd72c915d7d492c26930c0.camel@cybertec.at>
 <456003.1752442676@sss.pgh.pa.us> <458204.1752443813@sss.pgh.pa.us>
 <CAKFQuwa4VMoHehuN5qCX5Jv15ZahTJ00jxMu4mbtYNHbJ4PXOA@mail.gmail.com>
 <ec1e6bb700f9eefceea0648656b38ab223c14c54.camel@cybertec.at>
 <685003.1752506254@sss.pgh.pa.us>
 <CAKFQuwYzod+L_vjOuWz8OAte2SoS5V5ByOGfhDx1-ubvHTb11g@mail.gmail.com>
 <CAKFQuwYC-p=2pr__2Gu65HR5E=4fmiwHhacKBrxRYmB2GEqtGw@mail.gmail.com>
 <690858.1752509326@sss.pgh.pa.us>
 <CAKFQuwa2gDZTJm5hkrqubcn1=A3aTDR7HxX-NfF-9fKrp28f+A@mail.gmail.com>
 <697664.1752512964@sss.pgh.pa.us>
 <CAKFQuwbmoYJ8OOZDo1Wn5sBDRk-1jEA+v7Kz2fnGCuvG0g-TvQ@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Mon, 14 Jul 2025 10:31:41 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <702137.1752514835.1@sss.pgh.pa.us>
Date: Mon, 14 Jul 2025 13:40:35 -0400
Message-ID: <702138.1752514835@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/702138.1752514835%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> If we accept that we use the words statement and command interchangeably
> then the sole remaining use of command here sticks out because now we have
> to explain why commands are different from statements.  I'd rather just
> remove the parenthetical.  It's poorly clarifying a point that it seems you
> don't want to clarify more fully here.

[ shrug... ]  I'm inclined to go back to the "command message" wording
then.  I don't find "client-issued statement" to be helpful at all;
in particular, it's flat wrong for the multi-statement-query-message
case, because surely all those statements are client-issued.  I'm okay
with this text leaving out nitpicky details, but it should leave the
reader with a mental model that more or less matches reality.

			regards, tom lane