tests/scanner/annotationparser/gtkdoc/fail/tester.h.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2
   3 <tests>
   4
   5 <test>
   6 <commentblock>/**
   7  * MACRO_NO_ITEM_DOCS:
   8  *
   9  * Here we document the macro but not the parameters.
  10  */</commentblock>
  11   <docblock>
  12     <identifier>
  13       <name>MACRO_NO_ITEM_DOCS</name>
  14     </identifier>
  15     <description>Here we document the macro but not the parameters.</description>
  16   </docblock>
  17 </test>
  18
  19 <test>
  20 <commentblock>/**
  21  * MACRO_INCOMPLETE_DOCS:
  22  * @a: a value
  23  *
  24  * Here we document the macro but not all the parameters.
  25  */</commentblock>
  26   <docblock>
  27     <identifier>
  28       <name>MACRO_INCOMPLETE_DOCS</name>
  29     </identifier>
  30     <parameters>
  31       <parameter>
  32         <name>a</name>
  33         <description>a value</description>
  34       </parameter>
  35     </parameters>
  36     <description>Here we document the macro but not all the parameters.</description>
  37   </docblock>
  38 </test>
  39
  40 <test>
  41 <commentblock>/**
  42  * MACRO_UNUSED_DOCS:
  43  * @a: a value
  44  * @b: a value
  45  * @c: an unexisting value
  46  *
  47  * Here we document the macro and more than the actual parameters.
  48  */</commentblock>
  49   <docblock>
  50     <identifier>
  51       <name>MACRO_UNUSED_DOCS</name>
  52     </identifier>
  53     <parameters>
  54       <parameter>
  55         <name>a</name>
  56         <description>a value</description>
  57       </parameter>
  58       <parameter>
  59         <name>b</name>
  60         <description>a value</description>
  61       </parameter>
  62       <parameter>
  63         <name>c</name>
  64         <description>an unexisting value</description>
  65       </parameter>
  66     </parameters>
  67     <description>Here we document the macro and more than the actual parameters.</description>
  68   </docblock>
  69 </test>
  70
  71 <test>
  72 <commentblock>/**
  73  * EnumNoItemDocs:
  74  *
  75  * Here we document the enum but not the values.
  76  * http://bugzilla.gnome.org/show_bug.cgi?id=568711
  77  */</commentblock>
  78   <docblock>
  79     <identifier>
  80       <name>EnumNoItemDocs</name>
  81     </identifier>
  82     <description>Here we document the enum but not the values.
  83 http://bugzilla.gnome.org/show_bug.cgi?id=568711</description>
  84   </docblock>
  85 </test>
  86
  87 <test>
  88 <commentblock>/**
  89  * EnumIncompleteDocs:
  90  * @ENUM_INCOMPLETE_DOCS_1: a value
  91  *
  92  * Here we document the enum but not all the values.
  93  */</commentblock>
  94   <docblock>
  95     <identifier>
  96       <name>EnumIncompleteDocs</name>
  97     </identifier>
  98     <parameters>
  99       <parameter>
 100         <name>ENUM_INCOMPLETE_DOCS_1</name>
 101         <description>a value</description>
 102       </parameter>
 103     </parameters>
 104     <description>Here we document the enum but not all the values.</description>
 105   </docblock>
 106 </test>
 107
 108 <test>
 109 <commentblock>/**
 110  * EnumUnusedDocs:
 111  * @ENUM_UNUSED_DOCS_1: a value
 112  * @ENUM_UNUSED_DOCS_2: a value
 113  * @ENUM_UNUSED_DOCS_3: an unexisting value
 114  *
 115  * Here we document the enum and more than the actual values.
 116  */</commentblock>
 117   <docblock>
 118     <identifier>
 119       <name>EnumUnusedDocs</name>
 120     </identifier>
 121     <parameters>
 122       <parameter>
 123         <name>ENUM_UNUSED_DOCS_1</name>
 124         <description>a value</description>
 125       </parameter>
 126       <parameter>
 127         <name>ENUM_UNUSED_DOCS_2</name>
 128         <description>a value</description>
 129       </parameter>
 130       <parameter>
 131         <name>ENUM_UNUSED_DOCS_3</name>
 132         <description>an unexisting value</description>
 133       </parameter>
 134     </parameters>
 135     <description>Here we document the enum and more than the actual values.</description>
 136   </docblock>
 137 </test>
 138
 139 <test>
 140 <commentblock>/**
 141  * StructNoItemDocs:
 142  *
 143  * Here we document the struct but not the values.
 144  */</commentblock>
 145   <docblock>
 146     <identifier>
 147       <name>StructNoItemDocs</name>
 148     </identifier>
 149     <description>Here we document the struct but not the values.</description>
 150   </docblock>
 151 </test>
 152
 153 <test>
 154 <commentblock>/**
 155  * StructIncompleteDocs:
 156  * @a: a value
 157  *
 158  * Here we document the struct but not all the values.
 159  */</commentblock>
 160   <docblock>
 161     <identifier>
 162       <name>StructIncompleteDocs</name>
 163     </identifier>
 164     <parameters>
 165       <parameter>
 166         <name>a</name>
 167         <description>a value</description>
 168       </parameter>
 169     </parameters>
 170     <description>Here we document the struct but not all the values.</description>
 171   </docblock>
 172 </test>
 173
 174 <test>
 175 <commentblock>/**
 176  * StructUnusedDocs:
 177  * @a: a value
 178  * @b: a value
 179  * @c: an unexisting value
 180  *
 181  * Here we document the struct and more than the actual values.
 182  */</commentblock>
 183   <docblock>
 184     <identifier>
 185       <name>StructUnusedDocs</name>
 186     </identifier>
 187     <parameters>
 188       <parameter>
 189         <name>a</name>
 190         <description>a value</description>
 191       </parameter>
 192       <parameter>
 193         <name>b</name>
 194         <description>a value</description>
 195       </parameter>
 196       <parameter>
 197         <name>c</name>
 198         <description>an unexisting value</description>
 199       </parameter>
 200     </parameters>
 201     <description>Here we document the struct and more than the actual values.</description>
 202   </docblock>
 203 </test>
 204
 205 </tests>