Entity include files have a file extension of '.ent' (or example 'shared.ent'). An entity include file contains only entity declarations and XML comments, with no XML elements. See XML Entities. 

Note: XML elements may be contained inside of an entity declaration, but are not interpreted until the entity symbol is used inside of an application or partition file. 

Entity include files are copied into the parent file using an external parameter entity declaration in the DOCTYPE directive. This results in copying the contents of the entity include file into the parent file at that point.

The following example is an entity include file containing some entity declarations which are used to set application preferences. It is part of the uicinclude.ent sample.

<?xml version="1.0" encoding="UTF-8"?>
<!ENTITY TEXT_OFFSET "4">
<!ENTITY SCROLL_BAR_WIDTH "13">
<!ENTITY BUTTON_TEXT_OFFSET "3">
<!ENTITY BUTTON_MIN_SPACING "1">
<!ENTITY BUTTON_MAX_SPACING "8">
<!ENTITY BUTTON_MIN_WIDTH "36">
<!ENTITY BUTTON_MAX_WIDTH "100">
<!ENTITY BUTTON_FLASH_MSEC "150">

The following example shows how to copy the above entity include file. It is part of the padbuttons.ujms sample.

<!DOCTYPE ujml PUBLIC "-//UIEVOLUTION//DTD UJML 1.5//EN"
"http://www.uievolution.com/dtd/ujml-1.5.dtd" [
    <!ENTITY % include SYSTEM "uicinclude.ent">
    %include;
    <!ENTITY PAD_BUTTON_COUNT "12">
    <!ENTITY BUTTON_UP "0">
    <!ENTITY BUTTON_DOWN "1">
]>

XML Entities, uicinclude.ent, padbuttons.ujms