Received: from maia.hub.org (maia-3.hub.org [200.46.204.243]) by mail.postgresql.org (Postfix) with ESMTP id CD5EF1337B92 for ; Sat, 7 May 2011 23:25:39 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia, port 10024) with ESMTP id 81155-07 for ; Sun, 8 May 2011 02:25:31 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from momjian.us (momjian.us [70.90.9.53]) by mail.postgresql.org (Postfix) with ESMTP id A2A271337B82 for ; Sat, 7 May 2011 23:25:30 -0300 (ADT) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id p482PWe03624; Sat, 7 May 2011 22:25:32 -0400 (EDT) From: Bruce Momjian Message-Id: <201105080225.p482PWe03624@momjian.us> Subject: Re: many contrib links are broken In-Reply-To: <1304801570.15989.9.camel@vanquo.pezone.net> To: Peter Eisentraut Date: Sat, 7 May 2011 22:25:32 -0400 (EDT) CC: pgsql-docs X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="ELM1304821532-11659-0_" Content-Transfer-Encoding: 7bit X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201105/34 X-Sequence-Number: 6709 --ELM1304821532-11659-0_ Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" Peter Eisentraut wrote: > On l?r, 2011-05-07 at 14:28 -0400, Bruce Momjian wrote: > > Yep, this clearly needs cleanup. The README.links file I wrote says: > > > > > > use to get link text from the title of the target link; has no > > close tag > > > > http://www.oasis-open.org/docbook/documentation/reference/html/xref.html > > > > Is that not true? > > It is not true in general. > > > The URL seems to suggest that the title is used if > > there is no xreflabel, though it suggests the the supplied text is > > "Chapter ##: title". Of course, we are not seeing that behavior so > > maybe README.links is wrong. > > Using xreflabel might be the fix, but you'll have to try it to see if it > comes out OK. Thanks for the help. I added xreflabels to the contrib module pages and that fixed the item you showed me, so we should be good now. I also updated README.links to accurately descripbe xref. Applied patch attached. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. + --ELM1304821532-11659-0_ Content-Transfer-Encoding: 7bit Content-Type: text/x-diff Content-Disposition: inline; filename="/rtmp/diff" diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links new file mode 100644 index 8608859..2668b00 *** a/doc/src/sgml/README.links --- b/doc/src/sgml/README.links *************** Intra-document Linking *** 7,14 **** ---------------------- ! use to get link text from the title of the target link; has no ! close tag http://www.oasis-open.org/docbook/documentation/reference/html/xref.html --- 7,14 ---- ---------------------- ! 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 *************** External Linking *** 28,34 **** like , but uses a URL (not a document target); requires ! ; if no text is specified, the URL appears as the link text http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html url= --- 28,35 ---- like , but uses a URL (not a document target); requires ! ; if no text is specified, the URL appears as the link ! text http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html url= *************** Guidelines *** 40,43 **** 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' --- 41,45 ---- o If you want to supply text, use , else o Do not use text with so the URL appears in printed output ! 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 new file mode 100644 index 27d0034..9b72f34 *** a/doc/src/sgml/adminpack.sgml --- b/doc/src/sgml/adminpack.sgml *************** *** 1,6 **** ! adminpack --- 1,6 ---- ! adminpack diff --git a/doc/src/sgml/auth-delay.sgml b/doc/src/sgml/auth-delay.sgml new file mode 100644 index 9f1f3f6..b91a7ec *** a/doc/src/sgml/auth-delay.sgml --- b/doc/src/sgml/auth-delay.sgml *************** *** 1,6 **** ! auth_delay --- 1,6 ---- ! auth_delay diff --git a/doc/src/sgml/auto-explain.sgml b/doc/src/sgml/auto-explain.sgml new file mode 100644 index 405e3f7..b16f906 *** a/doc/src/sgml/auto-explain.sgml --- b/doc/src/sgml/auto-explain.sgml *************** *** 1,6 **** ! auto_explain --- 1,6 ---- ! auto_explain diff --git a/doc/src/sgml/btree-gin.sgml b/doc/src/sgml/btree-gin.sgml new file mode 100644 index 632bd1e..42b9e97 *** a/doc/src/sgml/btree-gin.sgml --- b/doc/src/sgml/btree-gin.sgml *************** *** 1,6 **** ! btree_gin --- 1,6 ---- ! btree_gin diff --git a/doc/src/sgml/btree-gist.sgml b/doc/src/sgml/btree-gist.sgml new file mode 100644 index af3f707..e52971f *** a/doc/src/sgml/btree-gist.sgml --- b/doc/src/sgml/btree-gist.sgml *************** *** 1,6 **** ! btree_gist --- 1,6 ---- ! btree_gist diff --git a/doc/src/sgml/chkpass.sgml b/doc/src/sgml/chkpass.sgml new file mode 100644 index b9b3c08..9f682d8 *** a/doc/src/sgml/chkpass.sgml --- b/doc/src/sgml/chkpass.sgml *************** *** 1,6 **** ! chkpass --- 1,6 ---- ! chkpass diff --git a/doc/src/sgml/citext.sgml b/doc/src/sgml/citext.sgml new file mode 100644 index 68a2aa4..8cbde88 *** a/doc/src/sgml/citext.sgml --- b/doc/src/sgml/citext.sgml *************** *** 1,6 **** ! citext --- 1,6 ---- ! citext diff --git a/doc/src/sgml/contrib-spi.sgml b/doc/src/sgml/contrib-spi.sgml new file mode 100644 index 55e5ce2..3287c18 *** a/doc/src/sgml/contrib-spi.sgml --- b/doc/src/sgml/contrib-spi.sgml *************** *** 1,6 **** ! spi --- 1,6 ---- ! spi diff --git a/doc/src/sgml/cube.sgml b/doc/src/sgml/cube.sgml new file mode 100644 index 0fcbf21..e2da685 *** a/doc/src/sgml/cube.sgml --- b/doc/src/sgml/cube.sgml *************** *** 1,6 **** ! cube --- 1,6 ---- ! cube diff --git a/doc/src/sgml/dblink.sgml b/doc/src/sgml/dblink.sgml new file mode 100644 index 295544e..2255140 *** a/doc/src/sgml/dblink.sgml --- b/doc/src/sgml/dblink.sgml *************** *** 1,6 **** ! dblink --- 1,6 ---- ! dblink diff --git a/doc/src/sgml/dict-int.sgml b/doc/src/sgml/dict-int.sgml new file mode 100644 index 17f98c0..d49f3e2 *** a/doc/src/sgml/dict-int.sgml --- b/doc/src/sgml/dict-int.sgml *************** *** 1,6 **** ! dict_int --- 1,6 ---- ! dict_int diff --git a/doc/src/sgml/dict-xsyn.sgml b/doc/src/sgml/dict-xsyn.sgml new file mode 100644 index 23c5d98..42362ff *** a/doc/src/sgml/dict-xsyn.sgml --- b/doc/src/sgml/dict-xsyn.sgml *************** *** 1,6 **** ! dict_xsyn --- 1,6 ---- ! dict_xsyn diff --git a/doc/src/sgml/dummy-seclabel.sgml b/doc/src/sgml/dummy-seclabel.sgml new file mode 100644 index 30d5819..28d19d2 *** a/doc/src/sgml/dummy-seclabel.sgml --- b/doc/src/sgml/dummy-seclabel.sgml *************** *** 1,6 **** ! dummy_seclabel --- 1,6 ---- ! dummy_seclabel diff --git a/doc/src/sgml/earthdistance.sgml b/doc/src/sgml/earthdistance.sgml new file mode 100644 index 48d9e6b..f9002b2 *** a/doc/src/sgml/earthdistance.sgml --- b/doc/src/sgml/earthdistance.sgml *************** *** 1,6 **** ! earthdistance --- 1,6 ---- ! earthdistance diff --git a/doc/src/sgml/file-fdw.sgml b/doc/src/sgml/file-fdw.sgml new file mode 100644 index 003c415..e6ccdad *** a/doc/src/sgml/file-fdw.sgml --- b/doc/src/sgml/file-fdw.sgml *************** *** 1,6 **** ! file_fdw --- 1,6 ---- ! file_fdw diff --git a/doc/src/sgml/fuzzystrmatch.sgml b/doc/src/sgml/fuzzystrmatch.sgml new file mode 100644 index cec3363..5078bf8 *** a/doc/src/sgml/fuzzystrmatch.sgml --- b/doc/src/sgml/fuzzystrmatch.sgml *************** *** 1,6 **** ! fuzzystrmatch --- 1,6 ---- ! fuzzystrmatch diff --git a/doc/src/sgml/hstore.sgml b/doc/src/sgml/hstore.sgml new file mode 100644 index acd931a..aa21295 *** a/doc/src/sgml/hstore.sgml --- b/doc/src/sgml/hstore.sgml *************** *** 1,6 **** ! hstore --- 1,6 ---- ! hstore diff --git a/doc/src/sgml/intagg.sgml b/doc/src/sgml/intagg.sgml new file mode 100644 index 43e36fb..ea5acbe *** a/doc/src/sgml/intagg.sgml --- b/doc/src/sgml/intagg.sgml *************** *** 1,6 **** ! intagg --- 1,6 ---- ! intagg diff --git a/doc/src/sgml/intarray.sgml b/doc/src/sgml/intarray.sgml new file mode 100644 index 5ad738d..2bbd98a *** a/doc/src/sgml/intarray.sgml --- b/doc/src/sgml/intarray.sgml *************** *** 1,6 **** ! intarray --- 1,6 ---- ! intarray diff --git a/doc/src/sgml/isn.sgml b/doc/src/sgml/isn.sgml new file mode 100644 index 38c9864..79ca3ac *** a/doc/src/sgml/isn.sgml --- b/doc/src/sgml/isn.sgml *************** *** 1,6 **** ! isn --- 1,6 ---- ! isn diff --git a/doc/src/sgml/lo.sgml b/doc/src/sgml/lo.sgml new file mode 100644 index 33124f9..3d56ba3 *** a/doc/src/sgml/lo.sgml --- b/doc/src/sgml/lo.sgml *************** *** 1,6 **** ! lo --- 1,6 ---- ! lo diff --git a/doc/src/sgml/ltree.sgml b/doc/src/sgml/ltree.sgml new file mode 100644 index d00c91e..0a91cd7 *** a/doc/src/sgml/ltree.sgml --- b/doc/src/sgml/ltree.sgml *************** *** 1,6 **** ! ltree --- 1,6 ---- ! ltree diff --git a/doc/src/sgml/oid2name.sgml b/doc/src/sgml/oid2name.sgml new file mode 100644 index 36fcfd5..3e4fe24 *** a/doc/src/sgml/oid2name.sgml --- b/doc/src/sgml/oid2name.sgml *************** *** 1,6 **** ! oid2name --- 1,6 ---- ! oid2name diff --git a/doc/src/sgml/pageinspect.sgml b/doc/src/sgml/pageinspect.sgml new file mode 100644 index a5fbadb..acbb05b *** a/doc/src/sgml/pageinspect.sgml --- b/doc/src/sgml/pageinspect.sgml *************** *** 1,6 **** ! pageinspect --- 1,6 ---- ! pageinspect diff --git a/doc/src/sgml/passwordcheck.sgml b/doc/src/sgml/passwordcheck.sgml new file mode 100644 index 11107fb..0050e65 *** a/doc/src/sgml/passwordcheck.sgml --- b/doc/src/sgml/passwordcheck.sgml *************** *** 1,6 **** ! passwordcheck --- 1,6 ---- ! passwordcheck diff --git a/doc/src/sgml/pgarchivecleanup.sgml b/doc/src/sgml/pgarchivecleanup.sgml new file mode 100644 index 725f3ed..ddffa32 *** a/doc/src/sgml/pgarchivecleanup.sgml --- b/doc/src/sgml/pgarchivecleanup.sgml *************** *** 1,6 **** ! pg_archivecleanup --- 1,6 ---- ! pg_archivecleanup diff --git a/doc/src/sgml/pgbench.sgml b/doc/src/sgml/pgbench.sgml new file mode 100644 index 5a10e93..e7b7860 *** a/doc/src/sgml/pgbench.sgml --- b/doc/src/sgml/pgbench.sgml *************** *** 1,6 **** ! pgbench --- 1,6 ---- ! pgbench diff --git a/doc/src/sgml/pgbuffercache.sgml b/doc/src/sgml/pgbuffercache.sgml new file mode 100644 index fa7a78d..1d7d95f *** a/doc/src/sgml/pgbuffercache.sgml --- b/doc/src/sgml/pgbuffercache.sgml *************** *** 1,6 **** ! pg_buffercache --- 1,6 ---- ! pg_buffercache diff --git a/doc/src/sgml/pgcrypto.sgml b/doc/src/sgml/pgcrypto.sgml new file mode 100644 index 60bc0a2..6b78f2c *** a/doc/src/sgml/pgcrypto.sgml --- b/doc/src/sgml/pgcrypto.sgml *************** *** 1,6 **** ! pgcrypto --- 1,6 ---- ! pgcrypto diff --git a/doc/src/sgml/pgfreespacemap.sgml b/doc/src/sgml/pgfreespacemap.sgml new file mode 100644 index bdacbaf..51f772a *** a/doc/src/sgml/pgfreespacemap.sgml --- b/doc/src/sgml/pgfreespacemap.sgml *************** *** 1,6 **** ! pg_freespacemap --- 1,6 ---- ! pg_freespacemap diff --git a/doc/src/sgml/pgrowlocks.sgml b/doc/src/sgml/pgrowlocks.sgml new file mode 100644 index b2c2590..db1cf5e *** a/doc/src/sgml/pgrowlocks.sgml --- b/doc/src/sgml/pgrowlocks.sgml *************** *** 1,6 **** ! pgrowlocks --- 1,6 ---- ! pgrowlocks diff --git a/doc/src/sgml/pgstandby.sgml b/doc/src/sgml/pgstandby.sgml new file mode 100644 index 7f0a874..e698cb7 *** a/doc/src/sgml/pgstandby.sgml --- b/doc/src/sgml/pgstandby.sgml *************** *** 1,6 **** ! pg_standby --- 1,6 ---- ! pg_standby diff --git a/doc/src/sgml/pgstatstatements.sgml b/doc/src/sgml/pgstatstatements.sgml new file mode 100644 index 8cff102..52268c5 *** a/doc/src/sgml/pgstatstatements.sgml --- b/doc/src/sgml/pgstatstatements.sgml *************** *** 1,6 **** ! pg_stat_statements --- 1,6 ---- ! pg_stat_statements diff --git a/doc/src/sgml/pgstattuple.sgml b/doc/src/sgml/pgstattuple.sgml new file mode 100644 index cc2849b..a55b35c *** a/doc/src/sgml/pgstattuple.sgml --- b/doc/src/sgml/pgstattuple.sgml *************** *** 1,6 **** ! pgstattuple --- 1,6 ---- ! pgstattuple diff --git a/doc/src/sgml/pgtestfsync.sgml b/doc/src/sgml/pgtestfsync.sgml new file mode 100644 index 5ad7b73..4015eb5 *** a/doc/src/sgml/pgtestfsync.sgml --- b/doc/src/sgml/pgtestfsync.sgml *************** *** 1,6 **** ! pg_test_fsync --- 1,6 ---- ! pg_test_fsync diff --git a/doc/src/sgml/pgtrgm.sgml b/doc/src/sgml/pgtrgm.sgml new file mode 100644 index 581388c..18f0f3e *** a/doc/src/sgml/pgtrgm.sgml --- b/doc/src/sgml/pgtrgm.sgml *************** *** 1,6 **** ! pg_trgm --- 1,6 ---- ! pg_trgm diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml new file mode 100644 index c41068f..1713bf0 *** a/doc/src/sgml/pgupgrade.sgml --- b/doc/src/sgml/pgupgrade.sgml *************** *** 1,6 **** ! pg_upgrade --- 1,6 ---- ! pg_upgrade diff --git a/doc/src/sgml/seg.sgml b/doc/src/sgml/seg.sgml new file mode 100644 index a726ca1..00bd71d *** a/doc/src/sgml/seg.sgml --- b/doc/src/sgml/seg.sgml *************** *** 1,6 **** ! seg --- 1,6 ---- ! seg diff --git a/doc/src/sgml/sepgsql.sgml b/doc/src/sgml/sepgsql.sgml new file mode 100644 index 589fe79..f35ab97 *** a/doc/src/sgml/sepgsql.sgml --- b/doc/src/sgml/sepgsql.sgml *************** *** 1,6 **** ! sepgsql --- 1,6 ---- ! sepgsql diff --git a/doc/src/sgml/sslinfo.sgml b/doc/src/sgml/sslinfo.sgml new file mode 100644 index f7ccb8c..6181824 *** a/doc/src/sgml/sslinfo.sgml --- b/doc/src/sgml/sslinfo.sgml *************** *** 1,6 **** ! sslinfo --- 1,6 ---- ! sslinfo diff --git a/doc/src/sgml/tablefunc.sgml b/doc/src/sgml/tablefunc.sgml new file mode 100644 index 60f0b57..cfa20e2 *** a/doc/src/sgml/tablefunc.sgml --- b/doc/src/sgml/tablefunc.sgml *************** *** 1,6 **** ! tablefunc --- 1,6 ---- ! tablefunc diff --git a/doc/src/sgml/test-parser.sgml b/doc/src/sgml/test-parser.sgml new file mode 100644 index 0f2008c..28b1e91 *** a/doc/src/sgml/test-parser.sgml --- b/doc/src/sgml/test-parser.sgml *************** *** 1,6 **** ! test_parser --- 1,6 ---- ! test_parser diff --git a/doc/src/sgml/tsearch2.sgml b/doc/src/sgml/tsearch2.sgml new file mode 100644 index 8321c1e..192eccd *** a/doc/src/sgml/tsearch2.sgml --- b/doc/src/sgml/tsearch2.sgml *************** *** 1,6 **** ! tsearch2 --- 1,6 ---- ! tsearch2 diff --git a/doc/src/sgml/unaccent.sgml b/doc/src/sgml/unaccent.sgml new file mode 100644 index 9c34c0b..af9cad5 *** a/doc/src/sgml/unaccent.sgml --- b/doc/src/sgml/unaccent.sgml *************** *** 1,6 **** ! unaccent --- 1,6 ---- ! unaccent diff --git a/doc/src/sgml/uuid-ossp.sgml b/doc/src/sgml/uuid-ossp.sgml new file mode 100644 index 3dd8990..7446b8b *** a/doc/src/sgml/uuid-ossp.sgml --- b/doc/src/sgml/uuid-ossp.sgml *************** *** 1,6 **** ! uuid-ossp --- 1,6 ---- ! uuid-ossp diff --git a/doc/src/sgml/vacuumlo.sgml b/doc/src/sgml/vacuumlo.sgml new file mode 100644 index fbb6815..471a6ca *** a/doc/src/sgml/vacuumlo.sgml --- b/doc/src/sgml/vacuumlo.sgml *************** *** 1,6 **** ! vacuumlo --- 1,6 ---- ! vacuumlo diff --git a/doc/src/sgml/xml2.sgml b/doc/src/sgml/xml2.sgml new file mode 100644 index 8ce7351..90b5ac0 *** a/doc/src/sgml/xml2.sgml --- b/doc/src/sgml/xml2.sgml *************** *** 1,6 **** ! xml2 --- 1,6 ---- ! xml2 --ELM1304821532-11659-0_--