On 11/13/2009 09:42 PM, John H Palmieri wrote:
> I like this.  (Note, though, that it doesn't show all of the methods
> for chain complexes (for instance) in one place, and it doesn't let
> you easily see which ones from SageObject may have been overridden.)

On including inherited members but not their docstrings:  Can we detect
them and "zero" their docstrings in autodoc-process-docstring

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

?

On a related note: Should we include [documented] hidden methods (e.g.,
__init__)?  Can we do this with autodoc-skip-member

http://sphinx.pocoo.org/ext/autodoc.html#skipping-members

?

On another note:  For single-page transformations, it may be easier or
otherwise worthwhile to add JavaScript code to layout.html that, e.g.,

 * Adds sidebar links for each class.
 * Collects all classes, functions, and methods at the bottom of the page.
 * Toggles (hide/show) the display of all docstrings.
 * ???

Does the documentation include nested classes?

--~--~---------~--~----~------------~-------~--~----~
To post to this group, send an email to sage-devel@googlegroups.com
To unsubscribe from this group, send an email to 
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to