Doc: re-re-revise markup for tables of functions.
Tom Lane <tgl@sss.pgh.pa.us>
Doc: re-re-revise markup for tables of functions. Make the markup a bit less ad-hoc. A function-table cell now contains several <para> units, and we label the ones that contain function signatures with role="func_signature". The CSS or FO stylesheets then key off of that to decide how to set the indentation. A very useful win from this approach is that we can have more than one signature entry per table cell, simplifying the documentation of closely-related operators and functions. This patch mostly just replaces the markup in the tables I converted so far. But I did alter a couple of places where multiple signatures were helpful. Discussion: https://postgr.es/m/5561.1587922854@sss.pgh.pa.us
Files
| Path | Change | +/− |
|---|---|---|
| doc/src/sgml/func.sgml | modified | +2941 −1789 |
| doc/src/sgml/stylesheet-common.xsl | modified | +0 −7 |
| doc/src/sgml/stylesheet.css | modified | +14 −3 |
| doc/src/sgml/stylesheet-fo.xsl | modified | +7 −28 |
Documentation touched
Discussion
- Poll: are people okay with function/operator table redesign? 113 messages · 2020-04-13 → 2020-05-05