Finish up #967. Thanks, Bernát Gábor

1 files changed, 8 insertions, 1 deletions

diff --git a/coverage/control.py b/coverage/control.py
index f7db26e9..2b8c3d26 100644
--- a/coverage/control.py
+++ b/coverage/control.py
@@ -367,7 +367,11 @@ class Coverage(object):
         option name.  For example, the ``branch`` option in the ``[run]``
         section of the config file would be indicated with `"run:branch"`.
 
-        Returns the value of the option.
+        Returns the value of the option.  The type depends on the option
+        selected.
+
+        As a special case, an `option_name` of ``"paths"`` will return an
+        OrderedDict with the entire ``[paths]`` section value.
 
         .. versionadded:: 4.0
 
@@ -394,6 +398,9 @@ class Coverage(object):
             [run]
             branch = True
 
+        As a special case, an `option_name` of ``"paths"`` will replace the
+        entire ``[paths]`` section.  The value should be an OrderedDict.
+
         .. versionadded:: 4.0
 
         """