<RefEntry ID="dbre.elem.Example">
<!-- Created by DTDParseRefentry version 0.94 -->
<!-- Consult http://www.ora.com/homepages/dtdparse/ -->
<!-- for more information. -->

<![ %dbre.ms.refmeta [
<RefMeta>
<IndexTerm><Primary>Example Element</Primary></IndexTerm>
<RefEntryTitle>Example</RefEntryTitle>
<RefMiscInfo>Element</RefMiscInfo>
</RefMeta>
]]>

<RefNameDiv>
<RefName>Example</RefName>
<RefPurpose>
Example of a computer
program or related information

</RefPurpose>
</RefNameDiv>

<![ %dbre.ms.refsynopsisdiv [
<RefSynopsisDiv><Title>Content Model</Title>
<Synopsis>
  ((<Link LinkEnd="dbre.elem.Title">Title</Link>, <Link LinkEnd="dbre.elem.TitleAbbrev">TitleAbbrev</Link>?), (<Link LinkEnd="dbre.elem.CalloutList">CalloutList</Link> | <Link LinkEnd="dbre.elem.GlossList">GlossList</Link>
  | <Link LinkEnd="dbre.elem.ItemizedList">ItemizedList</Link> | <Link LinkEnd="dbre.elem.OrderedList">OrderedList</Link> | <Link LinkEnd="dbre.elem.SegmentedList">SegmentedList</Link> | <Link LinkEnd="dbre.elem.SimpleList">SimpleList</Link>
  | <Link LinkEnd="dbre.elem.VariableList">VariableList</Link> | <Link LinkEnd="dbre.elem.LiteralLayout">LiteralLayout</Link> | <Link LinkEnd="dbre.elem.ProgramListing">ProgramListing</Link>
  | <Link LinkEnd="dbre.elem.ProgramListingCO">ProgramListingCO</Link> | <Link LinkEnd="dbre.elem.Screen">Screen</Link> | <Link LinkEnd="dbre.elem.ScreenCO">ScreenCO</Link> | <Link LinkEnd="dbre.elem.ScreenShot">ScreenShot</Link>
  | <Link LinkEnd="dbre.elem.Synopsis">Synopsis</Link> | <Link LinkEnd="dbre.elem.CmdSynopsis">CmdSynopsis</Link> | <Link LinkEnd="dbre.elem.FuncSynopsis">FuncSynopsis</Link> | <Link LinkEnd="dbre.elem.FormalPara">FormalPara</Link> | <Link LinkEnd="dbre.elem.Para">Para</Link>
  | <Link LinkEnd="dbre.elem.SimPara">SimPara</Link> | <Link LinkEnd="dbre.elem.Address">Address</Link> | <Link LinkEnd="dbre.elem.BlockQuote">BlockQuote</Link> | <Link LinkEnd="dbre.elem.Graphic">Graphic</Link> | <Link LinkEnd="dbre.elem.GraphicCO">GraphicCO</Link>
  | <Link LinkEnd="dbre.elem.InformalEquation">InformalEquation</Link> | <Link LinkEnd="dbre.elem.InformalExample">InformalExample</Link>
  | <Link LinkEnd="dbre.elem.InformalTable">InformalTable</Link>)+)
  -(<Link LinkEnd="dbre.elem.Equation">Equation</Link> | <Link LinkEnd="dbre.elem.Example">Example</Link> | <Link LinkEnd="dbre.elem.Figure">Figure</Link> | <Link LinkEnd="dbre.elem.Table">Table</Link>)
</Synopsis>

<![ %dbre.ms.refsynopsisdiv.excl [
<RefSect2><Title>Exclusions</Title>
<Para>
Example excludes these elements at every level:
</Para>
<Synopsis>
  <Link LinkEnd="dbre.elem.Equation">Equation</Link> | <Link LinkEnd="dbre.elem.Example">Example</Link> | <Link LinkEnd="dbre.elem.Figure">Figure</Link> | <Link LinkEnd="dbre.elem.Table">Table</Link>
</Synopsis>
</RefSect2>
]]>

<![ %dbre.ms.refsynopsisdiv.attr [
<RefSect2><Title>Attributes</Title>
<Para>
This element has <link linkend="dbre.x.common">common</link> and <link linkend="dbre.x.role"><sgmltag class=attribute>Role</></link> attributes.
</Para>
<INFORMALTABLE>
<TGROUP COLS=4>
<COLSPEC COLNUM=2 COLNAME=C2>
<COLSPEC COLNUM=4 COLNAME=C4>
<SPANSPEC SPANNAME=C2C4 NAMEST=C2 NAMEEND=C4>
<THEAD>
<ROW>
  <ENTRY>Name</ENTRY>
  <ENTRY>Value(s)</ENTRY>
  <ENTRY>Type</ENTRY>
  <ENTRY>Default Value</ENTRY>
</ROW>
</THEAD>
<TBODY>
<ROW>
  <ENTRY>Label</ENTRY>
  <ENTRY>CDATA</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>Width</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
</TBODY>

</TGROUP>

</INFORMALTABLE>

</RefSect2>
]]>

<![ %dbre.ms.refsynopsisdiv.tagmin [
<RefSect2><Title>Tag Minimization</Title>
<Para>
Both the start- and end-tags are required for this element.
</Para>
</RefSect2>
]]>

</RefSynopsisDiv>
]]>

<![ %dbre.ms.description [
<RefSect1><Title>Description</Title>
<para>Example of a computer 
program or related information,
typically a section of program source code.
It contains a required Title and an
optional TitleAbbrev, followed by one or more block-oriented
elements in any combination.  
A simple Example might contain a Title
and a ProgramListing.
It has Label, Width, and common attributes.  
</para>


<![ %dbre.ms.description.parents [
<RefSect2><Title>Parents</Title>
<Para>
These elements contain Example:
<SimpleList Type=Inline>
<Member><Link LinkEnd="dbre.elem.Appendix">Appendix</Link></Member>
<Member><Link LinkEnd="dbre.elem.Article">Article</Link></Member>
<Member><Link LinkEnd="dbre.elem.BiblioDiv">BiblioDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Bibliography">Bibliography</Link></Member>
<Member><Link LinkEnd="dbre.elem.BlockQuote">BlockQuote</Link></Member>
<Member><Link LinkEnd="dbre.elem.Callout">Callout</Link></Member>
<Member><Link LinkEnd="dbre.elem.Caution">Caution</Link></Member>
<Member><Link LinkEnd="dbre.elem.Chapter">Chapter</Link></Member>
<Member><Link LinkEnd="dbre.elem.GlossDef">GlossDef</Link></Member>
<Member><Link LinkEnd="dbre.elem.GlossDiv">GlossDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Glossary">Glossary</Link></Member>
<Member><Link LinkEnd="dbre.elem.Important">Important</Link></Member>
<Member><Link LinkEnd="dbre.elem.Index">Index</Link></Member>
<Member><Link LinkEnd="dbre.elem.ListItem">ListItem</Link></Member>
<Member><Link LinkEnd="dbre.elem.MsgExplan">MsgExplan</Link></Member>
<Member><Link LinkEnd="dbre.elem.MsgText">MsgText</Link></Member>
<Member><Link LinkEnd="dbre.elem.Note">Note</Link></Member>
<Member><Link LinkEnd="dbre.elem.Para">Para</Link></Member>
<Member><Link LinkEnd="dbre.elem.PartIntro">PartIntro</Link></Member>
<Member><Link LinkEnd="dbre.elem.Preface">Preface</Link></Member>
<Member><Link LinkEnd="dbre.elem.Procedure">Procedure</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect1">RefSect1</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect2">RefSect2</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect3">RefSect3</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSynopsisDiv">RefSynopsisDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect1">Sect1</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect2">Sect2</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect3">Sect3</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect4">Sect4</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect5">Sect5</Link></Member>
<Member><Link LinkEnd="dbre.elem.SetIndex">SetIndex</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sidebar">Sidebar</Link></Member>
<Member><Link LinkEnd="dbre.elem.SimpleSect">SimpleSect</Link></Member>
<Member><Link LinkEnd="dbre.elem.Step">Step</Link></Member>
<Member><Link LinkEnd="dbre.elem.Tip">Tip</Link></Member>
<Member><Link LinkEnd="dbre.elem.Warning">Warning</Link></Member>
</SimpleList>.
</Para>

</RefSect2>
]]>

<![ %dbre.ms.description.children [
<RefSect2><Title>Children</Title>
<Para>
Example contains these elements:
<SimpleList Type=Inline>
<Member><Link LinkEnd="dbre.elem.Address">Address</Link></Member>
<Member><Link LinkEnd="dbre.elem.BlockQuote">BlockQuote</Link></Member>
<Member><Link LinkEnd="dbre.elem.CalloutList">CalloutList</Link></Member>
<Member><Link LinkEnd="dbre.elem.CmdSynopsis">CmdSynopsis</Link></Member>
<Member><Link LinkEnd="dbre.elem.FormalPara">FormalPara</Link></Member>
<Member><Link LinkEnd="dbre.elem.FuncSynopsis">FuncSynopsis</Link></Member>
<Member><Link LinkEnd="dbre.elem.GlossList">GlossList</Link></Member>
<Member><Link LinkEnd="dbre.elem.Graphic">Graphic</Link></Member>
<Member><Link LinkEnd="dbre.elem.GraphicCO">GraphicCO</Link></Member>
<Member><Link LinkEnd="dbre.elem.InformalEquation">InformalEquation</Link></Member>
<Member><Link LinkEnd="dbre.elem.InformalExample">InformalExample</Link></Member>
<Member><Link LinkEnd="dbre.elem.InformalTable">InformalTable</Link></Member>
<Member><Link LinkEnd="dbre.elem.ItemizedList">ItemizedList</Link></Member>
<Member><Link LinkEnd="dbre.elem.LiteralLayout">LiteralLayout</Link></Member>
<Member><Link LinkEnd="dbre.elem.OrderedList">OrderedList</Link></Member>
<Member><Link LinkEnd="dbre.elem.Para">Para</Link></Member>
<Member><Link LinkEnd="dbre.elem.ProgramListing">ProgramListing</Link></Member>
<Member><Link LinkEnd="dbre.elem.ProgramListingCO">ProgramListingCO</Link></Member>
<Member><Link LinkEnd="dbre.elem.Screen">Screen</Link></Member>
<Member><Link LinkEnd="dbre.elem.ScreenCO">ScreenCO</Link></Member>
<Member><Link LinkEnd="dbre.elem.ScreenShot">ScreenShot</Link></Member>
<Member><Link LinkEnd="dbre.elem.SegmentedList">SegmentedList</Link></Member>
<Member><Link LinkEnd="dbre.elem.SimPara">SimPara</Link></Member>
<Member><Link LinkEnd="dbre.elem.SimpleList">SimpleList</Link></Member>
<Member><Link LinkEnd="dbre.elem.Synopsis">Synopsis</Link></Member>
<Member><Link LinkEnd="dbre.elem.Title">Title</Link></Member>
<Member><Link LinkEnd="dbre.elem.TitleAbbrev">TitleAbbrev</Link></Member>
<Member><Link LinkEnd="dbre.elem.VariableList">VariableList</Link></Member>
</SimpleList>.
</Para>

<Para>
In some contexts, additional elements may be allowed
by inclusions in parent elements.
Similarly, in some contexts, some of these elements
may be invalid due to exclusions in parent elements.
</Para>
</RefSect2>
]]>


</RefSect1>
]]>

<![ %dbre.ms.attrdesc [
<RefSect1><Title>Attributes</Title>

<variablelist>
<varlistentry><term>Label</term>
<listitem>
<para>
Label holds an identifying number 
or string to be output in some manner
when the element it is applied to is rendered.

</para>
</listitem>
</varlistentry>
<varlistentry><term>Width</term>
<listitem>
<para>
Width indicates the width of the longest line in the element
to which it pertains, in number of characters. 
</para>
</listitem>
</varlistentry>
</variablelist>
</RefSect1>
]]>

<![ %dbre.ms.examples [
<RefSect1><Title>Examples</Title>
<programlisting>
<![ CDATA [
<EXAMPLE ID="EX-1002-5-4">
<TITLE>Example of switching graphics contexts
</TITLE>
<PROGRAMLISTING>GC gc1, gc2;
XGCValues values;<LINEANNOTATION>Note capitalization</LINEANNOTATION>
unsigned long valuemask;
        .
        .
        .
/* Open display, create window, etc. */
values.foreground = BlackPixel(display,screen_num);
values.background = WhitePixel(display,screen_num);
gc1 = XCreateGC(display, RootWindow(display, screen_num),
        (GCForeground | GCBackground), &amp;values);
values.foreground = WhitePixel(display,screen_num);
values.background = BlackPixel(display,screen_num);
gc2 = XCreateGC(display, RootWindow(display, screen_num),
        (GCForeground | GCBackground), &amp;values);
/* Now you can use either gc in drawing routines, thereby
 * quickly swapping the foreground and background colors */
</PROGRAMLISTING>
</EXAMPLE>
]]>
</programlisting>

</RefSect1>
]]>

</RefEntry>