tests/bugs/src/tester.c

   1 /**
   2  * SECTION:tester
   3  * @short_description: module for gtk-doc unit test
   4  *
   5  * This file contains non-sense code for the sole purpose of testing the docs.
   6  *
   7  * As described in http://bugzilla.gnome.org/show_bug.cgi?id=457077 it
   8  * returns nothing.
   9  *
  10  * Some special characters need escaping. The tests should pass 100\%.
  11  * Try a <ulink url="http://www.gtk.org/gtk-doc/#Top">link containing a # char</ulink>.
  12  *
  13  * <refsect2 id="dummy-id">
  14  * <title>more details</title>
  15  * <para>
  16  * Second paragraph inside subsection.
  17  * </para>
  18  * </refsect2>
  19  */
  20
  21 #include <glib.h>
  22
  23 #include "tester.h"
  24
  25 /**
  26  * bug_141869_a:
  27  * @pid: arg
  28  *
  29  * http://bugzilla.gnome.org/show_bug.cgi?id=141869
  30  */
  31 void bug_141869_a (unsigned pid) {
  32   /* just silence a compiler warning */
  33   bug_481811((double)pid);
  34 }
  35
  36 /**
  37  * bug_141869_b:
  38  * @pid: arg
  39  *
  40  * http://bugzilla.gnome.org/show_bug.cgi?id=141869
  41  */
  42 void bug_141869_b (signed pid) {
  43 }
  44
  45
  46 /**
  47  * bug_379466:
  48  * @pid: arg
  49  *
  50  * http://bugzilla.gnome.org/show_bug.cgi?id=379466
  51  */
  52 void bug_379466 (int
  53   pid) {
  54 }
  55
  56
  57 /**
  58  * bug_380824:
  59  * @arg: arg
  60  *
  61  * Returns a value.
  62  * http://bugzilla.gnome.org/show_bug.cgi?id=380824
  63  *
  64  * Since: 0.1
  65  *
  66  * Returns: result
  67  */
  68 int bug_380824 (int arg) {
  69   return 0;
  70 }
  71
  72
  73 /**
  74  * bug_411739:
  75  *
  76  * http://bugzilla.gnome.org/show_bug.cgi?id=411739
  77  *
  78  * Returns: result
  79  */
  80 struct bug *
  81 bug_411739 (void) {
  82   return NULL;
  83 }
  84
  85
  86 /**
  87  * bug_419997:
  88  * @const_values: arg
  89  *
  90  * http://bugzilla.gnome.org/show_bug.cgi?id=419997
  91  */
  92 void bug_419997 (int const_values) {
  93 }
  94
  95
  96 /**
  97  * bug_445693:
  98  * @pid: arg
  99  *
 100  * http://bugzilla.gnome.org/show_bug.cgi?id=445693
 101  */
 102 void bug_445693 (unsigned long pid) {
 103 }
 104
 105
 106 /**
 107  * bug_471014:
 108  *
 109  * http://bugzilla.gnome.org/show_bug.cgi?id=471014
 110  *
 111  * Returns: result
 112  */
 113 G_CONST_RETURN gchar* G_CONST_RETURN * bug_471014 (void) {
 114   return NULL;
 115 }
 116
 117
 118 /**
 119  * Bug446648:
 120  * @BUG_446648_FOO: foo
 121  *
 122  * http://bugzilla.gnome.org/show_bug.cgi?id=446648
 123  **/
 124
 125
 126 /**
 127  * bug_552602:
 128  *
 129  * http://bugzilla.gnome.org/show_bug.cgi?id=552602
 130  *
 131  * Returns: result
 132  */
 133 const char* const * bug_552602 (void) {
 134   return NULL;
 135 }
 136
 137 /**
 138  * bug_574654a:
 139  *
 140  * http://bugzilla.gnome.org/show_bug.cgi?id=574654
 141  *
 142  * Returns: result
 143  */
 144 /**
 145  * bug_574654b:
 146  * @offset: skip this many items
 147  *
 148  * http://bugzilla.gnome.org/show_bug.cgi?id=574654
 149  */
 150 int bug_574654a(void) {
 151   return 0;
 152 }
 153
 154 void bug_574654b(double offset) { }
 155
 156
 157 /**
 158  * bug_580300a_get_type:
 159  *
 160  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
 161  */
 162 void bug_580300a_get_type(void) { }
 163
 164 /**
 165  * bug_580300b_get_type:
 166  * @a: value
 167  *
 168  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
 169  */
 170 void bug_580300b_get_type(gint a) { }
 171
 172 /**
 173  * bug_580300c_get_type:
 174  *
 175  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
 176  */
 177 void bug_580300c_get_type() { }
 178
 179 /**
 180  * bug_580300d_get_type:
 181  *
 182  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
 183  *
 184  * Returns: result
 185  */
 186 int bug_580300d_get_type() { return 0; }
 187
 188 /**
 189  * bug_597937:
 190  * @function_arg: value
 191  *
 192  * http://bugzilla.gnome.org/show_bug.cgi?id=597937
 193  */
 194 void bug_597937(void (*function_arg)(int arg1, char arg2, void *)) { }
 195
 196 /**
 197  * bug_602518a:
 198  *
 199  * http://bugzilla.gnome.org/show_bug.cgi?id=602518
 200  *
 201  * Returns: result
 202  */
 203 long int bug_602518a(void) {
 204   return (long int)0;
 205 }
 206
 207 /**
 208  * bug_602518b:
 209  *
 210  * http://bugzilla.gnome.org/show_bug.cgi?id=602518
 211  *
 212  * Returns: result
 213  */
 214 unsigned long int bug_602518b(void) {
 215   return (unsigned long int)0;
 216 }
 217
 218 /**
 219  * bug_602518c:
 220  *
 221  * http://bugzilla.gnome.org/show_bug.cgi?id=602518
 222  *
 223  * Returns: result
 224  */
 225 unsigned int bug_602518c(void) {
 226   return (unsigned int)0;
 227 }
 228
 229 /**
 230  * bug_607445:
 231  * @a: parameter
 232  * @n: parameter
 233  *
 234  * http://bugzilla.gnome.org/show_bug.cgi?id=607445
 235  */
 236 long double bug_607445(long double **a, int n) {
 237   return 2.0*n;
 238 }
 239
 240 /**
 241  * bug_610257:
 242  * @der: parameter
 243  * @len: parameter
 244  *
 245  * http://bugzilla.gnome.org/show_bug.cgi?id=610257
 246  */
 247 signed long
 248 bug_610257(const unsigned char *der, int *len)
 249 {
 250   return 1L;
 251 }
 252
 253
 254 /**
 255  * bug_623968a:
 256  *
 257  * <para>test</para>
 258  * <refsect3>
 259  *   <title>subsect</title>
 260  *   <para>test</para>
 261  * </refsect3>
 262  **/
 263 void
 264 bug_623968a(void)
 265 {
 266 }
 267
 268 /**
 269  * bug_623968b:
 270  *
 271  * test
 272  *
 273  * <refsect3>
 274  *   <title>subsect</title>
 275  *   <para>test</para>
 276  * </refsect3>
 277  **/
 278 void
 279 bug_623968b(void)
 280 {
 281 }
 282
 283 /**
 284  * bug_623968c:
 285  *
 286  * <para>test</para>
 287  **/
 288 void
 289 bug_623968c(void)
 290 {
 291 }
 292
 293
 294 /**
 295  * bug_624200a:
 296  *
 297  * http://bugzilla.gnome.org/show_bug.cgi?id=624200
 298  *
 299  * Returns: result
 300  */
 301 const char * const *
 302 bug_624200a(void)
 303 {
 304   return NULL;
 305 }
 306
 307 /**
 308  * bug_624200b:
 309  *
 310  * http://bugzilla.gnome.org/show_bug.cgi?id=624200
 311  *
 312  * Returns: result
 313  */
 314 const char ** const
 315 bug_624200b(void)
 316 {
 317   return NULL;
 318 }
 319
 320 /**
 321  * bug_638330:
 322  * @arg1: arg1
 323  * @data: data
 324  * @length: length
 325  *
 326  * http://bugzilla.gnome.org/show_bug.cgi?id=638330
 327  */
 328 void (*bug_638330) (void *arg1,
 329      const unsigned char *data,
 330      unsigned int length) = NULL;
 331
 332
 333 /* internal function */
 334 gchar *
 335 _bug_000000a (const gchar *name)
 336 {
 337   return NULL;
 338 }
 339