Improve documentation for the newly-added NOWAIT clause of LOCK TABLE.
authorNeil Conway
Fri, 12 Mar 2004 00:52:23 +0000 (00:52 +0000)
committerNeil Conway
Fri, 12 Mar 2004 00:52:23 +0000 (00:52 +0000)
doc/src/sgml/ref/lock.sgml

index a2c2a78a7aad29ebb9250399212527ac8c926754..cab378ec95cb12d6da61a2914eab9d3c2e9c879c 100644 (file)
@@ -1,5 +1,5 @@
 
 
@@ -33,13 +33,15 @@ where lockmode is one of:
   Description
 
   
-   LOCK TABLE obtains a table-level lock, waiting if
-   necessary for any conflicting locks to be released.
-   If NOWAIT is given, LOCK TABLE
-   does not wait for acquiring lock, and throws an error instead.
-   Once obtained, the lock is held for the remainder of the current transaction.
-   (There is no UNLOCK TABLE command; locks are always
-   released at transaction end.)
+   LOCK TABLE obtains a table-level lock, waiting
+   if necessary for any conflicting locks to be released.  If
+   NOWAIT is specified, LOCK
+   TABLE does not wait to acquire the desired lock: if it
+   cannot be immediately acquired, the transaction is aborted and an
+   error is emitted.  Once obtained, the lock is held for the
+   remainder of the current transaction.  (There is no UNLOCK
+   TABLE command; locks are always released at transaction
+   end.)
   
 
   
@@ -132,6 +134,18 @@ where lockmode is one of:
      
     
    
+
+   
+    NOWAIT
+    
+     
+      Specifies that LOCK TABLE should not wait for
+      any conflicting locks to be released: if the specified lock
+      cannot be immediately acquired without waiting, the transaction
+      is aborted.
+     
+    
+