NAME

       XML::DOM::EntityReference - An XML ENTITY reference in XML::DOM

DESCRIPTION

       XML::DOM::EntityReference extends XML::DOM::Node.

       EntityReference  objects  may  be  inserted  into  the structure model when an entity reference is in the
       source document, or when the user wishes to insert an entity reference. Note  that  character  references
       and  references to predefined entities are considered to be expanded by the HTML or XML processor so that
       characters are represented by their Unicode equivalent rather than by an entity reference. Moreover,  the
       XML processor may completely expand references to entities while building the structure model, instead of
       providing  EntityReference  objects.  If  it  does provide such objects, then for a given EntityReference
       node, it may be that there is no Entity node representing the referenced entity; but if  such  an  Entity
       exists,  then  the child list of the EntityReference node is the same as that of the Entity node. As with
       the Entity node, all descendants of the EntityReference are readonly.

       The resolution of the children of the EntityReference (the replacement value of  the  referenced  Entity)
       may  be  lazily  evaluated;  actions  by  the  user  (such  as  calling  the  childNodes  method  on  the
       EntityReference node) are assumed to trigger the evaluation.

perl v5.8.8                                        2002-02-09                     XML::DOM::EntityReference(3pm)