Re: Should we put command options in alphabetical order in the doc?

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: David Rowley <dgrowleyml(at)gmail(dot)com>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Peter Geoghegan <pg(at)bowt(dot)ie>, PostgreSQL Developers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Should we put command options in alphabetical order in the doc?
Date: 2023-04-20 12:57:46
Message-ID: DCABCA61-1ADE-4B9A-866E-7A9D9C2EC7AC@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

> On 20 Apr 2023, at 14:40, David Rowley <dgrowleyml(at)gmail(dot)com> wrote:

> I see "man grep" categorises the command line options and then sorts
> alphabetically within the category.

On FreeBSD and macOS "man grep" lists all options alphabetically.

> FWIW, vacuumdb --help has its options in alphabetical order using the
> abbreviated form of the option.

It does (as most of our binaries do) group "Connection options" separately
though, and in initdb --help and pg_dump --help we have other groupings as
well.

--
Daniel Gustafsson

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Ashutosh Bapat 2023-04-20 13:31:49 memory context mismatch in LockMethodLocalHash entries.
Previous Message Jehan-Guillaume de Rorthais 2023-04-20 12:43:44 [BUG] FK broken after DETACHing referencing part