Irrelevant text in specification of SAXParser class

Name: eaR10174 Date: 06/21/2001


  There are two paragraphs in heading part of the javadoc description of the
javax.xml.parsers.SAXParser class that seem relevant to another class -
javax.xml.parsers.SAXParserFactory :

" This static method creates a new factory instance based on a system property
setting or uses the platform default if no property has been defined.

The system property that controls which Factory implementation to create is named
"javax.xml.parsers.SAXParserFactory". This property names a class that is a concrete
subclass of this abstract class. If no property is defined, a platform default will
be used. "

  This text fragment says about some static method, but the method
SAXParserFactory.newSAXParser() mentioned above isn't static. Moreover, the
SAXParser class has not any static methods. Only one of the classes SAXParser and
SAXParserFactory has a static method. This is a SAXParserFactory class. The method
is newInstance() and the text describes behaviour of this method.

  The issue appears in jaxp-1.1.1-b24-19_jun_2001 and jdk1.4.0beta-b68.

======================================================================