added final javadocs