Re: clean up docs for v12

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