DITA-OT_CXX_Plugin/cxxapiref/doc/cxxDefine/cxxDefine.dita
changeset 4 468f4c8d3d5b
equal deleted inserted replaced
3:d8fccb2cd802 4:468f4c8d3d5b
       
     1 <?xml version="1.0" encoding="UTF-8"?>
       
     2 <!--
       
     3 Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
       
     4 All rights reserved.		
       
     5 		-->
       
     6 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
       
     7 <reference xml:lang="en-us" outputclass="element" id="cxxDefine">
       
     8     <title>cxxDefine</title>
       
     9     <shortdesc>The &lt;cxxDefine&gt; element provides the name of the C++ API
       
    10     define, all the elements necessary to describe the members that are introduced
       
    11     by the define declaration.</shortdesc>
       
    12     <refbody>
       
    13         <section>
       
    14             <title>Description</title>
       
    15             <p>The &lt;cxxDefine&gt; element requires
       
    16         an id attribute as an anchor point; this id must always be specified. The
       
    17         id attribute is referenced by the <i>conref</i> attribute and internal applications
       
    18         that refer to the  &lt;cxxDefine&gt; element content. The elements &lt;apiName&gt; 
       
    19         and &lt;cxxDefineDetail&gt; are required for this top-level container. </p>
       
    20         </section>
       
    21         <example>
       
    22             <title>Example</title>
       
    23             <codeblock>&lt;cxxFile id="cfperfmetrics_8cpp"&gt;
       
    24 	&lt;apiName&gt;cfperfmetrics.cpp&lt;/apiName&gt;
       
    25 	&lt;cxxDefine id="cfperfmetrics_8cpp_1aaf45a4d8cdebb244b0f01672cd981fb2"&gt;
       
    26 		&lt;apiName&gt;SYMBIAN_ENABLE_NETWORKING_PERFMETRICS&lt;/apiName&gt;
       
    27 		&lt;cxxDefineDetail&gt;
       
    28 			&lt;cxxDefineDefinition&gt;
       
    29 				&lt;cxxDefineAccessSpecifier value="public"/&gt;
       
    30 				&lt;cxxDefinePrototype&gt;#define SYMBIAN_ENABLE_NETWORKING_PERFMETRICS&lt;/cxxDefinePrototype&gt;
       
    31 				&lt;cxxDefineNameLookup&gt;SYMBIAN_ENABLE_NETWORKING_PERFMETRICS&lt;/cxxDefineNameLookup&gt;
       
    32 				&lt;cxxDefineParameters/&gt;
       
    33 				&lt;cxxDefineAPIItemLocation&gt;
       
    34 					&lt;cxxDefineDeclarationFile name="filePath" value="C:/EPOC/master/sf/os/commsfw/commsfwsupport/commselements/commsfw/src/cfperfmetrics.cpp"/&gt;
       
    35 					&lt;cxxDefineDeclarationFileLine name="lineNumber" value="17"/&gt;
       
    36 				&lt;/cxxDefineAPIItemLocation&gt;
       
    37 			&lt;/cxxDefineDefinition&gt;
       
    38 			&lt;apiDesc/&gt;
       
    39 		&lt;/cxxDefineDetail&gt;
       
    40 	&lt;/cxxDefine&gt;
       
    41 	&lt;cxxVariable id="cfperfmetrics_8cpp_1a8b57c8f405cbc5de5ad9caf2e1610d0f"&gt;
       
    42 		...
       
    43 	&lt;/cxxVariable&gt;
       
    44 	&lt;cxxEnumeration id="cfperfmetrics_8cpp_1a3a00212a28f7e4e2af6d5d57db53f4d3"&gt;
       
    45 		...
       
    46 	&lt;/cxxEnumeration&gt;
       
    47 	&lt;cxxFileAPIItemLocation&gt;
       
    48 		&lt;cxxFileDeclarationFile name="filePath" value="C:/EPOC/master/sf/os/commsfw/commsfwsupport/commselements/commsfw/src/cfperfmetrics.cpp"/&gt;
       
    49 	&lt;/cxxFileAPIItemLocation&gt;
       
    50 &lt;/cxxFile&gt;</codeblock>
       
    51         </example>
       
    52         <section conref="../packagedef.dita#cxxDefine-reference/cxxDefine-containedBy-section"/>
       
    53         <section conref="../packagedef.dita#cxxDefine-reference/cxxDefine-contains-section"/>
       
    54         <section conref="../packagedef.dita#cxxDefine-reference/cxxDefine-contentModel-section"/>
       
    55         <section conref="../packagedef.dita#cxxDefine-reference/cxxDefine-attList-section"/>
       
    56         <section conref="../packagedef.dita#cxxDefine-reference/cxxDefine-classValue-section"/>
       
    57     </refbody>
       
    58 </reference>