Re: small patch - Mailing list pgsql-docs

From rir
Subject Re: small patch
Date
Msg-id 20211012221604.ovfg7dv2ljgwuld6@localhost
Whole thread Raw
In response to Re: small patch  (Laurenz Albe <laurenz.albe@cybertec.at>)
List 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





pgsql-docs by date:

Previous
From: Peter Geoghegan
Date:
Subject: Re: Correction for vacuum_multixact_failsafe_age
Next
From: Alvaro Herrera
Date:
Subject: Re: small patch