diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml index 86f63c4e40588dde45b632cbb5057f228a9d1189..7db333b749fa8385eef063485f4e2b55c4e567d8 100644 --- a/doc/src/sgml/ref/clusterdb.sgml +++ b/doc/src/sgml/ref/clusterdb.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/clusterdb.sgml,v 1.19 2007/02/20 18:10:58 momjian Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/clusterdb.sgml,v 1.20 2007/02/21 23:21:11 momjian Exp $ PostgreSQL documentation --> @@ -66,7 +66,7 @@ PostgreSQL documentation <term><option>--all</></term> <listitem> <para> - Cluster all databases. + Cluster all databases. </para> </listitem> </varlistentry> @@ -76,12 +76,12 @@ PostgreSQL documentation <term><option><optional>--dbname</> <replaceable class="parameter">dbname</replaceable></></term> <listitem> <para> - Specifies the name of the database to be clustered. - If this is not specified and <option>-a</option> (or - <option>--all</option>) is not used, the database name is read - from the environment variable <envar>PGDATABASE</envar>. If - that is not set, the user name specified for the connection is - used. + Specifies the name of the database to be clustered. + If this is not specified and <option>-a</option> (or + <option>--all</option>) is not used, the database name is read + from the environment variable <envar>PGDATABASE</envar>. If + that is not set, the user name specified for the connection is + used. </para> </listitem> </varlistentry> @@ -92,7 +92,7 @@ PostgreSQL documentation <listitem> <para> Echo the commands that <application>clusterdb</application> generates - and sends to the server. + and sends to the server. </para> </listitem> </varlistentry> @@ -112,7 +112,7 @@ PostgreSQL documentation <term><option>--table <replaceable class="parameter">table</replaceable></></term> <listitem> <para> - Cluster <replaceable class="parameter">table</replaceable> only. + Cluster <replaceable class="parameter">table</replaceable> only. </para> </listitem> </varlistentry> @@ -130,9 +130,9 @@ PostgreSQL documentation <term><option>--host <replaceable class="parameter">host</replaceable></></term> <listitem> <para> - Specifies the host name of the machine on which the server is - running. If the value begins with a slash, it is used as the - directory for the Unix domain socket. + Specifies the host name of the machine on which the server is + running. If the value begins with a slash, it is used as the + directory for the Unix domain socket. </para> </listitem> </varlistentry> @@ -142,9 +142,9 @@ PostgreSQL documentation <term><option>--port <replaceable class="parameter">port</replaceable></></term> <listitem> <para> - Specifies the TCP port or local Unix domain socket file - extension on which the server - is listening for connections. + Specifies the TCP port or local Unix domain socket file + extension on which the server + is listening for connections. </para> </listitem> </varlistentry> diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml index 40e2ade8652417d764c80ae79743a0a62ebd8366..c96b2da6a541dc7a144920a44687fbfa17ff73af 100644 --- a/doc/src/sgml/ref/dropdb.sgml +++ b/doc/src/sgml/ref/dropdb.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.29 2007/02/20 18:10:58 momjian Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.30 2007/02/21 23:21:11 momjian Exp $ PostgreSQL documentation --> @@ -60,7 +60,7 @@ PostgreSQL documentation <term><replaceable class="parameter">dbname</replaceable></term> <listitem> <para> - Specifies the name of the database to be removed. + Specifies the name of the database to be removed. </para> </listitem> </varlistentry> @@ -71,7 +71,7 @@ PostgreSQL documentation <listitem> <para> Echo the commands that <application>dropdb</application> generates - and sends to the server. + and sends to the server. </para> </listitem> </varlistentry> @@ -108,10 +108,10 @@ PostgreSQL documentation <term><option>--host <replaceable class="parameter">host</replaceable></></term> <listitem> <para> - Specifies the host name of the machine on which the - server - is running. If the value begins with a slash, it is used - as the directory for the Unix domain socket. + Specifies the host name of the machine on which the + server + is running. If the value begins with a slash, it is used + as the directory for the Unix domain socket. </para> </listitem> </varlistentry> @@ -121,9 +121,9 @@ PostgreSQL documentation <term><option>--port <replaceable class="parameter">port</replaceable></></term> <listitem> <para> - Specifies the TCP port or local Unix domain socket file - extension on which the server - is listening for connections. + Specifies the TCP port or local Unix domain socket file + extension on which the server + is listening for connections. </para> </listitem> </varlistentry> diff --git a/doc/src/sgml/ref/droplang.sgml b/doc/src/sgml/ref/droplang.sgml index 3986b01dfc55d9a31a4791461e1d2425bf3437ce..ba590d430ec6e1a62383bbfeaf5d5487a5cb0d55 100644 --- a/doc/src/sgml/ref/droplang.sgml +++ b/doc/src/sgml/ref/droplang.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/droplang.sgml,v 1.28 2007/02/20 18:10:58 momjian Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/droplang.sgml,v 1.29 2007/02/21 23:21:11 momjian Exp $ PostgreSQL documentation --> @@ -67,7 +67,7 @@ PostgreSQL documentation <term><replaceable class="parameter">langname</replaceable></term> <listitem> <para> - Specifies the name of the backend programming language to be removed. + Specifies the name of the backend programming language to be removed. </para> </listitem> </varlistentry> @@ -77,7 +77,7 @@ PostgreSQL documentation <term><option><optional>--dbname</> <replaceable class="parameter">dbname</replaceable></></term> <listitem> <para> - Specifies from which database the language should be removed. + Specifies from which database the language should be removed. The default is to use the database with the same name as the current system user. </para> @@ -117,10 +117,10 @@ PostgreSQL documentation <term><option>--host <replaceable class="parameter">host</replaceable></></term> <listitem> <para> - Specifies the host name of the machine on which the - server - is running. If host begins with a slash, it is used - as the directory for the Unix domain socket. + Specifies the host name of the machine on which the + server + is running. If host begins with a slash, it is used + as the directory for the Unix domain socket. </para> </listitem> </varlistentry> @@ -130,9 +130,9 @@ PostgreSQL documentation <term><option>--port <replaceable class="parameter">port</replaceable></></term> <listitem> <para> - Specifies the Internet TCP/IP port or local Unix domain socket file - extension on which the server - is listening for connections. + Specifies the Internet TCP/IP port or local Unix domain socket file + extension on which the server + is listening for connections. </para> </listitem> </varlistentry> diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml index 985a79b36f5435e72f2d57cff423dcee5858782c..9c2e0b1d1d80bea0c6281e18bd71f44936795bc2 100644 --- a/doc/src/sgml/ref/initdb.sgml +++ b/doc/src/sgml/ref/initdb.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/initdb.sgml,v 1.41 2007/02/20 18:10:58 momjian Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/initdb.sgml,v 1.42 2007/02/21 23:21:11 momjian Exp $ PostgreSQL documentation --> @@ -237,11 +237,11 @@ PostgreSQL documentation <term><option>--debug</option></term> <listitem> <para> - Print debugging output from the bootstrap backend and a few other + Print debugging output from the bootstrap backend and a few other messages of lesser interest for the general public. - The bootstrap backend is the program <command>initdb</command> - uses to create the catalog tables. This option generates a tremendous - amount of extremely boring output. + The bootstrap backend is the program <command>initdb</command> + uses to create the catalog tables. This option generates a tremendous + amount of extremely boring output. </para> </listitem> </varlistentry> @@ -263,11 +263,11 @@ PostgreSQL documentation <term><option>--noclean</option></term> <listitem> <para> - By default, when <command>initdb</command> - determines that an error prevented it from completely creating the database - cluster, it removes any files it might have created before discovering - that it cannot finish the job. This option inhibits tidying-up and is - thus useful for debugging. + By default, when <command>initdb</command> + determines that an error prevented it from completely creating the database + cluster, it removes any files it might have created before discovering + that it cannot finish the job. This option inhibits tidying-up and is + thus useful for debugging. </para> </listitem> </varlistentry> diff --git a/doc/src/sgml/ref/pg_ctl-ref.sgml b/doc/src/sgml/ref/pg_ctl-ref.sgml index 791c37ea08222f49b487b0340266af81416bd893..a7e1b7ec69647960bdb542a6543ae2ca2171072a 100644 --- a/doc/src/sgml/ref/pg_ctl-ref.sgml +++ b/doc/src/sgml/ref/pg_ctl-ref.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.39 2007/02/20 18:10:58 momjian Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.40 2007/02/21 23:21:11 momjian Exp $ PostgreSQL documentation --> @@ -179,9 +179,9 @@ PostgreSQL documentation <term><option>-D <replaceable class="parameter">datadir</replaceable></option></term> <listitem> <para> - Specifies the file system location of the database files. If - this is omitted, the environment variable - <envar>PGDATA</envar> is used. + Specifies the file system location of the database files. If + this is omitted, the environment variable + <envar>PGDATA</envar> is used. </para> </listitem> </varlistentry> @@ -202,10 +202,10 @@ PostgreSQL documentation <term><option>-m <replaceable class="parameter">mode</replaceable></option></term> <listitem> <para> - Specifies the shutdown mode. <replaceable>mode</replaceable> - can be <literal>smart</literal>, <literal>fast</literal>, or - <literal>immediate</literal>, or the first letter of one of - these three. + Specifies the shutdown mode. <replaceable>mode</replaceable> + can be <literal>smart</literal>, <literal>fast</literal>, or + <literal>immediate</literal>, or the first letter of one of + these three. </para> </listitem> </varlistentry> @@ -218,8 +218,8 @@ PostgreSQL documentation <command>postgres</command> command. </para> <para> - The options are usually surrounded by single or double - quotes to ensure that they are passed through as a group. + The options are usually surrounded by single or double + quotes to ensure that they are passed through as a group. </para> </listitem> </varlistentry> @@ -228,12 +228,12 @@ PostgreSQL documentation <term><option>-p <replaceable class="parameter">path</replaceable></option></term> <listitem> <para> - Specifies the location of the <filename>postgres</filename> - executable. By default the <filename>postgres</filename> executable is taken from the same - directory as <command>pg_ctl</command>, or failing that, the hard-wired - installation directory. It is not necessary to use this - option unless you are doing something unusual and get errors - that the <filename>postgres</filename> executable was not found. + Specifies the location of the <filename>postgres</filename> + executable. By default the <filename>postgres</filename> executable is taken from the same + directory as <command>pg_ctl</command>, or failing that, the hard-wired + installation directory. It is not necessary to use this + option unless you are doing something unusual and get errors + that the <filename>postgres</filename> executable was not found. </para> </listitem> </varlistentry> @@ -253,9 +253,9 @@ PostgreSQL documentation <para> Attempt to allow server crashes to produce core files, on platforms where this available, by lifting any soft resource limit placed on - them. - This is useful in debugging or diagnosing problems by allowing a - stack trace to be obtained from a failed server process. + them. + This is useful in debugging or diagnosing problems by allowing a + stack trace to be obtained from a failed server process. </para> </listitem> </varlistentry> @@ -264,8 +264,8 @@ PostgreSQL documentation <term><option>-w</option></term> <listitem> <para> - Wait for the start or shutdown to complete. Times out after - 60 seconds. This is the default for shutdowns. A successful + Wait for the start or shutdown to complete. Times out after + 60 seconds. This is the default for shutdowns. A successful shutdown is indicated by removal of the <acronym>PID</acronym> file. For starting up, a successful <command>psql -l</command> indicates success. <command>pg_ctl</command> will attempt to @@ -276,7 +276,7 @@ PostgreSQL documentation <productname>PostgreSQL</productname> was compiled with (5432 by default). When waiting, <command>pg_ctl</command> will return an accurate exit code based on the success of the startup - or shutdown. + or shutdown. </para> </listitem> </varlistentry> diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml index 7912a94d5eab2aecde28904671f50b67eaeb669c..48869374dfbd76f34ae0449f36c6e958a9da31cd 100644 --- a/doc/src/sgml/ref/pg_dumpall.sgml +++ b/doc/src/sgml/ref/pg_dumpall.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.66 2007/02/20 18:10:58 momjian Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.67 2007/02/21 23:21:12 momjian Exp $ PostgreSQL documentation --> @@ -128,7 +128,7 @@ PostgreSQL documentation </para> </listitem> </varlistentry> - + <varlistentry> <term><option>-f <replaceable class="parameter">filename</replaceable></option></term> <term><option>--file=<replaceable class="parameter">filename</replaceable></option></term> @@ -335,7 +335,7 @@ PostgreSQL documentation </para> </listitem> </varlistentry> - + <varlistentry> <term>-l <replaceable>dbname</replaceable></term> <term>--database=<replaceable>dbname</replaceable></term> diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index 5cf2b0bd1090e6d7783a99288b8cb033e694313d..209a2cea3ec6f271b35971da0b07fb606c2a0e9c 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.184 2007/02/20 18:10:58 momjian Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.185 2007/02/21 23:21:12 momjian Exp $ PostgreSQL documentation --> @@ -108,15 +108,15 @@ PostgreSQL documentation <term><option>--dbname <replaceable class="parameter">dbname</replaceable></></term> <listitem> <para> - Specifies the name of the database to connect to. This is - equivalent to specifying <replaceable - class="parameter">dbname</replaceable> as the first non-option - argument on the command line. + Specifies the name of the database to connect to. This is + equivalent to specifying <replaceable + class="parameter">dbname</replaceable> as the first non-option + argument on the command line. + </para> + <para> + If this parameter contains an <symbol>=</symbol> sign, it it treated as a + <parameter>conninfo</parameter> string. See <xref linkend="libpq-connect"> for more information. </para> - <para> - If this parameter contains an <symbol>=</symbol> sign, it it treated as a - <parameter>conninfo</parameter> string. See <xref linkend="libpq-connect"> for more information. - </para> </listitem> </varlistentry> @@ -559,17 +559,17 @@ PostgreSQL documentation passwords. See <xref linkend="libpq-pgpass"> for more information. </para> - <para> - An alternative way to specify connection parameters is in a - <parameter>conninfo</parameter> string, which is used instead of a - database name. This mechanism give you very wide control over the - connection. For example: + <para> + An alternative way to specify connection parameters is in a + <parameter>conninfo</parameter> string, which is used instead of a + database name. This mechanism give you very wide control over the + connection. For example: <programlisting> $ <userinput>psql "service=myservice sslmode=require"</userinput> </programlisting> - See <xref linkend="libpq-connect"> for more information on all the - available connection options. - </para> + See <xref linkend="libpq-connect"> for more information on all the + available connection options. + </para> <para> If the connection could not be made for any reason (e.g., insufficient diff --git a/doc/src/sgml/ref/reindexdb.sgml b/doc/src/sgml/ref/reindexdb.sgml index 1594df0c2bc503bad7b9e65532ebcea57a7e55b0..ec6dc38872abc8f90caed0baec8212ad1cd580b4 100644 --- a/doc/src/sgml/ref/reindexdb.sgml +++ b/doc/src/sgml/ref/reindexdb.sgml @@ -69,7 +69,7 @@ PostgreSQL documentation <term><option>--all</></term> <listitem> <para> - Reindex all databases. + Reindex all databases. </para> </listitem> </varlistentry> @@ -79,7 +79,7 @@ PostgreSQL documentation <term><option>--system</></term> <listitem> <para> - Reindex database's system catalogs. + Reindex database's system catalogs. </para> </listitem> </varlistentry> @@ -89,7 +89,7 @@ PostgreSQL documentation <term><option>--table <replaceable class="parameter">table</replaceable></></term> <listitem> <para> - Reindex <replaceable class="parameter">table</replaceable> only. + Reindex <replaceable class="parameter">table</replaceable> only. </para> </listitem> </varlistentry> @@ -99,7 +99,7 @@ PostgreSQL documentation <term><option>--index <replaceable class="parameter">index</replaceable></></term> <listitem> <para> - Recreate <replaceable class="parameter">index</replaceable> only. + Recreate <replaceable class="parameter">index</replaceable> only. </para> </listitem> </varlistentry> @@ -109,12 +109,12 @@ PostgreSQL documentation <term><option><optional>--dbname</> <replaceable class="parameter">dbname</replaceable></></term> <listitem> <para> - Specifies the name of the database to be reindexed. - If this is not specified and <option>-a</option> (or - <option>--all</option>) is not used, the database name is read - from the environment variable <envar>PGDATABASE</envar>. If - that is not set, the user name specified for the connection is - used. + Specifies the name of the database to be reindexed. + If this is not specified and <option>-a</option> (or + <option>--all</option>) is not used, the database name is read + from the environment variable <envar>PGDATABASE</envar>. If + that is not set, the user name specified for the connection is + used. </para> </listitem> </varlistentry> @@ -125,7 +125,7 @@ PostgreSQL documentation <listitem> <para> Echo the commands that <application>reindexdb</application> generates - and sends to the server. + and sends to the server. </para> </listitem> </varlistentry> @@ -153,9 +153,9 @@ PostgreSQL documentation <term><option>--host <replaceable class="parameter">host</replaceable></></term> <listitem> <para> - Specifies the host name of the machine on which the server is - running. If the value begins with a slash, it is used as the - directory for the Unix domain socket. + Specifies the host name of the machine on which the server is + running. If the value begins with a slash, it is used as the + directory for the Unix domain socket. </para> </listitem> </varlistentry> @@ -165,9 +165,9 @@ PostgreSQL documentation <term><option>--port <replaceable class="parameter">port</replaceable></></term> <listitem> <para> - Specifies the TCP port or local Unix domain socket file - extension on which the server - is listening for connections. + Specifies the TCP port or local Unix domain socket file + extension on which the server + is listening for connections. </para> </listitem> </varlistentry>