Add 'toctree' option to autosummary directive to generate stub pages (#3927)

Author: seisman

doc/_templates/autosummary/class.rst

@@ -17,6 +17,7 @@
 .. rubric:: Methods Summary
 
 .. autosummary::
+    :toctree:
     {% for item in methods %}
     {% if item != '__init__' %}
     {{ objname }}.{{ item }}

doc/_templates/autosummary/module.rst

@@ -16,7 +16,7 @@
 .. rubric:: Classes
 
 .. autosummary::
-  :toctree: ./
+  :toctree:
 {% for item in classes %}
   {{ item }}
 {% endfor %}
@@ -29,7 +29,7 @@
 .. rubric:: Functions
 
 .. autosummary::
-  :toctree: ./
+  :toctree:
 {% for item in functions %}
   {{ item }}
 {% endfor %}
@@ -42,7 +42,7 @@
 .. rubric:: Exceptions
 
 .. autosummary::
-  :toctree: ./
+  :toctree:
 {% for item in exceptions %}
   {{ item }}
 {% endfor %}