Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Add xreflabels to /contrib manuals so links appear correct. Also update
authorBruce Momjian <bruce@momjian.us>
Sun, 8 May 2011 02:29:20 +0000 (22:29 -0400)
committerBruce Momjian <bruce@momjian.us>
Sun, 8 May 2011 02:29:20 +0000 (22:29 -0400)
README.links to explain xref properly.

48 files changed:
doc/src/sgml/README.links
doc/src/sgml/adminpack.sgml
doc/src/sgml/auth-delay.sgml
doc/src/sgml/auto-explain.sgml
doc/src/sgml/btree-gin.sgml
doc/src/sgml/btree-gist.sgml
doc/src/sgml/chkpass.sgml
doc/src/sgml/citext.sgml
doc/src/sgml/contrib-spi.sgml
doc/src/sgml/cube.sgml
doc/src/sgml/dblink.sgml
doc/src/sgml/dict-int.sgml
doc/src/sgml/dict-xsyn.sgml
doc/src/sgml/dummy-seclabel.sgml
doc/src/sgml/earthdistance.sgml
doc/src/sgml/file-fdw.sgml
doc/src/sgml/fuzzystrmatch.sgml
doc/src/sgml/hstore.sgml
doc/src/sgml/intagg.sgml
doc/src/sgml/intarray.sgml
doc/src/sgml/isn.sgml
doc/src/sgml/lo.sgml
doc/src/sgml/ltree.sgml
doc/src/sgml/oid2name.sgml
doc/src/sgml/pageinspect.sgml
doc/src/sgml/passwordcheck.sgml
doc/src/sgml/pgarchivecleanup.sgml
doc/src/sgml/pgbench.sgml
doc/src/sgml/pgbuffercache.sgml
doc/src/sgml/pgcrypto.sgml
doc/src/sgml/pgfreespacemap.sgml
doc/src/sgml/pgrowlocks.sgml
doc/src/sgml/pgstandby.sgml
doc/src/sgml/pgstatstatements.sgml
doc/src/sgml/pgstattuple.sgml
doc/src/sgml/pgtestfsync.sgml
doc/src/sgml/pgtrgm.sgml
doc/src/sgml/pgupgrade.sgml
doc/src/sgml/seg.sgml
doc/src/sgml/sepgsql.sgml
doc/src/sgml/sslinfo.sgml
doc/src/sgml/tablefunc.sgml
doc/src/sgml/test-parser.sgml
doc/src/sgml/tsearch2.sgml
doc/src/sgml/unaccent.sgml
doc/src/sgml/uuid-ossp.sgml
doc/src/sgml/vacuumlo.sgml
doc/src/sgml/xml2.sgml

index 8608859eac6d251d56ad0df2b748d6c9365e9f74..2668b00d7f5d48b6013e376233939d0e94fdc2e5 100644 (file)
@@ -7,8 +7,8 @@ Intra-document Linking
 ----------------------
 
 <xref>
-   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
 
 <link>
@@ -28,7 +28,8 @@ External Linking
 
 <ulink>
    like <link>, but uses a URL (not a document target);  requires
-   </ulink>; if no text is specified, the URL appears as the link text
+   </ulink>; 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 <link>, else <xref>
 o  Do not use text with <ulink> 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
index 27d003432978dbf64b0253a633c2cbc9d646e4e0..9b72f34eadc236038ce97557f46efdc8ccf3a50f 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/adminpack.sgml -->
 
-<sect1 id="adminpack">
+<sect1 id="adminpack" xreflabel="adminpack">
  <title>adminpack</title>
 
  <indexterm zone="adminpack">
index 9f1f3f645af0e946eb27b8a3272a40c57b718079..b91a7ecda7aea7a611e0feb268b2bf4b47000d76 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/auth-delay.sgml -->
 
-<sect1 id="auth-delay">
+<sect1 id="auth-delay" xreflabel="auth_delay">
  <title>auth_delay</title>
 
  <indexterm zone="auth-delay">
index 405e3f72b437377d304bdc88ab910e71d057e1a1..b16f9064ffc05d86637c054bc7b38221988b11db 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/auto-explain.sgml -->
 
