Document locks.BoundedSemaphore.

diff --git a/docs/locks.rst b/docs/locks.rst
index c0ad500543ccdb206ee801ead751a22f94f12c70..4f31cb25647d82eca446b138665b1c2acd873916 100644 (file)
--- a/docs/locks.rst
+++ b/docs/locks.rst
@@ -171,3 +171,22 @@ multithreaded app.)*
 
             # Now the semaphore has been released.
             print("Worker %d is done" % worker_id)
+
+   BoundedSemaphore
+   ----------------
+   .. autoclass:: BoundedSemaphore
+    :members:
+    :inherited-members:
+
+    .. testcode::
+
+        sem = locks.BoundedSemaphore()
+        sem.acquire()
+        sem.release()
+        sem.release()
+
+    .. testoutput::
+
+     Traceback (most recent call last):
+         ...
+     ValueError: Semaphore released too many times