add javadoc and shortcut method.