-<sect1 id="auto-explain">
+<sect1 id="auto-explain" xreflabel="auto_explain">
  <title>auto_explain</title>
 
  <indexterm zone="auto-explain">
index 632bd1e53af346ec39a104537e655c2b64d1aaa0..42b9e97b72a1f9191c51dc6d43694cc148dd1855 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/btree-gin.sgml -->
 
-<sect1 id="btree-gin">
+<sect1 id="btree-gin" xreflabel="btree_gin">
  <title>btree_gin</title>
 
  <indexterm zone="btree-gin">
index af3f707bb9c73c6876f12b9772a8fbb25dd0a8db..e52971f3d9e2e0615eccf965676a81efbc9ba1db 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/btree-gist.sgml -->
 
-<sect1 id="btree-gist">
+<sect1 id="btree-gist" xreflabel="btree_gist">
  <title>btree_gist</title>
 
  <indexterm zone="btree-gist">
index b9b3c08c25b52d9bf56b691127b7b2ae3154c7fe..9f682d898163bad2a15d2c7dc94e6918fcd59678 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/chkpass.sgml -->
 
-<sect1 id="chkpass">
+<sect1 id="chkpass" xreflabel="chkpass">
  <title>chkpass</title>
 
  <indexterm zone="chkpass">
index 68a2aa4cd3f7767d05b5fe1114b49e03075d5e58..8cbde88a3e77b8f18f104f9375366a7abf2c2b2d 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/citext.sgml -->
 
-<sect1 id="citext">
+<sect1 id="citext" xreflabel="citext">
  <title>citext</title>
 
  <indexterm zone="citext">
index 55e5ce264925f60ef6ab7f9db4eec9facf79cdf0..3287c18d27d5f9ca0eea46f523646891e9f435a4 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/contrib-spi.sgml -->
 
-<sect1 id="contrib-spi">
+<sect1 id="contrib-spi" xreflabel="spi">
  <title>spi</title>
 
  <indexterm zone="contrib-spi">
index 0fcbf21be61e146fe6039aeb52566074a7afb249..e2da68556d561a870e3a9a89de21f4e625a64ce5 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/cube.sgml -->
 
-<sect1 id="cube">
+<sect1 id="cube" xreflabel="cube">
  <title>cube</title>
 
  <indexterm zone="cube">
index 295544e54e1a3fac0d038da872a25172a3e68120..22551402e3d104ec598d061acb36605ea5c3b642 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/dblink.sgml -->
 
-<sect1 id="dblink">
+<sect1 id="dblink" xreflabel="dblink">
  <title>dblink</title>
 
  <indexterm zone="dblink">
index 17f98c05fa7862f3390e062c022f849fc15d55e3..d49f3e2a3a301137fc04b9e7be3109c98bafc700 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/dict-int.sgml -->
 
-<sect1 id="dict-int">
+<sect1 id="dict-int" xreflabel="dict_int">
  <title>dict_int</title>
 
  <indexterm zone="dict-int">
index 23c5d983c1f3d7263090dce42628f520b52921e0..42362ffbc8da1d5fdfc3abe81902127929af16be 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/dict-xsyn.sgml -->
 
-<sect1 id="dict-xsyn">
+<sect1 id="dict-xsyn" xreflabel="dict_xsyn">
  <title>dict_xsyn</title>
 
  <indexterm zone="dict-xsyn">
index 30d58198fb9cd8f6a43a0c9fb1d6950c0e8f3019..28d19d2409e089e35332c5922637379386d02943 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/dummy_seclabel.sgml -->
 
-<sect1 id="dummy-seclabel">
+<sect1 id="dummy-seclabel" xreflabel="dummy_seclabel">
  <title>dummy_seclabel</title>
 
  <indexterm zone="dummy-seclabel">
index 48d9e6b3573e1c14b0ecf2af4ab084db509eb6f7..f9002b235b83d8e2facd9164a66db46792f6e54a 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/earthdistance.sgml -->
 
