[Jack Jansen]
I agree that it doesn't belong in the language itself, but what would be nice is if the help module could point you to examples. A first stab at this could be to use a well-defined naming scheme for the examples (so that examples for the "os" module would be in "Demos/os", and examples of os.walk() would be in, say, Demos/os/walk.py or walk_1.py and walk_2.py). And this could be extended with having index files in the Demos tree which would map Python names to example files. For example, if there was a demo Demos/os/renamefilesintreetouppercase.py then and index file in Demos/os could tell the help module that this is a useful file to examine if you're interested in os.walk or os.path.
This is more reasonable, but I still have reservations over having this kind of thing in the core. It isn't over whether it is useful or not, but whether people who do the bulk of CVS checkins want to be bothered with reading a possible deluge of example Python code on top of their usual Python work. Isn't the Cookbook supposed to cover stuff like this? And it was suggested to have a separate ``examples`` package, but that might be a barrier of entry for newbies (albeit a low barrier). -Brett