pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: rir <rirans@comcast.net>
To: Laurenz Albe <laurenz.albe@cybertec.at>
Cc: rir <rirans@comcast.net>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: small patch
Date: Tue, 12 Oct 2021 18:16:04 -0400
Message-ID: <20211012221604.ovfg7dv2ljgwuld6@localhost> (raw)
In-Reply-To: <5be21049fc8b9dcc2a0404fbce196a65e9c4e347.camel@cybertec.at>
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>

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







view thread (16+ messages)  latest in thread

Message-ID: <20211012221604.ovfg7dv2ljgwuld6@localhost>
Permalink:  ../20211012221604.ovfg7dv2ljgwuld6@localhost/
Also on:    postgresql.org/message-id/20211012221604.ovfg7dv2ljgwuld6@localhost

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: rirans@comcast.net, laurenz.albe@cybertec.at, pgsql-docs@lists.postgresql.org
  Subject: Re: small patch
  In-Reply-To: <20211012221604.ovfg7dv2ljgwuld6@localhost>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox