pgsql: doc: Improve DocBook XML validity

doc: Improve DocBook XML validity

DocBook XML is superficially compatible with DocBook SGML but has a
slightly stricter DTD that we have been violating in a few cases.
Although XSLT doesn't care whether the document is valid, the style
sheets don't necessarily process invalid documents correctly, so we need
to work toward fixing this.

This first commit moves the indexterms in refentry elements to an
allowed position. It has no impact on the output.

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/bb4eefe7bf518e42c73797ea37b033a5d8a8e70a

Modified Files
--------------
doc/src/sgml/dblink.sgml | 152 +++++++++---------
doc/src/sgml/oid2name.sgml | 8 +-
doc/src/sgml/pg_xlogdump.sgml | 8 +-
doc/src/sgml/pgarchivecleanup.sgml | 8 +-
doc/src/sgml/pgbench.sgml | 8 +-
doc/src/sgml/pgstandby.sgml | 8 +-
doc/src/sgml/pgtestfsync.sgml | 8 +-
doc/src/sgml/pgtesttiming.sgml | 8 +-
doc/src/sgml/pgupgrade.sgml | 8 +-
doc/src/sgml/ref/abort.sgml | 8 +-
doc/src/sgml/ref/alter_aggregate.sgml | 8 +-
doc/src/sgml/ref/alter_collation.sgml | 8 +-
doc/src/sgml/ref/alter_conversion.sgml | 8 +-
doc/src/sgml/ref/alter_database.sgml | 8 +-
doc/src/sgml/ref/alter_default_privileges.sgml | 8 +-
doc/src/sgml/ref/alter_domain.sgml | 8 +-
doc/src/sgml/ref/alter_event_trigger.sgml | 8 +-
doc/src/sgml/ref/alter_extension.sgml | 8 +-
doc/src/sgml/ref/alter_foreign_data_wrapper.sgml | 8 +-
doc/src/sgml/ref/alter_foreign_table.sgml | 8 +-
doc/src/sgml/ref/alter_function.sgml | 8 +-
doc/src/sgml/ref/alter_group.sgml | 8 +-
doc/src/sgml/ref/alter_index.sgml | 8 +-
doc/src/sgml/ref/alter_language.sgml | 8 +-
doc/src/sgml/ref/alter_large_object.sgml | 8 +-
doc/src/sgml/ref/alter_materialized_view.sgml | 8 +-
doc/src/sgml/ref/alter_opclass.sgml | 8 +-
doc/src/sgml/ref/alter_operator.sgml | 8 +-
doc/src/sgml/ref/alter_opfamily.sgml | 8 +-
doc/src/sgml/ref/alter_role.sgml | 8 +-
doc/src/sgml/ref/alter_rule.sgml | 8 +-
doc/src/sgml/ref/alter_schema.sgml | 8 +-
doc/src/sgml/ref/alter_sequence.sgml | 8 +-
doc/src/sgml/ref/alter_server.sgml | 8 +-
doc/src/sgml/ref/alter_system.sgml | 8 +-
doc/src/sgml/ref/alter_table.sgml | 8 +-
doc/src/sgml/ref/alter_tablespace.sgml | 8 +-
doc/src/sgml/ref/alter_trigger.sgml | 8 +-
doc/src/sgml/ref/alter_tsconfig.sgml | 8 +-
doc/src/sgml/ref/alter_tsdictionary.sgml | 8 +-
doc/src/sgml/ref/alter_tsparser.sgml | 8 +-
doc/src/sgml/ref/alter_tstemplate.sgml | 8 +-
doc/src/sgml/ref/alter_type.sgml | 8 +-
doc/src/sgml/ref/alter_user.sgml | 8 +-
doc/src/sgml/ref/alter_user_mapping.sgml | 8 +-
doc/src/sgml/ref/alter_view.sgml | 8 +-
doc/src/sgml/ref/analyze.sgml | 8 +-
doc/src/sgml/ref/begin.sgml | 8 +-
doc/src/sgml/ref/checkpoint.sgml | 8 +-
doc/src/sgml/ref/close.sgml | 18 +--
doc/src/sgml/ref/cluster.sgml | 8 +-
doc/src/sgml/ref/clusterdb.sgml | 8 +-
doc/src/sgml/ref/comment.sgml | 8 +-
doc/src/sgml/ref/commit.sgml | 8 +-
doc/src/sgml/ref/commit_prepared.sgml | 8 +-
doc/src/sgml/ref/copy.sgml | 8 +-
doc/src/sgml/ref/create_aggregate.sgml | 8 +-
doc/src/sgml/ref/create_cast.sgml | 8 +-
doc/src/sgml/ref/create_collation.sgml | 8 +-
doc/src/sgml/ref/create_conversion.sgml | 8 +-
doc/src/sgml/ref/create_database.sgml | 8 +-
doc/src/sgml/ref/create_domain.sgml | 8 +-
doc/src/sgml/ref/create_event_trigger.sgml | 8 +-
doc/src/sgml/ref/create_extension.sgml | 8 +-
doc/src/sgml/ref/create_foreign_data_wrapper.sgml | 8 +-
doc/src/sgml/ref/create_foreign_table.sgml | 8 +-
doc/src/sgml/ref/create_function.sgml | 8 +-
doc/src/sgml/ref/create_group.sgml | 8 +-
doc/src/sgml/ref/create_index.sgml | 8 +-
doc/src/sgml/ref/create_language.sgml | 8 +-
doc/src/sgml/ref/create_materialized_view.sgml | 8 +-
doc/src/sgml/ref/create_opclass.sgml | 8 +-
doc/src/sgml/ref/create_operator.sgml | 8 +-
doc/src/sgml/ref/create_opfamily.sgml | 8 +-
doc/src/sgml/ref/create_role.sgml | 8 +-
doc/src/sgml/ref/create_rule.sgml | 8 +-
doc/src/sgml/ref/create_schema.sgml | 8 +-
doc/src/sgml/ref/create_sequence.sgml | 8 +-
doc/src/sgml/ref/create_server.sgml | 8 +-
doc/src/sgml/ref/create_table.sgml | 8 +-
doc/src/sgml/ref/create_table_as.sgml | 8 +-
doc/src/sgml/ref/create_tablespace.sgml | 8 +-
doc/src/sgml/ref/create_trigger.sgml | 8 +-
doc/src/sgml/ref/create_tsconfig.sgml | 8 +-
doc/src/sgml/ref/create_tsdictionary.sgml | 8 +-
doc/src/sgml/ref/create_tsparser.sgml | 8 +-
doc/src/sgml/ref/create_tstemplate.sgml | 8 +-
doc/src/sgml/ref/create_type.sgml | 8 +-
doc/src/sgml/ref/create_user.sgml | 8 +-
doc/src/sgml/ref/create_user_mapping.sgml | 8 +-
doc/src/sgml/ref/create_view.sgml | 8 +-
doc/src/sgml/ref/createdb.sgml | 8 +-
doc/src/sgml/ref/createlang.sgml | 8 +-
doc/src/sgml/ref/createuser.sgml | 8 +-
doc/src/sgml/ref/deallocate.sgml | 18 +--
doc/src/sgml/ref/declare.sgml | 18 +--
doc/src/sgml/ref/delete.sgml | 8 +-
doc/src/sgml/ref/discard.sgml | 8 +-
doc/src/sgml/ref/do.sgml | 16 +-
doc/src/sgml/ref/drop_aggregate.sgml | 8 +-
doc/src/sgml/ref/drop_cast.sgml | 8 +-
doc/src/sgml/ref/drop_collation.sgml | 8 +-
doc/src/sgml/ref/drop_conversion.sgml | 8 +-
doc/src/sgml/ref/drop_database.sgml | 8 +-
doc/src/sgml/ref/drop_domain.sgml | 8 +-
doc/src/sgml/ref/drop_event_trigger.sgml | 8 +-
doc/src/sgml/ref/drop_extension.sgml | 8 +-
doc/src/sgml/ref/drop_foreign_data_wrapper.sgml | 8 +-
doc/src/sgml/ref/drop_foreign_table.sgml | 8 +-
doc/src/sgml/ref/drop_function.sgml | 8 +-
doc/src/sgml/ref/drop_group.sgml | 8 +-
doc/src/sgml/ref/drop_index.sgml | 8 +-
doc/src/sgml/ref/drop_language.sgml | 8 +-
doc/src/sgml/ref/drop_materialized_view.sgml | 8 +-
doc/src/sgml/ref/drop_opclass.sgml | 8 +-
doc/src/sgml/ref/drop_operator.sgml | 8 +-
doc/src/sgml/ref/drop_opfamily.sgml | 8 +-
doc/src/sgml/ref/drop_owned.sgml | 8 +-
doc/src/sgml/ref/drop_role.sgml | 8 +-
doc/src/sgml/ref/drop_rule.sgml | 8 +-
doc/src/sgml/ref/drop_schema.sgml | 8 +-
doc/src/sgml/ref/drop_sequence.sgml | 8 +-
doc/src/sgml/ref/drop_server.sgml | 8 +-
doc/src/sgml/ref/drop_table.sgml | 8 +-
doc/src/sgml/ref/drop_tablespace.sgml | 8 +-
doc/src/sgml/ref/drop_trigger.sgml | 8 +-
doc/src/sgml/ref/drop_tsconfig.sgml | 8 +-
doc/src/sgml/ref/drop_tsdictionary.sgml | 8 +-
doc/src/sgml/ref/drop_tsparser.sgml | 8 +-
doc/src/sgml/ref/drop_tstemplate.sgml | 8 +-
doc/src/sgml/ref/drop_type.sgml | 8 +-
doc/src/sgml/ref/drop_user.sgml | 8 +-
doc/src/sgml/ref/drop_user_mapping.sgml | 8 +-
doc/src/sgml/ref/drop_view.sgml | 8 +-
doc/src/sgml/ref/dropdb.sgml | 8 +-
doc/src/sgml/ref/droplang.sgml | 8 +-
doc/src/sgml/ref/dropuser.sgml | 8 +-
doc/src/sgml/ref/ecpg-ref.sgml | 8 +-
doc/src/sgml/ref/end.sgml | 8 +-
doc/src/sgml/ref/execute.sgml | 18 +--
doc/src/sgml/ref/explain.sgml | 22 +--
doc/src/sgml/ref/fetch.sgml | 18 +--
doc/src/sgml/ref/grant.sgml | 8 +-
doc/src/sgml/ref/initdb.sgml | 8 +-
doc/src/sgml/ref/insert.sgml | 8 +-
doc/src/sgml/ref/listen.sgml | 8 +-
doc/src/sgml/ref/load.sgml | 8 +-
doc/src/sgml/ref/lock.sgml | 8 +-
doc/src/sgml/ref/move.sgml | 18 +--
doc/src/sgml/ref/notify.sgml | 8 +-
doc/src/sgml/ref/pg_basebackup.sgml | 8 +-
doc/src/sgml/ref/pg_config-ref.sgml | 8 +-
doc/src/sgml/ref/pg_controldata.sgml | 8 +-
doc/src/sgml/ref/pg_ctl-ref.sgml | 8 +-
doc/src/sgml/ref/pg_dump.sgml | 8 +-
doc/src/sgml/ref/pg_dumpall.sgml | 8 +-
doc/src/sgml/ref/pg_isready.sgml | 8 +-
doc/src/sgml/ref/pg_receivexlog.sgml | 8 +-
doc/src/sgml/ref/pg_resetxlog.sgml | 8 +-
doc/src/sgml/ref/pg_restore.sgml | 8 +-
doc/src/sgml/ref/postgres-ref.sgml | 8 +-
doc/src/sgml/ref/postmaster.sgml | 8 +-
doc/src/sgml/ref/prepare.sgml | 18 +--
doc/src/sgml/ref/prepare_transaction.sgml | 8 +-
doc/src/sgml/ref/psql-ref.sgml | 8 +-
doc/src/sgml/ref/reassign_owned.sgml | 8 +-
doc/src/sgml/ref/refresh_materialized_view.sgml | 8 +-
doc/src/sgml/ref/reindex.sgml | 8 +-
doc/src/sgml/ref/reindexdb.sgml | 8 +-
doc/src/sgml/ref/release_savepoint.sgml | 18 +--
doc/src/sgml/ref/reset.sgml | 8 +-
doc/src/sgml/ref/revoke.sgml | 8 +-
doc/src/sgml/ref/rollback.sgml | 8 +-
doc/src/sgml/ref/rollback_prepared.sgml | 8 +-
doc/src/sgml/ref/rollback_to.sgml | 18 +--
doc/src/sgml/ref/savepoint.sgml | 18 +--
doc/src/sgml/ref/security_label.sgml | 8 +-
doc/src/sgml/ref/select.sgml | 26 +--
doc/src/sgml/ref/select_into.sgml | 8 +-
doc/src/sgml/ref/set.sgml | 8 +-
doc/src/sgml/ref/set_constraints.sgml | 8 +-
doc/src/sgml/ref/set_role.sgml | 8 +-
doc/src/sgml/ref/set_session_auth.sgml | 8 +-
doc/src/sgml/ref/set_transaction.sgml | 22 +--
doc/src/sgml/ref/show.sgml | 8 +-
doc/src/sgml/ref/start_transaction.sgml | 8 +-
doc/src/sgml/ref/truncate.sgml | 8 +-
doc/src/sgml/ref/unlisten.sgml | 8 +-
doc/src/sgml/ref/update.sgml | 8 +-
doc/src/sgml/ref/vacuum.sgml | 8 +-
doc/src/sgml/ref/vacuumdb.sgml | 8 +-
doc/src/sgml/ref/values.sgml | 8 +-
doc/src/sgml/spi.sgml | 176 ++++++++++-----------
doc/src/sgml/vacuumlo.sgml | 8 +-
194 files changed, 1009 insertions(+), 1009 deletions(-)