add detail to readme.rdoc