Doc: re-re-revise markup for tables of functions.
authorTom Lane <tgl@sss.pgh.pa.us>
Thu, 30 Apr 2020 04:34:05 +0000 (00:34 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Thu, 30 Apr 2020 04:34:12 +0000 (00:34 -0400)
commit4ad047a6eac356436b88681a9383a52cde2ffe9c
treeb0f987aabce83eb469f9186baa9dea75a89cc4d9
parentab2343d4cb806c43e8a7269d38b3bdddea185213
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
doc/src/sgml/func.sgml
doc/src/sgml/stylesheet-common.xsl
doc/src/sgml/stylesheet-fo.xsl
doc/src/sgml/stylesheet.css