Avoid reprocessing already numpydocced docstrings

Author: jnothman

numpydoc/numpydoc.py

@@ -63,14 +63,21 @@ def rename_references(app, what, name, obj, options, lines,
         reference_offset[0] += len(references)
 
 
+DEDUPLICATION_TAG = ['..', '    processed by numpydoc']
+
+
 def mangle_docstrings(app, what, name, obj, options, lines):
+    if lines[-len(DEDUPLICATION_TAG):] == DEDUPLICATION_TAG:
+        return
 
     cfg = {'use_plots': app.config.numpydoc_use_plots,
            'show_class_members': app.config.numpydoc_show_class_members,
            'show_inherited_class_members':
            app.config.numpydoc_show_inherited_class_members,
            'class_members_toctree': app.config.numpydoc_class_members_toctree}
 
+    print(locals())
+
     u_NL = sixu('\n')
     if what == 'module':
         # Strip top title
@@ -100,6 +107,8 @@ def mangle_docstrings(app, what, name, obj, options, lines):
     # duplicates
     rename_references(app, what, name, obj, options, lines)
 
+    lines += DEDUPLICATION_TAG
+
 
 def mangle_signature(app, what, name, obj, options, sig, retann):
     # Do not try to inspect classes that don't define `__init__`