forked frompostgres/postgres
- Notifications
You must be signed in to change notification settings - Fork6
Commit737d69f
committed
Doc: revise formatting of function/operator tables.
The table layout ideas proposed in commite894c61 were not as widelypopular as I'd hoped. After discussion, we've settled on a layoutthat's effectively a single-column table with cell contents much like a<varlistentry> description of the function or operator; though we're notactually using <varlistentry>, because it'd add way too much verticalspace. Instead the effect is accomplished using line-break processinginstructions to separate the description and example(s), plus CSS or FOcustomizations to produce indentation of all but the first line in eachcell. While technically this is a bit grotty, it does have theadvantage that we won't need to write nearly as much boilerplate markup.This patch updates tables 9.30, 9.31, and 9.33 (which were touched bythe previous patch) to the revised style, and additionally convertstable 9.10. A lot of work still remains to do, but hopefully it won'tbe too controversial.Thanks to Andrew Dunstan, Pierre Giraud, Robert Haas, Alvaro Herrera,David Johnston, Jonathan Katz, Isaac Morland for valuable ideas.Discussion:https://postgr.es/m/8691.1586798003@sss.pgh.pa.us1 parent6741cfa commit737d69f
File tree
4 files changed
+937
-1041
lines changed- doc/src/sgml
4 files changed
+937
-1041
lines changed0 commit comments
Comments
(0)