<?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="cxxAPIMap">

    <title>cxxAPIMap</title>

    <shortdesc>The &lt;cxxAPIMap&gt; element provides the name of the C++ API Reference

and all the elements necessary to describe the package, or set of packages,

and its components.</shortdesc>

    <refbody>

        <section>

            <title>Description</title>

            <p>The containing element for a map is the &lt;cxxAPIMap&gt; element. 

            &lt;cxxAPIMap&gt; requires title and id attributes. </p> 

            <p>&lt;cxxAPIMap&gt; can also contain any number of the elements &lt;cxxFileRef&gt;, 

            <cxxClassRef>, <cxxStructRef> and <cxxUnionRef> to add references 

            to topics.</p>

        </section>

        <example>

            <title>Example</title>

            <codeblock>&lt;cxxAPIMap id=&quot;GUID-A1E43BB6-B43A-38A0-870F-29A553C534EC&quot; title=&quot;AMap&quot;&gt;

            <cxxStructRef href="GUID-4D736120-454B-3952-ADFA-FEC7BDDE18F2.xml" navtitle="AClass::AStruct" />

            <cxxClassRef href="GUID-1F65F1EB-791C-32A4-A05E-3262BA816EF6.xml" navtitle="AClass" />

            <cxxFileRef href="GUID-15161A9C-9AC4-3B34-AADE-5294E5C7CCC2.xml" navtitle="AFile.h" />    

            <cxxEnumRef href="GUID-4C504F67-7737-33A7-AA99-6F030423E4CB.xml" navtitle="AClass::anEnum" />

            <cxxFunctionRef href="GUID-1390F0BC-18FA-3E68-A5F7-25347A52A08C.xml" navtitle="AClass::aFunction(aParam,anotherParam)" />

            <cxxTypedefRef href="GUID-CB589BED-4E77-3CD9-83A8-516A4B47C223.xml" navtitle="AClass::aTypeDef" />

            <cxxUnionRef href="GUID-A6375D7C-47D4-38BB-946C-BF042C16F4BD.xml" navtitle="AClass::uAUnion" />

            <cxxDefineRef href="GUID-1EA4FECD-61BB-3D49-99B5-B4003993D383.xml" navtitle="AClass::aDefine" />    

            <cxxVariableRef href="GUID-57906A69-F9F1-39FC-8A3E-6EC67BFBCFBA.xml" navtitle="AClass::aVariable" />

        &lt;/cxxAPIMap&gt;</codeblock>

        </example>        

        <section conref="../packagedef.dita#cxxAPIMap-reference/cxxAPIMap-containedBy-section"/>

        <section conref="../packagedef.dita#cxxAPIMap-reference/cxxAPIMap-contains-section"/>

        <section conref="../packagedef.dita#cxxAPIMap-reference/cxxAPIMap-contentModel-section"/>

        <section conref="../packagedef.dita#cxxAPIMap-reference/cxxAPIMap-attList-section"/>

        <section conref="../packagedef.dita#cxxAPIMap-reference/cxxAPIMap-classValue-section"/>

    </refbody>

</reference>