wip

tkknight · Nov 9, 2023 · d744432 · d744432
1 parent 1fe628d
commit d744432
Show file tree

Hide file tree

Showing 3 changed files with 176 additions and 194 deletions.
diff --git a/docs/src/conf.py b/docs/src/conf.py
@@ -156,7 +156,6 @@ def _dotv(version):
     "sphinx.ext.intersphinx",
     "sphinx_copybutton",
     "sphinx.ext.napoleon",
-    "numpydoc",
     "sphinx_design",
     "sphinx_gallery.gen_gallery",
     "matplotlib.sphinxext.mathmpl",
@@ -169,22 +168,6 @@ def _dotv(version):
     extensions.extend(["sphinxcontrib.apidoc"])
     extensions.extend(["api_rst_formatting"])
 
-# -- Numpydoc -----------------------------------------------------------------
-# See https://numpydoc.readthedocs.io/en/latest/install.html#configuration
-# TREMTEST
-# numpydoc_use_plots = True  # ?
-numpydoc_show_class_members = False  # False stops lots of warnings: https://stackoverflow.com/questions/65198998/sphinx-warning-autosummary-stub-file-not-found-for-the-methods-of-the-class-c
-# numpydoc_show_inherited_class_members
-# numpydoc_class_members_toctree
-# numpydoc_citation_re
-# numpydoc_attributes_as_param_list
-numpydoc_xref_param_type = True  # add hyperlink to types
-# numpydoc_xref_aliases
-# numpydoc_xref_ignore
-# numpydoc_validation_checks
-# numpydoc_validation_exclude
-
-
 # -- Napoleon extension -------------------------------------------------------
 # See https://sphinxcontrib-napoleon.readthedocs.io/en/latest/sphinxcontrib.napoleon.html
 napoleon_google_docstring = True

diff --git a/lib/iris/fileformats/netcdf/loader.py b/lib/iris/fileformats/netcdf/loader.py
@@ -500,9 +500,7 @@ def load_cubes(file_sources, callback=None, constraints=None):
         One or more NetCDF filenames/OPeNDAP URLs to load from.
         OR open datasets.
 
-    Kwargs:
-
-    * callback (callable function):
+    callback: function, optional
         Function which can be passed on to :func:`iris.io.run_callback`.
 
     Returns
@@ -511,7 +509,7 @@ def load_cubes(file_sources, callback=None, constraints=None):
 
     """
     # TODO: rationalise UGRID/mesh handling once experimental.ugrid is folded
-    #  into standard behaviour.
+    # into standard behaviour.
     # Deferred import to avoid circular imports.
     from iris.experimental.ugrid.cf import CFUGridReader
     from iris.experimental.ugrid.load import (