> > Is it just me, or are docstrings less-convenient than comments? Any > thought given to reST-processing a module's comments? > Maybe it's just me but I would be more happy to optionally be able to write reST inside comments instead of docstrings and have it extracted from there. That means the comment would take the place of the secondary docstring. regards.