make output from restructured text generator useable
Merge pull request #43 from tychoish/rst-fixes

Clean up Restructured Text support.