Re: BUG #5814: documentation bug

Alvaro Herrera wrote:
> 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(at)momjian(dot)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.

Oops, I was wrong. There is no default. It keeps prompting if I press
<ENTER>.

Also, it seems this was addressed in January:

commit af84bee43e356866dc46c95ae5bf77996a8237ff
Author: Robert Haas <rhaas(at)postgresql(dot)org>
Date: Sat Jan 8 06:12:05 2011 -0500

Remove bogus claims regarding createuser defaults.

Josh Kupershmidt

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +