Update deprecation docs

This commit is contained in:
Matthias Clasen 2011-10-11 23:50:34 -04:00
parent 3d282dcc2e
commit c6016458ba

View File

@ -71,9 +71,20 @@ $ cc `pkg-config --cflags --libs glib-2.0` hello.c -o hello
</para> </para>
<para> <para>
If you want to make sure that your program doesn't use any deprecated Deprecated GLib functions are annotated to make the compiler
functions, you can define the preprocessor symbol G_DISABLE_DEPRECATED emit warnings when they are used (e.g. with gcc, you need to use
by using the command line option <literal>-DG_DISABLE_DEPRECATED=1</literal>. the -Wdeprecated-declarations option). If these warnings are
problematic, they can be turned off by defining the preprocessor
symbol GLIB_DISABLE_DEPRECATION_WARNINGS by using the commandline
option <literal>-DGLIB_DISABLE_DEPRECATION_WARNINGS</literal>
</para>
<para>
If you want to make <emphasis>really</emphasis> sure that your program
doesn't use any deprecated functions, you can define the preprocessor
symbol G_DISABLE_DEPRECATED by using the commandline option
<literal>-DG_DISABLE_DEPRECATED</literal>. This will hide deprecated
API from the compiler entirely, most likely causing your program's
build to fail.
</para> </para>
<para> <para>