http://nagoya.apache.org/bugzilla/show_bug.cgi?id=2691 *** shadow/2691 Thu Jul 19 09:05:45 2001 --- shadow/2691.tmp.3300 Thu Jul 19 09:05:45 2001 *************** *** 0 **** --- 1,41 ---- + +============================================================================+ + | Documentation for XMLReaderFactory does not say what value to use for org. | + +----------------------------------------------------------------------------+ + | Bug #: 2691 Product: Xerces2-J | + | Status: NEW Version: 2.0.0 [alpha] | + | Resolution: Platform: All | + | Severity: Normal OS/Version: All | + | Priority: Other Component: SAX | + +----------------------------------------------------------------------------+ + | Assigned To: [EMAIL PROTECTED] | + | Reported By: [EMAIL PROTECTED] | + | CC list: Cc: | + +----------------------------------------------------------------------------+ + | URL: | + +============================================================================+ + | DESCRIPTION | + The documentation for XMLReaderFactory suggests that XMLReaders should be + created using the (static) createReader() method. However, not passing in a + value results in an exception with a message 'org.xml.sax.driver is not set'. + + After a bit of RTFM, I found that I needed to set this property. However, there + isn't any documentation *anywhere* (including examples) that says what this + value should take. All the example code uses the SAXParser (SAX1) stuff. + + Eventually, I discovered that the value should be the fully qualified name of + the (SAX1/2) SAXParser class, but not without a lot of effort. It would be + really good to add into the FAQ, and preferably into the XMLReaderFactory API + documentation, what the value should be. For example, in the XMLReaderFactory + description, you could say that it could be run with: + + java -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser + + (I doubt that many people know how to run Java with a parameter, and there + certainly isn't anything in the documentation to say what that value should be). + + Please can this be added to the FAQ for both Xerces and Xalan, and in the + APIDocs for the XMLReaderFactory? If not, it should be mentioned somewhere in + the Xerces/Xalan documentation, and preferably in a comment in the XMLReader + examples (e.g. the SAX2SAX sample in Xalan). + + Alex. --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
