Re: Trivial doc patch

Поиск
Список
Период
Сортировка
От Michael Paquier
Тема Re: Trivial doc patch
Дата
Msg-id YWo1lgOQ0P1eUqqC@paquier.xyz
обсуждение исходный текст
Ответ на Trivial doc patch  (rir <rirans@comcast.net>)
Ответы Re: Trivial doc patch  (rir <rirans@comcast.net>)
Список 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

Вложения

В списке pgsql-hackers по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: pg_dump fails to lock partitioned tables
Следующее
От: Michael Paquier
Дата:
Сообщение: Re: Reset snapshot export state on the transaction abort