add warnings to javadoc about api issues