broadened api for Matcher case declaration. added more javadoc