On Wed, Jun 17, 2009 at 8:27 AM, Robert Bradshaw<rober...@math.washington.edu> wrote: > > On Jun 16, 2009, at 3:25 PM, Ondrej Certik wrote: > >> >> On Tue, Jun 16, 2009 at 4:09 PM, Nick >> Alexander<ncalexan...@gmail.com> wrote: >>> >>>> Also, there are probably lots of modules and classes where an >>>> alphabetical listing is way better than the one they are in in the >>>> code since the alphabetical is at least consistent and predictable. >>> >>> I think that alphabetical is probably the simplest option. This >>> suggests that module level documentation needs to give the overview/ >>> organization that Robert wants. Carl Witty is the master of such >>> organization. >> >> Note that in sphinx you can set the order by hand yourself by the >> :members: field like this: >> >> .. autoclass:: Theora >> :members: get_frame_image, read_frame >> >> I just checked that. > > Often related functions are grouped together in the file, and I would > like this to be preserved (if possible). Alphabetical is fine for an > index, but otherwise information is lost. For example, for > ell_rational_field, all the hegner point methods are grouped, all the > p-adic l-function methods are grouped, all the methods dealing with > sha are grouped, etc.
It seems to me that the only thing we can do is parse the file a little and generate the lines Ondrej lists above. -- William --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to sage-devel@googlegroups.com To unsubscribe from this group, send email to sage-devel-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---
