Document '-r' switch and switch README to proper markdown.