Date: Tue, 12 Oct 2021 18:16:04 -0400
From: rir <rirans@comcast.net>
To: Laurenz Albe <laurenz.albe@cybertec.at>
Cc: rir <rirans@comcast.net>, pgsql-docs@lists.postgresql.org
Subject: Re: small patch
Message-ID: <20211012221604.ovfg7dv2ljgwuld6@localhost>
References: <20211001163938.ifg4ayrsjwd7r6zr@localhost>
 <1c0eefa304434f67fd6a5a9d3f420d59ac74623a.camel@cybertec.at>
 <20211007033905.pmsg5qnyqceepfva@localhost>
 <9f703511c57d6bb0f44f9a968414869854ae50ea.camel@cybertec.at>
 <20211007200612.rkxxgeorw6w4fpjp@localhost>
 <57c6acf0d2936597184f6bc06f434c66eab07f49.camel@cybertec.at>
 <20211010201501.7e35hmwmdxqynjko@localhost>
 <20211012031414.fmel7tx5kb4jkz4x@localhost>
 <5be21049fc8b9dcc2a0404fbce196a65e9c4e347.camel@cybertec.at>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <5be21049fc8b9dcc2a0404fbce196a65e9c4e347.camel@cybertec.at>
User-Agent: NeoMutt/20180716
Archived-At: 
 <https://www.postgresql.org/message-id/20211012221604.ovfg7dv2ljgwuld6%40localhost>
Precedence: bulk

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