The attached patch removes endterm attributes from xref elements and the
associated id attributes on title elements.
Older documentation toolchains could not automatically generate text for
xrefs into refentries, so we had to use the endterm attribute to tell it
which text to create. This is no longer necessary and can be removed.
In most cases, we can just rely on the automatically generated text. In
the cases where that doesn't work, use the link element instead to
create the desired text locally instead of relying on text at a remote
location.
(This also removed a few spurious warnings in the FOP build as an
incidental benefit.)
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
From 65a26804fb76825f7a98022347aca6a3d17aadb8 Mon Sep 17 00:00:00 2001
From: Peter Eisentraut
Date: Mon, 19 Jun 2017 17:52:56 -0400
Subject: [PATCH] Remove endterms and title ids
Older documentation toolchains could not automatically generate text for
xrefs into refentries, so we had to use the endterm attribute to tell it
which text to create. This is no longer necessary and can be removed.
In most cases, we can just rely on the automatically generated text. In
the cases where that doesn't work, use the link element instead to
create the desired text locally instead of relying on text at a remote
location.
---
doc/src/sgml/README.links | 4 --
doc/src/sgml/config.sgml | 3 +-
doc/src/sgml/indices.sgml | 3 +-
doc/src/sgml/maintenance.sgml | 3 +-
doc/src/sgml/queries.sgml | 7 ++-
doc/src/sgml/ref/alter_collation.sgml | 5 +-
doc/src/sgml/ref/alter_table.sgml | 3 +-
doc/src/sgml/ref/commit_prepared.sgml | 2 +-
doc/src/sgml/ref/create_aggregate.sgml | 6 +--
doc/src/sgml/ref/create_foreign_table.sgml | 2 +-
doc/src/sgml/ref/create_index.sgml | 9 ++--
doc/src/sgml/ref/create_materialized_view.sgml | 3 +-
doc/src/sgml/ref/create_table.sgml | 10 ++--
doc/src/sgml/ref/create_table_as.sgml | 3 +-
doc/src/sgml/ref/create_view.sgml | 2 +-
doc/src/sgml/ref/declare.sgml | 5 +-
doc/src/sgml/ref/delete.sgml | 4 +-
doc/src/sgml/ref/do.sgml | 2 +-
doc/src/sgml/ref/execute.sgml | 4 +-
doc/src/sgml/ref/insert.sgml | 7 ++-
doc/src/sgml/ref/lock.sgml | 3 +-
doc/src/sgml/ref/pg_dump.sgml | 12 ++---
doc/src/sgml/ref/postgres-ref.sgml | 5 +-
doc/src/sgml/ref/prepare.sgml | 2 +-
doc/src/sgml/ref/prepare_transaction.sgml | 2 +-
doc/src/sgml/ref/psql-ref.sgml | 49 ---
doc/src/sgml/ref/rollback_prepared.sgml| 2 +-
doc/src/sgml/ref/select.sgml | 67 --
doc/src/sgml/ref/update.sgml | 4 +-
doc/src/sgml/ref/values.sgml | 8 +--
30 files changed, 104 insertions(+), 137 deletions(-)
diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links
index f64b857316..4050de140c 100644
--- a/doc/src/sgml/README.links
+++ b/doc/src/sgml/README.links
@@ -19,10 +19,6 @@ Intra-document Linking
linkend=
controls the target of the link/xref, required
-endterm=
- for , allows the text of the link/xref to be taken from a
- different link target title
-
External Linking
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 533faf060d..750db427dc 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -5894,8 +5894,7 @@ Automatic Vacuuming
These settings control the behavior of the
autovacuum
feature. Refer to for more information.
Note that many of these settings can be overridden on a per-table
- basis; see .
+ basis; see .
diff --git a/doc/src/sgml/indices.sgml b/doc/src/sgml/indices.sgml
index 0818196e76..f60d16e812 100644
--- a/doc/src/sgml/indices.sgml
+++ b/doc/src/sgml/indices.sgml
@@ -98,8 +98,7 @@ Introduction
In production environments this is often unacceptable.
It is possible to allow writes to occur in parallel with index
creation, but there are several caveats to be aware of —
- for more information see .
+ for more information see .
diff --git a/doc/src/sgml/maintenance.sgml b/doc/src/sgml/maintenance.sgml
index 4a68ec3b40..e4341e252c 100644
--- a/doc/src/sgml/maintenance.sgml
+++ b/doc/src/sgml/maintenance.sgml
@@ -807,8 +807,7 @@ The Autovacuum Daemon
The default thresholds and scale factors are taken from
postgresql.conf, but it is possible to override them
(and many other autovacuum control parameters) on a per-table basis; see
- for more information.
+ for more information.
