On 11/13/2009 04:58 PM, Florent Hivert wrote:
> If it's doable, I think that is the good way, as I suggested:
> 
>  > when documenting a class, either put systematically links to the upper
>  > classes, or else put some array with inherited methods together with
>  > links."

According to

http://sphinx.pocoo.org/ext/autodoc.html

we can use, e.g.,

.. automodule:: sage.algebras.steenrod_algebra
   :members:
   :undoc-members:
   :show-inheritance:

to leave a trail of superclasses.

Perhaps we can use the autosummary extension

http://sphinx.pocoo.org/ext/autosummary.html

in some way for the other problems?


Also of potential use is the inheritance diagram extension:

http://sphinx.pocoo.org/ext/inheritance.html

There's a sample patch at

http://trac.sagemath.org/sage_trac/attachment/ticket/6586/inheritance_example.patch

Unfortunately, it's not automatic.


A link to this thread:

http://groups.google.com/group/sage-devel/browse_thread/thread/a34a80097ad47805/2e57eb60d7f9881d?#2e57eb60d7f9881d

--~--~---------~--~----~------------~-------~--~----~
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