Date: Thu, 7 Oct 2021 16:06:12 -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: <20211007200612.rkxxgeorw6w4fpjp@localhost>
References: <20211001163938.ifg4ayrsjwd7r6zr@localhost>
 <1c0eefa304434f67fd6a5a9d3f420d59ac74623a.camel@cybertec.at>
 <20211007033905.pmsg5qnyqceepfva@localhost>
 <9f703511c57d6bb0f44f9a968414869854ae50ea.camel@cybertec.at>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <9f703511c57d6bb0f44f9a968414869854ae50ea.camel@cybertec.at>
User-Agent: NeoMutt/20180716
Archived-At: 
 <https://www.postgresql.org/message-id/20211007200612.rkxxgeorw6w4fpjp%40localhost>
Precedence: bulk

On Thu, Oct 07, 2021 at 07:58:47AM +0200, Laurenz Albe wrote:
> On Wed, 2021-10-06 at 23:39 -0400, rir wrote:
> > On Mon, Oct 04, 2021 at 08:18:22AM +0200, Laurenz Albe wrote:
> > > On Fri, 2021-10-01 at 21:06 -0400, rir wrote:

> > > > Minor changes to move.sgml and fetch.sgml.

> > > However, I don't think that is an improvement:
> > > 
> > > - the comments pointing from MOVE to FETCH and vice versa are
> > >   helpful for people who edit the documentation like you did
> > > - we should retain "empty or one of", otherwise the following syntax
> > >   would be undocumented:
> > > 
> > >       FETCH FROM c;
> > 
> > Your view is completely reasonable, but it suggests that
> > many of the synopses are leaving syntax undocumented.
> > The 'empty or one of:' is only used in these two synopses.

> Can you think of a way to modify the syntax diagram so that it
> expresses that and still remains comprehensible?


For myself,
   'FETCH [ <direction> [ FROM | IN ] ] <cursor_name>'
clearly indicates that 'direction' is optional.

Rob