Re: Marking options deprecated in help output - Mailing list pgsql-hackers

From Heikki Linnakangas
Subject Re: Marking options deprecated in help output
Date
Msg-id 370af68a-0025-5b93-4230-600ec63dd3da@iki.fi
Whole thread Raw
In response to Marking options deprecated in help output  (Daniel Gustafsson <daniel@yesql.se>)
Responses Re: Marking options deprecated in help output
List 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




pgsql-hackers by date:

Previous
From: Joseph Koshakow
Date:
Subject: Re: Inconsistency in ACL error message
Next
From: "Imseih (AWS), Sami"
Date:
Subject: Doc update for pg_stat_statements normalization