-<sect1 id="earthdistance">
+<sect1 id="earthdistance" xreflabel="earthdistance">
  <title>earthdistance</title>
 
  <indexterm zone="earthdistance">
index 003c415b43a3561a40d034bf68063b182022f271..e6ccdada2c191d2c24bce19498cfaf1a3ceb2032 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/file-fdw.sgml -->
 
-<sect1 id="file-fdw">
+<sect1 id="file-fdw" xreflabel="file_fdw">
  <title>file_fdw</title>
 
  <indexterm zone="file-fdw">
index cec336319332c89d86da13c6be0f93f223567bbf..5078bf82da9d7a6246713eb908727f7b45f16bf2 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/fuzzystrmatch.sgml -->
 
-<sect1 id="fuzzystrmatch">
+<sect1 id="fuzzystrmatch" xreflabel="fuzzystrmatch">
  <title>fuzzystrmatch</title>
 
  <indexterm zone="fuzzystrmatch">
index acd931a99093ab2767288a25012fba7f75e3157f..aa2129526577b84a72d6ac148d3cd4f36b4baba0 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/hstore.sgml -->
 
-<sect1 id="hstore">
+<sect1 id="hstore" xreflabel="hstore">
  <title>hstore</title>
 
  <indexterm zone="hstore">
index 43e36fb34838c6c9f2d0548e44b6ba38e0182539..ea5acbe91fbd31d484744f6abff2b19f83434bae 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/intagg.sgml -->
 
-<sect1 id="intagg">
+<sect1 id="intagg" xreflabel="intagg">
  <title>intagg</title>
 
  <indexterm zone="intagg">
index 5ad738d918628791396bfc3ba8f3ced914565003..2bbd98ae37b88500a0fa0ade98a91b7ad6d46924 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/intarray.sgml -->
 
-<sect1 id="intarray">
+<sect1 id="intarray" xreflabel="intarray">
  <title>intarray</title>
 
  <indexterm zone="intarray">
index 38c98641b2e72a659dd4b553641363e864154ec3..79ca3acd1b37e11a31668f746e38534324f22a91 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/isn.sgml -->
 
-<sect1 id="isn">
+<sect1 id="isn" xreflabel="isn">
  <title>isn</title>
 
  <indexterm zone="isn">
index 33124f99202e8bf2a56b055174714c1ef793cf98..3d56ba3f70af7d905116c8d9fcc68af4f10e182f 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/lo.sgml -->
 
-<sect1 id="lo">
+<sect1 id="lo" xreflabel="lo">
  <title>lo</title>
 
  <indexterm zone="lo">
index d00c91e9857d6dcc77faf8586dc0c61328df4be2..0a91cd79d1a2c6e2f72f10395f80ddd29eb4cd2d 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/ltree.sgml -->
 
-<sect1 id="ltree">
+<sect1 id="ltree" xreflabel="ltree">
  <title>ltree</title>
 
  <indexterm zone="ltree">
index 36fcfd5cdad5cb4354ef49991fff728c9d359e6d..3e4fe24a49f5ef54b7c734fd9215c414340579b5 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/oid2name.sgml -->
 
-<sect1 id="oid2name">
+<sect1 id="oid2name" xreflabel="oid2name">
  <title>oid2name</title>
 
  <indexterm zone="oid2name">
index a5fbadb7310c42002c5b21d1cc8d1f8bd4b76a50..acbb05bc9c575150631951576212451e4552628b 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pageinspect.sgml -->
 
-<sect1 id="pageinspect">
+<sect1 id="pageinspect" xreflabel="pageinspect">
  <title>pageinspect</title>
 
  <indexterm zone="pageinspect">
index 11107fb6ddde303e09ba916cfd9b2ff1a2d0df86..0050e658247826c2e462e5fd6bb872c8572bda60 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/passwordcheck.sgml -->
 
-<sect1 id="passwordcheck">
+<sect1 id="passwordcheck" xreflabel="passwordcheck">
  <title>passwordcheck</title>
 
  <indexterm zone="passwordcheck">
index 725f3ed07c5b981a398f4e3bf5401432b5afe3e4..ddffa321f6368cf52df31bbbe0c5904639a1c10c 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgarchivecleanup.sgml -->
 
