Re: Wording in TABLESAMPLE documentation - Mailing list pgsql-docs

From Tom Lane
Subject Re: Wording in TABLESAMPLE documentation
Date
Msg-id 26367.1471011853@sss.pgh.pa.us
Whole thread Raw
In response to Re: Wording in TABLESAMPLE documentation  (Simon Riggs <simon@2ndquadrant.com>)
Responses Re: Wording in TABLESAMPLE documentation  (Simon Riggs <simon@2ndquadrant.com>)
List pgsql-docs
Simon Riggs <simon@2ndquadrant.com> writes:
> On 11 August 2016 at 17:21,  <paddor@gmail.com> wrote:
>> > If REPEATABLE is not given then a new random sample is selected for each
>> query.
>>
>> the word "sample" should be "seed". Of course it results in a new random
>> sample as well, but IMHO this sentence is about what happens to the seed in
>> case REPEATABLE (seed) is omitted.

> Corrected, thanks.

I do not think this is an improvement.  The sentence was specifically about
whether the sample (that is, the set of rows selected) would change.  This
rewording essentially removes that user-visible behavior guarantee, and
for what?  It's certainly not any clearer.

            regards, tom lane


pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Undocumented behavior od DROP SCHEMA ... CASCADE
Next
From: Simon Riggs
Date:
Subject: Re: Wording in TABLESAMPLE documentation