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
