Re: Fix help option of contrib/oid2name

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: Tatsuro Yamada <yamada(dot)tatsuro(at)lab(dot)ntt(dot)co(dot)jp>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, pgsql-hackers(at)postgresql(dot)org
Subject: Re: Fix help option of contrib/oid2name
Date: 2018-08-20 04:54:57
Message-ID: 20180820045457.GI7403@paquier.xyz
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Mon, Aug 20, 2018 at 12:30:29PM +0900, Tatsuro Yamada wrote:
> vacuumlo:
> Document
> - Add long options
> - Add environment section

Let's keep things simple by not adding long options where it is not
especially obvious, so I would suggest to keep the patch simple and just
add long options for connection options.

> oid2name:
> Document
> - Add long options
> - Add environment section
> - Remove deprecated and unhandled option "-P password"

Is this a good idea? I doubt that it is used but keeping it would not
cause any breakage, and removing it could.

oid2name supports also PGDATABASE.

> Code
> - Revive handling "-H host" option silently
>
> I didn't add "-H" to the help message because it's a deprecated
> option.

It seems to me that this should be still documented in both --help and
in the docs, and that we should just mark it as deprecated in both.

> I guess that that means "silently" as you said on previous email.
> Should I add it? For example,
>
> [...]

Let's use a different line for that. See for example how pg_standby -k
is treated.

I can see why you have reordered the options, this is more consistent
with things in src/bin/scripts.

We could have as well some basic TAP tests for both utilities while on
it. Something as simple as the first tests in 050_dropdb.pl would do a
fine first shot.
--
Michael

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Michael Paquier 2018-08-20 04:57:12 Re: simplehash.h comment
Previous Message Thomas Munro 2018-08-20 04:38:20 simplehash.h comment