Name: jk109818 Date: 01/02/2002


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




A DESCRIPTION OF THE PROBLEM :
The Javadoc for DeclHandler.attributeDecl() says in part:

    Any parameter entities in the attribute value will be
    expanded, but general entities (and character
    references) will not.

This may have been true in some older version of SAX 2, but
it is inconsistent with (a) the current version of SAX 2 on
www.saxproject.org and (b) the actual behaviour of Crimson
(the default XML parser in JDK 1.4 and JAXP 1.1).

The new SAX 2 Javadoc (and what Crimson seems to implement)
is

    The value will be the value as reported to applications,
    appropriately normalized and with entity and character
    references expanded.

This is good, because

    (a) it's much easier for the user (me)

    (b) Thinking about it, the old Javadoc seems pretty
        nonsensical from an XML point of view



This bug can be reproduced always.
(Review ID: 137807)
======================================================================