gtk+ r20228 - in trunk/docs/reference: . gtk

[matthiasc svn gnome org]

Author: matthiasc
Date: Thu May 29 04:19:54 2008
New Revision: 20228
URL: http://svn.gnome.org/viewvc/gtk+?rev=20228&view=rev

Log:
Additions


Modified:
   trunk/docs/reference/ChangeLog
   trunk/docs/reference/gtk/compiling.sgml

Modified: trunk/docs/reference/gtk/compiling.sgml
==============================================================================
--- trunk/docs/reference/gtk/compiling.sgml	(original)
+++ trunk/docs/reference/gtk/compiling.sgml	Thu May 29 04:19:54 2008
@@ -58,6 +58,16 @@
 <literal>-DGTK_MULTIHEAD_SAFE=1</literal>.
 </para>
 
+<para>
+The recommended way of using GTK+ has always been to only include the
+toplevel headers <filename>gtk.h</filename>, <filename>gdk.h</filename>, 
+<filename>gdk-pixbuf.h</filename>.
+If you want to make sure that your program follows this recommended
+practise, you can define the preprocessor symbols GTK_DISABLE_SINGLE_INCLUDES
+and GDK_PIXBUF_DISABLE_SINGLE_INCLUDES to make GTK+ generate an error
+when individual headers are directly included. 
+</para>
+
 </refsect1>
 </refentry>