update README
honor method scope; add package-specific exceptions