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

doc: Fix DocBook XML validity

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

View File

@ -164,10 +164,10 @@ CTRL-C
<sect1 id="logicaldecoding-explanation">
<title>Logical Decoding Concepts</title>
<sect2>
<title>Logical Decoding</title>
<indexterm>
<primary>Logical Decoding</primary>
</indexterm>
<title>Logical Decoding</title>
<para>
Logical decoding is the process of extracting all persistent changes
to a database's tables into a coherent, easy to understand format which