[Feature Request] add 'extensions' option to z3c.recipe.sphinxdoc
Hi, I'm using z3c.recipe.sphinxdoc to generate documentation for a project. Sphinx has some very useful extensions like 'sphinx.ext.autodoc' and 'sphinx.ext.doctest' and I would like to use both extensions in my 'docs' part. Especially the autodoc function is useful when creating API docs. I would be cool if 'z3c.recipe.sphinxdoc' could take an additional option to include extensions, like: [docs] recipe = z3c.recipe.sphinxdoc eggs = someeeg extensions = sphinx.ext.autodoc sphinx.ext.doctest Thanks, Markus
I'm not familiar with your process of implementing new features, but the attached patch adds such option to z3c.recipe.sphinxdoc, comments welcome. Markus
Hi Markus. Stephan Richter and Paul Cardune are the people I would expect to manage this package. I expect they'll get back to you soonish. On freenode #zope3-dev they are srichter and pcardune, IIRC. The feature and the diff look reasonable to me. Normally we want tests in our diffs, but this package doesn't have them yet, so I don't see why it should block this contribution. FWIW, I did notice a trivial issue: a spelling error in the CHANGES: "seperated" -> "separated". Thanks! Gary On Apr 28, 2009, at 9:25 AM, markus korn wrote:
I'm not familiar with your process of implementing new features, but the attached patch adds such option to z3c.recipe.sphinxdoc, comments welcome.
Markus < add_extensions_option .diff>_______________________________________________ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
participants (2)
-
Gary Poster -
markus korn