<section role="NotInToc" id="rich_orderingList">
   <title>
				&lt;
				rich:orderingList
				&gt;
				<emphasis role="since">
         <superscript> available since <emphasis role="version">3.1.3</emphasis>
         </superscript>
      </emphasis>
   </title>
   <section>
     <title>Description</title>
     <para>The <emphasis role="bold">
            <property>&lt;rich:orderingList&gt;</property>
         </emphasis> is a component for ordering items in a list.  This component provides possibilities to reorder a list and sort it on the client side.</para>
     <figure>
         <title>
            <emphasis role="bold">
               <property>&lt;rich:orderingList&gt;</property>
            </emphasis> component</title>
         <mediaobject> 
            <imageobject>
               <imagedata fileref="images/orderingList_init.png"/>
            </imageobject>
         </mediaobject>
     </figure>
     
   </section>
   <section>
      <title>Key Features</title>    
      <itemizedlist>
        <listitem>
            <para>Highly customizable look and feel</para>
         </listitem>
        <listitem>
            <para>Reordering possibility for list items</para>
         </listitem>
        <!--listitem>Customizable component layout (captions, headers, list items and ordering control set)</listitem-->
        <!--listitem>Disabled/enabled ordering controls</listitem-->
        <listitem>
            <para>Multiple selection of list items</para>
         </listitem>
        <listitem>
            <para>Keyboard support</para>
         </listitem>
        <!--listitem>Possibility to manage selection from 
            <itemizedlist>
                <listitem><para>Keyboard</para></listitem>
                <listitem><para>Server side</para></listitem>
            </itemizedlist>
        </listitem-->   
    </itemizedlist>
   </section>
   <section>
        <title>Details of Usage</title>

        <!--maintenance of component  orderingList-->

        <para>The <emphasis role="bold">
                <property>&lt;rich:orderingList&gt;</property>
            </emphasis> component consists of <itemizedlist>
                <listitem>
               <para>
                  <property>Item list</property> element that displays a list of items. It
                    has three different representations for a single element: common, selected,
                    active. Combination of these states is possible.</para>
            </listitem>
                <listitem>
               <para>
                    <property>Ordering controls set</property>
                </para>
            </listitem>
            </itemizedlist>
        </para>

        <!-- attributes of component  orderingList -->

        <para>The <emphasis>
                <property> "value"</property>
            </emphasis> and <emphasis>
                <property>"var" </property>
            </emphasis> attributes are used to access the values of a list. </para>

        <para>Controls rendering is based on the <emphasis>
            <property>"controlsType" </property>
        </emphasis> attribute. Possible types are button or none.
        </para>
        <note>
            <para>
                Currently the button controls type is based on <emphasis role="bold">
               <property>&lt;div&gt;</property>
            </emphasis> element.     
            </para>
        </note>
        <para>The information about the <emphasis>
            <property>"converter"</property>
         </emphasis> attribute is <link linkend="conv">here</link>.</para>
        <para> The <emphasis>
                <property>"selection" </property>
            </emphasis> attribute stores the collection of items selected by you. In the example
            below after submitting the form the current collection is placed in the object's
            property and then <emphasis role="bold">
                <property>&lt;rich:dataTable&gt;</property>
            </emphasis> with selected items is shown. </para>

        <para>
            <emphasis role="bold">Example:</emphasis>
        </para>
        <programlisting role="XML"><![CDATA[...
<h:form>
        <rich:orderingList value="#{bean.simpleItems}" var="item" selection="#{bean.selection}" controlsType="button">
                <rich:column>
                    <f:facet name="header">
                            <h:outputText value="Cars" />
                    </f:facet>
                    <h:outputText value="#{item}" />
                </rich:column>
        </rich:orderingList>
        <rich:dataTable id="infoPanelID" value="#{bean.info}" var="info" rendered="true">
                <rich:column>
                            <h:outputText value="#{info}" />
                </rich:column>
        </rich:dataTable>
        <a4j:commandButton value="reRender" reRender="infoPanelID" />
</h:form>
...]]></programlisting>
        <para> The <emphasis role="bold">
                <property>&lt;rich:orderingList&gt;</property>
            </emphasis> component allows to use <emphasis>
            <property>"caption"</property>
         </emphasis>
            <!--and <emphasis>
                <property>&quot;footer&quot; </property>
            </emphasis> -->
             facet.
            A caption could be also defined with  <emphasis>
                <property>"captionLabel"</property>
         </emphasis> attribute.           
        </para>

        <!-- ADD SCREENSHOT-->

        <para>Simple example is placed below.</para>
        <para>
            <emphasis role="bold">Example:</emphasis>
        </para>
        <programlisting role="XML"><![CDATA[...
<rich:orderingList value="#{bean.simpleItems}" var="item" controlsType="button" selection="#{bean.selection}">
        <f:facet name="caption">
                <h:outputText value="Caption Facet" />
        </f:facet>
        <rich:column>
                <f:facet name="header">
	            <h:outputText value="Cars" />
                </f:facet>
                <h:outputText value="#{item.name}" />
        </rich:column>
        <rich:column>
                <f:facet name="header">
	            <h:outputText value="Price" />
                </f:facet>
                <h:outputText value="#{item.price}" />
        </rich:column>
</rich:orderingList>
...]]></programlisting>

        <!-- ordering control set-->
        <para>The <emphasis role="bold">
                <property>&lt;rich:orderingList&gt;</property>
            </emphasis> component provides the possibility to use <property>ordering controls
            set</property>, which performs reordering. Every control has possibility to be disabled. </para>
        <para>An <property>ordering controls set</property> could be defined with <emphasis>
                <property>"topControlLabel"</property>
            </emphasis>, <emphasis>
                <property>"bottomControlLabel"</property>
            </emphasis>, <emphasis>
                <property>"upControlLabel"</property>
            </emphasis>, <emphasis>
                <property>"downControlLabel"</property>
            </emphasis>attributes. </para>
        <para>It is also possible to use <emphasis>
            <property>"topControl" </property>
         </emphasis>,
            <emphasis>
            <property>"topControlDisabled"</property>
         </emphasis>, <emphasis>
            <property>"bottomControl"</property>
         </emphasis>, 
            <emphasis>
            <property>"bottomControlDisabled" </property>
         </emphasis>, <emphasis>
            <property>"upControl" </property>
         </emphasis>,
            <emphasis>
            <property>"upControlDisabled" </property>
         </emphasis>, 
            <emphasis>
            <property>"downControl"</property>
         </emphasis>, <emphasis>
            <property>"downControlDisabled" </property>
         </emphasis> facets in order to replace the default controls with facets content. </para>
        <para>
            <emphasis role="bold">Example:</emphasis>
        </para>
        <programlisting role="XML"><![CDATA[...
<rich:orderingList value="#{bean.simpleItems}" var="item" controlsType="button" selection="#{bean.selection}">
        <f:facet name="topControl">
                <h:outputText value="Move to top" />
        </f:facet>
        <f:facet name="upControl">
                <h:outputText value="Move up" />
        </f:facet>
        <f:facet name="downControl">
                <h:outputText value="Move down" />
        </f:facet>
        <f:facet name="bottomControl">
                <h:outputText value="Move to bottom" />
        </f:facet>
<rich:orderingList>
...]]></programlisting>

        <para>The position of the controls relatively to a list could be customized with: <itemizedlist>
                <!--listitem>
                    <emphasis>
                        <property>&quot;controlsPosition&quot;</property>
                    </emphasis> attribute. Possible values: <itemizedlist>
                        <listitem><para>left - controls could be rendered to the left side of a list</para></listitem>
                        <listitem><para>right(default) - controls could be rendered to the right side of a
                            list </para></listitem>
                        <listitem><para>top - controls could be rendered above the list </para></listitem>
                        <listitem><para>bottom - controls could be rendered below the list </para></listitem>
                    </itemizedlist>
                </listitem-->
                <listitem>
               <para>
                  <emphasis>
                        <property> "controlsHorizontalAlign"</property>
                    </emphasis> attribute. Possible values: <itemizedlist>
                        <listitem>
                        <para>"left" - controls render to the left side of a list</para>
                     </listitem>
                        <listitem>
                        <para>"right" (default) - controls render to the right side of a list</para>
                     </listitem>
                        <listitem>
                        <para>"center" - controls is centered</para>
                     </listitem>
                    </itemizedlist>
                </para>
            </listitem>
                <listitem>
               <para>
                  <emphasis>
                        <property> "controlsVerticalAlign"</property>
                    </emphasis> attribute. Possible values: <itemizedlist>
                        <listitem>
                        <para>"top" - controls render aligned to the top side of a list </para>
                     </listitem>
                        <listitem>
                        <para>"bottom" - controls render aligned to the bottom side of a list </para>
                     </listitem>
                        <listitem>
                        <para>"center" (default) - controls is centered relatively to a list
                        </para>
                     </listitem>
                    </itemizedlist>
                </para>
            </listitem>
                <!--listitem><emphasis>
                        <property>&quot;controlsLayout&quot;</property>
                    </emphasis> attribute. Possible values: <itemizedlist>
                        <listitem><para>inline - controls defined one by one in line </para></listitem>
                        <listitem><para>block - controls defined in column </para></listitem>
                    </itemizedlist>
                </listitem-->
            </itemizedlist>
        </para>

        <para>The <emphasis role="bold">
                <property>&lt;rich:orderingList&gt;</property>
            </emphasis> component has a possibility to hide any of the controls by pairs using
            following attributes: <itemizedlist>
                <listitem>
               <para>
                    <emphasis>
                        <property>"orderControlsVisible"</property>
                    </emphasis> attribute has two values: "true" or "false". If false
                    <property>Up</property> and <property>Down</property> controls are not
                    displayed.</para>
            </listitem>
                <listitem>
               <para>
                    <emphasis>
                        <property>"fastOrderControlsVisible"</property>
                    </emphasis> attribute has two values: "true" or "false". If false
                    <property>Top</property> and <property>Bottom</property> controls are not
                    displayed.</para>
            </listitem>
            </itemizedlist>
        </para>
        <para>
            The <emphasis role="bold">
            <property>&lt;rich:orderingList&gt;</property>
         </emphasis> component allows to use internationalization method 
            to redefine and localize the labels. You could use application resource bundle and define 
            <code>RICH_SHUTTLES_TOP_LABEL</code>,
            <code>RICH_SHUTTLES_BOTTOM_LABEL</code>,
            <code>RICH_SHUTTLES_UP_LABEL</code>,
            <code>RICH_SHUTTLES_DOWN_LABEL</code> there.
        </para>
        <para>
            You could also pack <code>org.richfaces.renderkit.orderingList</code> resource bundle with your JARs defining the same properties.
        </para>
        <!-- Wiil be done for 3.2.0 version-->
        <!--para>The component provides possibility to be customized using templating. The
            customization could be performed by a layout definition nested into the component. 5
            elements are provided to be defined inside template: {list}, {topControl},
            {bottomControl}, {downCotrol}, {upControl}. <para>The example is placed below.</para>
        </para>
        <para>Example:</para>
        <programlisting role="XML"><![CDATA[<![CDATA[...
<rich:orderingList>
        <h:panelGrid columns="2" columnClasses="class1 class2">
            <h:outputText value="{list}"/>
                <h:panelGroup>
                    <h:outputText value="{topControl}"/>
                    <h:outputText value="{upControl}"/>
                    <h:outputText value="{downControl}"/>
                    <h:outputText value="{bottomControl}"/>
                </h:panelGroup>
        </h:panelGrid>
</rich:orderingList>
...]]>
        </programlisting-->

        <table>
            <title>Keyboard usage for elements selection</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Keys and combinations </entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <!--Sorting API -->
                    <row>
                        <entry>CTRL+click</entry>
                        <entry>Inverts selection for an item</entry>
                    </row>
                    <row>
                        <entry>SHIFT+click</entry>
                        <entry>Selects all rows from active one to a clicked row if they differ,
                            else select the active row. All other selections are cleared</entry>
                    </row>
                    <row>
                        <entry>CTRL+A</entry>
                        <entry>Selects all elements inside the list if some active element is
                            already present in a list</entry>
                    </row>
                    <row>
                        <entry>Up, Down arrows</entry>
                        <entry>Changes the active and selected elements to the next or previous in a list</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>


        <table>
            <title>Keyboard usage for elements reordering</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Keys and combinations </entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <!--Sorting API -->
                    <row>
                        <entry>Page Up</entry>
                        <entry>Moves selected set to the top of a list</entry>
                    </row>
                    <row>
                        <entry>Page Down</entry>
                        <entry>Moves selected set to the bottom of a list</entry>
                    </row>
                    <row>
                        <entry>CTRL+Up arrow</entry>
                        <entry>Moves selected item to one position upper</entry>
                    </row>
                    <row>
                        <entry>CTRL+Down arrow</entry>
                        <entry>Moves selected item to one position lower</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </section>
   <section>
      <title>Reference Data</title>
      <para>
         <ulink url="&tlddoc;rich/orderingList.html">Table of 
							&lt;rich:orderingList&gt; 
							 attributes</ulink>.
						</para>
      <table>
        <title>Component Identification Parameters</title>

        <tgroup cols="2">
            <thead>
                <row>
                    <entry>Name</entry>

                    <entry>Value</entry>
                </row>
            </thead>
            <tbody>
                <row>
                    <entry>component-type</entry>

                    <entry>org.richfaces.OrderingList</entry>
                </row>
                <row>
                    <entry>component-class</entry>

                    <entry>org.richfaces.component.html.HtmlOrderingList</entry>
                </row>
                <row>
                    <entry>component-family</entry>

                    <entry>org.richfaces.OrderingList</entry>
                </row>
                <row>
                    <entry>renderer-type</entry>

                    <entry>org.richfaces.OrderingListRenderer</entry>
                </row>
            </tbody>
        </tgroup>
      </table>
      <table>
            <title>JavaScript API</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Function</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <!--Sorting API -->
                    <!--
                    <row>
                        <entry>SortAscending()</entry>
                        <entry>Sorts items in the list ascending</entry>
                    </row>
                    <row>
                        <entry>SortDescending()</entry>
                        <entry>Sorts items in the list descending</entry>
                    </row>
                    <row>
                        <entry>Sort()</entry>
                        <entry>Inverts current sorting</entry>
                    </row>
                    -->

                    <!--Controls common API -->
                    <row>
                        <entry role="tbi">hide()</entry>
                        <entry role="tbi">Hides ordering control (to be implemented)</entry>
                    </row>
                    <row>
                        <entry role="tbi">show()</entry>
                        <entry role="tbi">Shows ordering control (to be implemented)</entry>
                    </row>
                    <row>
                        <entry role="tbi">isShown()</entry>
                        <entry role="tbi">Checks if current control is shown (to be implemented)</entry>
                    </row>
                    <row>
                        <entry role="tbi">enable()</entry>
                        <entry role="tbi">Enables ordering control (to be implemented)</entry>
                    </row>
                    <row>
                        <entry role="tbi">disable()</entry>
                        <entry role="tbi">Disables ordering control (to be implemented)</entry>
                    </row>
                    <row>
                        <entry role="tbi">isEnabled()</entry>
                        <entry role="tbi">Checks if current control is enabled (to be implemented)</entry>
                    </row>
                    <!--List managing API -->
                    <row>
                        <entry>Up()</entry>
                        <entry>Moves up selected item in the list</entry>
                    </row>
                    <row>
                        <entry>Down()</entry>
                        <entry>Moves down selected item in the list</entry>
                    </row>
                    <row>
                        <entry>Top()</entry>
                        <entry>Moves top selected item in the list</entry>
                    </row>
                    <row>
                        <entry>Bottom()</entry>
                        <entry>Moves bottom selected item in the list</entry>
                    </row>
                    <row>
                        <entry>getSelection()</entry>
                        <entry>Returns currently selected item</entry>
                    </row>
                    <row>
                        <entry>getItems()</entry>
                        <entry>Returns the collection of all items</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
      <table>
            <title>Facets</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Facet</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>caption</entry>
                        <entry>Redefines the caption content. Related attribute is "captionLabel"</entry>
                    </row>
                    <row>
                        <entry>topControl</entry>
                        <entry>Redefines the label for the "Top" control. Related attribute is "topControlLabel"</entry>
                    </row>
                    <row>
                        <entry>bottomControl</entry>
                        <entry>Redefines the label for the "Bottom" control. Related attribute is "bottomControlLabel"</entry>
                    </row>
                    <row>
                        <entry>upControl</entry>
                        <entry>Redefines the label for the "Up" control. Related attribute is "upControlLabel"</entry>
                    </row>
                    <row>
                        <entry>downControl</entry>
                        <entry>Redefines the label for the "Down" control. Related attribute is "downControlLabel"</entry>
                    </row>
                    <row>
                        <entry>topControlDisabled</entry>
                        <entry>Redefines the disabled label for the "Top" control</entry>
                    </row>
                    <row>
                        <entry>bottomControlDisabled</entry>
                        <entry>Redefines the disabled label for the "Bottom" control</entry>
                    </row>
                    <row>
                        <entry>upControlDisabled</entry>
                        <entry>Redefines the disabled label for the "Up" control</entry>
                    </row>
                    <row>
                        <entry>downControlDisabled</entry>
                        <entry>Redefines the disabled label for the "Down" control</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
      <table id="OrderLC">
            <title>Classes names that define a list representation</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Class name</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>rich-ordering-list-body</entry>
                        <entry>Defines styles for a wrapper table element of an orderingList</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-output</entry>
                        <entry>Defines styles for a wrapper &lt;div&gt; element of a
                        list</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-items</entry>
                        <entry>Defines styles for a wrapper table element of items in the
                        list</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-content</entry>
                        <entry>Defines styles for a list content</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-header</entry>
                        <entry>Defines styles for a wrapper &lt;div&gt; element for a list
                            header</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-table-header</entry>
                        <entry>Defines styles for a wrapper &lt;tr&gt; element for a list
                            header</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-table-header-cell</entry>
                        <entry>Defines styles for a header cell</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
      <table>
            <title>Classes names that define a caption representation</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Class name</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>rich-ordering-list-caption</entry>
                        <entry>Defines styles for a caption</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-caption-disabled</entry>
                        <entry>Defines styles for a caption in disabled state</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-caption-active</entry>
                        <entry>Defines styles for a caption in active state</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
      <table>
            <title>Classes names that define rows representation</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Class name</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>rich-ordering-list-row</entry>
                        <entry>Defines styles for a row</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-row-selected</entry>
                        <entry>Defines styles for a selected row</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-row-active</entry>
                        <entry>Defines styles for an active row</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-row-disabled</entry>
                        <entry>Defines styles for a disabled row</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
      <table>
            <title>Classes names that define cells representation</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Class name</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>rich-ordering-list-cell</entry>
                        <entry>Defines styles for a cell</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-cell-selected</entry>
                        <entry>Defines styles for a selected cell</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-cell-active</entry>
                        <entry>Defines styles for an active cell</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-cell-disabled</entry>
                        <entry>Defines styles for a disabled cell</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
      <table>
            <title>Classes names that define a button representation</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Class name</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>rich-ordering-list-button</entry>
                        <entry>Defines styles for a button</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-button-disabled</entry>
                        <entry>Defines styles for a disabled button</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-button-light</entry>
                        <entry>Defines styles for a button highlight</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-button-press</entry>
                        <entry>Defines styles for a pressed button</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-button-content</entry>
                        <entry>Defines styles for a button content</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-button-selection</entry>
                        <entry>Defines styles for a button selection</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-button-valign</entry>
                        <entry>Defines styles for a wrapper &lt;td&gt; element for buttons
                            vertical align</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-list-button-layout</entry>
                        <entry>Defines styles for a wrapper &lt;div&gt; element of buttons
                            layout</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
      <table>
            <title>Classes names that define controls representation</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Class name</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>rich-ordering-controls</entry>
                        <entry>Defines styles for a controls group</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-control-top</entry>
                        <entry>Defines styles for a "top" control</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-control-bottom</entry>
                        <entry>Defines styles for a "bottom" control</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-control-up</entry>
                        <entry>Defines styles for a "up" control</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-control-down</entry>
                        <entry>Defines styles for a "down" control</entry>
                    </row>
                    <row>
                        <entry>rich-ordering-control-disabled</entry>
                        <entry>Defines styles for controls in disabled state</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
							You can find all necessary information about style classes redefinition in 
						<link linkend="customstyles">Definition of Custom Style Classes</link> 
							section.
						</section>
   <section>
        <title>Relevant Resources Links</title>
        <para>
         <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/orderingList.jsf?c=orderingList">On RichFaces LiveDemo page </ulink> you can see an example of <emphasis role="bold">
                <property>&lt;rich:orderingList&gt;</property>
            </emphasis> usage and sources for the given example. </para>
    </section>
</section>