11<!--
2- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.68 2007/03/26 17:23:37 tgl Exp $
2+ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.69 2007/12/11 19:57:32 tgl Exp $
33PostgreSQL documentation
44-->
55
@@ -59,7 +59,7 @@ PostgreSQL documentation
5959 <para>
6060 <application>pg_dumpall</application> needs to connect several
6161 times to the <productname>PostgreSQL</productname> server (once per
62- database). If you use password authentication itis likely to ask for
62+ database). If you use password authentication itwill ask for
6363 a password each time. It is convenient to have a
6464 <filename>~/.pgpass</> file in such cases. See <xref
6565 linkend="libpq-pgpass"> for more information.
@@ -367,7 +367,7 @@ PostgreSQL documentation
367367 <term>--username=<replaceable>username</replaceable></term>
368368 <listitem>
369369 <para>
370- Connect as the given user .
370+ User name to connect as .
371371 </para>
372372 </listitem>
373373 </varlistentry>
@@ -377,8 +377,24 @@ PostgreSQL documentation
377377 <term>--password</term>
378378 <listitem>
379379 <para>
380- Force a password prompt. This should happen automatically if
381- the server requires password authentication.
380+ Force <application>pg_dumpall</application> to prompt for a
381+ password before connecting to a database.
382+ </para>
383+
384+ <para>
385+ This option is never essential, since
386+ <application>pg_dumpall</application> will automatically prompt
387+ for a password if the server demands password authentication.
388+ However, <application>pg_dumpall</application> will waste a
389+ connection attempt finding out that the server wants a password.
390+ In some cases it is worth typing <option>-W</> to avoid the extra
391+ connection attempt.
392+ </para>
393+
394+ <para>
395+ Note that the password prompt will occur again for each database
396+ to be dumped. Usually, it's better to set up a
397+ <filename>~/.pgpass</> file than to rely on manual password entry.
382398 </para>
383399 </listitem>
384400 </varlistentry>