database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-10-25 13:17:41 +03:00
Code Activity

Doc: re-re-revise markup for tables of functions.

Browse Source 
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
This commit is contained in:
Tom Lane
2020-04-30 00:34:05 -04:00
parent ab2343d4cb
commit 4ad047a6ea
4 changed files with 2962 additions and 1827 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
doc/src/sgml/stylesheet.css
View File

@@ -78,13 +78,24 @@ div.example {
/* formatting for entries in tables of functions: indent all but first line */
th.functableentry,
td.functableentry {
th.func_table_entry p,
td.func_table_entry p {
margin-top: 0.1em;
margin-bottom: 0.1em;
padding-left: 4em;
text-indent: -3.5em;
text-align: left;
}
p.func_signature {
text-indent: -3.5em;
}
td.func_table_entry pre.programlisting {
margin-top: 0.1em;
margin-bottom: 0.1em;
padding-left: 4em;
}
/* Put these here instead of inside the HTML (see unsetting of
admon.style in XSL) so that the web site stylesheet can set its own
style. */