#11 __docformat__ for entire packages

Inspection (9)

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.


  • Edward Loper

    Edward Loper - 2004-04-24
    • labels: --> Inspection
    • assigned_to: nobody --> edloper
    • status: open --> closed
  • Edward Loper

    Edward Loper - 2004-04-24

    Logged In: YES

    I floated this idea on python-dev, and Guido said he'd
    rather each module get its own __docformat__. [1] So
    things will stay as they are.

    I moved the __doctitle__ request to its own RFE
    (#941140), so I could close this one.

    [1] http://mail.python.org/pipermail/python-dev/2004-


Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks