Add xreflabels to /contrib manuals so links appear correct. Also update

README.links to explain xref properly.

diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links
index 8608859eac6d251d56ad0df2b748d6c9365e9f74..2668b00d7f5d48b6013e376233939d0e94fdc2e5 100644 (file)
--- a/doc/src/sgml/README.links
+++ b/doc/src/sgml/README.links
@@ -7,8 +7,8 @@ Intra-document Linking
 ----------------------
 
 
-   use to get link text from the title of the target link; has no
-   close tag
+   use to get chapter/section # from the title of the target
+   link, or xreflabel if defined at the target; has no close tag
    http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
 
 
@@ -28,7 +28,8 @@ External Linking
 
 
    like , but uses a URL (not a document target);  requires
-   ; if no text is specified, the URL appears as the link text
+   ; if no text is specified, the URL appears as the link
+   text
    http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html
 
 url=
@@ -40,4 +41,5 @@ Guidelines
 
 o  If you want to supply text, use , else 
 o  Do not use text with  so the URL appears in printed output
-o  You can supply text at the target location with 'xreflabel'
+o  Specific nouns like GUC variables, SQL commands, and contrib modules
+   usually have xreflabels

diff --git a/doc/src/sgml/adminpack.sgml b/doc/src/sgml/adminpack.sgml
index 27d003432978dbf64b0253a633c2cbc9d646e4e0..9b72f34eadc236038ce97557f46efdc8ccf3a50f 100644 (file)
--- a/doc/src/sgml/adminpack.sgml
+++ b/doc/src/sgml/adminpack.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="adminpack">
  adminpack
 
  

diff --git a/doc/src/sgml/auth-delay.sgml b/doc/src/sgml/auth-delay.sgml
index 9f1f3f645af0e946eb27b8a3272a40c57b718079..b91a7ecda7aea7a611e0feb268b2bf4b47000d76 100644 (file)
--- a/doc/src/sgml/auth-delay.sgml
+++ b/doc/src/sgml/auth-delay.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="auth_delay">
  auth_delay
 
  

diff --git a/doc/src/sgml/auto-explain.sgml b/doc/src/sgml/auto-explain.sgml
index 405e3f72b437377d304bdc88ab910e71d057e1a1..b16f9064ffc05d86637c054bc7b38221988b11db 100644 (file)
--- a/doc/src/sgml/auto-explain.sgml
+++ b/doc/src/sgml/auto-explain.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="auto_explain">
  auto_explain
 
  

diff --git a/doc/src/sgml/btree-gin.sgml b/doc/src/sgml/btree-gin.sgml
index 632bd1e53af346ec39a104537e655c2b64d1aaa0..42b9e97b72a1f9191c51dc6d43694cc148dd1855 100644 (file)
--- a/doc/src/sgml/btree-gin.sgml
+++ b/doc/src/sgml/btree-gin.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="btree_gin">
  btree_gin
 
  

diff --git a/doc/src/sgml/btree-gist.sgml b/doc/src/sgml/btree-gist.sgml
index af3f707bb9c73c6876f12b9772a8fbb25dd0a8db..e52971f3d9e2e0615eccf965676a81efbc9ba1db 100644 (file)
--- a/doc/src/sgml/btree-gist.sgml
+++ b/doc/src/sgml/btree-gist.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="btree_gist">
  btree_gist
 
  

diff --git a/doc/src/sgml/chkpass.sgml b/doc/src/sgml/chkpass.sgml
index b9b3c08c25b52d9bf56b691127b7b2ae3154c7fe..9f682d898163bad2a15d2c7dc94e6918fcd59678 100644 (file)
--- a/doc/src/sgml/chkpass.sgml
+++ b/doc/src/sgml/chkpass.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="chkpass">
  chkpass
 
  

diff --git a/doc/src/sgml/citext.sgml b/doc/src/sgml/citext.sgml
index 68a2aa4cd3f7767d05b5fe1114b49e03075d5e58..8cbde88a3e77b8f18f104f9375366a7abf2c2b2d 100644 (file)
--- a/doc/src/sgml/citext.sgml
+++ b/doc/src/sgml/citext.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="citext">
  citext
 
  

diff --git a/doc/src/sgml/contrib-spi.sgml b/doc/src/sgml/contrib-spi.sgml
index 55e5ce264925f60ef6ab7f9db4eec9facf79cdf0..3287c18d27d5f9ca0eea46f523646891e9f435a4 100644 (file)
--- a/doc/src/sgml/contrib-spi.sgml
+++ b/doc/src/sgml/contrib-spi.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="spi">
  spi
 
  

diff --git a/doc/src/sgml/cube.sgml b/doc/src/sgml/cube.sgml
index 0fcbf21be61e146fe6039aeb52566074a7afb249..e2da68556d561a870e3a9a89de21f4e625a64ce5 100644 (file)
--- a/doc/src/sgml/cube.sgml
+++ b/doc/src/sgml/cube.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="cube">
  cube
 
  

diff --git a/doc/src/sgml/dblink.sgml b/doc/src/sgml/dblink.sgml
index 295544e54e1a3fac0d038da872a25172a3e68120..22551402e3d104ec598d061acb36605ea5c3b642 100644 (file)
--- a/doc/src/sgml/dblink.sgml
+++ b/doc/src/sgml/dblink.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="dblink">
  dblink
 
  

diff --git a/doc/src/sgml/dict-int.sgml b/doc/src/sgml/dict-int.sgml
index 17f98c05fa7862f3390e062c022f849fc15d55e3..d49f3e2a3a301137fc04b9e7be3109c98bafc700 100644 (file)
--- a/doc/src/sgml/dict-int.sgml
+++ b/doc/src/sgml/dict-int.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="dict_int">
  dict_int
 
  

diff --git a/doc/src/sgml/dict-xsyn.sgml b/doc/src/sgml/dict-xsyn.sgml
index 23c5d983c1f3d7263090dce42628f520b52921e0..42362ffbc8da1d5fdfc3abe81902127929af16be 100644 (file)
--- a/doc/src/sgml/dict-xsyn.sgml
+++ b/doc/src/sgml/dict-xsyn.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="dict_xsyn">
  dict_xsyn
 
  

diff --git a/doc/src/sgml/dummy-seclabel.sgml b/doc/src/sgml/dummy-seclabel.sgml
index 30d58198fb9cd8f6a43a0c9fb1d6950c0e8f3019..28d19d2409e089e35332c5922637379386d02943 100644 (file)
--- a/doc/src/sgml/dummy-seclabel.sgml
+++ b/doc/src/sgml/dummy-seclabel.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="dummy_seclabel">
  dummy_seclabel
 
  

diff --git a/doc/src/sgml/earthdistance.sgml b/doc/src/sgml/earthdistance.sgml
index 48d9e6b3573e1c14b0ecf2af4ab084db509eb6f7..f9002b235b83d8e2facd9164a66db46792f6e54a 100644 (file)
--- a/doc/src/sgml/earthdistance.sgml
+++ b/doc/src/sgml/earthdistance.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="earthdistance">
  earthdistance
 
  

diff --git a/doc/src/sgml/file-fdw.sgml b/doc/src/sgml/file-fdw.sgml
index 003c415b43a3561a40d034bf68063b182022f271..e6ccdada2c191d2c24bce19498cfaf1a3ceb2032 100644 (file)
--- a/doc/src/sgml/file-fdw.sgml
+++ b/doc/src/sgml/file-fdw.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="file_fdw">
  file_fdw
 
  

diff --git a/doc/src/sgml/fuzzystrmatch.sgml b/doc/src/sgml/fuzzystrmatch.sgml
index cec336319332c89d86da13c6be0f93f223567bbf..5078bf82da9d7a6246713eb908727f7b45f16bf2 100644 (file)
--- a/doc/src/sgml/fuzzystrmatch.sgml
+++ b/doc/src/sgml/fuzzystrmatch.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="fuzzystrmatch">
  fuzzystrmatch
 
  

diff --git a/doc/src/sgml/hstore.sgml b/doc/src/sgml/hstore.sgml
index acd931a99093ab2767288a25012fba7f75e3157f..aa2129526577b84a72d6ac148d3cd4f36b4baba0 100644 (file)
--- a/doc/src/sgml/hstore.sgml
+++ b/doc/src/sgml/hstore.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="hstore">
  hstore
 
  

