small improvements to README, DESCRIPTION and package manual page