sprinkle some reStructuredText usage examples into the code samples of
the manual