Format in RDoc for nicer github rendering.

Also corrected some spelling issues as well as some commentary leftover from
when it was on my own branch.