Re: Remaining PDF layout issues
Tom Lane <tgl@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-docs@lists.postgresql.org
Date: 2020-05-12T01:59:30Z
Lists: pgsql-docs
Attachments
- fix-wait-event-table.patch (text/x-diff) patch
I wrote: > Table 27.4 is annoying: it could be made to work, just barely, with some > hacking of the column widths and a &zwsp; or two. But it's not stable > text so I have little faith in the longevity of such a solution, > especially if people keep on inventing long wait event names. I also > find it not very readable, even in a wide window. The first idea that > comes to mind is to split it into multiple tables, one per "Wait Event > Type", so that we don't need the lefthand column. Another idea is to > go over to a format similar to what I've proposed for catalog tables, > with entries like > Timeout / BaseBackupThrottle > Descriptive text here ... > Timeout / RecoveryApplyDelay > Descriptive text here ... Attached is a draft patch that does it the second way. This looks reasonably okay to me, although there's no denying that given a reasonably wide window, the existing layout requires less vertical space. But I'm not sure that matters: I have come to the conclusion, after studying this table, that nobody has ever yet looked at it. If they had, we would surely have gotten gripes about the fact that most of the entries are not in anything resembling alphabetical order. How in the world would anyone look something up in this? I have not changed the ordering in this patch, but I think it would be a good idea to fix it to be rigidly alphabetical (including the "type" part). BTW, for the purposes of this patch I just abused the func_table_entry/func_signature role values. We could invent new ones, but I'm not sure if it's worthwhile for just one table. regards, tom lane
Commits
-
Doc: hack on table 26.1 till it fits in PDF format.
- 2e619f86a96c 13.0 landed
-
Doc: tweak examples to silence line-too-long PDF build warnings.
- 3d14c174cbbb 13.0 landed
-
Doc: split up wait_event table.
- 4fa8bd392d02 13.0 landed
-
Doc: hack table 13.2 "Conflicting Lock Modes" till it fits in PDF.
- 57775e82b235 13.0 landed
-
Doc: fix remaining over-length entries in SQL keywords table.
- 4d1563717fb1 13.0 landed