Doc: document the current-transaction-modes GUCs.

We had documentation of default_transaction_isolation et al,
but for some reason not of transaction_isolation et al.
AFAICS this is just an ancient oversight, so repair.

Per bug #17077 from Yanliang Lei.

Discussion: https://postgr.es/m/17077-ade8e166a01e1374@postgresql.org

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index a23ae67ba52bdce3f2c5bf8149bef572a53834d7..b69ac974e3537eb1c1bf4a582d95d005f419096b 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -3141,7 +3141,7 @@ include_dir 'conf.d'
       
       
        
-        This parameter enables compression of WAL using the specified 
+        This parameter enables compression of WAL using the specified
         compression method.
         When enabled, the PostgreSQL
         server compresses full page images written to WAL when
@@ -8434,6 +8434,68 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
       
      
 
+     
+      transaction_isolation (enum)
+      
+       transaction isolation level
+      
+      
+       transaction_isolation configuration parameter
+      
+      
+      
+       
+        This parameter reflects the current transaction's isolation level.
+        At the beginning of each transaction, it is set to the current value
+        of .
+        Any subsequent attempt to change it is equivalent to a 
+        linkend="sql-set-transaction"/> command.
+       
+      
+     
+
+     
+      transaction_read_only (boolean)
+      
+       read-only transaction
+       setting default
+      
+      
+       transaction_read_only configuration parameter
+      
+      
+      
+       
+        This parameter reflects the current transaction's read-only status.
+        At the beginning of each transaction, it is set to the current value
+        of .
+        Any subsequent attempt to change it is equivalent to a 
+        linkend="sql-set-transaction"/> command.
+       
+      
+     
+
+     
+      transaction_deferrable (boolean)
+      
+       deferrable transaction
+       setting default
+      
+      
+       transaction_deferrable configuration parameter
+      
+      
+      
+       
+        This parameter reflects the current transaction's deferrability status.
+        At the beginning of each transaction, it is set to the current value
+        of .
+        Any subsequent attempt to change it is equivalent to a 
+        linkend="sql-set-transaction"/> command.
+       
+      
+     
+
 
      
       session_replication_role (enum)
@@ -10913,7 +10975,7 @@ LOG:  CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1)
         PostgreSQL will automatically remove
         temporary files after a backend crash. If disabled, the files will be
         retained and may be used for debugging, for example. Repeated crashes
-        may however result in accumulation of useless files. This parameter 
+        may however result in accumulation of useless files. This parameter
         can only be set in the postgresql.conf file or on
         the server command line.
        


diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml

index ec436b2d163efb333173856cebd4558aa55c96c9..e062e2461e1f61daa5c6ab4aa87cae3a0d9f1887 100644 (file)

--- a/doc/src/sgml/ref/set_transaction.sgml
+++ b/doc/src/sgml/ref/set_transaction.sgml
@@ -202,7 +202,7 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
   
 
   
-   The session default transaction modes can also be set by setting the
+   The session default transaction modes can also be set or examined via the
    configuration parameters ,
    , and
    .
@@ -212,6 +212,17 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
    ALTER DATABASE, etc.  Consult 
    for more information.
   
+
+  
+   The current transaction's modes can similarly be set or examined via the
+   configuration parameters ,
+   , and
+   .  Setting one of these
+   parameters acts the same as the corresponding SET
+   TRANSACTION option, with the same restrictions on when it can
+   be done.  However, these parameters cannot be set in the configuration
+   file, or from any source other than live SQL.
+  
  
 
  




This is the main PostgreSQL git repository.
RSS
Atom

diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml
index ec436b2d163efb333173856cebd4558aa55c96c9..e062e2461e1f61daa5c6ab4aa87cae3a0d9f1887 100644 (file)
--- a/doc/src/sgml/ref/set_transaction.sgml
+++ b/doc/src/sgml/ref/set_transaction.sgml
@@ -202,7 +202,7 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
   
 
   
-   The session default transaction modes can also be set by setting the
+   The session default transaction modes can also be set or examined via the
    configuration parameters ,
    , and
    .
@@ -212,6 +212,17 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
    ALTER DATABASE, etc.  Consult 
    for more information.
   
+
+  
+   The current transaction's modes can similarly be set or examined via the
+   configuration parameters ,
+   , and
+   .  Setting one of these
+   parameters acts the same as the corresponding SET
+   TRANSACTION option, with the same restrictions on when it can
+   be done.  However, these parameters cannot be set in the configuration
+   file, or from any source other than live SQL.
+