database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-12-22 17:42:17 +03:00
Code Activity

Make documentation of --help and --version options more consistent

Browse Source 
Before, some places didn't document the short options (-? and -V),
some documented both, some documented nothing, and they were listed in
various orders.  Now this is hopefully more consistent and complete.
This commit is contained in:
Peter Eisentraut
2012-06-18 02:44:00 +03:00
parent 9e18eacbdf
commit bb7520cc26
45 changed files with 348 additions and 139 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
doc/src/sgml/ref/createuser.sgml
View File

@@ -256,13 +256,23 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>
<listitem>
<para>
Print the <application>createuser</application> version and exit.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--replication</></term>
<listitem>
<para>
The new user will have the REPLICATION privilege, which is
described more fully in the documentation for
<xref linkend="sql-createrole">.
The new user will have the <literal>REPLICATION</literal> privilege,
which is described more fully in the documentation for <xref
linkend="sql-createrole">.
</para>
</listitem>
</varlistentry>
@@ -271,23 +281,13 @@ PostgreSQL documentation
<term><option>--no-replication</></term>
<listitem>
<para>
The new user will not have the REPLICATION privilege, which is
described more fully in the documentation for
<xref linkend="sql-createrole">.
The new user will not have the <literal>REPLICATION</literal>
privilege, which is described more fully in the documentation for <xref
linkend="sql-createrole">.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>
<listitem>
<para>
Print the <application>createuser</application> version and exit.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-?</></term>
<term><option>--help</></term>

20
doc/src/sgml/ref/dropdb.sgml
View File

@@ -86,16 +86,6 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry>
<term><option>--if-exists</></term>
<listitem>
<para>
Do not throw an error if the database does not exist. A notice is issued
in this case.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>
@@ -106,6 +96,16 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry>
<term><option>--if-exists</></term>
<listitem>
<para>
Do not throw an error if the database does not exist. A notice is issued
in this case.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-?</></term>
<term><option>--help</></term>

20
doc/src/sgml/ref/dropuser.sgml
View File

@@ -91,16 +91,6 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry>
<term><option>--if-exists</></term>
<listitem>
<para>
Do not throw an error if the user does not exist. A notice is
issued in this case.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>
@@ -111,6 +101,16 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry>
<term><option>--if-exists</></term>
<listitem>
<para>
Do not throw an error if the user does not exist. A notice is
issued in this case.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-?</></term>
<term><option>--help</></term>

1
doc/src/sgml/ref/ecpg-ref.sgml
View File

@@ -202,6 +202,7 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-?</option></term>
<term><option>--help</option></term>
<listitem>
<para>

6
doc/src/sgml/ref/initdb.sgml
View File

@@ -326,7 +326,13 @@ PostgreSQL documentation
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Other options:
<variablelist>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>

2
doc/src/sgml/ref/pg_basebackup.sgml
View File

@@ -431,7 +431,7 @@ PostgreSQL documentation
</para>
<para>
Other, less commonly used, options are also available:
Other options are also available:
<variablelist>
<varlistentry>

11
doc/src/sgml/ref/pg_config-ref.sgml
View File

@@ -273,6 +273,17 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-?</></term>
<term><option>--help</></term>
<listitem>
<para>
Show help about <application>pg_config</application> command line
arguments, and exit.
</para>
</listitem>
</varlistentry>
</variablelist>
If more than one option is given, the information is printed in that order,

21
doc/src/sgml/ref/pg_ctl-ref.sgml
View File

@@ -363,6 +363,16 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>
<listitem>
<para>
Print the <application>pg_ctl</application> version and exit.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-w</option></term>
<listitem>
@@ -388,6 +398,17 @@ PostgreSQL documentation
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-?</></term>
<term><option>--help</></term>
<listitem>
<para>
Show help about <application>pg_ctl</application> command line
arguments, and exit.
</para>
</listitem>
</varlistentry>
</variablelist>
<refsect2 id="app-pg-ctl-windows-options">

2
doc/src/sgml/ref/pg_receivexlog.sgml
View File

@@ -211,7 +211,7 @@ PostgreSQL documentation
</para>
<para>
Other, less commonly used, options are also available:
Other options are also available:
<variablelist>
<varlistentry>

21
doc/src/sgml/ref/postgres-ref.sgml
View File

@@ -345,6 +345,16 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>
<listitem>
<para>
Print the <application>postgres</application> version and exit.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--<replaceable>name</replaceable>=<replaceable>value</replaceable></option></term>
<listitem>
@@ -365,6 +375,17 @@ PostgreSQL documentation
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-?</></term>
<term><option>--help</></term>
<listitem>
<para>
Show help about <application>postgres</application> command line
arguments, and exit.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>