diff --git a/docs/locks.rst b/docs/locks.rst
index c0ad5005..4f31cb25 100644
--- 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