adding JavaDoc for the 1.0.RC release