package: tidied up comments
package: added package features to README.md