Skip to content

Commit f215993

Browse files
tglsfdctglsfdc
committed
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.
1 parent beb2516 commit f215993

18 files changed

+269
-128
lines changed

‎doc/src/sgml/brin.sgml‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,9 @@ LOG: request for BRIN range summarization for index "brin_wi_idx" page 128 was
121121
<table id="brin-builtin-opclasses-table">
122122
<title>Built-in <acronym>BRIN</acronym> Operator Classes</title>
123123
<tgroup cols="3">
124+
<colspec colname="col1" colwidth="2*"/>
125+
<colspec colname="col2" colwidth="2*"/>
126+
<colspec colname="col3" colwidth="1*"/>
124127
<thead>
125128
<row>
126129
<entry>Name</entry>
@@ -587,6 +590,8 @@ typedef struct BrinOpcInfo
587590
<table id="brin-extensibility-minmax-table">
588591
<title>Function and Support Numbers for Minmax Operator Classes</title>
589592
<tgroup cols="2">
593+
<colspec colname="col1" colwidth="1*"/>
594+
<colspec colname="col2" colwidth="2*"/>
590595
<thead>
591596
<row>
592597
<entry>Operator class member</entry>
@@ -648,6 +653,9 @@ typedef struct BrinOpcInfo
648653
<table id="brin-extensibility-inclusion-table">
649654
<title>Function and Support Numbers for Inclusion Operator Classes</title>
650655
<tgroup cols="3">
656+
<colspec colname="col1" colwidth="1*"/>
657+
<colspec colname="col2" colwidth="2*"/>
658+
<colspec colname="col3" colwidth="1*"/>
651659
<thead>
652660
<row>
653661
<entry>Operator class member</entry>

‎doc/src/sgml/config.sgml‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6258,6 +6258,10 @@ local0.* /var/log/postgresql
62586258
<table id="runtime-config-severity-levels">
62596259
<title>Message Severity Levels</title>
62606260
<tgroup cols="4">
6261+
<colspec colname="col1" colwidth="1*"/>
6262+
<colspec colname="col2" colwidth="2*"/>
6263+
<colspec colname="col3" colwidth="1*"/>
6264+
<colspec colname="col4" colwidth="1*"/>
62616265
<thead>
62626266
<row>
62636267
<entry>Severity</entry>
@@ -6269,7 +6273,7 @@ local0.* /var/log/postgresql
62696273

62706274
<tbody>
62716275
<row>
6272-
<entry><literal>DEBUG1..DEBUG5</literal></entry>
6276+
<entry><literal>DEBUG1 .. DEBUG5</literal></entry>
62736277
<entry>Provides successively-more-detailed information for use by
62746278
developers.</entry>
62756279
<entry><literal>DEBUG</literal></entry>
@@ -10288,6 +10292,8 @@ LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1)
1028810292
<table id="runtime-config-short-table">
1028910293
<title>Short Option Key</title>
1029010294
<tgroup cols="2">
10295+
<colspec colname="col1" colwidth="1*"/>
10296+
<colspec colname="col2" colwidth="2*"/>
1029110297
<thead>
1029210298
<row>
1029310299
<entry>Short Option</entry>

‎doc/src/sgml/datatype.sgml‎