diff --git a/doc/src/sgml/intagg.sgml b/doc/src/sgml/intagg.sgml
index 43e36fb34838c6c9f2d0548e44b6ba38e0182539..ea5acbe91fbd31d484744f6abff2b19f83434bae 100644 (file)
--- a/doc/src/sgml/intagg.sgml
+++ b/doc/src/sgml/intagg.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="intagg">
  intagg
 
  

diff --git a/doc/src/sgml/intarray.sgml b/doc/src/sgml/intarray.sgml
index 5ad738d918628791396bfc3ba8f3ced914565003..2bbd98ae37b88500a0fa0ade98a91b7ad6d46924 100644 (file)
--- a/doc/src/sgml/intarray.sgml
+++ b/doc/src/sgml/intarray.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="intarray">
  intarray
 
  

diff --git a/doc/src/sgml/isn.sgml b/doc/src/sgml/isn.sgml
index 38c98641b2e72a659dd4b553641363e864154ec3..79ca3acd1b37e11a31668f746e38534324f22a91 100644 (file)
--- a/doc/src/sgml/isn.sgml
+++ b/doc/src/sgml/isn.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="isn">
  isn
 
  

diff --git a/doc/src/sgml/lo.sgml b/doc/src/sgml/lo.sgml
index 33124f99202e8bf2a56b055174714c1ef793cf98..3d56ba3f70af7d905116c8d9fcc68af4f10e182f 100644 (file)
--- a/doc/src/sgml/lo.sgml
+++ b/doc/src/sgml/lo.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="lo">
  lo
 
  

diff --git a/doc/src/sgml/ltree.sgml b/doc/src/sgml/ltree.sgml
index d00c91e9857d6dcc77faf8586dc0c61328df4be2..0a91cd79d1a2c6e2f72f10395f80ddd29eb4cd2d 100644 (file)
--- a/doc/src/sgml/ltree.sgml
+++ b/doc/src/sgml/ltree.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="ltree">
  ltree
 
  

diff --git a/doc/src/sgml/oid2name.sgml b/doc/src/sgml/oid2name.sgml
index 36fcfd5cdad5cb4354ef49991fff728c9d359e6d..3e4fe24a49f5ef54b7c734fd9215c414340579b5 100644 (file)
--- a/doc/src/sgml/oid2name.sgml
+++ b/doc/src/sgml/oid2name.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="oid2name">
  oid2name
 
  

diff --git a/doc/src/sgml/pageinspect.sgml b/doc/src/sgml/pageinspect.sgml
index a5fbadb7310c42002c5b21d1cc8d1f8bd4b76a50..acbb05bc9c575150631951576212451e4552628b 100644 (file)
--- a/doc/src/sgml/pageinspect.sgml
+++ b/doc/src/sgml/pageinspect.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pageinspect">
  pageinspect
 
  

diff --git a/doc/src/sgml/passwordcheck.sgml b/doc/src/sgml/passwordcheck.sgml
index 11107fb6ddde303e09ba916cfd9b2ff1a2d0df86..0050e658247826c2e462e5fd6bb872c8572bda60 100644 (file)
--- a/doc/src/sgml/passwordcheck.sgml
+++ b/doc/src/sgml/passwordcheck.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="passwordcheck">
  passwordcheck
 
  

diff --git a/doc/src/sgml/pgarchivecleanup.sgml b/doc/src/sgml/pgarchivecleanup.sgml
index 725f3ed07c5b981a398f4e3bf5401432b5afe3e4..ddffa321f6368cf52df31bbbe0c5904639a1c10c 100644 (file)
--- a/doc/src/sgml/pgarchivecleanup.sgml
+++ b/doc/src/sgml/pgarchivecleanup.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_archivecleanup">
  pg_archivecleanup
 
  

diff --git a/doc/src/sgml/pgbench.sgml b/doc/src/sgml/pgbench.sgml
index 5a10e93a400572725957beb0a79f22cbfe932cc7..e7b78605ecf3aa4f3893e450dcbfd2274e3b32a1 100644 (file)
--- a/doc/src/sgml/pgbench.sgml
+++ b/doc/src/sgml/pgbench.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pgbench">
  pgbench
 
  

