Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vNnA4-00EqMj-0w for pgsql-docs@arkaria.postgresql.org; Tue, 25 Nov 2025 07:08:28 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.96) (envelope-from ) id 1vNnA1-006uFS-2q for pgsql-docs@arkaria.postgresql.org; Tue, 25 Nov 2025 07:08:26 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vNnA1-006uDw-13 for pgsql-docs@lists.postgresql.org; Tue, 25 Nov 2025 07:08:25 +0000 Received: from mail.postgrespro.ru ([93.174.132.70]) by makus.postgresql.org with smtp (Exim 4.96) (envelope-from ) id 1vNn9y-001LNP-0X for pgsql-docs@lists.postgresql.org; Tue, 25 Nov 2025 07:08:24 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=postgrespro.ru; s=mx2023; t=1764054499; bh=bxUh6BKO3zOTOCwMmlOoHK4lcxDwHnI4CosecA2YQF0=; h=Message-ID:Date:User-Agent:Subject:To:Cc:References:From: In-Reply-To:From; b=lZZ7Hn3vxn2YulWzU2TmkvsrnHt5uRlyra7vAGLeS2An6Hj4qwf7SWZuN0DcCLgnC 1VWGL+F1j1ryFgM5hBNe7N+maHksi9s/9UH5C7DjJWbcEioe5/X9HzpgDFMxCC1RDh 9QialnoDXxPKdyVW3Xsj7uWI3+h94GL37JyLkPpziEPbCa9YQAtC//e+rh4j3YKuYI qBazBk6OA8g/RKaFUzhRuQsCiInRYyEaWuqyxeiJU7IGh+0fIxGo/j1PJ9dGRydMnA YC+nO6a7aheFsyD+HJbtK3oLqQJXLrceS6L1va6yOtGN/vxmPKOXkLQE8sGDR8hIrw dSjPSEXpjLURw== Received: from [10.3.12.106] (unknown [217.174.179.222]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (Client did not present a certificate) (Authenticated sender: o.sibiryakov@postgrespro.ru) by mail.postgrespro.ru (Postfix/465) with ESMTPSA id 561FD60391; Tue, 25 Nov 2025 10:08:19 +0300 (MSK) Message-ID: <4e4141ed-d0f3-4cec-b668-885e59e06c0c@postgrespro.ru> Date: Tue, 25 Nov 2025 10:08:18 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: Documentation improvement patch To: Daniel Gustafsson , Peter Eisentraut Cc: pgsql-docs@lists.postgresql.org References: <3881A97B-0146-4389-9C39-3C596536750B@yesql.se> <84E4E3E6-D702-4604-AE0B-AF92B80B3833@yesql.se> <284a26c6-0a38-47ab-bd73-e28943029046@postgrespro.ru> <6de77026-b34f-4f32-a0f3-2dc345c4b1bf@eisentraut.org> <93538952-E9CC-492C-9BDD-9249AD4C6B91@yesql.se> Content-Language: en-US From: Oleg In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-KSMG-AntiPhishing: NotDetected X-KSMG-AntiSpam-Interceptor-Info: not scanned X-KSMG-AntiSpam-Status: not scanned, disabled by settings X-KSMG-AntiVirus: Kaspersky Secure Mail Gateway, version 2.1.0.7854, bases: 2025/11/25 06:45:00 #27971657 X-KSMG-AntiVirus-Status: NotDetected, skipped X-KSMG-LinksScanning: not scanned, disabled by settings X-KSMG-Message-Action: skipped X-KSMG-Rule-ID: 1 List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk Daniel, Peter, thank you for the thorough review of the patch. -- Oleg Sibiryakov On 19.11.2025 17:14, Daniel Gustafsson wrote: >> On 19 Nov 2025, at 12:02, Peter Eisentraut wrote: >> The following changes are left in your patch that should not be changed per the above discussion (all in doc/src/sgml/protocol.sgml): > I did consider these to be separate but re-reading I agree that they should be > removed. > >> Separately, maybe this could be improved further: >> >> - Sets the maximum number of open files each server subprocess is >> + Sets the maximum number of files each server subprocess is >> allowed to open simultaneously; files already opened in the >> >> I think it would be more correct to say something like "... number of files each server subprocess is allowed to have open simultaneously ..." (not how many open actions are happening concurrently). > I wonder if the original intent was to write "Sets the maximum number of open > files each server subprocess is allowed to have simultaneously;"? That being > said, your suggestion is better so I'll go with that. > > I will push the patch with the above changes a bit later today. > > -- > Daniel Gustafsson > > >