Re: clean up docs for v12

Поиск
Список
Период
Сортировка
От Michael Paquier
Тема Re: clean up docs for v12
Дата
Msg-id 20190427045700.GG2032@paquier.xyz
обсуждение исходный текст
Ответ на Re: clean up docs for v12  (Justin Pryzby <pryzby@telsasoft.com>)
Ответы Re: clean up docs for v12  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-hackers
On Fri, Apr 26, 2019 at 09:56:47PM -0500, Justin Pryzby wrote:
> But here's some one-liner excerpts.
>
> -      is <literal>2</literal> bits and maximum is <literal>4095</literal>.  Parameters for
> +      is <literal>2</literal> bits and the maximum is <literal>4095</literal>.  Parameters for
>
> Adding "the" makes it a complete sentence and not a fragment.

Not sure here either that it matters.

> -        all autovacuum actions. Minus-one (the default) disables logging
> +        all autovacuum actions. <literal>-1</literal> (the default) disables logging
>
> There's nothing else that says "minus-one" anywhere else on that page.  I just
> found one in auto-explain.sgml, which I changed.

That's one of these I am not sure about.

> -    than 16KB; <function>gss_wrap_size_limit()</function> should be used by the
> +    than 16kB; <function>gss_wrap_size_limit()</function> should be used by the
>
> Every other use in documentation has a lowercase "kay", and PG itself doesn't
> accept "KB" unit suffix.

Right.  There are more places like that, particularly in the comments
of the code.

> -     A few features included in the C99 standard are, at this time, not be
> +     A few features included in the C99 standard are, at this time, not
>       permitted to be used in core <productname>PostgreSQL</productname>
>
> Indisputably wrong ?

Yep, this one is wrong as-is.
--
Michael

Вложения

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

Предыдущее
От: David Fetter
Дата:
Сообщение: Re: [PATCH v1] Show whether tables are logged in \dt+
Следующее
От: Fabien COELHO
Дата:
Сообщение: nRe: [PATCH v1] Show whether tables are logged in \dt+