Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1iSlfB-0000iI-K1 for pgsql-committers@arkaria.postgresql.org; Thu, 07 Nov 2019 17:33:41 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1iSlf9-0000HY-VY for pgsql-committers@arkaria.postgresql.org; Thu, 07 Nov 2019 17:33:39 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1iSlf9-0000HM-OZ for pgsql-committers@lists.postgresql.org; Thu, 07 Nov 2019 17:33:39 +0000 Received: from mail.thelabyrinth.net ([45.56.70.56]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1iSlf7-0002Q3-EQ for pgsql-committers@lists.postgresql.org; Thu, 07 Nov 2019 17:33:39 +0000 Received: from crunchy.local (67-132-193-50.dia.static.qwest.net [67.132.193.50]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: dsteele) by mail.thelabyrinth.net (Postfix) with ESMTPSA id B4D7F54663; Thu, 7 Nov 2019 17:33:33 +0000 (UTC) Subject: Re: pgsql: doc: Further clarify how recovery target parameters are applied To: Fujii Masao , Peter Eisentraut Cc: Alvaro Herrera , pgsql-committers@lists.postgresql.org References: <20191105132123.GA1578@alvherre.pgsql> From: David Steele Message-ID: <8bd7266c-f720-1eda-c94e-77e815768b7b@pgmasters.net> Date: Thu, 7 Nov 2019 12:33:33 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:60.0) Gecko/20100101 Thunderbird/60.9.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk On 11/6/19 4:49 AM, Fujii Masao wrote: > On Wed, Nov 6, 2019 at 4:29 PM Peter Eisentraut > wrote: >> >> On 2019-11-06 05:48, Fujii Masao wrote: >>> Patch attached. As I argued upthread, IMO it's better to remove >>> the latter description from the doc and the patch does that. >>> Also the patch adds "mainly" into the former description. >> >> I think we should list explicitly what is applied and what is not. This >> is the reference documentation after all. > > Or it might be better to add something like "This setting has no effect if > in standby mode / archive recovery" into the description of each parameter, > instead. +1. This will probably be easier to maintain and less confusing overall. -- -David david@pgmasters.net