Documentation details.

Author: RKrahl

doc/src/reference.rst

@@ -11,8 +11,8 @@ Reference
     for the test may be set in the depends argument.
 
     :param name: the name of the test to be used for referencing by
-	dependent tests.  If not set, it defaults to the internal name
-	used in pytest, that is the name of the test function,
+	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.
     :type name: :class:`str`
     :param depends: dependencies, a list of names of tests that this

doc/src/usage.rst

@@ -38,11 +38,12 @@ Naming tests
 ------------
 
 Tests are referenced by their name in the `depends` argument.  The
-default for this name is the internal name used in pytest, that is the
+default for this name is the node ID defined by pytest, that is the
 name of the test function, extended by the parameters if applicable.
-As these names may become complicated, they can be overridden by an
-explicit `name` argument to the marker.  The following example works
-exactly as the last one, only the test names are explicitely set:
+As these node IDs may become complicated, the name can be overridden
+by an explicit `name` argument to the marker.  The following example
+works exactly as the last one, only the test names are explicitely
+set:
 
 .. literalinclude:: ../examples/named.py
 

pytest_dependency.py

@@ -65,11 +65,11 @@ def checkDepend(self, depends):
 def depends(request, other):
     """Add dependency on other test.
 
-    Call pytest.skip() unless a successful outcome of all of the tests
-    in other has been registered previously.  This has the same effect
-    as the `depends` keyword argument to the `dependency` marker.  In
-    contrast to the marker, this function may be called at runtime
-    during a test.
+    Call pytest.skip() unless a successful outcome of all of the tests in
+    other has been registered previously.  This has the same effect as
+    the `depends` keyword argument to the :func:`pytest.mark.dependency`
+    marker.  In contrast to the marker, this function may be called at
+    runtime during a test.
 
     :param request: the value of the `request` pytest fixture related
         to the current test.