re-RST README and fix some syntax