-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Am 11.01.2010 18:16, schrieb Ciantic: > Hi! > > I decided to post also here, I have implemented a way to get > submodules working for autosummary extension. > > Also I implemented to autosummary to respect __all__ of package/ > module. This is changes behavior, but I think not that many people are > yet using autosummary, since there was bug where all Classes were > included in Exceptions section also, one would think that would have > been spotted a long time ago?
Well, that particular bug was only present in the trunk, not the released version, and it seems that intersecting the set of trunk users with the set of autosummary users leaves just you :) I assume that numpy (where autosummary was conceived) uses its own adapted version. > See following issue, diff file is attached to it: > http://bitbucket.org/birkenfeld/sphinx/issue/317/submodules-to-autosummary-and-respect-__all__ > > Essentially the submodule iteration allows to generate *whole* > documentation for *package* like EpyDoc does with a custom module.rst: > > {{ fullname }} > {{ underline }} I'll look at your patch for the next release, if it works as intended it could be the smoothest way to automatic package doc generation which is often requested. > Also I've been wondering, can't that {{ underline }} be done with > {{ fullname|underline }}, I'm coming from Django and that would be the > most natural way to do it. You're right, that could be replaced by {{ '-' * (fullname | length) }}. cheers, Georg -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.14 (GNU/Linux) iEYEARECAAYFAktMSRoACgkQN9GcIYhpnLDqhgCfXMVNgWcO3dR4LzHhmlCAnmfA gcAAnAryd+6NYI0CI7RRf2WyWbv5ptfO =+5Y7 -----END PGP SIGNATURE-----
-- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected]. 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.
