Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bYDO5-0004LV-0k for pgsql-docs@arkaria.postgresql.org; Fri, 12 Aug 2016 14:24:41 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.84_2) (envelope-from ) id 1bYDO4-0005N2-KA for pgsql-docs@arkaria.postgresql.org; Fri, 12 Aug 2016 14:24:40 +0000 Received: from makus.postgresql.org ([2001:4800:1501:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1bYDNi-0004yF-LT for pgsql-docs@postgresql.org; Fri, 12 Aug 2016 14:24:18 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1bYDNg-0002uE-43 for pgsql-docs@postgresql.org; Fri, 12 Aug 2016 14:24:17 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id u7CEODA7026368; Fri, 12 Aug 2016 10:24:13 -0400 From: Tom Lane To: Simon Riggs cc: paddor@gmail.com, pgsql-docs@postgresql.org Subject: Re: Wording in TABLESAMPLE documentation In-reply-to: References: <20160811162148.26427.26037@wrigleys.postgresql.org> Comments: In-reply-to Simon Riggs message dated "Fri, 12 Aug 2016 10:37:44 +0100" Date: Fri, 12 Aug 2016 10:24:13 -0400 Message-ID: <26367.1471011853@sss.pgh.pa.us> X-Pg-Spam-Score: -2.4 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org Simon Riggs writes: > On 11 August 2016 at 17:21, 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 -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs