From: | Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> |
---|---|
To: | rir <rirans(at)comcast(dot)net> |
Cc: | pgsql-docs(at)lists(dot)postgresql(dot)org |
Subject: | Re: small patch |
Date: | 2021-10-08 12:47:43 |
Message-ID: | 57c6acf0d2936597184f6bc06f434c66eab07f49.camel@cybertec.at |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Thu, 2021-10-07 at 16:06 -0400, rir wrote:
> > > > - we should retain "empty or one of", otherwise the following syntax
> > > > would be undocumented:
>
> For myself,
> 'FETCH [ <direction> [ FROM | IN ] ] <cursor_name>'
> clearly indicates that 'direction' is optional.
Yes, but since [ FROM | IN ] is inside the bracket, that
diagram would not account for "direction" being omitted
while retaining FROM.
So I suggest that you change the syntax diagram to
FETCH [ direction ] [ FROM | IN ] cursor_name
Then I agree that the "empty or" can be removed.
I think that would be a good idea, and it would add
clarity.
I remain of the opinion that the comments should be
retained, but we can leave that for somebody else to
decide.
Do you want to prepare a new patch and register it in
the commitfest?
Yours,
Laurenz Albe
From | Date | Subject | |
---|---|---|---|
Next Message | Pantelis Theodosiou | 2021-10-08 13:27:25 | Re: 9.17. Sequence Manipulation Functions |
Previous Message | PG Doc comments form | 2021-10-08 10:41:13 | 9.17. Sequence Manipulation Functions |