[TO_AMEND] Fix locks docstrings

koschei/locks.py

@@ -35,8 +35,9 @@ def pg_lock(db, namespace, key, block=True, transaction=False, shared=False):
     advisory lock.
 
     :param: db Database session
-    :param: namespace Integer namespace key. Should use one of the constants
+    :param: namespace Integer namespace identifier. Should use one of the constants
             defined in this module.
+    :param: key Integer identifier of the lock.
     :param: block Whether to block waiting for the lock.
     :param: transaction Whether the lock should be scoped by the transaction
             (unlocks when the transaction ends). Otherwise scoped by the
@@ -67,7 +68,7 @@ def pg_lock(db, namespace, key, block=True, transaction=False, shared=False):
 
 def pg_unlock(db, namespace, key, shared=False):
     """
-    Unlocks given advisory lock. Arguments have the same meaning as in pg_lock
+    Unlocks given advisory session lock. Arguments have the same meaning as in pg_lock
     """
     fn_name = 'pg_advisory_unlock'
     if shared:
@@ -77,6 +78,9 @@ def pg_unlock(db, namespace, key, shared=False):
 
 
 def pg_unlock_all(db):
+    """
+    Unlocks advisory session locks.
+    """
     db.query(func.pg_advisory_unlock_all()).one()