Docs for new dynamic context techniques

1 files changed, 3 insertions, 1 deletions

diff --git a/coverage/control.py b/coverage/control.py
index ace3d8bf..76467257 100644
--- a/coverage/control.py
+++ b/coverage/control.py
@@ -487,7 +487,9 @@ class Coverage(object):
         """Switch to a new dynamic context.
 
         `new_context` is a string to use as the context label
-        for collected data.
+        for collected data.  If a :ref:`static context <static_contexts>` is in
+        use, the static and dynamic context labels will be joined together with
+        a pipe character.
 
         Coverage collection must be started already.