Name: rmT116609 Date: 07/07/2003


A DESCRIPTION OF THE PROBLEM :
The TransformerFactory.newTransformer(...) documentation is unclear regarding
the source parameter.

It says:

    Process the Source into a Transformer object.
    ...
    source - An object that holds a URI, input stream, etc.

Nothing says clearly that the source parameter is for an XSLT transform
document.

Also, the parameter description is not useful. Source's documentation already
defines the relationship between a Source and the associated input document.
This parameter description should say what that input document it (the
XSLT transform).




EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
See above.
ACTUAL -
See above.

URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.4.2/docs/api/javax/xml/transform/TransformerFactory.html#newTransformer(javax.xml.transform.Source)
(Review ID: 189914)
======================================================================

Integrated the fix as part of Sept 12,2003 JAXP integration into Tiger build 20

###@###.### 2003-09-12