improving java api doc