[gtk+] docs: Add examples for use of GDK_VERSION_MIN_REQUIRED

[Matthias Clasen <matthiasc src gnome org>]

commit bdbd47818f3407748d8283919a2d89a7434808a7
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Aug 3 01:49:56 2012 +0200

    docs: Add examples for use of GDK_VERSION_MIN_REQUIRED
    
    I had to work this out for myself, so better document it.

 docs/reference/gtk/compiling.sgml |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gtk/compiling.sgml b/docs/reference/gtk/compiling.sgml
index 03206d9..827e408 100644
--- a/docs/reference/gtk/compiling.sgml
+++ b/docs/reference/gtk/compiling.sgml
@@ -64,6 +64,22 @@ this range will trigger compiler warnings.
 </para>
 
 <para>
+Here is how you would compile hello.c if you want to allow it
+to use symbols that were not deprecated in 3.2:
+<programlisting>
+$ cc -DGDK_VERSION_MIN_REQIRED=GDK_VERSION_3_2 `pkg-config --cflags --libs gtk+-3.0` hello.c -o hello
+</programlisting>
+</para>
+
+<para>
+And here is how you would compile hello.c if you don't want
+it to use any symbols that were introduced after 3.4:
+<programlisting>
+$ cc -DGDK_VERSION_MAX_ALLOWED=GDK_VERSION_3_4 `pkg-config --cflags --libs gtk+-3.0` hello.c -o hello
+</programlisting>
+</para>
+
+<para>
 The older deprecation mechanism of hiding deprecated interfaces
 entirely from the compiler by using the preprocessor symbol
 GTK_DISABLE_DEPRECATED is still used for deprecated macros,