tidy and improve man page
update README.md