pgsql: Doc: improve PDF presentation of some tables by adjusting column - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Doc: improve PDF presentation of some tables by adjusting column
Date
Msg-id E1jVhWO-0006uu-04@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Doc: improve PDF presentation of some tables by adjusting column widths.

The PDF toolchain defaults to laying out all columns of a table with
equal widths, in contrast to the HTML rendering which automatically
varies the column widths to fit the data.  In many places, this
results in very badly laid-out tables, with lots of useless whitespace
in some places and text that overruns its cell in other places.

For tables that have reasonably static content, we can improve
matters by adding <colspec> entries to hand-assign the column widths.
This commit does that for a few of the tables that were worst off;
it eliminates close to 200 "contents ... exceed the available area"
warnings in an A4 PDF build.

I also forced align="left" in these tables, overriding the PDF
toolchain's default which is evidently "justify".  (The HTML toolchain
seems to default to that already.)  Anyplace where things are tight
enough that we need to worry about this, forced justification tends to
look truly awful.

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/5545b69ae65f27ba1f4ceaf24486e98c186e9412

Modified Files
--------------
doc/src/sgml/charset.sgml               | 16 +++++++++++++++-
doc/src/sgml/errcodes.sgml              |  4 ++--
doc/src/sgml/features.sgml              |  8 ++++++++
doc/src/sgml/generate-keywords-table.pl |  5 +++++
4 files changed, 30 insertions(+), 3 deletions(-)


pgsql-committers by date:

Previous
From: Peter Geoghegan
Date:
Subject: pgsql: Add posting list tuple amcheck test case.
Next
From: Amit Kapila
Date:
Subject: pgsql: Change the display of WAL usage statistics in Explain.