pg.ddx.io pgsql-docs@postgresql.org mailing list archivehelp / color / mirror / Atom feed
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
To: Jonathan S. Katz <jkatz@postgresql.org>
To: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: confusing positioning of notes in connection settings
Date: Wed, 26 Apr 2023 08:08:36 +0200
Message-ID: <4e34fcb4-6791-0266-7352-27b769c478f9@enterprisedb.com> (raw)
In-Reply-To: <6f825d42-a1ce-492a-2ea7-c83e6e65fa8b@postgresql.org>
References: <6f825d42-a1ce-492a-2ea7-c83e6e65fa8b@postgresql.org>
On 22.04.23 21:53, Jonathan S. Katz wrote:
> While testing a few other things on the connection settings page[1], I
> noticed the notes on the "tcp_*" family of settings. While scrolling
> further down the page, I found myself slightly confused over which note
> corresponded to which setting (example in screenshot).
>
> Given the nature of these notes, i.e. to say that the setting is not
> supported in Windows, couldn't we just add that text to the description
> of the parameter and remove the note? I think that'd make it a bit
> clearer which comment applies to which parameter.
I agree we could fold the notes (and other similar notes nearby) into
the main text. Or we could just remove them, because the main text
already contains the information in more general form.
I wonder if the notes are even true. The text for
tcp_keepalives_interval already says that it is only supported if
TCP_KEEPCNT is supported. There is no specific code for Windows.
Random googling suggests that TCP_KEEPCNT does exist on Windows.
view thread (11+ messages) latest in thread
Message-ID: <4e34fcb4-6791-0266-7352-27b769c478f9@enterprisedb.com> Permalink: ../4e34fcb4-6791-0266-7352-27b769c478f9@enterprisedb.com/ Also on: postgresql.org/message-id/4e34fcb4-6791-0266-7352-27b769c478f9@enterprisedb.com ·
reply
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Reply to all the recipients using the --to and --cc options: reply via email To: pgsql-docs@postgresql.org Cc: peter.eisentraut@enterprisedb.com, jkatz@postgresql.org, pgsql-docs@lists.postgresql.org Subject: Re: confusing positioning of notes in connection settings In-Reply-To: <4e34fcb4-6791-0266-7352-27b769c478f9@enterprisedb.com> * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions for how to clone and mirror all data and code used for this inbox