diff --git a/doc/src/sgml/pgbuffercache.sgml b/doc/src/sgml/pgbuffercache.sgml
index fa7a78dfcda99f739b7f085828fd056ad10575ea..1d7d95f9d7de3d972374d05a96308971f5cf961e 100644 (file)
--- a/doc/src/sgml/pgbuffercache.sgml
+++ b/doc/src/sgml/pgbuffercache.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_buffercache">
  pg_buffercache
 
  

diff --git a/doc/src/sgml/pgcrypto.sgml b/doc/src/sgml/pgcrypto.sgml
index 60bc0a20465a7105e1a21a1960e6df4625cada3c..6b78f2c1c6319677ebd186da4468ebf86b22dd42 100644 (file)
--- a/doc/src/sgml/pgcrypto.sgml
+++ b/doc/src/sgml/pgcrypto.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pgcrypto">
  pgcrypto
 
  

diff --git a/doc/src/sgml/pgfreespacemap.sgml b/doc/src/sgml/pgfreespacemap.sgml
index bdacbaf0e546ef694eda4ef38177427302fa3cbe..51f772a397a0436830bcae861063a716ac49189f 100644 (file)
--- a/doc/src/sgml/pgfreespacemap.sgml
+++ b/doc/src/sgml/pgfreespacemap.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_freespacemap">
  pg_freespacemap
 
  

diff --git a/doc/src/sgml/pgrowlocks.sgml b/doc/src/sgml/pgrowlocks.sgml
index b2c2590ad7db746a6a47559578895962032f58df..db1cf5e863d6d1f56a13940e696ab093a71f907f 100644 (file)
--- a/doc/src/sgml/pgrowlocks.sgml
+++ b/doc/src/sgml/pgrowlocks.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pgrowlocks">
  pgrowlocks
 
  

diff --git a/doc/src/sgml/pgstandby.sgml b/doc/src/sgml/pgstandby.sgml
index 7f0a8744fa4f5e4a3e699646d3dfacc96adbc2b8..e698cb73e6390cf99b7a6e6e458ee954147afd85 100644 (file)
--- a/doc/src/sgml/pgstandby.sgml
+++ b/doc/src/sgml/pgstandby.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_standby">
  pg_standby
 
  

diff --git a/doc/src/sgml/pgstatstatements.sgml b/doc/src/sgml/pgstatstatements.sgml
index 8cff1020bb36be8432eef824c8070994a0a5f547..52268c545d74a5baf8c601705dec66d82711c8a6 100644 (file)
--- a/doc/src/sgml/pgstatstatements.sgml
+++ b/doc/src/sgml/pgstatstatements.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_stat_statements">
  pg_stat_statements
 
  

diff --git a/doc/src/sgml/pgstattuple.sgml b/doc/src/sgml/pgstattuple.sgml
index cc2849b5e61346882d680bcb52e1f48b60e51458..a55b35cb3f1b0e49bbead372a537b02fe36455b1 100644 (file)
--- a/doc/src/sgml/pgstattuple.sgml
+++ b/doc/src/sgml/pgstattuple.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pgstattuple">
  pgstattuple
 
  

diff --git a/doc/src/sgml/pgtestfsync.sgml b/doc/src/sgml/pgtestfsync.sgml
index 5ad7b73ed0b54ab0e3ec1ff036694b476a941eef..4015eb51d8d8cc777d66060ea3f76ef9aff3685b 100644 (file)
--- a/doc/src/sgml/pgtestfsync.sgml
+++ b/doc/src/sgml/pgtestfsync.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_test_fsync">
  pg_test_fsync
 
  

diff --git a/doc/src/sgml/pgtrgm.sgml b/doc/src/sgml/pgtrgm.sgml
index 581388c683f835d70913c562bcc9ae7d229836af..18f0f3eba0cc596fa37368ab5c4006a165cc6bb5 100644 (file)
--- a/doc/src/sgml/pgtrgm.sgml
+++ b/doc/src/sgml/pgtrgm.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_trgm">
  pg_trgm
 
  

diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
index c41068f074ec8ba55012f84f3e9135bbdc8cf99c..1713bf0272913a70f959b7ed9db334405769252e 100644 (file)
--- a/doc/src/sgml/pgupgrade.sgml
+++ b/doc/src/sgml/pgupgrade.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="pg_upgrade">
  pg_upgrade
 
  

