I'd really like to be able to note in a package that
the docstrings are in reStructuredText, and have that
apply to an entire package (and preferably for
subpackages that don't override it). Perhaps a
__docformat__ in __init__.py could be treated as
applying to the entire package or hierarchy (and
__docformat__ in a module overrides the package setting).
It would also be nice if the module named as a starting
point could have a __doctitle__ that's equivalent to
the --name command line option.
Log in to post a comment.