public inbox for [email protected]  

help / color / mirror / Atom feed

From: Dean Rasheed <[email protected]>
To: Alvaro Herrera <[email protected]>
Cc: Hunaid Sohail <[email protected]>
Cc: Sami Imseih <[email protected]>
Cc: David G. Johnston <[email protected]>
Cc: Maiquel Grassi <[email protected]>
Cc: [email protected] <[email protected]>
Cc: Jim Jones <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: Nathan Bossart <[email protected]>
Cc: Imseih (AWS), Sami <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: Pavel Luzanov <[email protected]>
Cc: Erik Wienhold <[email protected]>
Subject: Re: Psql meta-command conninfo+
Date: Tue, 14 Jan 2025 09:50:51 +0000
Message-ID: <CAEZATCW3Y8jOD=-gXrNh984q23J42p0_CXieU5KYqTFvRDE0ig@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <CAMWA6yaO82QyW0p3_38QdVykvFT=qWfcjPxOFam10SW_tOyt-w@mail.gmail.com>
	<[email protected]>

On Tue, 14 Jan 2025 at 08:51, Alvaro Herrera <[email protected]> wrote:
>
> On 2025-Jan-14, Hunaid Sohail wrote:
>
> > I've tried the approach and attached the output.  Does this look good?
>
> Hmm, I'm not sure I like the third column particularly; it's noisy to
> have on all the time.  I'd leave that for \conninfo++ maybe :-)
>

Yeah, I thought perhaps it might provide some useful extra
information, however...

> _If_ we keep the descriptions, I suggest that the majority need to be
> very short, say three words tops, with exceptions allowed for egregious
> cases (if any).  We should get rid of filler words such as "Displays
> the" or "Indicates whether".  For instance, I'd turn "Indicates if
> GSSAPI authentication was used for the connection" into "GSSAPI
> authenticated?" which conveys exactly the same; the ending "?" matches
> things like "Key?" in \d of an index or the "Default?" column in \dc.
> It's a boolean, so people know how to read it.
>

By the time the filler words have been stripped out, the description
isn't really adding any useful information that can't be guessed from
the parameter name and value. So I tend to agree that it should be
left out (for now at least).

Regards,
Dean

view thread (2+ messages)

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: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: Psql meta-command conninfo+
  In-Reply-To: <CAEZATCW3Y8jOD=-gXrNh984q23J42p0_CXieU5KYqTFvRDE0ig@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox