From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: "dilerie01@gmail.com" <dilerie01@gmail.com>,
        "pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Subject: Re: Grammar suggestion
In-reply-to: 
 <CAKFQuwYEqi_Jit67XOtqe7a=MZv+k2fchxk_Qh=PRJ0S5B4p9Q@mail.gmail.com>
References: <170472069665.664.18333923743276806522@wrigleys.postgresql.org>
 <CAKFQuwYEqi_Jit67XOtqe7a=MZv+k2fchxk_Qh=PRJ0S5B4p9Q@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Mon, 08 Jan 2024 08:19:06 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <1888325.1704728241.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Mon, 08 Jan 2024 10:37:21 -0500
Message-ID: <1888326.1704728241@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/1888326.1704728241%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> I see where you are coming from but I think the word =E2=80=9Cneed=E2=80=
=9D is actual
> problem and it has to go.  We use the phrase =E2=80=9Cescapes satisfying=
=E2=80=9D in the
> subsequent sentence and should use it here too.

Meh.  I don't like the "escapes" construction too much; I think it's
more confusing than "need not".  But I agree that the two sentences
should use parallel constructions.

> Also, we go to the trouble of accepting =E2=80=9Cmatch partial=E2=80=9D.=
  Maybe add a final
> sentence in this paragraph nothing that we do so and explaining what
> partial is defined to mean in the standard?

I'd be inclined not to.  That info would fit in the reference page
that covers this, but this is introductory material and shouldn't
get too deep in the weeds.  (Of course, if we ever did add MATCH
PARTIAL, we'd have to explain it here.  But nobody's done so in
twenty years so I'm not holding my breath.)

			regards, tom lane