Documentation fixes.

Author: RKrahl

doc/src/reference.rst

@@ -12,9 +12,7 @@ Reference
 
     :param name: the name of the test to be used for referencing by
         dependent tests.  If not set, it defaults to the node ID
-        defined by pytest, that is the name of the test function,
-        extended by the parameters if applicable.  The name must be
-        unique in the scope, which is currently the test module.
+        defined by pytest.  The name must be unique.
     :type name: :class:`str`
     :param depends: dependencies, a list of names of tests that this
         test depends on.  The test will be skipped unless all of the
@@ -26,6 +24,10 @@ Reference
         either `'session'`, `'package'`, `'module'`, or `'class'`.
     :type scope: :class:`str`
 
+    See Section :ref:`names` for details on the default name if the
+    `name` argument is not set and on how references in the `depends`
+    argument must be adapted to the scope.
+
     .. versionchanged:: 0.5.0
         the scope parameter has been added.
 

doc/src/scope.rst

@@ -53,6 +53,12 @@ turn will be run and succeed.  It depends on the test method `test_b`
 of class `TestClass` in `tests/test_mod_01.py`, not on the test
 function of the same name.
 
+The `scope` argument only affects the references in the `depends`
+argument of the marker.  It does not matter which scope is set for the
+dependencies: the dependency of `test_e` in `tests/test_mod_02.py` on
+`test_a` in `tests/test_mod_01.py` is in session scope.  It is not
+needed to set the scope also for `test_a`.
+
 Note that the references in session scope must use the full node id of
 the dependencies.  This node id is composed of the module path, the
 name of the test class if applicable, and the name of the test,