FULL PRODUCT VERSION :
N/A

ADDITIONAL OS VERSION INFORMATION :
SunOS shell 5.10 Generic_118822-25 sun4v sparc SUNW,Sun-Fire-T1000 Solaris
and any system providing javax.imageio.


A DESCRIPTION OF THE PROBLEM :
It's unfortunate that the markByteStack (and markBitStack) is
private rather than protected. Overriding the reset method would be
easier if the Stack were accessible to the subclass implementation.

Also, the javadoc should make it clear when a method has side effects.
Of course, as an "older" software developer I am compelled to examine
the code to be sure I am aware of side effects when depending on an
abstract base class implementation. But the "new generation" seems to be
rather blase about implementation details, depending on the doc to say
whatever needs to be done.


STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Examine the javax/imageio/stream/ImageInputStreamImpl.java file.


EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Expecting to see the critical javadoc for the abstract read method.

ACTUAL -
Don't see the critical javadoc for the abstract read method.


REPRODUCIBILITY :
This bug can be reproduced always.

---------- BEGIN SOURCE ----------
Examine the javax/imageio/stream/ImageInputStreamImpl.java file.

---------- END SOURCE ----------