Horton

Re: clean up docs for v12

Tom Lane <tgl@sss.pgh.pa.us>

View thread View on postgr.es
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Michael Paquier <michael@paquier.xyz>
Cc: Justin Pryzby <pryzby@telsasoft.com>, Alvaro Herrera <alvherre@2ndquadrant.com>, Andres Freund <andres@anarazel.de>, pgsql-hackers@postgresql.org
Date: 2019-04-27T15:10:46Z
Lists: pgsql-hackers 
Michael Paquier <michael@paquier.xyz> writes:
> On Fri, Apr 26, 2019 at 09:56:47PM -0500, Justin Pryzby wrote:
>> -        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.

FWIW, I think we generally write this the way Justin suggests.  It's
more precise, at least if you're reading it in a way that makes
<literal> text distinguishable from plain text: what to put into
the config file is exactly "-1", and not for instance "minus-one".

			regards, tom lane

Commits

  1. Improve code inferring length of bitmap for JITed tuple deforming.

  2. Fix more typos and inconsistencies in documentation

  3. Fix collection of typos and grammar mistakes in docs and comments

  4. Clean up some documentation for log_statement_sample_rate