Lines changed: 55 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,9 @@
3131
<table id="datatype-table">
3232
<title>Data Types</title>
3333
<tgroup cols="3">
34+
<colspec colname="col1" colwidth="2*"/>
35+
<colspec colname="col2" colwidth="1*"/>
36+
<colspec colname="col3" colwidth="2*"/>
3437
<thead>
3538
<row>
3639
<entry>Name</entry>
@@ -349,6 +352,10 @@
349352
<table id="datatype-numeric-table">
350353
<title>Numeric Types</title>
351354
<tgroup cols="4">
355+
<colspec colname="col1" colwidth="2*"/>
356+
<colspec colname="col2" colwidth="1*"/>
357+
<colspec colname="col3" colwidth="2*"/>
358+
<colspec colname="col4" colwidth="2*"/>
352359
<thead>
353360
<row>
354361
<entry>Name</entry>
@@ -965,6 +972,10 @@ ALTER SEQUENCE <replaceable class="parameter">tablename</replaceable>_<replaceab
965972
<table id="datatype-money-table">
966973
<title>Monetary Types</title>
967974
<tgroup cols="4">
975+
<colspec colname="col1" colwidth="2*"/>
976+
<colspec colname="col2" colwidth="1*"/>
977+
<colspec colname="col3" colwidth="2*"/>
978+
<colspec colname="col4" colwidth="2*"/>
968979
<thead>
969980
<row>
970981
<entry>Name</entry>
@@ -1299,6 +1310,9 @@ SELECT b, char_length(b) FROM test2;
12991310
<table id="datatype-binary-table">
13001311
<title>Binary Data Types</title>
13011312
<tgroup cols="3">
1313+
<colspec colname="col1" colwidth="1*"/>
1314+
<colspec colname="col2" colwidth="3*"/>
1315+
<colspec colname="col3" colwidth="2*"/>
13021316
<thead>
13031317
<row>
13041318
<entry>Name</entry>
@@ -1415,6 +1429,11 @@ SELECT '\xDEADBEEF';
14151429
<table id="datatype-binary-sqlesc">
14161430
<title><type>bytea</type> Literal Escaped Octets</title>
14171431
<tgroup cols="5">
1432+
<colspec colname="col1" colwidth="1*"/>
1433+
<colspec colname="col2" colwidth="1*"/>
1434+
<colspec colname="col3" colwidth="1*"/>
1435+
<colspec colname="col4" colwidth="1.25*"/>
1436+
<colspec colname="col5" colwidth="1*"/>
14181437
<thead>
14191438
<row>
14201439
<entry>Decimal Octet Value</entry>
@@ -1430,31 +1449,31 @@ SELECT '\xDEADBEEF';
14301449
<entry>0</entry>
14311450
<entry>zero octet</entry>
14321451
<entry><literal>'\000'</literal></entry>
1433-
<entry><literal>SELECT '\000'::bytea;</literal></entry>
1452+
<entry><literal>'\000'::bytea</literal></entry>
14341453
<entry><literal>\x00</literal></entry>
14351454
</row>
14361455

