Re: Psql meta-command conninfo+

From: Dean Rasheed <dean(dot)a(dot)rasheed(at)gmail(dot)com>
To: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
Cc: Hunaid Sohail <hunaidpgml(at)gmail(dot)com>, Sami Imseih <samimseih(at)gmail(dot)com>, "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, Maiquel Grassi <grassi(at)hotmail(dot)com(dot)br>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>, Jim Jones <jim(dot)jones(at)uni-muenster(dot)de>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Nathan Bossart <nathandbossart(at)gmail(dot)com>, "Imseih (AWS), Sami" <simseih(at)amazon(dot)com>, Peter Eisentraut <peter(at)eisentraut(dot)org>, Pavel Luzanov <p(dot)luzanov(at)postgrespro(dot)ru>, Erik Wienhold <ewie(at)ewie(dot)name>
Subject: Re: Psql meta-command conninfo+
Date: 2025-01-14 09:50:51
Message-ID: CAEZATCW3Y8jOD=-gXrNh984q23J42p0_CXieU5KYqTFvRDE0ig@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Tue, 14 Jan 2025 at 08:51, Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> 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

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2025-01-14 09:58:20 Re: Virtual generated columns
Previous Message Peter Eisentraut 2025-01-14 09:42:37 Re: Virtual generated columns