Name: gm110360 Date: 08/29/2002


FULL PRODUCT VERSION :
java version "1.4.0_01"
java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0_01-b03)
Java HotSpot(TM) Client VM (build 1.4.0_01-b03, mixed mode)

A DESCRIPTION OF THE PROBLEM :
I wish if all the API documentations had consistent pattern
of including one or two line examples of every Class/Method
possible. Not only that it would make the learning
experience of Java a lot easier but it would really make
the pages of API description meaningful.

I was having a hard time trying to get the right (new and
non deprecated) Factory/Class/SAXParser determined from the
JAXP API (which is now a part of JDK 1.4.x). ALl tutorials
and books taught the deprecated methods and classess and so
I headed to the API to get the right one. One presentation
that I was fortunately able to locate from JDC related to
the new JAXP helped me get some clues and find what I want
finally. But it was not very straightforward at all. If the
API had some simple examples associated with the new
XMLReader, SAXParserFactory, DefaultHandler etc. it would
have been a lot simpler and I probably might have
understood more of the API. (Same true for any new API
documentation)

REPRODUCIBILITY :
This bug can be reproduced occasionally.
(Review ID: 163733)
======================================================================