Doc: hack table 13.2 "Conflicting Lock Modes" till it fits in PDF.
authorTom Lane <[email protected]>
Tue, 12 May 2020 00:41:06 +0000 (20:41 -0400)
committerTom Lane <[email protected]>
Tue, 12 May 2020 02:00:28 +0000 (22:00 -0400)
I can't see any way to make this table fit in PDF column width
without either a fundamental redesign or abbreviating EXCLUSIVE.
So I did the latter.

It'd be nicer if the abbreviating didn't leak into the HTML output
as well; but the hackery required to make the output different
seems like more trouble than it's really worth.

Discussion: https://postgr.es/m/6916.1589146280@sss.pgh.pa.us

doc/src/sgml/mvcc.sgml

index 3f6c2316112b3c3ab0777dfc54cd20ef4efd7668..a826f2b4e470703b5bcb9d82d7bac8fc606cca52 100644 (file)
@@ -1053,28 +1053,35 @@ ERROR:  could not serialize access due to read/write dependencies among transact
     <table tocentry="1" id="table-lock-compatibility">
      <title> Conflicting Lock Modes</title>
      <tgroup cols="9">
-      <colspec colnum="2" colname="lockst"/>
-      <colspec colnum="9" colname="lockend"/>
-      <spanspec namest="lockst" nameend="lockend" spanname="lockreq"/>
+      <colspec colnum="1" colwidth="1.25*"/>
+      <colspec colnum="2" colwidth="1*" colname="lockst"/>
+      <colspec colnum="3" colwidth="1*"/>
+      <colspec colnum="4" colwidth="1*"/>
+      <colspec colnum="5" colwidth="1*"/>
+      <colspec colnum="6" colwidth="1*"/>
+      <colspec colnum="7" colwidth="1*"/>
+      <colspec colnum="8" colwidth="1*"/>
+      <colspec colnum="9" colwidth="1*" colname="lockend"/>
+      <spanspec spanname="lockreq" namest="lockst" nameend="lockend" align="center"/>
       <thead>
        <row>
         <entry morerows="1">Requested Lock Mode</entry>
-        <entry spanname="lockreq">Current Lock Mode</entry>
+        <entry spanname="lockreq">Existing Lock Mode</entry>
        </row>
        <row>
-        <entry>ACCESS SHARE</entry>
-        <entry>ROW SHARE</entry>
-        <entry>ROW EXCLUSIVE</entry>
-        <entry>SHARE UPDATE EXCLUSIVE</entry>
-        <entry>SHARE</entry>
-        <entry>SHARE ROW EXCLUSIVE</entry>
-        <entry>EXCLUSIVE</entry>
-        <entry>ACCESS EXCLUSIVE</entry>
+        <entry><literal>ACCESS SHARE</literal></entry>
+        <entry><literal>ROW SHARE</literal></entry>
+        <entry><literal>ROW EXCL.</literal></entry>
+        <entry><literal>SHARE UPDATE EXCL.</literal></entry>
+        <entry><literal>SHARE</literal></entry>
+        <entry><literal>SHARE ROW EXCL.</literal></entry>
+        <entry><literal>EXCL.</literal></entry>
+        <entry><literal>ACCESS EXCL.</literal></entry>
        </row>
       </thead>
       <tbody>
        <row>
-        <entry>ACCESS SHARE</entry>
+        <entry><literal>ACCESS SHARE</literal></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
@@ -1085,7 +1092,7 @@ ERROR:  could not serialize access due to read/write dependencies among transact
         <entry align="center">X</entry>
        </row>
        <row>
-        <entry>ROW SHARE</entry>
+        <entry><literal>ROW SHARE</literal></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
@@ -1096,7 +1103,7 @@ ERROR:  could not serialize access due to read/write dependencies among transact
         <entry align="center">X</entry>
        </row>
        <row>
-        <entry>ROW EXCLUSIVE</entry>
+        <entry><literal>ROW EXCL.</literal></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
@@ -1107,7 +1114,7 @@ ERROR:  could not serialize access due to read/write dependencies among transact
         <entry align="center">X</entry>
        </row>
        <row>
-        <entry>SHARE UPDATE EXCLUSIVE</entry>
+        <entry><literal>SHARE UPDATE EXCL.</literal></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
@@ -1118,7 +1125,7 @@ ERROR:  could not serialize access due to read/write dependencies among transact
         <entry align="center">X</entry>
        </row>
        <row>
-        <entry>SHARE</entry>
+        <entry><literal>SHARE</literal></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
         <entry align="center">X</entry>
@@ -1129,7 +1136,7 @@ ERROR:  could not serialize access due to read/write dependencies among transact
         <entry align="center">X</entry>
        </row>
        <row>
-        <entry>SHARE ROW EXCLUSIVE</entry>
+        <entry><literal>SHARE ROW EXCL.</literal></entry>
         <entry align="center"></entry>
         <entry align="center"></entry>
         <entry align="center">X</entry>
@@ -1140,7 +1147,7 @@ ERROR:  could not serialize access due to read/write dependencies among transact
         <entry align="center">X</entry>
        </row>
        <row>
-        <entry>EXCLUSIVE</entry>
+        <entry><literal>EXCL.</literal></entry>
         <entry align="center"></entry>
         <entry align="center">X</entry>
         <entry align="center">X</entry>
@@ -1151,7 +1158,7 @@ ERROR:  could not serialize access due to read/write dependencies among transact
         <entry align="center">X</entry>
        </row>
        <row>
-        <entry>ACCESS EXCLUSIVE</entry>
+        <entry><literal>ACCESS EXCL.</literal></entry>
         <entry align="center">X</entry>
         <entry align="center">X</entry>
         <entry align="center">X</entry>