296- <b>first</b> to prepend the symbol (\em search contains a single word,
297 no attribute) declaration before the rest.
298 Example:
299 \code
300 <first search='GtkWidget' />
301 <first search='GtkWidgetClass' />
302 \endcode
303
304The text in the attribute \em search needs to be specified
305case-sensitive. It may contain more then one word in case of a \em
306type rule, but just one word for \em name and \em first rules.
307\em replace and \em add attributes are used as-is in the output. See
308<em>*.GirToBac</em> files in folder \em Gir for further examples.
309
310GirToBac reports duplicated tags while reading the control file. The
311first tag gets used in that case and all further get skipped. After
312translating the <em>*.gir</em> file, GirToBac reports about
313nonexistent symbols (defined in a \em search attribute but not
314existing in the <em>*.gir</em> file). Removing the corresponding
315tags from the control file speads up the translation process.
316
317The control files should be shipped together with the translated
318header files. On one hand side this helps the users to learn about
319the differences between C and FB source. On the other hand side the
320control file helps anyone who want to generate an up-date for the
321header, further on.
322
323
324Have fun, share your results.
325
326*/
327
328/** \page changelog Changelog
329\tableofcontents
330
331\section v-0-2 GirToBac-0.2
332
333New:
334- GirToBac source 32/64 bit ready.
335- Translated header code 32/64 bit ready.
336- Self translated GLib header in use, see [GnomeHeaders-1.0](http://www.freebasic-portal.de/downloads/bibliotheken/gtk-3-header-dateien-fuer-freebasic-191.html).