DOC: hack to numpydoc to include attributes that are None (GH6100)

See GH6100. Some attributes of our classes are None, even on the class objects themselves (so not on instances). By default, numpydoc does not include them in the autosummary table but in a separate plain table. But, our class.rst template does include them in the toctree autosummary, which creates docstring pages for these. This results in warnings "WARNING: document isn't included in any toctree". This hack to numpydoc does include them in the autosummary in the class docstring, removing this warning.

Author: jorisvandenbossche

doc/sphinxext/numpydoc/docscrape_sphinx.py

@@ -115,11 +115,13 @@ def _str_member_list(self, name):
  or inspect.isgetsetdescriptor(param_obj)):
  param_obj = None
 
- if param_obj and (pydoc.getdoc(param_obj) or not desc):
- # Referenced object has a docstring
- autosum += [" %s%s" % (prefix, param)]
- else:
- others.append((param, param_type, desc))
+ # pandas HACK - do not exclude attributes wich are None
+ # if param_obj and (pydoc.getdoc(param_obj) or not desc):
+ # # Referenced object has a docstring
+ # autosum += [" %s%s" % (prefix, param)]
+ # else:
+ # others.append((param, param_type, desc))
+ autosum += [" %s%s" % (prefix, param)]
 
  if autosum:
  out += ['.. autosummary::']