Hi,

Tue, 04 Nov 2008 13:18:06 -0800, percious wrote:
> Ok, numpyext is now my sphinx branch in as autosummary.  I will no
> longer speak of this functionality in a "numpy" domain.
> 
> This extension provides auto-generated :autodoc: style for all
> :autosummary: directives in the .rst files in the root source folder.

Looks nice. Some comments / wishlist:

- Hooking autosummary into the same "autodoc-process-docstring"
  and "autodoc-process-signature" signal as sphinx.ext.autodoc
  would be nice.

  Cf. http://sphinx.pocoo.org/latest/ext/autodoc.html
  #docstring-preprocessing

  This would allow removing autosummary.py from numpyext after it is
  merged to Sphinx.

- I'd recommend retaining the signature formatting functionality -- it's
  probably generally useful. Though maybe the function signatures
  shouldn't be on by default.

- There's presently an error on line 222 in autosummary/__init__.py,
  variable "title" is undefined, but maybe this part is still under
  refactoring.

-- 
Pauli Virtanen


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to