-<sect1 id="pgarchivecleanup">
+<sect1 id="pgarchivecleanup" xreflabel="pg_archivecleanup">
  <title>pg_archivecleanup</title>
 
  <indexterm zone="pgarchivecleanup">
index 5a10e93a400572725957beb0a79f22cbfe932cc7..e7b78605ecf3aa4f3893e450dcbfd2274e3b32a1 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgbench.sgml -->
 
-<sect1 id="pgbench">
+<sect1 id="pgbench" xreflabel="pgbench">
  <title>pgbench</title>
 
  <indexterm zone="pgbench">
index fa7a78dfcda99f739b7f085828fd056ad10575ea..1d7d95f9d7de3d972374d05a96308971f5cf961e 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgbuffercache.sgml -->
 
-<sect1 id="pgbuffercache">
+<sect1 id="pgbuffercache" xreflabel="pg_buffercache">
  <title>pg_buffercache</title>
 
  <indexterm zone="pgbuffercache">
index 60bc0a20465a7105e1a21a1960e6df4625cada3c..6b78f2c1c6319677ebd186da4468ebf86b22dd42 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgcrypto.sgml -->
 
-<sect1 id="pgcrypto">
+<sect1 id="pgcrypto" xreflabel="pgcrypto">
  <title>pgcrypto</title>
 
  <indexterm zone="pgcrypto">
index bdacbaf0e546ef694eda4ef38177427302fa3cbe..51f772a397a0436830bcae861063a716ac49189f 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgfreespacemap.sgml -->
 
-<sect1 id="pgfreespacemap">
+<sect1 id="pgfreespacemap" xreflabel="pg_freespacemap">
  <title>pg_freespacemap</title>
 
  <indexterm zone="pgfreespacemap">
index b2c2590ad7db746a6a47559578895962032f58df..db1cf5e863d6d1f56a13940e696ab093a71f907f 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgrowlocks.sgml -->
 
-<sect1 id="pgrowlocks">
+<sect1 id="pgrowlocks" xreflabel="pgrowlocks">
  <title>pgrowlocks</title>
 
  <indexterm zone="pgrowlocks">
index 7f0a8744fa4f5e4a3e699646d3dfacc96adbc2b8..e698cb73e6390cf99b7a6e6e458ee954147afd85 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgstandby.sgml -->
 
-<sect1 id="pgstandby">
+<sect1 id="pgstandby" xreflabel="pg_standby">
  <title>pg_standby</title>
 
  <indexterm zone="pgstandby">
index 8cff1020bb36be8432eef824c8070994a0a5f547..52268c545d74a5baf8c601705dec66d82711c8a6 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgstatstatements.sgml -->
 
-<sect1 id="pgstatstatements">
+<sect1 id="pgstatstatements" xreflabel="pg_stat_statements">
  <title>pg_stat_statements</title>
 
  <indexterm zone="pgstatstatements">
index cc2849b5e61346882d680bcb52e1f48b60e51458..a55b35cb3f1b0e49bbead372a537b02fe36455b1 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgstattuple.sgml -->
 
-<sect1 id="pgstattuple">
+<sect1 id="pgstattuple" xreflabel="pgstattuple">
  <title>pgstattuple</title>
 
  <indexterm zone="pgstattuple">
index 5ad7b73ed0b54ab0e3ec1ff036694b476a941eef..4015eb51d8d8cc777d66060ea3f76ef9aff3685b 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgtestfsync.sgml -->
 
-<sect1 id="pgtestfsync">
+<sect1 id="pgtestfsync" xreflabel="pg_test_fsync">
  <title>pg_test_fsync</title>
 
  <indexterm zone="pgtestfsync">
index 581388c683f835d70913c562bcc9ae7d229836af..18f0f3eba0cc596fa37368ab5c4006a165cc6bb5 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgtrgm.sgml -->
 
-<sect1 id="pgtrgm">
+<sect1 id="pgtrgm" xreflabel="pg_trgm">
  <title>pg_trgm</title>
 
  <indexterm zone="pgtrgm">
