added package level javadoc & some examples