14371456
<row>
14381457
<entry>39</entry>
14391458
<entry>single quote</entry>
14401459
<entry><literal>''''</literal> or <literal>'\047'</literal></entry>
1441-
<entry><literal>SELECT ''''::bytea;</literal></entry>
1460+
<entry><literal>''''::bytea</literal></entry>
14421461
<entry><literal>\x27</literal></entry>
14431462
</row>
14441463

14451464
<row>
14461465
<entry>92</entry>
14471466
<entry>backslash</entry>
14481467
<entry><literal>'\\'</literal> or <literal>'\134'</literal></entry>
1449-
<entry><literal>SELECT '\\'::bytea;</literal></entry>
1468+
<entry><literal>'\\'::bytea</literal></entry>
14501469
<entry><literal>\x5c</literal></entry>
14511470
</row>
14521471

14531472
<row>
14541473
<entry>0 to 31 and 127 to 255</entry>
14551474
<entry><quote>non-printable</quote> octets</entry>
14561475
<entry><literal>'\<replaceable>xxx'</replaceable></literal> (octal value)</entry>
1457-
<entry><literal>SELECT '\001'::bytea;</literal></entry>
1476+
<entry><literal>'\001'::bytea</literal></entry>
14581477
<entry><literal>\x01</literal></entry>
14591478
</row>
14601479

@@ -1514,6 +1533,11 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
15141533
<table id="datatype-binary-resesc">
15151534
<title><type>bytea</type> Output Escaped Octets</title>
15161535
<tgroup cols="5">
1536+
<colspec colname="col1" colwidth="1*"/>
1537+
<colspec colname="col2" colwidth="1*"/>
1538+
<colspec colname="col3" colwidth="1*"/>
1539+
<colspec colname="col4" colwidth="1.25*"/>
1540+
<colspec colname="col5" colwidth="1*"/>
15171541
<thead>
15181542
<row>
15191543
<entry>Decimal Octet Value</entry>
@@ -1530,23 +1554,23 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
15301554
<entry>92</entry>
15311555
<entry>backslash</entry>
15321556
<entry><literal>\\</literal></entry>
1533-
<entry><literal>SELECT '\134'::bytea;</literal></entry>
1557+
<entry><literal>'\134'::bytea</literal></entry>
15341558
<entry><literal>\\</literal></entry>
15351559
</row>
15361560

15371561
<row>
15381562
<entry>0 to 31 and 127 to 255</entry>
15391563
<entry><quote>non-printable</quote> octets</entry>
15401564
<entry><literal>\<replaceable>xxx</replaceable></literal> (octal value)</entry>
1541-
<entry><literal>SELECT '\001'::bytea;</literal></entry>
1565+
<entry><literal>'\001'::bytea</literal></entry>
15421566
<entry><literal>\001</literal></entry>
15431567
</row>
15441568

15451569
<row>
15461570
<entry>32 to 126</entry>
15471571
<entry><quote>printable</quote> octets</entry>
15481572
<entry>client character set representation</entry>
1549-
<entry><literal>SELECT '\176'::bytea;</literal></entry>
1573+
<entry><literal>'\176'::bytea</literal></entry>
15501574
<entry><literal>~</literal></entry>
15511575
</row>
15521576

@@ -1789,6 +1813,8 @@ MINUTE TO SECOND
17891813
<table id="datatype-datetime-date-table">
17901814
<title>Date Input</title>
17911815
<tgroup cols="2">
1816+
<colspec colname="col1" colwidth="1*"/>
1817+
<colspec colname="col2" colwidth="2*"/>
17921818
<thead>
17931819
<row>
17941820
<entry>Example</entry>
@@ -1910,6 +1936,8 @@ MINUTE TO SECOND
19101936
<table id="datatype-datetime-time-table">
19111937
<title>Time Input</title>
19121938
<tgroup cols="2">
1939+
<colspec colname="col1" colwidth="3*"/>
1940+
<colspec colname="col2" colwidth="2*"/>
19131941
<thead>
19141942
<row>
19151943
<entry>Example</entry>
@@ -2252,6 +2280,9 @@ January 8 04:05:06 1999 PST
22522280
<table id="datatype-datetime-output-table">
22532281
<title>Date/Time Output Styles</title>
22542282
<tgroup cols="3">
2283+
<colspec colname="col1" colwidth="1*"/>
2284+
<colspec colname="col2" colwidth="1*"/>
2285+
<colspec colname="col3" colwidth="2*"/>
22552286
<thead>
22562287
<row>
22572288
<entry>Style Specification</entry>
@@ -2306,6 +2337,9 @@ January 8 04:05:06 1999 PST
23062337
<table id="datatype-datetime-output2-table">
23072338
<title>Date Order Conventions</title>
23082339
<tgroup cols="3">
2340+
<colspec colname="col1" colwidth="1*"/>
2341+
<colspec colname="col2" colwidth="1*"/>
2342+
<colspec colname="col3" colwidth="2*"/>
23092343
<thead>
23102344
<row>
23112345
<entry><varname>datestyle</varname> Setting</entry>
@@ -2721,23 +2755,23 @@ P <optional> <replaceable>years</replaceable>-<replaceable>months</replaceable>-
27212755
</thead>
27222756
<tbody>
27232757
<row>
2724-
<entry>1-2</entry>
2758+
<entry><literal>1-2</literal></entry>
27252759
<entry>SQL standard format: 1 year 2 months</entry>
27262760
</row>
27272761
<row>
2728-
<entry>3 4:05:06</entry>
2762+
<entry><literal>3 4:05:06</literal></entry>
27292763
<entry>SQL standard format: 3 days 4 hours 5 minutes 6 seconds</entry>
27302764
</row>
27312765
<row>
2732-
<entry>1 year 2 months 3 days 4 hours 5 minutes 6 seconds</entry>
2766+
<entry><literal>1 year 2 months 3 days 4 hours 5 minutes 6 seconds</literal></entry>
27332767
<entry>Traditional Postgres format: 1 year 2 months 3 days 4 hours 5 minutes 6 seconds</entry>
27342768
</row>
27352769
<row>
2736-
<entry>P1Y2M3DT4H5M6S</entry>
2770+
<entry><literal>P1Y2M3DT4H5M6S</literal></entry>
27372771
<entry>ISO 8601 <quote>format with designators</quote>: same meaning as above</entry>
27382772
</row>
27392773
<row>
2740-
<entry>P0001-02-03T04:05:06</entry>
2774+
<entry><literal>P0001-02-03T04:05:06</literal></entry>
27412775
<entry>ISO 8601 <quote>alternative format</quote>: same meaning as above</entry>
27422776
</row>
27432777
</tbody>
@@ -3159,6 +3193,10 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
31593193
<table id="datatype-geo-table">
31603194
<title>Geometric Types</title>
31613195
<tgroup cols="4">
3196+
<colspec colname="col1" colwidth="1*"/>
3197+
<colspec colname="col2" colwidth="1*"/>
3198+
<colspec colname="col3" colwidth="2*"/>
3199+
<colspec colname="col4" colwidth="1*"/>
31623200
<thead>
31633201
<row>
31643202
<entry>Name</entry>
@@ -3485,6 +3523,9 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
34853523
<table tocentry="1" id="datatype-net-types-table">
34863524
<title>Network Address Types</title>
34873525
<tgroup cols="3">
3526+
<colspec colname="col1" colwidth="1*"/>
3527+
<colspec colname="col2" colwidth="1*"/>
3528+
<colspec colname="col3" colwidth="2*"/>
34883529
<thead>
34893530
<row>
34903531
<entry>Name</entry>
@@ -4897,6 +4938,8 @@ SELECT * FROM pg_attribute
48974938
<table id="datatype-pseudotypes-table">
48984939
<title>Pseudo-Types</title>
48994940
<tgroup cols="2">
4941+
<colspec colname="col1" colwidth="1*"/>
4942+
<colspec colname="col2" colwidth="2*"/>
49004943
<thead>
49014944
<row>
49024945
<entry>Name</entry>

‎doc/src/sgml/ddl.sgml‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1882,6 +1882,9 @@ REVOKE ALL ON accounts FROM PUBLIC;
18821882
<table id="privilege-abbrevs-table">
18831883
<title>ACL Privilege Abbreviations</title>
18841884
<tgroup cols="3">
1885+
<colspec colname="col1" colwidth="1*"/>
1886+
<colspec colname="col2" colwidth="1*"/>
1887+
<colspec colname="col3" colwidth="2*"/>
18851888
<thead>
18861889
<row>
18871890
<entry>Privilege</entry>
@@ -1987,6 +1990,10 @@ REVOKE ALL ON accounts FROM PUBLIC;
19871990
<table id="privileges-summary-table">
19881991
<title>Summary of Access Privileges</title>
19891992
<tgroup cols="4">
1993+
<colspec colname="col1" colwidth="2*"/>
1994+
<colspec colname="col2" colwidth="1*"/>
1995+
<colspec colname="col3" colwidth="1*"/>
1996+
<colspec colname="col4" colwidth="1*"/>
19901997
<thead>
19911998
<row>
19921999
<entry>Object Type</entry>

0 commit comments

Comments
 (0)