Update / clean-up RDoc

I'm currently up through the 'helpers' directory. The basic idea is to stick to commenting the basic purpose of classes or methods and leave the expository stuff (tutorials, long explanations with examples, etc.) to external content (the Web site, wiki, etc.). A lot of the docs are already fairly decent, so it is mostly just added / tweaking.
