From 713d32c4da34abaaea77fec3e1211f28206e154f Mon Sep 17 00:00:00 2001
From: Jeffrey Rackauckas <jeffreyrack@gmail.com>
Date: Sun, 1 Jul 2018 18:49:39 -0700
Subject: [PATCH] Adding documentation for the --trace option.

---
 doc/en/usage.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/en/usage.rst b/doc/en/usage.rst
index 25be54395..b1085c9e8 100644
--- a/doc/en/usage.rst
+++ b/doc/en/usage.rst
@@ -171,6 +171,16 @@ for example::
     >>> sys.last_value
     AssertionError('assert result == "ok"',)
 
+.. _trace-option:
+
+Dropping to PDB_ (Python Debugger) at the start of a test
+
+``pytest`` allows one to drop into the PDB_ prompt immediately at the start of each test via a command line option::
+
+    pytest --trace
+
+    This will invoke the Python debugger at the start of every test.
+
 .. _breakpoints:
 
 Setting breakpoints