Easily extendable autodoc #3
Description
Make autodoc directives easily extendable, as proposed in
[comment from OP]
I'd like to retract my proposition, or rather rephrase it.
Extending autodoc would be simpler if directives such as function, class, method were
defined as classes rather than in the desc_directive function.
Something like:
class Description(Directive):
def __init__
def handle_options
def handle_signature
def handle_content
def handle_field_list
def index_as
def run
Extending autodoc would then simply be a matter of subclassing those directive. I
used this approach to write directives to autodocument fortran code (fortrandoc on
launchpad) and I found it worked well.
- Bitbucket: https://bitbucket.org/birkenfeld/sphinx/issue/3
- Originally reported by: Georg Brandl
- Originally created at: 2008-11-02T22:14:37.704