Horton

doc: Fix DocBook XML validity

Peter Eisentraut <peter_e@gmx.net>

View on postgr.es
Commit: 3a9d430af515e9dd8a9d34a4011367e667a66521
Author: Peter Eisentraut <peter_e@gmx.net>
Date: 2014-05-07T01:28:58Z
Releases: 9.4.0 
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 bb4eefe7bf518e42c73797ea37b033a5d8a8e70a.

There is currently nothing in the build system that enforces that things
stay valid, because that requires additional tools and will receive
separate consideration.

Files

PathChange+/−
doc/src/sgml/auth-delay.sgml modified +3 −3
doc/src/sgml/auto-explain.sgml modified +24 −24
doc/src/sgml/config.sgml modified +488 −245
doc/src/sgml/dfunc.sgml modified +37 −19
doc/src/sgml/installation.sgml modified +4 −3
doc/src/sgml/libpq.sgml modified +3 −1
doc/src/sgml/logicaldecoding.sgml modified +1 −1
doc/src/sgml/pageinspect.sgml modified +21 −21
doc/src/sgml/pgfreespacemap.sgml modified +3 −3
doc/src/sgml/pgstatstatements.sgml modified +7 −9
doc/src/sgml/pgstattuple.sgml modified +3 −4
doc/src/sgml/plperl.sgml modified +157 −121
doc/src/sgml/pltcl.sgml modified +14 −9
doc/src/sgml/protocol.sgml modified +1 −2
doc/src/sgml/queries.sgml modified +8 −8
doc/src/sgml/recovery-config.sgml modified +30 −25
doc/src/sgml/ref/alter_table.sgml modified +7 −6
doc/src/sgml/ref/pg_recvlogical.sgml modified +4 −4
doc/src/sgml/ref/psql-ref.sgml modified +14 −10
doc/src/sgml/rules.sgml modified +2 −2
doc/src/sgml/runtime.sgml modified +20 −10
doc/src/sgml/sepgsql.sgml modified +12 −8
doc/src/sgml/sslinfo.sgml modified +27 −27
doc/src/sgml/textsearch.sgml modified +13 −13