diff --git a/doc/src/sgml/seg.sgml b/doc/src/sgml/seg.sgml
index a726ca127fe47d1cc78d80b022d7a34ef5236a2e..00bd71dcb6148d3b64ce3621a1188f2400a640f4 100644 (file)
--- a/doc/src/sgml/seg.sgml
+++ b/doc/src/sgml/seg.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="seg">
  seg
 
  

diff --git a/doc/src/sgml/sepgsql.sgml b/doc/src/sgml/sepgsql.sgml
index 589fe79d51fbb286f8c12a76a2b0c524b1f7a021..f35ab97be15c11198797dc1330b2c9559c729db3 100644 (file)
--- a/doc/src/sgml/sepgsql.sgml
+++ b/doc/src/sgml/sepgsql.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="sepgsql">
  sepgsql
 
  

diff --git a/doc/src/sgml/sslinfo.sgml b/doc/src/sgml/sslinfo.sgml
index f7ccb8c56c1d4f20d6577f0cce69e4cdd653eec3..618182458ac85eede50272228c55a006bf081bfd 100644 (file)
--- a/doc/src/sgml/sslinfo.sgml
+++ b/doc/src/sgml/sslinfo.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="sslinfo">
  sslinfo
 
  

diff --git a/doc/src/sgml/tablefunc.sgml b/doc/src/sgml/tablefunc.sgml
index 60f0b57cd92fb85ff2125f892821f84b033e4af7..cfa20e2a70c9a99e7605a192705550f9a0bdb78a 100644 (file)
--- a/doc/src/sgml/tablefunc.sgml
+++ b/doc/src/sgml/tablefunc.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="tablefunc">
  tablefunc
 
  

diff --git a/doc/src/sgml/test-parser.sgml b/doc/src/sgml/test-parser.sgml
index 0f2008cbe6b62c660e3d13cacff7d63add8e9ce2..28b1e91c584165e28d6bbd59f4aac80562705ce9 100644 (file)
--- a/doc/src/sgml/test-parser.sgml
+++ b/doc/src/sgml/test-parser.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="test_parser">
  test_parser
 
  

diff --git a/doc/src/sgml/tsearch2.sgml b/doc/src/sgml/tsearch2.sgml
index 8321c1efb4f4731065c47f0cb6b3d7046f5aefff..192eccd7326a5b0c60d8f38e4a16764d9239594c 100644 (file)
--- a/doc/src/sgml/tsearch2.sgml
+++ b/doc/src/sgml/tsearch2.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="tsearch2">
  tsearch2
 
  

diff --git a/doc/src/sgml/unaccent.sgml b/doc/src/sgml/unaccent.sgml
index 9c34c0bbd2e28258c559e6cb4afbd569b29bf8c9..af9cad5d8c778659ba2d36421579ad6d6e4cf64a 100644 (file)
--- a/doc/src/sgml/unaccent.sgml
+++ b/doc/src/sgml/unaccent.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="unaccent">
  unaccent
 
  

diff --git a/doc/src/sgml/uuid-ossp.sgml b/doc/src/sgml/uuid-ossp.sgml
index 3dd89903fad88b1a424f104a4700c49537d31891..7446b8be5c8e9624addf78ed2df011c1a0fd9f68 100644 (file)
--- a/doc/src/sgml/uuid-ossp.sgml
+++ b/doc/src/sgml/uuid-ossp.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="uuid-ossp">
  uuid-ossp
 
  

diff --git a/doc/src/sgml/vacuumlo.sgml b/doc/src/sgml/vacuumlo.sgml
index fbb6815a446c758aa5b194d5045cdd54a4618b5a..471a6ca32be9e75e7a38b3fe51891373ce02e357 100644 (file)
--- a/doc/src/sgml/vacuumlo.sgml
+++ b/doc/src/sgml/vacuumlo.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="vacuumlo">
  vacuumlo
 
  

diff --git a/doc/src/sgml/xml2.sgml b/doc/src/sgml/xml2.sgml
index 8ce7351a7c07b0f17e0800b23ce622e48f1d8ca4..90b5ac07859d083ee29db0889ace27f564fc9375 100644 (file)
--- a/doc/src/sgml/xml2.sgml
+++ b/doc/src/sgml/xml2.sgml
@@ -1,6 +1,6 @@
 
 
-
+ xreflabel="xml2">
  xml2