update notes in README.rdoc