diff --git a/doc/reference/cmdline.rst b/doc/reference/cmdline.rst
index 1ec7d96ae9d8013eef326dcd18d49276d4b60761..e0713410981c1d6d0ce86072203447a3dc6a1ff3 100644
--- a/doc/reference/cmdline.rst
+++ b/doc/reference/cmdline.rst
@@ -54,6 +54,12 @@ Running the server
 
     runs tests after installing modules
 
+.. option:: --debug
+
+    when an unexpected error is raised (not a warning or an access error),
+    automatically starts :mod:`python:pdb` before logging and returning the
+    error
+
 .. _reference/cmdline/scaffold:
 
 Scaffolding