On Fri, Jul 24, 2026 at 5:10 PM Fujii Masao <[email protected]> wrote:
>
> On Fri, Jul 24, 2026 at 3:44 PM Peter Smith <[email protected]> wrote:
> > I felt it would make more sense for all the simple replaceable
> > parameters to be kept together:
>
> I'd already pushed the patch before seeing this email, but thanks!

Thanks for pushing!.

>
> If you think it's worth improving the ordering of those descriptions,
> please feel free to work on it. Maybe it's better to discuss that at
> separete thread. I also wonder whether other reference pages have
> the same issue. For example, in the ALTER SERVER documentation,
> OPTIONS (...) appears between new_version and new_owner, so it seems
> to have a similar inconsistency.
>

Last week, I hadn't recognised any meaning for the parameter order. I
thought it was just ad-hoc. But, after looking at a couple more pages
like:
[1] DROP PUBLICATION
[2] CREATE TABLE
It seems like there is some attempt to keep the parameters in roughly
the order that they appear in the synopsis.

So, I'm going to leave this alone now.

======
[1] https://www.postgresql.org/docs/devel/sql-droppublication.html
[2] https://www.postgresql.org/docs/devel/sql-createtable.html

Kind Regards,
Peter Smith.
Fujitsu Australia.


Reply via email to