Commit f2159931 authored by Tom Lane's avatar Tom Lane

Doc: further fooling-about with rendering of tables in PDF output.

I concluded that we really just ought to force all tables in PDF output
to default to "left" alignment (instead of "justify"); that is what the
HTML toolchain does and that's what most people have been designing the
tables to look good with.  There are few if any places where "justify"
produces better-looking output, and there are many where it looks
horrible.  So change stylesheet-fo.xsl to make that true.

Also tweak column widths in a few more tables to make them look better
and avoid "exceed the available area" warnings.  This commit fixes
basically everything that can be fixed through that approach.  The
remaining tables that give warnings either are scheduled for redesign
as per recent discussions, or need a fundamental rethink because they
Just Don't Work in a narrow view.
parent beb2516e
......@@ -121,6 +121,9 @@ LOG: request for BRIN range summarization for index "brin_wi_idx" page 128 was
<table id="brin-builtin-opclasses-table">
<title>Built-in <acronym>BRIN</acronym> Operator Classes</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="2*"/>
<colspec colname="col3" colwidth="1*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -587,6 +590,8 @@ typedef struct BrinOpcInfo
<table id="brin-extensibility-minmax-table">
<title>Function and Support Numbers for Minmax Operator Classes</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Operator class member</entry>
......@@ -648,6 +653,9 @@ typedef struct BrinOpcInfo
<table id="brin-extensibility-inclusion-table">
<title>Function and Support Numbers for Inclusion Operator Classes</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<colspec colname="col3" colwidth="1*"/>
<thead>
<row>
<entry>Operator class member</entry>
......
......@@ -6258,6 +6258,10 @@ local0.* /var/log/postgresql
<table id="runtime-config-severity-levels">
<title>Message Severity Levels</title>
<tgroup cols="4">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<colspec colname="col3" colwidth="1*"/>
<colspec colname="col4" colwidth="1*"/>
<thead>
<row>
<entry>Severity</entry>
......@@ -6269,7 +6273,7 @@ local0.* /var/log/postgresql
<tbody>
<row>
<entry><literal>DEBUG1..DEBUG5</literal></entry>
<entry><literal>DEBUG1 .. DEBUG5</literal></entry>
<entry>Provides successively-more-detailed information for use by
developers.</entry>
<entry><literal>DEBUG</literal></entry>
......@@ -10288,6 +10292,8 @@ LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1)
<table id="runtime-config-short-table">
<title>Short Option Key</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Short Option</entry>
......
......@@ -31,6 +31,9 @@
<table id="datatype-table">
<title>Data Types</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -349,6 +352,10 @@
<table id="datatype-numeric-table">
<title>Numeric Types</title>
<tgroup cols="4">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<colspec colname="col4" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -965,6 +972,10 @@ ALTER SEQUENCE <replaceable class="parameter">tablename</replaceable>_<replaceab
<table id="datatype-money-table">
<title>Monetary Types</title>
<tgroup cols="4">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<colspec colname="col4" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -1299,6 +1310,9 @@ SELECT b, char_length(b) FROM test2;
<table id="datatype-binary-table">
<title>Binary Data Types</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="3*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -1415,6 +1429,11 @@ SELECT '\xDEADBEEF';
<table id="datatype-binary-sqlesc">
<title><type>bytea</type> Literal Escaped Octets</title>
<tgroup cols="5">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="1*"/>
<colspec colname="col4" colwidth="1.25*"/>
<colspec colname="col5" colwidth="1*"/>
<thead>
<row>
<entry>Decimal Octet Value</entry>
......@@ -1430,7 +1449,7 @@ SELECT '\xDEADBEEF';
<entry>0</entry>
<entry>zero octet</entry>
<entry><literal>'\000'</literal></entry>
<entry><literal>SELECT '\000'::bytea;</literal></entry>
<entry><literal>'\000'::bytea</literal></entry>
<entry><literal>\x00</literal></entry>
</row>
......@@ -1438,7 +1457,7 @@ SELECT '\xDEADBEEF';
<entry>39</entry>
<entry>single quote</entry>
<entry><literal>''''</literal> or <literal>'\047'</literal></entry>
<entry><literal>SELECT ''''::bytea;</literal></entry>
<entry><literal>''''::bytea</literal></entry>
<entry><literal>\x27</literal></entry>
</row>
......@@ -1446,7 +1465,7 @@ SELECT '\xDEADBEEF';
<entry>92</entry>
<entry>backslash</entry>
<entry><literal>'\\'</literal> or <literal>'\134'</literal></entry>
<entry><literal>SELECT '\\'::bytea;</literal></entry>
<entry><literal>'\\'::bytea</literal></entry>
<entry><literal>\x5c</literal></entry>
</row>
......@@ -1454,7 +1473,7 @@ SELECT '\xDEADBEEF';
<entry>0 to 31 and 127 to 255</entry>
<entry><quote>non-printable</quote> octets</entry>
<entry><literal>'\<replaceable>xxx'</replaceable></literal> (octal value)</entry>
<entry><literal>SELECT '\001'::bytea;</literal></entry>
<entry><literal>'\001'::bytea</literal></entry>
<entry><literal>\x01</literal></entry>
</row>
......@@ -1514,6 +1533,11 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
<table id="datatype-binary-resesc">
<title><type>bytea</type> Output Escaped Octets</title>
<tgroup cols="5">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="1*"/>
<colspec colname="col4" colwidth="1.25*"/>
<colspec colname="col5" colwidth="1*"/>
<thead>
<row>
<entry>Decimal Octet Value</entry>
......@@ -1530,7 +1554,7 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
<entry>92</entry>
<entry>backslash</entry>
<entry><literal>\\</literal></entry>
<entry><literal>SELECT '\134'::bytea;</literal></entry>
<entry><literal>'\134'::bytea</literal></entry>
<entry><literal>\\</literal></entry>
</row>
......@@ -1538,7 +1562,7 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
<entry>0 to 31 and 127 to 255</entry>
<entry><quote>non-printable</quote> octets</entry>
<entry><literal>\<replaceable>xxx</replaceable></literal> (octal value)</entry>
<entry><literal>SELECT '\001'::bytea;</literal></entry>
<entry><literal>'\001'::bytea</literal></entry>
<entry><literal>\001</literal></entry>
</row>
......@@ -1546,7 +1570,7 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
<entry>32 to 126</entry>
<entry><quote>printable</quote> octets</entry>
<entry>client character set representation</entry>
<entry><literal>SELECT '\176'::bytea;</literal></entry>
<entry><literal>'\176'::bytea</literal></entry>
<entry><literal>~</literal></entry>
</row>
......@@ -1789,6 +1813,8 @@ MINUTE TO SECOND
<table id="datatype-datetime-date-table">
<title>Date Input</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Example</entry>
......@@ -1910,6 +1936,8 @@ MINUTE TO SECOND
<table id="datatype-datetime-time-table">
<title>Time Input</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="3*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Example</entry>
......@@ -2252,6 +2280,9 @@ January 8 04:05:06 1999 PST
<table id="datatype-datetime-output-table">
<title>Date/Time Output Styles</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Style Specification</entry>
......@@ -2306,6 +2337,9 @@ January 8 04:05:06 1999 PST
<table id="datatype-datetime-output2-table">
<title>Date Order Conventions</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry><varname>datestyle</varname> Setting</entry>
......@@ -2721,23 +2755,23 @@ P <optional> <replaceable>years</replaceable>-<replaceable>months</replaceable>-
</thead>
<tbody>
<row>
<entry>1-2</entry>
<entry><literal>1-2</literal></entry>
<entry>SQL standard format: 1 year 2 months</entry>
</row>
<row>
<entry>3 4:05:06</entry>
<entry><literal>3 4:05:06</literal></entry>
<entry>SQL standard format: 3 days 4 hours 5 minutes 6 seconds</entry>
</row>
<row>
<entry>1 year 2 months 3 days 4 hours 5 minutes 6 seconds</entry>
<entry><literal>1 year 2 months 3 days 4 hours 5 minutes 6 seconds</literal></entry>
<entry>Traditional Postgres format: 1 year 2 months 3 days 4 hours 5 minutes 6 seconds</entry>
</row>
<row>
<entry>P1Y2M3DT4H5M6S</entry>
<entry><literal>P1Y2M3DT4H5M6S</literal></entry>
<entry>ISO 8601 <quote>format with designators</quote>: same meaning as above</entry>
</row>
<row>
<entry>P0001-02-03T04:05:06</entry>
<entry><literal>P0001-02-03T04:05:06</literal></entry>
<entry>ISO 8601 <quote>alternative format</quote>: same meaning as above</entry>
</row>
</tbody>
......@@ -3159,6 +3193,10 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
<table id="datatype-geo-table">
<title>Geometric Types</title>
<tgroup cols="4">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<colspec colname="col4" colwidth="1*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -3485,6 +3523,9 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
<table tocentry="1" id="datatype-net-types-table">
<title>Network Address Types</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -4897,6 +4938,8 @@ SELECT * FROM pg_attribute
<table id="datatype-pseudotypes-table">
<title>Pseudo-Types</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......
......@@ -1882,6 +1882,9 @@ REVOKE ALL ON accounts FROM PUBLIC;
<table id="privilege-abbrevs-table">
<title>ACL Privilege Abbreviations</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Privilege</entry>
......@@ -1987,6 +1990,10 @@ REVOKE ALL ON accounts FROM PUBLIC;
<table id="privileges-summary-table">
<title>Summary of Access Privileges</title>
<tgroup cols="4">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="1*"/>
<colspec colname="col4" colwidth="1*"/>
<thead>
<row>
<entry>Object Type</entry>
......
This diff is collapsed.
......@@ -242,6 +242,9 @@
<table id="extend-types-polymorphic-table">
<title>Polymorphic Types</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......
......@@ -132,6 +132,9 @@
<table id="json-type-mapping-table">
<title>JSON Primitive Types and Corresponding <productname>PostgreSQL</productname> Types</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>JSON primitive type</entry>
......@@ -742,6 +745,8 @@ SELECT jdoc-&gt;'guid', jdoc-&gt;'name' FROM api WHERE jdoc @&gt; '{"tags": ["qu
<table id="type-jsonpath-variables">
<title><type>jsonpath</type> Variables</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Variable</entry>
......@@ -777,6 +782,8 @@ SELECT jdoc-&gt;'guid', jdoc-&gt;'name' FROM api WHERE jdoc @&gt; '{"tags": ["qu
<table id="type-jsonpath-accessors">
<title><type>jsonpath</type> Accessors</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Accessor Operator</entry>
......
......@@ -7763,6 +7763,10 @@ ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*)
<table id="libpq-ssl-sslmode-statements">
<title>SSL Mode Descriptions</title>
<tgroup cols="4">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="1*"/>
<colspec colname="col4" colwidth="2*"/>
<thead>
<row>
<entry><literal>sslmode</literal></entry>
......
......@@ -3784,6 +3784,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
<table id="analyze-phases">
<title>ANALYZE phases</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Phase</entry>
......@@ -3988,6 +3990,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
<table id="create-index-phases">
<title>CREATE INDEX Phases</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Phase</entry>
......@@ -4217,6 +4221,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
<table id="vacuum-phases">
<title>VACUUM Phases</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Phase</entry>
......@@ -4411,6 +4417,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
<table id="cluster-phases">
<title>CLUSTER and VACUUM FULL Phases</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Phase</entry>
......@@ -4559,6 +4567,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
<table id="basebackup-phases">
<title>Base backup phases</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Phase</entry>
......@@ -4686,6 +4696,9 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
<table id="dtrace-probe-point-table">
<title>Built-in DTrace Probes</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="3*"/>
<colspec colname="col3" colwidth="3*"/>
<thead>
<row>
<entry>Name</entry>
......
......@@ -1289,8 +1289,11 @@ ERROR: could not serialize access due to read/write dependencies among transact
<table tocentry="1" id="row-lock-compatibility">
<title>Conflicting Row-Level Locks</title>
<tgroup cols="5">
<colspec colnum="2" colname="lockst"/>
<colspec colnum="5" colname="lockend"/>
<colspec colname="col1" colwidth="1.5*"/>
<colspec colname="lockst" colwidth="1*"/>
<colspec colname="col3" colwidth="1*"/>
<colspec colname="col4" colwidth="1*"/>
<colspec colname="lockend" colwidth="1*"/>
<spanspec namest="lockst" nameend="lockend" spanname="lockreq"/>
<thead>
<row>
......
......@@ -1493,6 +1493,9 @@ GET DIAGNOSTICS integer_var = ROW_COUNT;
<table id="plpgsql-current-diagnostics-values">
<title>Available Diagnostics Items</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......@@ -2820,6 +2823,9 @@ GET STACKED DIAGNOSTICS <replaceable>variable</replaceable> { = | := } <replacea
<table id="plpgsql-exception-diagnostics-values">
<title>Error Diagnostics Items</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Name</entry>
......
......@@ -709,6 +709,9 @@ psql: could not connect to server: No such file or directory
<title><systemitem class="osname">System V</systemitem> <acronym>IPC</acronym> Parameters</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="3*"/>
<colspec colname="col3" colwidth="3*"/>
<thead>
<row>
<entry>Name</entry>
......
......@@ -32,6 +32,11 @@
<xsl:attribute name="text-align">center</xsl:attribute>
</xsl:attribute-set>
<!-- Make all tables default to left alignment, for consistency with HTML -->
<xsl:attribute-set name="table.table.properties">
<xsl:attribute name="text-align">left</xsl:attribute>
</xsl:attribute-set>
<!-- fix missing space after vertical simplelist
https://github.com/docbook/xslt10-stylesheets/issues/31 -->
<xsl:attribute-set name="normal.para.spacing">
......
......@@ -1004,6 +1004,9 @@ SELECT (5 !) - 6;
<title>Operator Precedence (highest to lowest)</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>Operator/Element</entry>
......
......@@ -2074,6 +2074,9 @@ LIMIT 10;
<table id="textsearch-default-parser">
<title>Default Parser's Token Types</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="2*"/>
<colspec colname="col3" colwidth="3*"/>
<thead>
<row>
<entry>Alias</entry>
......
......@@ -508,6 +508,8 @@ DROP ROLE doomed_role;
<table tocentry="1" id="default-roles-table">
<title>Default Roles</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2*"/>
<thead>
<row>
<entry>Role</entry>
......
......@@ -2084,6 +2084,9 @@ memcpy(destination->data, buffer, 40);
<table tocentry="1" id="xfunc-c-type-table">
<title>Equivalent C Types for Built-in SQL Types</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>
<colspec colname="col3" colwidth="2*"/>
<thead>
<row>
<entry>
......
......@@ -412,6 +412,8 @@
<table tocentry="1" id="xindex-btree-support-table">
<title>B-Tree Support Functions</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="3*"/>
<colspec colname="col2" colwidth="1*"/>
<thead>
<row>
<entry>Function</entry>
......@@ -461,6 +463,8 @@
<table tocentry="1" id="xindex-hash-support-table">
<title>Hash Support Functions</title>
<tgroup cols="2">
<colspec colname="col1" colwidth="3*"/>
<colspec colname="col2" colwidth="1*"/>
<thead>
<row>
<entry>Function</entry>
......@@ -494,6 +498,9 @@
<table tocentry="1" id="xindex-gist-support-table">
<title>GiST Support Functions</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="3*"/>
<colspec colname="col3" colwidth="1*"/>
<thead>
<row>
<entry>Function</entry>
......@@ -566,6 +573,9 @@
<table tocentry="1" id="xindex-spgist-support-table">
<title>SP-GiST Support Functions</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="3*"/>
<colspec colname="col3" colwidth="1*"/>
<thead>
<row>
<entry>Function</entry>
......@@ -614,6 +624,9 @@
<table tocentry="1" id="xindex-gin-support-table">
<title>GIN Support Functions</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="3*"/>
<colspec colname="col3" colwidth="1*"/>
<thead>
<row>
<entry>Function</entry>
......@@ -681,6 +694,9 @@
<table tocentry="1" id="xindex-brin-support-table">
<title>BRIN Support Functions</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="2*"/>
<colspec colname="col2" colwidth="3*"/>
<colspec colname="col3" colwidth="1*"/>
<thead>
<row>
<entry>Function</entry>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment