From: Alvaro Herrera <alvherre@commandprompt.com>
To: Bruce Momjian <bruce@momjian.us>
Cc: Robert Haas <robertmhaas@gmail.com>
Cc: Antje Petersen <antje.petersen@desy.de>
Cc: pgsql-bugs <pgsql-bugs@postgresql.org>
Subject: Re: BUG #5814: documentation bug
Date: Fri, 11 Mar 2011 11:56:18 -0300
Message-ID: <1299855267-sup-1399@alvh.no-ip.org> (raw)
In-Reply-To: <201103111444.p2BEiqj02720@momjian.us>
References: <201103111444.p2BEiqj02720@momjian.us>
Excerpts from Bruce Momjian's message of vie mar 11 11:44:52 -0300 2011:
> Robert Haas wrote:
> > On Thu, Mar 10, 2011 at 10:45 PM, Bruce Momjian <bruce@momjian.us> wrote:
> > > Antje Petersen wrote:
> > >>
> > >> The following bug has been logged online:
> > >>
> > >> According to the documentation
> > >> createuser --no-superuser and
> > >> createuser --no-createrole is the default.
> > >> This is not true. The default is to be asked
> > >> Shall the new role be a superuser? (y/n)
> > >> Shall the new role be allowed to create more new roles? (y/n)
> > >
> > > Sorry for the late reply. ?If you press "enter", "no" is the default.
> >
> > That's a lame answer. Surely this is a documentation bug.
>
> Well, what do you suggest? I see no other way to specify the default
> for pressing <ENTER>. I know I just press <ENTER> at those prompts.
He's saying that the documentation should say "if no options are passed,
you will be asked".
While at it, I think the default option should be capitalized:
Shall the new role be allowed to create more new roles? (y/N)
That way, the user knows what will happen, without having to look it up
in the docs. This capitalization of the default option is pretty common
nowadays.
--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: alvherre@commandprompt.com, bruce@momjian.us, robertmhaas@gmail.com, antje.petersen@desy.de, pgsql-bugs@postgresql.org
Subject: Re: BUG #5814: documentation bug
In-Reply-To: <1299855267-sup-1399@alvh.no-ip.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox