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. If such an
* Entity exists, then the subtree of the
* EntityReference node is in general a copy of the
* Entity node subtree. However, this may not be true when an
* entity contains an unbound namespace prefix. In such a case, because the
* namespace prefix resolution depends on where the entity reference is, the
* descendants of the EntityReference node may be bound to
* different namespace URIs.
* As for Entity nodes, EntityReference nodes and
* all their descendants are readonly.
*
See also the Document Object Model (DOM) Level 2 Core Specification. */ public interface EntityReference extends Node { }