| From: | Michael Paquier <michael(at)paquier(dot)xyz> |
|---|---|
| To: | rir <rirans(at)comcast(dot)net> |
| Cc: | pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: Trivial doc patch |
| Date: | 2021-10-16 02:14:46 |
| Message-ID: | YWo1lgOQ0P1eUqqC@paquier.xyz |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
On Fri, Oct 15, 2021 at 01:13:14PM -0400, rir wrote:
> This removes the outer square brackets in the create_database.sgml
> file's synopsis. In the command sysopses, this is the only case
> where an optional group contains only optional groups.
>
> CREATE DATABASE <replaceable class="parameter">name</replaceable>
> - [ [ WITH ] [ OWNER [=] <replaceable class="parameter">user_name</replaceable> ]
> + [ WITH ] [ OWNER [=] <replaceable class="parameter">user_name</replaceable> ]
> [...]
> - [ IS_TEMPLATE [=] <replaceable class="parameter">istemplate</replaceable> ] ]
> + [ IS_TEMPLATE [=] <replaceable class="parameter">istemplate</replaceable> ]
> </synopsis>
> </refsynopsisdiv>
You are not wrong, and the existing doc is not wrong either. I tend
to prefer the existing style, though, as it insists on the options
as being a single group, with or without the keyword WITH.
--
Michael
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Michael Paquier | 2021-10-16 03:43:00 | Re: Reset snapshot export state on the transaction abort |
| Previous Message | Tom Lane | 2021-10-16 01:05:27 | pg_dump fails to lock partitioned tables |