added post - released API
added javadoc