Re: Move --interactive in createuser.sgml?

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Ekaterina Kiryanova <e(dot)kiryanova(at)postgrespro(dot)ru>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Move --interactive in createuser.sgml?
Date: 2023-07-04 09:56:55
Message-ID: AD568BD1-3127-45A3-A713-9E8FE673A378@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 4 Jul 2023, at 09:58, Ekaterina Kiryanova <e(dot)kiryanova(at)postgrespro(dot)ru> wrote:

> I noticed that the --interactive option in createuser.sgml is in the list of short options rather than in the list of the long ones later on.
> If it makes sense to move it below, the attached patch fixes that for master (after --bypassrls/--no-bypassrls).
> Please take a look.

I'm not sure this moves the needle much in terms of consistency in listing
options, and I'm not sure there is policy to follow. createdb has long options
in alphabetical order, pg_basebackup has long options both by alphabetical and
grouped last, and pg_amcheck groups options by type.

Whether or not an option has a short option as well as a long option is an
implementation detail that I don't think should drive how we present the
information to the users in order to help them find what they need.

--
Daniel Gustafsson

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2023-07-07 07:36:00 group by can use alias from select list
Previous Message Ekaterina Kiryanova 2023-07-04 07:58:48 Move --interactive in createuser.sgml?