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

Remove unnecessary xref endterm attributes and title ids

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

33
doc/src/sgml/ref/begin.sgml
View File

@@ -1,11 +1,11 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/begin.sgml,v 1.38 2009/09/18 05:00:41 petere Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/begin.sgml,v 1.39 2010/04/03 07:22:57 petere Exp $
PostgreSQL documentation
-->
<refentry id="SQL-BEGIN">
<refmeta>
<refentrytitle id="SQL-BEGIN-TITLE">BEGIN</refentrytitle>
<refentrytitle>BEGIN</refentrytitle>
<manvolnum>7</manvolnum>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
@@ -37,8 +37,8 @@ BEGIN [ WORK | TRANSACTION ] [ <replaceable class="parameter">transaction_mode</
<command>BEGIN</command> initiates a transaction block, that is,
all statements after a <command>BEGIN</command> command will be
executed in a single transaction until an explicit <xref
linkend="sql-commit" endterm="sql-commit-title"> or <xref
linkend="sql-rollback" endterm="sql-rollback-title"> is given.
linkend="sql-commit"> or <xref
linkend="sql-rollback"> is given.
By default (without <command>BEGIN</command>),
<productname>PostgreSQL</productname> executes
transactions in <quote>autocommit</quote> mode, that is, each
@@ -59,7 +59,7 @@ BEGIN [ WORK | TRANSACTION ] [ <replaceable class="parameter">transaction_mode</
<para>
If the isolation level or read/write mode is specified, the new
transaction has those characteristics, as if
<xref linkend="sql-set-transaction" endterm="sql-set-transaction-title">
<xref linkend="sql-set-transaction">
was executed.
</para>
</refsect1>
@@ -80,8 +80,7 @@ BEGIN [ WORK | TRANSACTION ] [ <replaceable class="parameter">transaction_mode</
</variablelist>
<para>
Refer to <xref linkend="sql-set-transaction"
endterm="sql-set-transaction-title"> for information on the meaning
Refer to <xref linkend="sql-set-transaction"> for information on the meaning
of the other parameters to this statement.
</para>
</refsect1>
@@ -90,14 +89,13 @@ BEGIN [ WORK | TRANSACTION ] [ <replaceable class="parameter">transaction_mode</
<title>Notes</title>
<para>
<xref linkend="sql-start-transaction"
endterm="sql-start-transaction-title"> has the same functionality
<xref linkend="sql-start-transaction"> has the same functionality
as <command>BEGIN</>.
</para>
<para>
Use <xref linkend="SQL-COMMIT" endterm="SQL-COMMIT-TITLE"> or
<xref linkend="SQL-ROLLBACK" endterm="SQL-ROLLBACK-TITLE">
Use <xref linkend="SQL-COMMIT"> or
<xref linkend="SQL-ROLLBACK">
to terminate a transaction block.
</para>
@@ -105,7 +103,7 @@ BEGIN [ WORK | TRANSACTION ] [ <replaceable class="parameter">transaction_mode</
Issuing <command>BEGIN</> when already inside a transaction block will
provoke a warning message. The state of the transaction is not affected.
To nest transactions within a transaction block, use savepoints
(see <xref linkend="sql-savepoint" endterm="sql-savepoint-title">).
(see <xref linkend="sql-savepoint">).
</para>
<para>
@@ -133,8 +131,7 @@ BEGIN;
<para>
<command>BEGIN</command> is a <productname>PostgreSQL</productname>
language extension. It is equivalent to the SQL-standard command
<xref linkend="sql-start-transaction"
endterm="sql-start-transaction-title">, whose reference page
<xref linkend="sql-start-transaction">, whose reference page
contains additional compatibility information.
</para>
@@ -149,10 +146,10 @@ BEGIN;
<title>See Also</title>
<simplelist type="inline">
<member><xref linkend="sql-commit" endterm="sql-commit-title"></member>
<member><xref linkend="sql-rollback" endterm="sql-rollback-title"></member>
<member><xref linkend="sql-start-transaction" endterm="sql-start-transaction-title"></member>
<member><xref linkend="sql-savepoint" endterm="sql-savepoint-title"></member>
<member><xref linkend="sql-commit"></member>
<member><xref linkend="sql-rollback"></member>
<member><xref linkend="sql-start-transaction"></member>
<member><xref linkend="sql-savepoint"></member>
</simplelist>
</refsect1>
</refentry>