Documentation suggestions

Iain King iainking at gmail.com
Wed Dec 7 08:51:45 EST 2005


skip at pobox.com wrote:
> Iain> Well, the point of the GMI is to lookup whatever module you are
>     Iain> currently having to use for the first time (at least it is for
>     Iain> me).  Giving easy access to the modules I've already had to look
>     Iain> up (because they are common) doesn't really help - I've already
>     Iain> accessed those.  It'll be nice when I have to find some obscure
>     Iain> feature I haven't used in them before, but really, all I'd like is
>     Iain> an easy to use index :)
>
> Reorganizing the global module index isn't all that straightforward.  It is
> generated by latex2html.  To change its layout would probaly require some
> additional markup and mods to latex2html (not a pretty piece of code as I
> understand it).
>
> OTOH, I find myself returning to the same module docs over and over again to
> look up function arguments, regular expression syntax, that sort of thing.
> Having to page down past dozens and dozens of modules I don't care about to
> click on "sys" or "datetime" motivated me to write my little hack.
>
> Skip

Argh, you made me look at the html again - at least now I know *why* it
is so disgusting.  I understand there's a new version coming out soon,
hopefully in html 4 strict or xhtml.  I'm sure at that point it'll be
easier to use.  I can wait. :)

Iain




More information about the Python-list mailing list