Merge pull request #1689 from quodlibetor/autouse-docs

Document the interaction of autouse scopes

1 files changed, 4 insertions, 0 deletions

diff --git a/doc/en/fixture.rst b/doc/en/fixture.rst
index 590649b56..3c7033f83 100644
--- a/doc/en/fixture.rst
+++ b/doc/en/fixture.rst
@@ -798,6 +798,10 @@ If we run it, we get two passing tests::
 
 Here is how autouse fixtures work in other scopes:
 
+- autouse fixtures obey the ``scope=`` keyword-argument: if an autouse fixture
+  has ``scope='session'`` it will only be run once, no matter where it is
+  defined. ``scope='class'`` means it will be run once per class, etc.
+
 - if an autouse fixture is defined in a test module, all its test
   functions automatically use it.