DITA-OT_CXX_Plugin/cxxapiref/doc/cxxDefine/cxxDefineNameLookup.dita
author Jonathan Harrington <jonathan.harrington@nokia.com>
Wed, 11 Aug 2010 14:49:30 +0100
changeset 4 468f4c8d3d5b
permissions -rw-r--r--
Orb version 0.2.0

<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved.		
		-->
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference xml:lang="en-us" outputclass="element" id="cxxDefineNameLookup">
    <title>cxxDefineNameLookup</title>
    <shortdesc>Provides a unique identifier of the define.</shortdesc>
    <refbody>
        <section>
            <title>Description</title>
            <p>This element provides a way of  uniquely identifying a define in a body of DITA XML that 
            describes a body of C++ source code.</p><p>Implementations are free to write what they want in 
            this elements PCDATA but a "good" implementation would place some premium on the following:<ul>
                    <li>The text would be unique within a set of DITA XML files.</li>
                    <li>The text would be human readable.</li>
                    <li>The text would generally follow the lookup techniques use in the C++ standard (ISO/IEC 14882:2003(E)).</li>
                    <li>Any encoding used would be reversible.</li>
                </ul>
            </p>
        </section>
        <example>
            <title>Example</title>
            <codeblock>&lt;cxxDefineNameLookup&gt;ENABLE_NETWORKING_PERFMETRICS&lt;/cxxDefineNameLookup&gt;</codeblock>
        </example>
        <section conref="../packagedef.dita#cxxDefineNameLookup-reference/cxxDefineNameLookup-containedBy-section"/>
        <section conref="../packagedef.dita#cxxDefineNameLookup-reference/cxxDefineNameLookup-contains-section"/>
        <section conref="../packagedef.dita#cxxDefineNameLookup-reference/cxxDefineNameLookup-contentModel-section"/>
        <section conref="../packagedef.dita#cxxDefineNameLookup-reference/cxxDefineNameLookup-attList-section"/>
        <section conref="../packagedef.dita#cxxDefineNameLookup-reference/cxxDefineNameLookup-classValue-section"/>
    </refbody>
</reference>