RDoc cleanup

Various rdoc cleanup so that "puppet doc" generates nicely formatted documentation, including toplevel module documentation (moved module overview from init.pp into README)