Rearrange docstrings for long lines

numpydoc has no guidance for how to handle a long parameter type
line. Rearrange things slightly to move the type information
to the parameter documentation instead.

See numpy/numpydoc#87

Author: timj

python/lsst/daf/butler/core/config.py

@@ -215,12 +215,11 @@ class Config(collections.abc.MutableMapping):
 
     Parameters
     ----------
-    other : `str` or `Config` or `dict` or `lsst.resources.ResourcePath`
-            or `pathlib.Path`
+    other : various
         Other source of configuration, can be:
 
-        - (`str` or `lsst.resources.ResourcePath`) Treated as a URI to a
-          config file. Must end with ".yaml".
+        - (`str`, `lsst.resources.ResourcePath` or `pathlib.Path`)
+          Treated as a URI to a config file. Must end with ".yaml".
         - (`Config`) Copies the other Config's values into this one.
         - (`dict`) Copies the values from the dict into this Config.
 

python/lsst/daf/butler/core/datastore.py

@@ -378,10 +378,9 @@ def mexists(
         ----------
         refs : iterable of `DatasetRef`
             The datasets to be checked.
-        artifact_existence : `dict` of [`lsst.resources.ResourcePath`, `bool`],
-                             optional
-            Mapping of datastore artifact to existence. Updated by this
-            method with details of all artifacts tested. Can be `None`
+        artifact_existence : `dict` [`lsst.resources.ResourcePath`, `bool`]
+            Optional mapping of datastore artifact to existence. Updated by
+            this method with details of all artifacts tested. Can be `None`
             if the caller is not interested.
 
         Returns
@@ -671,10 +670,9 @@ def transfer_from(
             data store choose the most natural option for itself.
             If the source location and transfer location are identical the
             transfer mode will be ignored.
-        artifact_existence : `dict` of [`lsst.resources.ResourcePath`, `bool`],
-                             optional
-            Mapping of datastore artifact to existence. Updated by this
-            method with details of all artifacts tested. Can be `None`
+        artifact_existence : `dict` [`lsst.resources.ResourcePath`, `bool`]
+            Optional mapping of datastore artifact to existence. Updated by
+            this method with details of all artifacts tested. Can be `None`
             if the caller is not interested.
 
         Raises

python/lsst/daf/butler/datastores/chainedDatastore.py

@@ -269,10 +269,9 @@ def mexists(
         ----------
         refs : iterable of `DatasetRef`
             The datasets to be checked.
-        artifact_existence : `dict` of [`lsst.resources.ResourcePath`, `bool`],
-                             optional
-            Mapping of datastore artifact to existence. Updated by this
-            method with details of all artifacts tested. Can be `None`
+        artifact_existence : `dict` [`lsst.resources.ResourcePath`, `bool`]
+            Optional mapping of datastore artifact to existence. Updated by
+            this method with details of all artifacts tested. Can be `None`
             if the caller is not interested.
 
         Returns

python/lsst/daf/butler/datastores/fileDatastore.py

@@ -1351,10 +1351,9 @@ def _process_mexists_records(
         all_required : `bool`
             Flag to indicate whether existence requires all artifacts
             associated with a dataset ID to exist or not for existence.
-        artifact_existence : `dict` of [`lsst.resources.ResourcePath`, `bool`],
-                             optional
-            Mapping of datastore artifact to existence. Updated by this
-            method with details of all artifacts tested. Can be `None`
+        artifact_existence : `dict` [`lsst.resources.ResourcePath`, `bool`]
+            Optional mapping of datastore artifact to existence. Updated by
+            this method with details of all artifacts tested. Can be `None`
             if the caller is not interested.
 
         Returns
@@ -1418,10 +1417,9 @@ def mexists(
         ----------
         refs : iterable of `DatasetRef`
             The datasets to be checked.
-        artifact_existence : `dict` of [`lsst.resources.ResourcePath`, `bool`],
-                             optional
-            Mapping of datastore artifact to existence. Updated by this
-            method with details of all artifacts tested. Can be `None`
+        artifact_existence : `dict` [`lsst.resources.ResourcePath`, `bool`]
+            Optional mapping of datastore artifact to existence. Updated by
+            this method with details of all artifacts tested. Can be `None`
             if the caller is not interested.
 
         Returns