Doc: further fooling-about with rendering of tables in PDF output.
authorTom Lane
Wed, 6 May 2020 16:23:43 +0000 (12:23 -0400)
committerTom Lane
Wed, 6 May 2020 16:23:54 +0000 (12:23 -0400)
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.

18 files changed:
doc/src/sgml/brin.sgml
doc/src/sgml/config.sgml
doc/src/sgml/datatype.sgml
doc/src/sgml/ddl.sgml
doc/src/sgml/event-trigger.sgml
doc/src/sgml/extend.sgml
doc/src/sgml/json.sgml
doc/src/sgml/libpq.sgml
doc/src/sgml/monitoring.sgml
doc/src/sgml/mvcc.sgml
doc/src/sgml/plpgsql.sgml
doc/src/sgml/runtime.sgml
doc/src/sgml/stylesheet-fo.xsl
doc/src/sgml/syntax.sgml
doc/src/sgml/textsearch.sgml
doc/src/sgml/user-manag.sgml
doc/src/sgml/xfunc.sgml
doc/src/sgml/xindex.sgml

index 176f1cfbd06848202e5987c0e2b04cf48dc11019..46a7d07bf8b670d77692a796ad1adb1db0c0e3bc 100644 (file)
@@ -121,6 +121,9 @@ LOG:  request for BRIN range summarization for index "brin_wi_idx" page 128 was
  
   Built-in <acronym>BRIN</acronym> Operator Classes
   
+   
+   
+   
    
     
      Name
@@ -587,6 +590,8 @@ typedef struct BrinOpcInfo
  
   Function and Support Numbers for Minmax Operator Classes
   
+   
+   
    
     
      Operator class member
@@ -648,6 +653,9 @@ typedef struct BrinOpcInfo
  
   Function and Support Numbers for Inclusion Operator Classes
   
+   
+   
+   
    
     
      Operator class member
index 48d1c8d6414130c0f301364e6e39f3944c631783..3aea1763b48ad4fe6b5067ca550708a8675daf7f 100644 (file)
@@ -6258,6 +6258,10 @@ local0.*    /var/log/postgresql
     
      Message Severity Levels
      
+      
+      
+      
+      
       
        
         Severity
@@ -6269,7 +6273,7 @@ local0.*    /var/log/postgresql
 
       
        
-        DEBUG1..DEBUG5
+        DEBUG1 .. DEBUG5
         Provides successively-more-detailed information for use by
          developers.
         DEBUG
@@ -10288,6 +10292,8 @@ LOG:  CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1)
     
      Short Option Key
      
+      
+      
       
        
         Short Option
index 22eda0f4e9ed4f65abbbf09da4ac5b6a0bea92b1..a8d078038796bccb0325449ec47bc8ac214bd719 100644 (file)
@@ -31,6 +31,9 @@
    
     Data Types
     
+     
+     
+     
      
       
        Name
     
      Numeric Types
      
+      
+      
+      
+      
       
        
         Name
@@ -965,6 +972,10 @@ ALTER SEQUENCE tablename_
     
      Monetary Types
      
+      
+      
+      
+      
       
        
         Name
@@ -1299,6 +1310,9 @@ SELECT b, char_length(b) FROM test2;
    
     Binary Data Types
     
+     
+     
+     
      
       
        Name
@@ -1415,6 +1429,11 @@ SELECT '\xDEADBEEF';
    
     <type>bytea</type> Literal Escaped Octets
     
+     
+     
+     
+     
+     
      
       
        Decimal Octet Value
@@ -1430,7 +1449,7 @@ SELECT '\xDEADBEEF';
        0
        zero octet
        '\000'
-       SELECT '\000'::bytea;
+       '\000'::bytea
        \x00
       
 
