1
0
mirror of https://github.com/postgres/postgres.git synced 2025-12-21 05:21:08 +03:00

Remove unnecessary xref endterm attributes and title ids

The endterm attribute is mainly useful when the toolchain does not support
automatic link target text generation for a particular situation.  In  the
past, this was required by the man page tools for all reference page links,
but that is no longer the case, and it now actually gets in the way of
proper automatic link text generation.  The only remaining use cases are
currently xrefs to refsects.
This commit is contained in:
Peter Eisentraut
2010-04-03 07:23:02 +00:00
parent 7969145483
commit 6dcce3985b
203 changed files with 1132 additions and 1195 deletions

View File

@@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/user-manag.sgml,v 1.42 2010/02/03 17:25:06 momjian Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/user-manag.sgml,v 1.43 2010/04/03 07:22:56 petere Exp $ -->
<chapter id="user-manag">
<title>Database Roles and Privileges</title>
@@ -53,7 +53,7 @@
maintain a correspondence, but this is not required. Database roles
are global across a database cluster installation (and not
per individual database). To create a role use the <xref
linkend="sql-createrole" endterm="sql-createrole-title"> SQL command:
linkend="sql-createrole"> SQL command:
<synopsis>
CREATE ROLE <replaceable>name</replaceable>;
</synopsis>
@@ -62,7 +62,7 @@ CREATE ROLE <replaceable>name</replaceable>;
double-quoted. (In practice, you will usually want to add additional
options, such as <literal>LOGIN</>, to the command. More details appear
below.) To remove an existing role, use the analogous
<xref linkend="sql-droprole" endterm="sql-droprole-title"> command:
<xref linkend="sql-droprole"> command:
<synopsis>
DROP ROLE <replaceable>name</replaceable>;
</synopsis>
@@ -228,8 +228,8 @@ CREATE USER <replaceable>name</replaceable>;
A role's attributes can be modified after creation with
<command>ALTER ROLE</command>.<indexterm><primary>ALTER ROLE</></>
See the reference pages for the <xref linkend="sql-createrole"
endterm="sql-createrole-title"> and <xref linkend="sql-alterrole"
endterm="sql-alterrole-title"> commands for details.
> and <xref linkend="sql-alterrole"
> commands for details.
</para>
<tip>
@@ -297,7 +297,7 @@ ALTER ROLE myname SET statement_timeout = '5min';
<literal>EXECUTE</>, and <literal>USAGE</>.
For more information on the different types of privileges supported by
<productname>PostgreSQL</productname>, see the
<xref linkend="sql-grant" endterm="sql-grant-title"> reference page.
<xref linkend="sql-grant"> reference page.
</para>
<para>
@@ -316,7 +316,7 @@ GRANT UPDATE ON accounts TO joe;
<para>
To revoke a privilege, use the fittingly named
<xref linkend="sql-revoke" endterm="sql-revoke-title"> command:
<xref linkend="sql-revoke"> command:
<programlisting>
REVOKE ALL ON accounts FROM PUBLIC;
</programlisting>
@@ -366,8 +366,8 @@ CREATE ROLE <replaceable>name</replaceable>;
<para>
Once the group role exists, you can add and remove members using the
<xref linkend="sql-grant" endterm="sql-grant-title"> and
<xref linkend="sql-revoke" endterm="sql-revoke-title"> commands:
<xref linkend="sql-grant"> and
<xref linkend="sql-revoke"> commands:
<synopsis>
GRANT <replaceable>group_role</replaceable> TO <replaceable>role1</replaceable>, ... ;
REVOKE <replaceable>group_role</replaceable> FROM <replaceable>role1</replaceable>, ... ;
@@ -382,7 +382,7 @@ REVOKE <replaceable>group_role</replaceable> FROM <replaceable>role1</replaceabl
<para>
The members of a group role can use the privileges of the role in two
ways. First, every member of a group can explicitly do
<xref linkend="sql-set-role" endterm="sql-set-role-title"> to
<xref linkend="sql-set-role"> to
temporarily <quote>become</> the group role. In this state, the
database session has access to the privileges of the group role rather
than the original login role, and any database objects created are
@@ -466,7 +466,7 @@ RESET ROLE;
<para>
To destroy a group role, use <xref
linkend="sql-droprole" endterm="sql-droprole-title">:
linkend="sql-droprole">:
<synopsis>
DROP ROLE <replaceable>name</replaceable>;
</synopsis>