Name: gm110360 Date: 02/12/2002


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


A DESCRIPTION OF THE PROBLEM :
Suggest clarifying
javax.xml.parsers.SAXParser.getXMLReader() JavaDoc, which is
vague on two points:

1. Under what conditions does it throw SAXException?
2. What is the relationship between
(a) the XMLReader returned by getXMLReader() [where
XMLReader contains handlers ContentHandler, ErrorHandler,
etc.], and
(b) the DefaultHandler parameter to parse(InputSource,
DefaultHandler) [where DefaultHandler implements
ContentHandler, ErrorHandler, etc.]
E.g., does (b) modify (a), or does (b) override (a), or ?



STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
See javadoc at
http://java.sun.com/j2se/1.4/docs/api/javax/xml/parsers/SAXParser.html#getParser()

EXPECTED VERSUS ACTUAL BEHAVIOR :
Expected:
1. throws SAXException clause explaining when this is thrown.
2. explanation of connections between the XMLReader and the
DefaultHandler

Actual:
1. just a link to SAXException
2. vague explanation that this class wraps an XMLReader, but
no explanation of the connections between the XMLReader and
the DefaultHandler.

This bug can be reproduced always.
(Review ID: 139186)
======================================================================
###@###.### 11/2/04 01:08 GMT