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 "tester.h"
22
23 /**
24 * bug_380824:
25 * @arg: arg
26 *
27 * Returns a value.
28 * http://bugzilla.gnome.org/show_bug.cgi?id=380824
29 *
30 * Since: 0.1
31 *
32 * Returns: result
33 */
bug_380824(int arg)34 int bug_380824 (int arg) {
35 return 0;
36 }
37
38
39 /**
40 * bug_419997:
41 * @const_values: arg
42 *
43 * http://bugzilla.gnome.org/show_bug.cgi?id=419997
44 */
bug_419997(int const_values)45 void bug_419997 (int const_values) {
46 }
47
48
49 /**
50 * bug_445693:
51 * @pid: arg
52 *
53 * http://bugzilla.gnome.org/show_bug.cgi?id=445693
54 */
bug_445693(unsigned long pid)55 void bug_445693 (unsigned long pid) {
56 }
57
58
59 /**
60 * bug_471014:
61 *
62 * http://bugzilla.gnome.org/show_bug.cgi?id=471014
63 *
64 * Returns: result
65 */
bug_471014(void)66 G_CONST_RETURN gchar* G_CONST_RETURN * bug_471014 (void) {
67 return NULL;
68 }
69
70 /**
71 * bug_574654a:
72 *
73 * http://bugzilla.gnome.org/show_bug.cgi?id=574654
74 *
75 * Returns: result
76 */
77 /**
78 * bug_574654b:
79 * @offset: skip this many items
80 *
81 * http://bugzilla.gnome.org/show_bug.cgi?id=574654
82 */
bug_574654a(void)83 int bug_574654a(void) {
84 return 0;
85 }
86
bug_574654b(double offset)87 void bug_574654b(double offset) { }
88
89
90 /**
91 * bug_580300a_get_type:
92 *
93 * http://bugzilla.gnome.org/show_bug.cgi?id=580300
94 */
bug_580300a_get_type(void)95 void bug_580300a_get_type(void) { }
96
97 /**
98 * bug_580300b_get_type:
99 * @a: value
100 *
101 * http://bugzilla.gnome.org/show_bug.cgi?id=580300
102 */
bug_580300b_get_type(gint a)103 void bug_580300b_get_type(gint a) { }
104
105 /**
106 * bug_580300c_get_type:
107 *
108 * http://bugzilla.gnome.org/show_bug.cgi?id=580300
109 */
bug_580300c_get_type()110 void bug_580300c_get_type() { }
111
112 /**
113 * bug_580300d_get_type:
114 *
115 * http://bugzilla.gnome.org/show_bug.cgi?id=580300
116 *
117 * Returns: result
118 */
bug_580300d_get_type()119 int bug_580300d_get_type() { return 0; }
120
121 /**
122 * bug_597937:
123 * @function_arg: value
124 *
125 * http://bugzilla.gnome.org/show_bug.cgi?id=597937
126 */
bug_597937(void (* function_arg)(int arg1,char arg2,void *))127 void bug_597937(void (*function_arg)(int arg1, char arg2, void *)) { }
128
129 /**
130 * bug_602518a:
131 *
132 * http://bugzilla.gnome.org/show_bug.cgi?id=602518
133 *
134 * Returns: result
135 */
bug_602518a(void)136 long int bug_602518a(void) {
137 return (long int)0;
138 }
139
140 /**
141 * bug_602518b:
142 *
143 * http://bugzilla.gnome.org/show_bug.cgi?id=602518
144 *
145 * Returns: result
146 */
bug_602518b(void)147 unsigned long int bug_602518b(void) {
148 return (unsigned long int)0;
149 }
150
151 /**
152 * bug_602518c:
153 *
154 * http://bugzilla.gnome.org/show_bug.cgi?id=602518
155 *
156 * Returns: result
157 */
bug_602518c(void)158 unsigned int bug_602518c(void) {
159 return (unsigned int)0;
160 }
161
162 /**
163 * bug_607445:
164 * @a: parameter
165 * @n: parameter
166 *
167 * http://bugzilla.gnome.org/show_bug.cgi?id=607445
168 */
bug_607445(long double ** a,int n)169 long double bug_607445(long double **a, int n) {
170 return 2.0*n;
171 }
172
173 /**
174 * bug_610257:
175 * @der: parameter
176 * @len: parameter
177 *
178 * http://bugzilla.gnome.org/show_bug.cgi?id=610257
179 */
180 signed long
bug_610257(const unsigned char * der,int * len)181 bug_610257(const unsigned char *der, int *len)
182 {
183 return 1L;
184 }
185
186
187 /**
188 * bug_623968a:
189 *
190 * <para>test</para>
191 * <refsect3>
192 * <title>subsect</title>
193 * <para>test</para>
194 * </refsect3>
195 **/
196 void
bug_623968a(void)197 bug_623968a(void)
198 {
199 }
200
201 /**
202 * bug_623968b:
203 *
204 * test
205 *
206 * <refsect3>
207 * <title>subsect</title>
208 * <para>test</para>
209 * </refsect3>
210 **/
211 void
bug_623968b(void)212 bug_623968b(void)
213 {
214 }
215
216 /**
217 * bug_623968c:
218 *
219 * <para>test</para>
220 **/
221 void
bug_623968c(void)222 bug_623968c(void)
223 {
224 }
225
226
227 /**
228 * bug_624200a:
229 *
230 * http://bugzilla.gnome.org/show_bug.cgi?id=624200
231 *
232 * Returns: result
233 */
234 const char * const *
bug_624200a(void)235 bug_624200a(void)
236 {
237 return NULL;
238 }
239
240 /**
241 * bug_624200b:
242 *
243 * http://bugzilla.gnome.org/show_bug.cgi?id=624200
244 *
245 * Returns: result
246 */
247 const char ** const
bug_624200b(void)248 bug_624200b(void)
249 {
250 return NULL;
251 }
252
253 /**
254 * bug_638330:
255 * @arg1: arg1
256 * @data: data
257 * @length: length
258 *
259 * http://bugzilla.gnome.org/show_bug.cgi?id=638330
260 */
261 void (*bug_638330) (void *arg1,
262 const unsigned char *data,
263 unsigned int length) = NULL;
264
265
266 /* internal function */
267 gchar *
_bug_000000a(const gchar * name)268 _bug_000000a (const gchar *name)
269 {
270 return NULL;
271 }
272
273 /* varargs */
274
275 /**
276 * bug_000000_va1:
277 * @name: a name
278 * @...: A printf-style message to output
279 *
280 * Outputs a message.
281 */
bug_000000_va1(gchar name,...)282 void bug_000000_va1 (gchar name, ...)
283 {
284 }
285
286
287 /**
288 * bug_624001a:
289 *
290 * http://bugzilla.gnome.org/show_bug.cgi?id=624001
291 *
292 * Deprecated: Use main() instead.
293 */
bug_624001a(void)294 void bug_624001a(void)
295 {
296 }
297
298 /**
299 * bug_624001b:
300 *
301 * http://bugzilla.gnome.org/show_bug.cgi?id=624001
302 *
303 * Deprecated: Use main() instead.
304 */
bug_624001b(void)305 void bug_624001b(void)
306 {
307 }
308
309 /**
310 * bug_624001c:
311 *
312 * http://bugzilla.gnome.org/show_bug.cgi?id=624001
313 *
314 * Deprecated: Use main() instead.
315 */
bug_624001c(void)316 void bug_624001c(void)
317 {
318 }
319
320 /**
321 * bug_624001d:
322 *
323 * http://bugzilla.gnome.org/show_bug.cgi?id=624001
324 *
325 * Deprecated: Use main() instead.
326 */
bug_624001d(void)327 void bug_624001d(void)
328 {
329 }
330
331 /**
332 * bug_624001e:
333 *
334 * http://bugzilla.gnome.org/show_bug.cgi?id=624001
335 *
336 * Deprecated: Use main() instead.
337 */
bug_624001e(void)338 void bug_624001e(void)
339 {
340 }
341
342 /**
343 * bug_711598:
344 *
345 * http://bugzilla.gnome.org/show_bug.cgi?id=711598
346 */
bug_711598(void)347 void bug_711598(void)
348 {
349 }
350
351 /**
352 * deprecation_notice:
353 *
354 * Foo.
355 *
356 * Deprecated: 3.10: Use named icon "bar" instead.
357 */
deprecation_notice(void)358 void deprecation_notice(void)
359 {
360 }
361
362 /**
363 * bug_741941:
364 * @object: the object
365 * @par: parameter
366 *
367 * http://bugzilla.gnome.org/show_bug.cgi?id=741941
368 */
bug_741941(void * object,void * par)369 void bug_741941(void *object, void *par)
370 {
371 }
372
373 /**
374 * bug_732689:
375 * @spec: the string specifying the color.
376 *
377 * Parses a textual specification of a color and fill in the
378 * <structfield>red</structfield>, <structfield>green</structfield>,
379 * and <structfield>blue</structfield> fields of a color.
380 **/
381 void
bug_732689(const gchar * spec)382 bug_732689 (const gchar *spec)
383 {
384 }
385
386 /**
387 * bug_749142:
388 *
389 * The message's structure contains one field:
390 * <itemizedlist>
391 * <listitem><para>int timeout: the timeout.</para></listitem>
392 * </itemizedlist>
393 *
394 * <refsect3>
395 * <title>Example usage</title>
396 * |[
397 * echo "Hello" | foo
398 * ]|
399 * </refsect3>
400 **/
401 void
bug_749142(void)402 bug_749142 (void)
403 {
404 }
405
406 /**
407 * bug_783420:
408 * @in: input
409 * @out: output
410 *
411 * http://bugzilla.gnome.org/show_bug.cgi?id=783420
412 *
413 * |[
414 * #include <tester.h>
415 *
416 * int res;
417 * bug_783420(42, &res);
418 * ]|
419 *
420 * <refsect2 id="subsect">
421 * <title>Subsection</title>
422 * <para>
423 * Lorem ipsum ...
424 * |[
425 * #include <tester.h>
426 *
427 * int res;
428 * bug_783420(42, &res);
429 * ]|
430 * </para>
431 * </refsect2>
432 */
433 void
bug_783420(int in,int * out)434 bug_783420 (int in, int *out)
435 {
436 }
437