add notes to readme.rdoc