Prev: Slicing [N::-1]
Next: ANN: Wing IDE 3.2.5 Released
From: Aahz on 16 Mar 2010 19:51 In article <ec8e0912-bc85-4c51-85f5-fc855e289c1c(a)k6g2000prg.googlegroups.com>, Pete Emerson <pemerson(a)gmail.com> wrote: > >Excellent, this is what I finally discovered, although I was looking >for 'foo' in sys.modules.keys(), which apparently isn't necessary. Actually, `foo in sys.modules.keys()` is double-slow, because first the dict must be scanned to create a list, and then the list must be scanned linearly to test for foo. -- Aahz (aahz(a)pythoncraft.com) <*> http://www.pythoncraft.com/ "Many customs in this life persist because they ease friction and promote productivity as a result of universal agreement, and whether they are precisely the optimal choices is much less important." --Henry Spencer
From: Aahz on 16 Mar 2010 19:55
In article <42062deb-785a-4955-9ce0-d9fb7a26455d(a)j27g2000yqn.googlegroups.com>, Vinay Sajip <vinay_sajip(a)yahoo.co.uk> wrote: > >I'm reviewing the documentation at the moment, as it happens, and it >still seems hard to be able to put together a structure which is good >for everyone. A full treatment, it seems to me, would talk a little >about the detail of why things work as they do; but a lot of the time, >people are just interested in getting going with the package, and less >interested in the whys and wherefores. But for people trying to do more >than the basics, that deeper understanding is sometimes necessary. The >hard part is satisfying all audiences in one document! Simple answer: don't The main logging docs should be reference material, but the top of the docs should link to a tutorial (or the other way around, but I think the Python docs have generally preferred to make the primary doc reference). Trying to make one page serve all documentation purposes rarely works. -- Aahz (aahz(a)pythoncraft.com) <*> http://www.pythoncraft.com/ "Many customs in this life persist because they ease friction and promote productivity as a result of universal agreement, and whether they are precisely the optimal choices is much less important." --Henry Spencer |