There are three public fields in java.lang.Float that I don't know what they
do exactly. Their names are WIDEFP_SIGNIFICAND_BITS, WIDEFP_MIN_EXPONENT,
and WIDEFP_MAX_EXPONENT. There doesn't appear to be any explanation in the
1.2 JavaDocs either (they aren't even listed). Could someone who knows fix
these? Other than these three, everything in Float is now documented.
Also, I have a question about Float and Number, specifically the methods
byteValue() and shortValue(). They are implemented in Number, calling
intValue() and casting down. Is there a reason for this? It appears that
Float and Double are the only numeric classes which actually takes advantage
of this and do not override those methods (though it's possible I added
methods to the other ones without thinking when I added docs ...).
Finally, in both Float and Double, the toString() method needs a little
elaboration. It would be nice to know what format the resulting String will
be in. Will it be in exponential notation? Will it ever be in regular
notation, and under what circumstances? Stuff people reading this could
use. parseFloat() needs the same elaboration. It would be nice to have
full specification of what the methods do inside the docs.
All that's left to document in java.lang are StringBuffer and Math. I'll
get to those later today, I hope.
--John
"All great truths begin as blasphemies." - George Bernard Shaw
