Re: clean up pg_checksums.sgml

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: Justin Pryzby <pryzby(at)telsasoft(dot)com>
Cc: pgsql-hackers(at)postgresql(dot)org
Subject: Re: clean up pg_checksums.sgml
Date: 2019-03-30 01:51:23
Message-ID: 20190330015123.GP1954@paquier.xyz
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Fri, Mar 29, 2019 at 09:32:10AM -0500, Justin Pryzby wrote:
> PFA patch with minor improvements to documentation.

Patch does not apply, and I have reworded the last paragraph about
failures while operating.

> Also, what do you think about changing user-facing language from
> "check checksum" to "verify checksum" ? I see that commit ed308d78
> actually moved in the other direction, but I preferred "verify".

Yes, that's a debate that we had during the discussion for the new
switches, and we have decided to use --check over --verify for the
default option. On the one hand, "Check checksums" is rather
redundant, but that's more consistent with the option name. "Verify
checksums" is perhaps more elegant. My opinion is that having some
consistency between the option names and the docs is nicer.
--
Michael

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Amit Langote 2019-03-30 02:19:58 Re: speeding up planning with partitions
Previous Message Michael Paquier 2019-03-30 01:44:09 Re: REINDEX CONCURRENTLY 2.0