Document the DEFERRABLE option in SET TRANSACTION command.

Kevin Grittner

diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml
index 2c57f45511b3d6a1ce563b691c1dec697f518742..f864bbf6a61c35000928f0ea83b255be464f7e23 100644 (file)
--- a/doc/src/sgml/ref/set_transaction.sgml
+++ b/doc/src/sgml/ref/set_transaction.sgml
@@ -135,6 +135,17 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa
    among those listed.  This is a high-level notion of read-only that
    does not prevent all writes to disk.
   
+
+  
+   The DEFERRABLE transaction property has no effect
+   unless the transaction is also SERIALIZABLE and
+   READ ONLY.  When all of these properties are set on a
+   transaction, the transaction may block when first acquiring its snapshot,
+   after which it is able to run without the normal overhead of a
+   SERIALIZABLE transaction and without any risk of
+   contributing to or being cancelled by a serialization failure.  This mode
+   is well suited for long-running reports or backups.
+