Re: Marking options deprecated in help output

Heikki Linnakangas <hlinnaka@iki.fi>

From: Heikki Linnakangas <hlinnaka@iki.fi>
To: Daniel Gustafsson <daniel@yesql.se>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-02-24T20:31:57Z
Lists: pgsql-hackers
On 05/12/2022 11:42, Daniel Gustafsson wrote:
> In the pg_dump blob terminology thread it was briefly discussed [0] to mark
> parameters as deprecated in the --help output.  The attached is a quick diff to
> show that that would look like.  Personally I think it makes sense, not
> everyone will read the docs.

Makes sense. One minor suggestion; instead of this:

>   -h, -H, --host=HOSTNAME    database server host or socket directory
>                              (-H is deprecated)

How about putting the deprecated option on a separate line like this:

>   -h, --host=HOSTNAME        database server host or socket directory
>   -H                         (same as -h, deprecated)

And same for --blobs and -no-blobs

- Heikki




Commits

  1. Mark options as deprecated in usage output