Doc: improve PDF presentation of some tables by adjusting column widths.
authorTom Lane
Mon, 4 May 2020 20:16:42 +0000 (16:16 -0400)
committerTom Lane
Mon, 4 May 2020 20:16:48 +0000 (16:16 -0400)
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  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.

doc/src/sgml/charset.sgml
doc/src/sgml/errcodes.sgml
doc/src/sgml/features.sgml
doc/src/sgml/generate-keywords-table.pl

index b6023fa459e6ee6740b1850656967b36cfd96872..04e71f17d30e648053fb3ae62c2da2ab9672fc2f 100644 (file)
@@ -95,6 +95,8 @@ initdb --locale=sv_SE
 
     
      
+      
+      
       
        
         LC_COLLATE
@@ -993,6 +995,13 @@ CREATE COLLATION ignore_accents (provider = icu, locale = 'und-u-ks-level1-kc-tr
      
       <productname>PostgreSQL</productname> Character Sets
       
+       
+       
+       
+       
+       
+       
+       
        
         
          Name
@@ -1004,7 +1013,7 @@ CREATE COLLATION ignore_accents (provider = icu, locale = 'und-u-ks-level1-kc-tr
           The Bytes/Char field is populated by looking at the values returned
           by pg_wchar_table.mblen function for each encoding.
          -->
-         Bytes/Char
+         Bytes/&zwsp;Char
          Aliases
         
        
@@ -1635,6 +1644,8 @@ RESET client_encoding;
     
      Built-in Client/Server Character Set Conversions
      
+      
+      
       
        
         Server Character Set
@@ -1933,6 +1944,9 @@ RESET client_encoding;
     
      All Built-in Character Set Conversions
      
+      
+      
+      
       
        
         Conversion Name
index 6fd16f643eaf35ddad13bb1be61d409439e00e88..f0ef0500339e28fcbd0910a1ad967923a09ee5a6 100644 (file)
@@ -66,8 +66,8 @@
  <productname>PostgreSQL</productname> Error Codes
 
  
-  
-  
+   align="left" colwidth="1*"/>
+   align="left" colwidth="8*"/>
   
 
   
index b4596a9eb24ecf447c142503aa66d8c374562fd9..330481ff6a1db7af0e4bc568c128b7a37f876b73 100644 (file)
    
     
      
+      
+      
+      
+      
       
        
         Identifier
 
     
      
+      
+      
+      
+      
       
        
         Identifier
index 086a158e798a9110d4c24e175887915bdcec22b4..a975b058d8459d99d5b0828534fe2fe2f7d8bcbf 100644 (file)
@@ -56,6 +56,11 @@ print <
  <acronym>SQL</acronym> Key Words
 
  
+  
+  
+  
+  
+  
   
    
     Key Word