Fix docstring markup errors

python/lsst/obs/base/butler_tests.py

@@ -28,8 +28,7 @@
 
 
 class ButlerGetTests(metaclass=abc.ABCMeta):
-    """
-    Tests of obs_* Butler get() functionality.
+    """Tests of obs_* Butler get() functionality.
 
     In the subclasses's setUp():
         * Call setUp_butler_get() to fill in required parameters.
@@ -79,7 +78,8 @@ def setUp_butler_get(self,
         sky_origin : `tuple` of `float`
             Longitude, Latitude of 'raw' exposure
         raw_subsets : `tuple` of (kwargs, `int`)
-            keyword args and expected number of subsets for butler.subset('raw', **kwargs)
+            keyword args and expected number of subsets for
+            ``butler.subset('raw', **kwargs)``
         good_detectorIds : `list` of `int`
             list of valid ccd numbers
         bad_detectorIds : `list` of `int`
@@ -89,8 +89,8 @@ def setUp_butler_get(self,
             (e.g. lsst.ip.isr.LinearizeLookupTable.LinearityType),
             or unittest.SkipTest to skip all linearizer tests.
         raw_header_wcs : `lsst.afw.geom.SkyWcs`
-            The SkyWcs object that should be returned by:
-                `butler.get("raw_header_wcs", dataId=self.dataIds["raw"])`
+            The SkyWcs object that should be returned by
+            ``butler.get("raw_header_wcs", dataId=self.dataIds["raw"])``
         """
 
         fields = ['ccdExposureId_bits',

python/lsst/obs/base/camera_tests.py

@@ -30,8 +30,7 @@
 
 
 class CameraTests(metaclass=abc.ABCMeta):
-    """
-    Tests that the butler returns a useable Camera.
+    """Tests that the butler returns a useable Camera.
 
     In the subclasses's setUp():
         * Call setUp_camera() to fill in required parameters.
@@ -43,17 +42,16 @@ def setUp_camera(self,
                      first_detector_name=None,
                      plate_scale=None,
                      ):
-        """
-        Set up the necessary variables for camera tests.
+        """Set up the necessary variables for camera tests.
 
         Parameters
         ----------
 
-         camera_name : `str`
-             name of this camera
-         n_detectors : `int`
+        camera_name : `str`
+            name of this camera
+        n_detectors : `int`
             number of detectors in this camera
-         first_detector_name : `str`
+        first_detector_name : `str`
             name of the first detector in this camera
         plate_scale : `lsst.geom.Angle`
             plate scale at center of focal plane, as angle-on-sky/mm

python/lsst/obs/base/tests.py

@@ -40,8 +40,7 @@
 
 class ObsTests(butler_tests.ButlerGetTests, mapper_tests.MapperTests,
                camera_tests.CameraTests):
-    """
-    Aggregator class for all of the obs_* test classes.
+    """Aggregator class for all of the obs_* test classes.
 
     Inherit from this class, then lsst.utils.tests.TestCase, in that order.
 
@@ -56,8 +55,7 @@ def setUp(self):
     """
 
     def setUp_tests(self, butler, mapper, dataIds):
-        """
-        Set up the necessary shared variables used by multiple tests.
+        """Set up the necessary shared variables used by multiple tests.
 
         Parameters
         ----------
@@ -73,11 +71,12 @@ def setUp_tests(self, butler, mapper, dataIds):
             exposures you do not have/do not want to test. It must contain a
             valid 'raw' dataId, in addition to 'bias','flat','dark', which may
             be set to SkipTest. For example::
+
                   self.dataIds = {'raw': {'visit': 1, 'filter': 'g'},
                                   'bias': {'visit': 1},
                                   'flat': {'visit': 1},
                                   'dark': unittest.SkipTest
-                                  }
+                                 }
         """
         self.butler = butler
         self.mapper = mapper