Re: clean up docs for v12 - Mailing list pgsql-hackers

From Tom Lane
Subject Re: clean up docs for v12
Date
Msg-id 21539.1556377846@sss.pgh.pa.us
Whole thread Raw
In response to Re: clean up docs for v12  (Michael Paquier <michael@paquier.xyz>)
Responses Re: clean up docs for v12
List 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



pgsql-hackers by date:

Previous
From: Fabien COELHO
Date:
Subject: Re: [PATCH v1] Add \echo_stderr to psql
Next
From: Tom Lane
Date:
Subject: Re: generate documentation keywords table automatically