summaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref/createdb.sgml
diff options
context:
space:
mode:
authorTom Lane2007-12-11 19:57:32 +0000
committerTom Lane2007-12-11 19:57:32 +0000
commit1ebff9ba81afbb885d8c34d7e4e975f5cdbe9a4a (patch)
treee2071cd9cbfec6f721b2468c4a9e93e30f652074 /doc/src/sgml/ref/createdb.sgml
parent1161f1ae1474e373ac02fd24898f12d9c7c43436 (diff)
Make documentation of -W options more accurate and uniform.
Diffstat (limited to 'doc/src/sgml/ref/createdb.sgml')
-rw-r--r--doc/src/sgml/ref/createdb.sgml17
1 files changed, 14 insertions, 3 deletions
diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml
index 3b12e94f793..c75042c9b74 100644
--- a/doc/src/sgml/ref/createdb.sgml
+++ b/doc/src/sgml/ref/createdb.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/createdb.sgml,v 1.46 2007/06/21 10:43:09 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/createdb.sgml,v 1.47 2007/12/11 19:57:32 tgl Exp $
PostgreSQL documentation
-->
@@ -183,7 +183,7 @@ PostgreSQL documentation
<term><option>--username <replaceable class="parameter">username</replaceable></></term>
<listitem>
<para>
- User name to connect as
+ User name to connect as.
</para>
</listitem>
</varlistentry>
@@ -193,7 +193,18 @@ PostgreSQL documentation
<term><option>--password</></term>
<listitem>
<para>
- Force password prompt.
+ Force <application>createdb</application> to prompt for a
+ password before connecting to a database.
+ </para>
+
+ <para>
+ This option is never essential, since
+ <application>createdb</application> will automatically prompt
+ for a password if the server demands password authentication.
+ However, <application>createdb</application> will waste a
+ connection attempt finding out that the server wants a password.
+ In some cases it is worth typing <option>-W</> to avoid the extra
+ connection attempt.
</para>
</listitem>
</varlistentry>