MNT: Some docstring clean-ups

Found by flake8-rst-docstrings or found while working on other fixes.

metpy/calc/indices.py

@@ -76,7 +76,7 @@ def mean_pressure_weighted(pressure, *args, **kwargs):
     ----------
     pressure : `pint.Quantity`
         Atmospheric pressure profile
-    *args : `pint.Quantity`
+    args : `pint.Quantity`
         Parameters for which the pressure-weighted mean is to be calculated.
     heights : `pint.Quantity`, optional
         Heights from sounding. Standard atmosphere heights assumed (if needed)

metpy/calc/thermo.py

@@ -204,8 +204,7 @@ def dry_lapse(pressure, temperature, ref_pressure=None):
 
     See Also
     --------
-    moist_lapse : Calculate parcel temperature assuming liquid saturation
-                  processes
+    moist_lapse : Calculate parcel temperature assuming liquid saturation processes
     parcel_profile : Calculate complete parcel profile
     potential_temperature
 

metpy/calc/tools.py

@@ -437,7 +437,7 @@ def get_layer_heights(heights, depth, *args, **kwargs):
         Atmospheric heights
     depth : `pint.Quantity`
         The thickness of the layer
-    *args : array-like
+    args : array-like
         Atmospheric variable(s) measured at the given pressures
     bottom : `pint.Quantity`, optional
         The bottom of the layer
@@ -530,7 +530,7 @@ def get_layer(pressure, *args, **kwargs):
     ----------
     pressure : array-like
         Atmospheric pressure profile
-    *args : array-like
+    args : array-like
         Atmospheric variable(s) measured at the given pressures
     heights: array-like, optional
         Atmospheric heights corresponding to the given pressures. Defaults to using

metpy/deprecation.py

@@ -32,7 +32,7 @@
 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS.
 
 5. MDT SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF MATPLOTLIB
- FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR
+FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR
 LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING
 MATPLOTLIB , OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF
 THE POSSIBILITY THEREOF.
@@ -82,7 +82,7 @@
 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS.
 
 5. JDH SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF MATPLOTLIB
- FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR
+FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR
 LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING
 MATPLOTLIB , OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF
 THE POSSIBILITY THEREOF.

metpy/testing.py

@@ -28,12 +28,13 @@ def get_upper_air_data(date, station):
     """Get upper air observations from the test data cache.
 
     Parameters
-     ----------
+    ----------
     time : datetime
           The date and time of the desired observation.
     station : str
          The three letter ICAO identifier of the station for which data should be
          downloaded.
+
     Returns
     -------
         dict : upper air data

metpy/units.py

@@ -228,17 +228,18 @@ def masked_array(data, data_units=None, **kwargs):
 
     This is a thin wrapper around :func:`numpy.ma.masked_array` that ensures that
     units are properly attached to the result (otherwise units are silently lost). Units
-    are taken from the ``units`` argument, or if this is ``None``, the units on ``data``
+    are taken from the ``data_units`` argument, or if this is ``None``, the units on ``data``
     are used.
 
     Parameters
     ----------
     data : array_like
-        The source data. If ``units`` is `None`, this should be a `pint.Quantity` with
+        The source data. If ``data_units`` is `None`, this should be a `pint.Quantity` with
         the desired units.
-    data_units : str or `pint.Unit`
+    data_units : str or `pint.Unit`, optional
         The units for the resulting `pint.Quantity`
-    **kwargs : Arbitrary keyword arguments passed to `numpy.ma.masked_array`
+    kwargs
+        Arbitrary keyword arguments passed to `numpy.ma.masked_array`, optional
 
     Returns
     -------