Re: [PATCH] doc/queries.sgml: add missing comma

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Drew DeVault <sir(at)cmpwn(dot)com>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: [PATCH] doc/queries.sgml: add missing comma
Date: 2022-08-18 18:10:48
Message-ID: Yv6AqJuvnP3HelUP@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Oct 19, 2021 at 06:41:54PM -0700, David G. Johnston wrote:
> On Tue, Oct 19, 2021 at 2:33 PM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>
> Drew DeVault <sir(at)cmpwn(dot)com> writes:
> > Minor grammatical fix.
>
> Hmm, I'm not sure that reads any better than before.
>
> >     <para>
> > -    Strictly speaking, this process is iteration not recursion, but
> > +    Strictly speaking, this process is iteration, not recursion, but
> >      <literal>RECURSIVE</literal> is the terminology chosen by the SQL
> standards
>
> ... although I think this text is mine, so naturally I'd think
> that.  Anyone else have an opinion?
>
>
>
> If I read that aloud to myself there is a comma after iteration.
>
> That said, given that a comma and a "but" later we use the word "RECURSIVE" the
> clarification that the process isn't recursion seems redundant.  If one knows
> what it means to be "recursive" then they will understand the juxtaposition of
> "iteration" and "recursive" just fine.  If they do not, I don't think adding
> the word "recursion" is going to make much difference.
>
> Thus:
> Strictly speaking, this process is iteration, but <literal>RECURSIVE</literal>
> is the terminology chosen by the SQL standards committee."
>
> Because the above sounds just fine, I'd argue that if one does leave "not
> recursion" it should be set off by a comma.

I went with new wording, which should make this even clearer; patch
attached.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Indecision is a decision. Inaction is an action. Mark Batterson

Attachment Content-Type Size
recursion.diff text/x-diff 482 bytes

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Michael Paquier 2022-08-19 01:04:33 Re: PostgreSQL 15 minor documentation improvements
Previous Message Bruce Momjian 2022-08-18 18:04:56 Re: max_sync_workers_per_subscription