pgsql: doc: Improve DocBook XML validity - Mailing list pgsql-committers

From Peter Eisentraut
Subject pgsql: doc: Improve DocBook XML validity
Date
Msg-id E1WHlTx-0006iS-51@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
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(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: pgsql: Prefer pg_any_to_server/pg_server_to_any over pg_do_encoding_con
Next
From: Robert Haas
Date:
Subject: pgsql: Remove a couple of comments from the pg_lsn regression test.