index c41068f074ec8ba55012f84f3e9135bbdc8cf99c..1713bf0272913a70f959b7ed9db334405769252e 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/pgupgrade.sgml -->
 
-<sect1 id="pgupgrade">
+<sect1 id="pgupgrade" xreflabel="pg_upgrade">
  <title>pg_upgrade</title>
 
  <indexterm zone="pgupgrade">
index a726ca127fe47d1cc78d80b022d7a34ef5236a2e..00bd71dcb6148d3b64ce3621a1188f2400a640f4 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/seg.sgml -->
 
-<sect1 id="seg">
+<sect1 id="seg" xreflabel="seg">
  <title>seg</title>
 
  <indexterm zone="seg">
index 589fe79d51fbb286f8c12a76a2b0c524b1f7a021..f35ab97be15c11198797dc1330b2c9559c729db3 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/sepgsql.sgml -->
 
-<sect1 id="sepgsql">
+<sect1 id="sepgsql" xreflabel="sepgsql">
  <title>sepgsql</title>
 
  <indexterm zone="sepgsql">
index f7ccb8c56c1d4f20d6577f0cce69e4cdd653eec3..618182458ac85eede50272228c55a006bf081bfd 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/sslinfo.sgml -->
 
-<sect1 id="sslinfo">
+<sect1 id="sslinfo" xreflabel="sslinfo">
  <title>sslinfo</title>
 
  <indexterm zone="sslinfo">
index 60f0b57cd92fb85ff2125f892821f84b033e4af7..cfa20e2a70c9a99e7605a192705550f9a0bdb78a 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/tablefunc.sgml -->
 
-<sect1 id="tablefunc">
+<sect1 id="tablefunc" xreflabel="tablefunc">
  <title>tablefunc</title>
 
  <indexterm zone="tablefunc">
index 0f2008cbe6b62c660e3d13cacff7d63add8e9ce2..28b1e91c584165e28d6bbd59f4aac80562705ce9 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/test-parser.sgml -->
 
-<sect1 id="test-parser">
+<sect1 id="test-parser" xreflabel="test_parser">
  <title>test_parser</title>
 
  <indexterm zone="test-parser">
index 8321c1efb4f4731065c47f0cb6b3d7046f5aefff..192eccd7326a5b0c60d8f38e4a16764d9239594c 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/tsearch2.sgml -->
 
-<sect1 id="tsearch2">
+<sect1 id="tsearch2" xreflabel="tsearch2">
  <title>tsearch2</title>
 
  <indexterm zone="tsearch2">
index 9c34c0bbd2e28258c559e6cb4afbd569b29bf8c9..af9cad5d8c778659ba2d36421579ad6d6e4cf64a 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/unaccent.sgml -->
 
-<sect1 id="unaccent">
+<sect1 id="unaccent" xreflabel="unaccent">
  <title>unaccent</title>
 
  <indexterm zone="unaccent">
index 3dd89903fad88b1a424f104a4700c49537d31891..7446b8be5c8e9624addf78ed2df011c1a0fd9f68 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/uuid-ossp.sgml -->
 
-<sect1 id="uuid-ossp">
+<sect1 id="uuid-ossp" xreflabel="uuid-ossp">
  <title>uuid-ossp</title>
 
  <indexterm zone="uuid-ossp">
index fbb6815a446c758aa5b194d5045cdd54a4618b5a..471a6ca32be9e75e7a38b3fe51891373ce02e357 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/vacuumlo.sgml -->
 
-<sect1 id="vacuumlo">
+<sect1 id="vacuumlo" xreflabel="vacuumlo">
  <title>vacuumlo</title>
 
  <indexterm zone="vacuumlo">
index 8ce7351a7c07b0f17e0800b23ce622e48f1d8ca4..90b5ac07859d083ee29db0889ace27f564fc9375 100644 (file)
@@ -1,6 +1,6 @@
 <!-- doc/src/sgml/xml2.sgml -->
 
-<sect1 id="xml2">
+<sect1 id="xml2" xreflabel="xml2">
  <title>xml2</title>
 
  <indexterm zone="xml2">