Re: small patch

From: rir <rirans(at)comcast(dot)net>
To: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
Cc: rir <rirans(at)comcast(dot)net>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: small patch
Date: 2021-10-12 22:16:04
Message-ID: 20211012221604.ovfg7dv2ljgwuld6@localhost
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Oct 12, 2021 at 08:43:34AM +0200, Laurenz Albe wrote:
> On Mon, 2021-10-11 at 23:14 -0400, rir wrote:
> > On Sun, Oct 10, 2021 at 04:15:01PM -0400, rir wrote:
> > > On Fri, Oct 08, 2021 at 02:47:43PM +0200, Laurenz Albe wrote:
> > > > On Thu, 2021-10-07 at 16:06 -0400, rir wrote:
> >
> > > > FETCH [ direction ] [ FROM | IN ] cursor_name
> >
> > Should the pgplsql docs be similiarly changed per the above
> > in 43.7.3.1 and 2?
>
> Absolutely!
>
> It may even make sense to extend the existing comments to
> alert people who modify the syntax diagram in the future
> that they should also consider reviewing the PL/pgSQL syntax.

I will make the syntax change.

Since my understanding is that, absent contrary documentation,
plpgSQL follows SQL, I resist the idea of yet another comment.
Better would be establishing a SPoT, tagging it, and tagging
various forms of derived info as quotes, code samples, etc. or,
at worst, logically dependent. This more form of commenting
could allow linting processes to support its use and check
its accuracy.

Absent that ...

Rob

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2021-10-12 22:44:19 Re: small patch
Previous Message Peter Geoghegan 2021-10-12 18:00:53 Re: Correction for vacuum_multixact_failsafe_age