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

doc: Fix DocBook XML validity

Browse Source 
The main problem is that DocBook SGML allows indexterm elements just
about everywhere, but DocBook XML is stricter.  For example, this common
pattern

    <varlistentry>
     <indexterm>...</indexterm>
     <term>...</term>
     ...
    </varlistentry>

needs to be changed to something like

    <varlistentry>
     <term>...<indexterm>...</indexterm></term>
     ...
    </varlistentry>

See also bb4eefe7bf.

There is currently nothing in the build system that enforces that things
stay valid, because that requires additional tools and will receive
separate consideration.
This commit is contained in:
Peter Eisentraut
2014-05-06 21:28:58 -04:00
parent 84288a86ac
commit 3a9d430af5
24 changed files with 903 additions and 578 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
doc/src/sgml/ref/alter_table.sgml
View File

@@ -227,12 +227,13 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable>
</varlistentry>
<varlistentry>
<indexterm>
<primary>TOAST</primary>
<secondary>per-column storage settings</secondary>
</indexterm>
<term><literal>SET STORAGE</literal></term>
<term>
<literal>SET STORAGE</literal>
<indexterm>
<primary>TOAST</primary>
<secondary>per-column storage settings</secondary>
</indexterm>
</term>
<listitem>
<para>
This form sets the storage mode for a column. This controls whether this

8
doc/src/sgml/ref/pg_recvlogical.sgml
View File

@@ -4,6 +4,10 @@ PostgreSQL documentation
-->
<refentry id="app-pgrecvlogical">
<indexterm zone="app-pgrecvlogical">
<primary>pg_recvlogical</primary>
</indexterm>
<refmeta>
<refentrytitle><application>pg_recvlogical</application></refentrytitle>
<manvolnum>1</manvolnum>
@@ -16,10 +20,6 @@ PostgreSQL documentation
streams over a walsender connection.</refpurpose>
</refnamediv>
<indexterm zone="app-pgrecvlogical">
<primary>pg_recvlogical</primary>
</indexterm>
<refsynopsisdiv>
<cmdsynopsis>
<command>pg_recvlogical</command>

24
doc/src/sgml/ref/psql-ref.sgml
View File

@@ -2731,11 +2731,13 @@ bar
<variablelist>
<varlistentry>
<indexterm>
<primary>autocommit</primary>
<secondary>psql</secondary>
</indexterm>
<term><varname>AUTOCOMMIT</varname></term>
<term>
<varname>AUTOCOMMIT</varname>
<indexterm>
<primary>autocommit</primary>
<secondary>psql</secondary>
</indexterm>
</term>
<listitem>
<para>
When <literal>on</> (the default), each SQL command is automatically
@@ -2971,11 +2973,13 @@ bar
</varlistentry>
<varlistentry>
<indexterm>
<primary>rollback</primary>
<secondary>psql</secondary>
</indexterm>
<term><varname>ON_ERROR_ROLLBACK</varname></term>
<term>
<varname>ON_ERROR_ROLLBACK</varname>
<indexterm>
<primary>rollback</primary>
<secondary>psql</secondary>
</indexterm>
</term>
<listitem>
<para>
When <literal>on</>, if a statement in a transaction block