MRG: Use numpydoc from pip (mne-tools#3337)

* ENH: Use numpydoc from pip

* DOC: Explain nesting [ci skip]

* FIX: Fix typos

circle.yml

@@ -40,7 +40,7 @@ dependencies:
     - git clone https://github.com/sphinx-gallery/sphinx-gallery.git;
     - cd sphinx-gallery && pip install -r requirements.txt && python setup.py develop;
     - cd /home/ubuntu && git clone https://github.com/enthought/pyface.git && cd pyface && python setup.py develop;
-    - pip install sphinx_bootstrap_theme PySurfer nilearn neo;
+    - pip install sphinx_bootstrap_theme PySurfer nilearn neo numpydoc;
 
   override:
     - cd /home/ubuntu/mne-python && python setup.py develop;

doc/conf.py

@@ -26,6 +26,8 @@
 sys.path.append(os.path.abspath(os.path.join(curdir, 'sphinxext')))
 
 import mne
+if not os.path.isdir('_images'):
+    os.mkdir('_images')
 
 # -- General configuration ------------------------------------------------
 
@@ -34,7 +36,9 @@
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-import numpy_ext.numpydoc
+from numpydoc import numpydoc, docscrape
+docscrape.ClassDoc.extra_public_methods = mne.utils._doc_special_members
+
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.autosummary',
@@ -46,7 +50,7 @@
     'sphinx_gallery.gen_gallery',
 ]
 
-extensions += ['numpy_ext.numpydoc'] 
+extensions += ['numpydoc'] 
 extensions += ['gen_commands']  # auto generate the doc for the python commands
 # extensions += ['flow_diagram]  # generate flow chart in cookbook
 
@@ -296,3 +300,5 @@
     'default_thumb_file': os.path.join('_static', 'mne_helmet.png'),
     'mod_example_dir': 'generated',
     }
+
+numpydoc_class_members_toctree = False