@@ -1438,7 +1457,7 @@ SELECT '\xDEADBEEF';
        39
        single quote
        '''' or '\047'
-       SELECT ''''::bytea;
+       ''''::bytea
        \x27
       
 
@@ -1446,7 +1465,7 @@ SELECT '\xDEADBEEF';
        92
        backslash
        '\\' or '\134'
-       SELECT '\\'::bytea;
+       '\\'::bytea
        \x5c
       
 
@@ -1454,7 +1473,7 @@ SELECT '\xDEADBEEF';
        0 to 31 and 127 to 255
        non-printable octets
        '\xxx' (octal value)
-       SELECT '\001'::bytea;
+       '\001'::bytea
        \x01
       
 
@@ -1514,6 +1533,11 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
    
     <type>bytea</type> Output Escaped Octets
     
+     
+     
+     
+     
+     
      
       
        Decimal Octet Value
@@ -1530,7 +1554,7 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
        92
        backslash
        \\
-       SELECT '\134'::bytea;
+       '\134'::bytea
        \\
       
 
@@ -1538,7 +1562,7 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
        0 to 31 and 127 to 255
        non-printable octets
        \xxx (octal value)
-       SELECT '\001'::bytea;
+       '\001'::bytea
        \001
       
 
@@ -1546,7 +1570,7 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea;
        32 to 126
        printable octets
        client character set representation
-       SELECT '\176'::bytea;
+       '\176'::bytea
        ~
       
 
@@ -1789,6 +1813,8 @@ MINUTE TO SECOND
      
       Date Input
       
+       
+       
        
         
          Example
@@ -1910,6 +1936,8 @@ MINUTE TO SECOND
       
        Time Input
        
+        
+        
         
          
           Example
@@ -2252,6 +2280,9 @@ January 8 04:05:06 1999 PST
      
       Date/Time Output Styles
       
+       
+       
+       
        
         
          Style Specification
@@ -2306,6 +2337,9 @@ January 8 04:05:06 1999 PST
      
       Date Order Conventions
       
+       
+       
+       
        
         
          datestyle Setting
@@ -2721,23 +2755,23 @@ P  years-months-
        
        
         
-         1-2
+         1-2
          SQL standard format: 1 year 2 months
         
         
-         3 4:05:06
+         3 4:05:06
          SQL standard format: 3 days 4 hours 5 minutes 6 seconds
         
         
-         1 year 2 months 3 days 4 hours 5 minutes 6 seconds
+         1 year 2 months 3 days 4 hours 5 minutes 6 seconds
          Traditional Postgres format: 1 year 2 months 3 days 4 hours 5 minutes 6 seconds
         
         
-         P1Y2M3DT4H5M6S
+         P1Y2M3DT4H5M6S
          ISO 8601 format with designators: same meaning as above
         
         
-         P0001-02-03T04:05:06
+         P0001-02-03T04:05:06
          ISO 8601 alternative format: same meaning as above
         
        
@@ -3159,6 +3193,10 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
     
      Geometric Types
      
+      
+      
+      
+      
       
        
         Name
@@ -3485,6 +3523,9 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
     
      Network Address Types
      
+      
+      
+      
       
        
         Name
@@ -4897,6 +4938,8 @@ SELECT * FROM pg_attribute
     
      Pseudo-Types
      
+      
+      
       
        
         Name
index 2a478c4f7317b4c3e1dad96e9c8af7d3518a39b2..aae5d320309a6dd1101c8cd3bf12949bc2063a9a 100644 (file)
@@ -1882,6 +1882,9 @@ REVOKE ALL ON accounts FROM PUBLIC;
   
    ACL Privilege Abbreviations
    
+    
+    
+    
     
      
       Privilege
@@ -1987,6 +1990,10 @@ REVOKE ALL ON accounts FROM PUBLIC;
   
    Summary of Access Privileges
    
+    
+    
+    
+    
     
      
       Object Type
index 130f6cd886a593c26a5a0e61024981a924b86b99..60366a950ec7197c8469e67560aeedf14d0ee347 100644 (file)
    
      Event Trigger Support by Command Tag
      
+      
+      
+      
+      
+      
+      
       
        
         Command Tag
-        ddl_command_start
-        ddl_command_end
-        sql_drop
-        table_rewrite
+        ddl_&zwsp;command_&zwsp;start
+        ddl_&zwsp;command_&zwsp;end
+        sql_&zwsp;drop
+        table_&zwsp;rewrite
         Notes
        
       
         X
         -
         -
-        center">
+        left">
        
        
         ALTER COLLATION
         X
         -
         -
-        center">
+        left">
        
        
         ALTER CONVERSION
         X
         -
         -
-        center">
+        left">
        
        
         ALTER DOMAIN
         X
         -
         -
-        center">
+        left">
        
        
         ALTER DEFAULT PRIVILEGES
         X
         -
         -
-        center">
+        left">
        
        
         ALTER EXTENSION
         X
         -
         -
-        center">
+        left">
        
        
         ALTER FOREIGN DATA WRAPPER
         X
         -
         -
-        center">
+        left">
        
        
         ALTER FOREIGN TABLE
         X
         X
         -
-        center">
+        left">
        
        
         ALTER FUNCTION
         X
         -
         -
-        center">
+        left">
        
        
         ALTER LANGUAGE
         X
         -
         -
-        center">
+        left">
        
        
         ALTER LARGE OBJECT
         X
         -
         -
-        center">
+        left">
        
        
         ALTER MATERIALIZED VIEW
         X
         -
         -
-        center">
+        left">
        
        
         ALTER OPERATOR
         X
         -
         -
-        center">
+        left">
        
        
         ALTER OPERATOR CLASS
         X
         -
         -
-        center">
+        left">
        
        
         ALTER OPERATOR FAMILY
         X
         -
         -
-        center">
+        left">
        
        
         ALTER POLICY
         X
         -
         -
-        center">
+        left">
        
        
         ALTER PROCEDURE
         X
         -
         -
-        center">
+        left">
        
        
         ALTER PUBLICATION
         X
         -
         -
-        center">
+        left">
        
        
         ALTER SCHEMA
         X
         -
         -
-        center">
+        left">
        
        
         ALTER SEQUENCE
         X
         -
         -
-        center">
+        left">
        
        
         ALTER SERVER
         X
         -
         -
-        center">
+        left">
        
        
         ALTER STATISTICS
         X
         -
         -
-        center">
+        left">
        
        
         ALTER SUBSCRIPTION
         X
         -
         -
-        center">
+        left">
        
        
         ALTER TABLE
         X
         X
         X
-        center">
+        left">
        
        
         ALTER TEXT SEARCH CONFIGURATION
         X
         -
         -
-        center">
+        left">
        
        
         ALTER TEXT SEARCH DICTIONARY
         X
         -
         -
-        center">
+        left">
        
        
         ALTER TEXT SEARCH PARSER
         X
         -
         -
-        center">
+        left">
        
        
         ALTER TEXT SEARCH TEMPLATE
         X
         -
         -
-        center">
+        left">
        
        
         ALTER TRIGGER
         X
         -
         -
-        center">
+        left">
        
        
         ALTER TYPE
         X
         -
         X
-        center">
+        left">
        
        
         ALTER USER MAPPING
         X
         -
         -
-        center">
+        left">
        
        
         ALTER VIEW
         X
         -
         -
-        center">
+        left">
        
        
         COMMENT
         X
         -
         -
-        center">Only for local objects
+        left">Only for local objects
        
        
         CREATE ACCESS METHOD
         X
         -
         -
-        center">
+        left">
        
        
         CREATE AGGREGATE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE CAST
         X
         -
         -
-        center">
+        left">
        
        
         CREATE COLLATION
         X
         -
         -
-        center">
+        left">
        
        
         CREATE CONVERSION
         X
         -
         -
-        center">
+        left">
        
        
         CREATE DOMAIN
         X
         -
         -
-        center">
+        left">
        
        
         CREATE EXTENSION
         X
         -
         -
-        center">
+        left">
        
        
         CREATE FOREIGN DATA WRAPPER
         X
         -
         -
-        center">
+        left">
        
        
         CREATE FOREIGN TABLE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE FUNCTION
         X
         -
         -
-        center">
+        left">
        
        
         CREATE INDEX
         X
         -
         -
-        center">
+        left">
        
        
         CREATE LANGUAGE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE MATERIALIZED VIEW
         X
         -
         -
-        center">
+        left">
        
        
         CREATE OPERATOR
         X
         -
         -
-        center">
+        left">
        
        
         CREATE OPERATOR CLASS
         X
         -
         -
-        center">
+        left">
        
        
         CREATE OPERATOR FAMILY
         X
         -
         -
-        center">
+        left">
        
        
         CREATE POLICY
         X
         -
         -
-        center">
+        left">
        
        
         CREATE PROCEDURE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE PUBLICATION
         X
         -
         -
-        center">
+        left">
        
        
         CREATE RULE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE SCHEMA
         X
         -
         -
-        center">
+        left">
        
        
         CREATE SEQUENCE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE SERVER
         X
         -
         -
-        center">
+        left">
        
        
         CREATE STATISTICS
         X
         -
         -
-        center">
+        left">
        
        
         CREATE SUBSCRIPTION
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TABLE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TABLE AS
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TEXT SEARCH CONFIGURATION
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TEXT SEARCH DICTIONARY
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TEXT SEARCH PARSER
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TEXT SEARCH TEMPLATE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TRIGGER
         X
         -
         -
-        center">
+        left">
        
        
         CREATE TYPE
         X
         -
         -
-        center">
+        left">
        
        
         CREATE USER MAPPING
         X
         -
         -
-        center">
+        left">
        
        
         CREATE VIEW
         X
         -
         -
-        center">
+        left">
        
        
         DROP ACCESS METHOD
         X
         X
         -
-        center">
+        left">
        
        
         DROP AGGREGATE
         X
         X
         -
-        center">
+        left">
        
        
         DROP CAST
         X
         X
         -
-        center">
+        left">
        
        
         DROP COLLATION
         X
         X
         -
-        center">
+        left">
        
        
         DROP CONVERSION
         X
         X
         -
-        center">
+        left">
        
        
         DROP DOMAIN
         X
         X
         -
-        center">
+        left">
        
        
         DROP EXTENSION
         X
         X
         -
-        center">
+        left">
        
        
         DROP FOREIGN DATA WRAPPER
         X
         X
         -
-        center">
+        left">
        
        
         DROP FOREIGN TABLE
         X
         X
         -
-        center">
+        left">
        
        
         DROP FUNCTION
         X
         X
         -
-        center">
+        left">
        
        
         DROP INDEX
         X
         X
         -
-        center">
+        left">
        
        
         DROP LANGUAGE
         X
         X
         -
-        center">
+        left">
        
        
         DROP MATERIALIZED VIEW
         X
         X
         -
-        center">
+        left">
        
        
         DROP OPERATOR
         X
         X
         -
-        center">
+        left">
        
        
         DROP OPERATOR CLASS
         X
         X
         -
-        center">
+        left">
        
        
         DROP OPERATOR FAMILY
         X
         X
         -
-        center">
+        left">
        
        
         DROP OWNED
         X
         X
         -
-        center">
+        left">
        
        
         DROP POLICY
         X
         X
         -
-        center">
+        left">
        
        
         DROP PROCEDURE
         X
         X
         -
-        center">
+        left">
        
        
         DROP PUBLICATION
         X
         X
         -
-        center">
+        left">
        
        
         DROP RULE
         X
         X
         -
-        center">
+        left">
        
        
         DROP SCHEMA
         X
         X
         -
-        center">
+        left">
        
        
         DROP SEQUENCE
         X
         X
         -
-        center">
+        left">
        
        
         DROP SERVER
         X
         X
         -
-        center">
+        left">
        
        
         DROP STATISTICS
         X
         X
         -
-        center">
+        left">
        
        
         DROP SUBSCRIPTION
         X
         X
         -
-        center">
+        left">
        
        
         DROP TABLE
         X
         X
         -
-        center">
+        left">
        
        
         DROP TEXT SEARCH CONFIGURATION
         X
         X
         -
-        center">
+        left">
        
        
         DROP TEXT SEARCH DICTIONARY
         X
         X
         -
-        center">
+        left">
        
        
         DROP TEXT SEARCH PARSER
         X
         X
         -
-        center">
+        left">
        
        
         DROP TEXT SEARCH TEMPLATE
         X
         X
         -
-        center">
+        left">
        
        
         DROP TRIGGER
         X
         X
         -
-        center">
+        left">
        
        
         DROP TYPE
         X
         X
         -
-        center">
+        left">
        
        
         DROP USER MAPPING
         X
         X
         -
-        center">
+        left">
        
        
         DROP VIEW
         X
         X
         -
-        center">
+        left">
        
        
         GRANT
         X
         -
         -
-        center">Only for local objects
+        left">Only for local objects
        
        
         IMPORT FOREIGN SCHEMA
         X
         -
         -
-        center">
+        left">
        
        
         REFRESH MATERIALIZED VIEW
         X
         -
         -
-        center">
+        left">
        
        
         REVOKE
         X
         -
         -
-        center">Only for local objects
+        left">Only for local objects
        
        
         SECURITY LABEL
         X
         -
         -
-        center">Only for local objects
+        left">Only for local objects
        
        
         SELECT INTO
         X
         -
         -
-        center">
+        left">
        
       
      
index 930aeb767c39a492442b879824af7ee468e16ff3..c1ffb145710588af761726feadb9370e9aee4ecf 100644 (file)
     
      Polymorphic Types
      
+      
+      
+      
       
        
         Name
index 05ecb99c5dd3f6c0920923ca6b1400ad3c43b664..c0a6554d4d7eea1fc67d0a79e144af805bdac32f 100644 (file)
   
      JSON Primitive Types and Corresponding <productname>PostgreSQL</productname> Types
      
+      
+      
+      
       
        
         JSON primitive type
@@ -742,6 +745,8 @@ SELECT jdoc->'guid', jdoc->'name' FROM api WHERE jdoc @> '{"tags": ["qu
   
    <type>jsonpath</type> Variables
    
+    
+    
     
      
       Variable
@@ -777,6 +782,8 @@ SELECT jdoc->'guid', jdoc->'name' FROM api WHERE jdoc @> '{"tags": ["qu
   
    <type>jsonpath</type> Accessors
    
+    
+    
     
      
       Accessor Operator
index 5ddb4c28bdefe352518b0e1dd2bd787b002ea6a8..5892367c61cd6b85e987d35a4c8e91c9cd2fe9d5 100644 (file)
@@ -7763,6 +7763,10 @@ ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*)
   
    SSL Mode Descriptions
    
+    
+    
+    
+    
     
      
       sslmode
index 252300db14b29f23f7a03aa33eb3b686e802a0c5..842e553e1eccf623c4bbf6567dd53081b737a90a 100644 (file)
@@ -3784,6 +3784,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
   
    ANALYZE phases
    
+    
+    
     
      
       Phase
@@ -3988,6 +3990,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
   
    CREATE INDEX Phases
    
+    
+    
     
      
       Phase
@@ -4217,6 +4221,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
   
    VACUUM Phases
    
+    
+    
     
     
       Phase
@@ -4411,6 +4417,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
   
    CLUSTER and VACUUM FULL Phases
    
+    
+    
     
     
       Phase
@@ -4559,6 +4567,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
   
    Base backup phases
    
+    
+    
     
      
       Phase
@@ -4686,6 +4696,9 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
  
   Built-in DTrace Probes
   
+   
+   
+   
    
     
      Name
index ecff9474c8edd8313dc0f779061989bdf2a92145..3f6c2316112b3c3ab0777dfc54cd20ef4efd7668 100644 (file)
@@ -1289,8 +1289,11 @@ ERROR:  could not serialize access due to read/write dependencies among transact
     
      Conflicting Row-Level Locks
      
-      
-      
+      
+      
+      
+      
+      
       
       
        
index cc99acad31f18801d475ccefbfc19abd9968cc71..05d2705604b5a9f813c4b42747632c4534c53e70 100644 (file)
@@ -1493,6 +1493,9 @@ GET DIAGNOSTICS integer_var = ROW_COUNT;
      
       Available Diagnostics Items
       
+       
+       
+       
        
         
          Name
@@ -2820,6 +2823,9 @@ GET STACKED DIAGNOSTICS variable { = | := } 
      
       Error Diagnostics Items
       
+       
+       
+       
        
         
          Name
index a34d31d297abd12b5260613af644c6b8e219cdd5..a8bb85e6f5a92d18a19ff3dd30deaded845e950a 100644 (file)
@@ -709,6 +709,9 @@ psql: could not connect to server: No such file or directory
     <systemitem class="osname">System V</systemitem> <acronym>IPC</acronym> Parameters
 
     
+     
+     
+     
      
       
        Name
index fe2a06a26a1790ef72d5240f4d6168edd4ce90eb..5a2734649e9731633e6b532efdbcb8f63921ce20 100644 (file)
   center
 
 
+
+
+  left
+
+
 
 
index e13487779828fb87d91f5c723bbb99db99a572f3..f5ce6f0149fac00a7268d380a1048880843761e7 100644 (file)
@@ -1004,6 +1004,9 @@ SELECT (5 !) - 6;
     Operator Precedence (highest to lowest)
 
     
+     
+     
+     
      
       
        Operator/Element
index 187ff22f3eaf9574000fa275257bf2886fcc70ff..e3b70df6ebcd01cd848372c94545556b73a4a0a8 100644 (file)
@@ -2074,6 +2074,9 @@ LIMIT 10;
   
    Default Parser's Token Types
    
+    
+    
+    
     
      
       Alias
index 66f162703ddddc075fec796bf8d53821900cd297..829decd883904ffd1978d5506b17661fb234b652 100644 (file)
@@ -508,6 +508,8 @@ DROP ROLE doomed_role;
    
     Default Roles
     
+     
+     
      
       
        Role
index 0bec854d04b99ad728da8148024a634909c5a934..6de464c654577e3f2bd27cc5fea33c6dcf64b987 100644 (file)
@@ -2084,6 +2084,9 @@ memcpy(destination->data, buffer, 40);
      
       Equivalent C Types for Built-in SQL Types
       
+       
+       
+       
        
         
          
index 2e06ad01bf5faa454340c6a0f4aac8b89397753d..14c1701c9b572b3cabfb320167f0fbfb1c94736d 100644 (file)
    
     B-Tree Support Functions
     
+     
+     
      
       
        Function
    
     Hash Support Functions
     
+     
+     
      
       
        Function
    
     GiST Support Functions
     
+     
+     
+     
      
       
        Function
    
     SP-GiST Support Functions
     
+     
+     
+     
      
       
        Function
    
     GIN Support Functions
     
+     
+     
+     
      
       
        Function
    
     BRIN Support Functions
     
+     
+     
+     
      
       
        Function