From: | Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> |
---|---|
To: | pgsql-docs <pgsql-docs(at)postgresql(dot)org> |
Subject: | remove endterms and title ids |
Date: | 2017-12-19 20:20:38 |
Message-ID: | 4a60dfc3-061b-01c4-2b86-279d3a612fd2@2ndquadrant.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
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
Attachment | Content-Type | Size |
---|---|---|
0001-Remove-endterms-and-title-ids.patch | text/plain | 46.0 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | PG Doc comments form | 2017-12-20 06:35:30 | titles dont have documentation |
Previous Message | PG Doc comments form | 2017-12-18 21:30:41 | pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader |