database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-08-27 07:42:10 +03:00
Code Activity

Don't use SGML empty tags

Browse Source 
For DocBook XML compatibility, don't use SGML empty tags (</>) anymore,
replace by the full tag name.  Add a warning option to catch future
occurrences.

Alexander Lakhin, Jürgen Purtz
This commit is contained in:
Peter Eisentraut
2017-10-08 21:44:17 -04:00
parent 6ecabead4b
commit c29c578908
337 changed files with 31636 additions and 31635 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -34,15 +34,15 @@ PostgreSQL documentation
<para>
<application>createuser</application> creates a
new <productname>PostgreSQL</productname> user (or more precisely, a role).
Only superusers and users with <literal>CREATEROLE</> privilege can create
Only superusers and users with <literal>CREATEROLE</literal> privilege can create
new users, so <application>createuser</application> must be
invoked by someone who can connect as a superuser or a user with
<literal>CREATEROLE</> privilege.
<literal>CREATEROLE</literal> privilege.
</para>
<para>
If you wish to create a new superuser, you must connect as a
superuser, not merely with <literal>CREATEROLE</> privilege.
superuser, not merely with <literal>CREATEROLE</literal> privilege.
Being a superuser implies the ability to bypass all access permission
checks within the database, so superuserdom should not be granted lightly.
</para>
@@ -61,7 +61,7 @@ PostgreSQL documentation
<title>Options</title>
<para>
<application>createuser</> accepts the following command-line arguments:
<application>createuser</application> accepts the following command-line arguments:
<variablelist>
<varlistentry>
@@ -77,8 +77,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-c <replaceable class="parameter">number</replaceable></></term>
<term><option>--connection-limit=<replaceable class="parameter">number</replaceable></></term>
<term><option>-c <replaceable class="parameter">number</replaceable></option></term>
<term><option>--connection-limit=<replaceable class="parameter">number</replaceable></option></term>
<listitem>
<para>
Set a maximum number of connections for the new user.
@@ -88,8 +88,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-d</></term>
<term><option>--createdb</></term>
<term><option>-d</option></term>
<term><option>--createdb</option></term>
<listitem>
<para>
The new user will be allowed to create databases.
@@ -98,8 +98,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-D</></term>
<term><option>--no-createdb</></term>
<term><option>-D</option></term>
<term><option>--no-createdb</option></term>
<listitem>
<para>
The new user will not be allowed to create databases. This is the
@@ -109,8 +109,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-e</></term>
<term><option>--echo</></term>
<term><option>-e</option></term>
<term><option>--echo</option></term>
<listitem>
<para>
Echo the commands that <application>createuser</application> generates
@@ -120,8 +120,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-E</></term>
<term><option>--encrypted</></term>
<term><option>-E</option></term>
<term><option>--encrypted</option></term>
<listitem>
<para>
This option is obsolete but still accepted for backward
@@ -131,21 +131,21 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-g <replaceable class="parameter">role</replaceable></></term>
<term><option>--role=<replaceable class="parameter">role</replaceable></></term>
<term><option>-g <replaceable class="parameter">role</replaceable></option></term>
<term><option>--role=<replaceable class="parameter">role</replaceable></option></term>
<listitem>
<para>
Indicates role to which this role will be added immediately as a new
member. Multiple roles to which this role will be added as a member
can be specified by writing multiple
<option>-g</> switches.
<option>-g</option> switches.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-i</></term>
<term><option>--inherit</></term>
<term><option>-i</option></term>
<term><option>--inherit</option></term>
<listitem>
<para>
The new role will automatically inherit privileges of roles
@@ -156,8 +156,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-I</></term>
<term><option>--no-inherit</></term>
<term><option>-I</option></term>
<term><option>--no-inherit</option></term>
<listitem>
<para>
The new role will not automatically inherit privileges of roles
@@ -167,7 +167,7 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>--interactive</></term>
<term><option>--interactive</option></term>
<listitem>
<para>
Prompt for the user name if none is specified on the command line, and
@@ -181,8 +181,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-l</></term>
<term><option>--login</></term>
<term><option>-l</option></term>
<term><option>--login</option></term>
<listitem>
<para>
The new user will be allowed to log in (that is, the user name
@@ -193,8 +193,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-L</></term>
<term><option>--no-login</></term>
<term><option>-L</option></term>
<term><option>--no-login</option></term>
<listitem>
<para>
The new user will not be allowed to log in.
@@ -205,8 +205,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-P</></term>
<term><option>--pwprompt</></term>
<term><option>-P</option></term>
<term><option>--pwprompt</option></term>
<listitem>
<para>
If given, <application>createuser</application> will issue a prompt for
@@ -217,19 +217,19 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-r</></term>
<term><option>--createrole</></term>
<term><option>-r</option></term>
<term><option>--createrole</option></term>
<listitem>
<para>
The new user will be allowed to create new roles (that is,
this user will have <literal>CREATEROLE</> privilege).
this user will have <literal>CREATEROLE</literal> privilege).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-R</></term>
<term><option>--no-createrole</></term>
<term><option>-R</option></term>
<term><option>--no-createrole</option></term>
<listitem>
<para>
The new user will not be allowed to create new roles. This is the
@@ -239,8 +239,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-s</></term>
<term><option>--superuser</></term>
<term><option>-s</option></term>
<term><option>--superuser</option></term>
<listitem>
<para>
The new user will be a superuser.
@@ -249,8 +249,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-S</></term>
<term><option>--no-superuser</></term>
<term><option>-S</option></term>
<term><option>--no-superuser</option></term>
<listitem>
<para>
The new user will not be a superuser. This is the default.
@@ -259,8 +259,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-V</></term>
<term><option>--version</></term>
<term><option>-V</option></term>
<term><option>--version</option></term>
<listitem>
<para>
Print the <application>createuser</application> version and exit.
@@ -269,7 +269,7 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>--replication</></term>
<term><option>--replication</option></term>
<listitem>
<para>
The new user will have the <literal>REPLICATION</literal> privilege,
@@ -280,7 +280,7 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>--no-replication</></term>
<term><option>--no-replication</option></term>
<listitem>
<para>
The new user will not have the <literal>REPLICATION</literal>
@@ -291,8 +291,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-?</></term>
<term><option>--help</></term>
<term><option>-?</option></term>
<term><option>--help</option></term>
<listitem>
<para>
Show help about <application>createuser</application> command line
@@ -310,8 +310,8 @@ PostgreSQL documentation
<variablelist>
<varlistentry>
<term><option>-h <replaceable class="parameter">host</replaceable></></term>
<term><option>--host=<replaceable class="parameter">host</replaceable></></term>
<term><option>-h <replaceable class="parameter">host</replaceable></option></term>
<term><option>--host=<replaceable class="parameter">host</replaceable></option></term>
<listitem>
<para>
Specifies the host name of the machine on which the
@@ -323,8 +323,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-p <replaceable class="parameter">port</replaceable></></term>
<term><option>--port=<replaceable class="parameter">port</replaceable></></term>
<term><option>-p <replaceable class="parameter">port</replaceable></option></term>
<term><option>--port=<replaceable class="parameter">port</replaceable></option></term>
<listitem>
<para>
Specifies the TCP port or local Unix domain socket file
@@ -335,8 +335,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-U <replaceable class="parameter">username</replaceable></></term>
<term><option>--username=<replaceable class="parameter">username</replaceable></></term>
<term><option>-U <replaceable class="parameter">username</replaceable></option></term>
<term><option>--username=<replaceable class="parameter">username</replaceable></option></term>
<listitem>
<para>
User name to connect as (not the user name to create).
@@ -345,8 +345,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-w</></term>
<term><option>--no-password</></term>
<term><option>-w</option></term>
<term><option>--no-password</option></term>
<listitem>
<para>
Never issue a password prompt. If the server requires
@@ -360,8 +360,8 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
<term><option>-W</></term>
<term><option>--password</></term>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
<para>
Force <application>createuser</application> to prompt for a
@@ -375,7 +375,7 @@ PostgreSQL documentation
for a password if the server demands password authentication.
However, <application>createuser</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
In some cases it is worth typing <option>-W</option> to avoid the extra
connection attempt.
</para>
</listitem>
@@ -403,8 +403,8 @@ PostgreSQL documentation
</variablelist>
<para>
This utility, like most other <productname>PostgreSQL</> utilities,
also uses the environment variables supported by <application>libpq</>
This utility, like most other <productname>PostgreSQL</productname> utilities,
also uses the environment variables supported by <application>libpq</application>
(see <xref linkend="libpq-envars">).
</para>
@@ -451,7 +451,7 @@ PostgreSQL documentation
<para>
To create the same user <literal>joe</literal> using the
server on host <literal>eden</>, port 5000, with attributes explicitly specified,
server on host <literal>eden</literal>, port 5000, with attributes explicitly specified,
taking a look at the underlying command:
<screen>
<prompt>$ </prompt><userinput>createuser -h eden -p 5000 -S -D -R -e joe</userinput>