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