Received: from maia.hub.org (maia-5.hub.org [200.46.204.29])
	by mail.postgresql.org (Postfix) with ESMTP id 42AD91337BCD
	for <pgsql-bugs-postgresql.org@mail.postgresql.org>;
	Fri, 11 Mar 2011 10:57:11 -0400 (AST)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024)
	with ESMTP id 31237-04-3 for
	<pgsql-bugs-postgresql.org@mail.postgresql.org>;
	Fri, 11 Mar 2011 14:57:02 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from spinlock.commandprompt.com (unknown [207.173.203.215])
	by mail.postgresql.org (Postfix) with ESMTP id 6AA001337C43
	for <pgsql-bugs@postgresql.org>; Fri, 11 Mar 2011 10:56:44 -0400 (AST)
Received: from localhost (localhost [127.0.0.1])
	by spinlock.commandprompt.com (Postfix) with ESMTP id DBAAA348046;
	Fri, 11 Mar 2011 06:56:23 -0800 (PST)
X-Virus-Scanned: Debian amavisd-new at commandprompt.com
Received: from spinlock.commandprompt.com ([127.0.0.1])
	by localhost (spinlock.commandprompt.com.commandprompt.com [127.0.0.1])
	(amavisd-new, port 10024)
	with ESMTP id hwi5ZihWEvPf; Fri, 11 Mar 2011 06:56:21 -0800 (PST)
Received: from perhan.alvh.no-ip.org (unknown [190.95.20.220])
	by spinlock.commandprompt.com (Postfix) with ESMTPSA id 63697348022;
	Fri, 11 Mar 2011 06:56:21 -0800 (PST)
Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000)
	id D0F2E6E58B; Fri, 11 Mar 2011 11:56:18 -0300 (CLST)
Content-Type: text/plain; charset=UTF-8
Cc: Robert Haas <robertmhaas@gmail.com>,
	Antje Petersen <antje.petersen@desy.de>,
	pgsql-bugs <pgsql-bugs@postgresql.org>
Subject: Re: BUG #5814: documentation bug
From: Alvaro Herrera <alvherre@commandprompt.com>
To: Bruce Momjian <bruce@momjian.us>
In-reply-to: <201103111444.p2BEiqj02720@momjian.us>
References: <201103111444.p2BEiqj02720@momjian.us>
Date: Fri, 11 Mar 2011 11:56:18 -0300
Message-Id: <1299855267-sup-1399@alvh.no-ip.org>
User-Agent: Sup/git
Content-Transfer-Encoding: 8bit
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.107 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	RDNS_NONE=0.793
X-Spam-Level: 
X-Archive-Number: 201103/196
X-Sequence-Number: 29706

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