Additions

svn path=/trunk/; revision=20228

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 5ccb04cd0c16ef1f94d0137f0e5570be5ba5e5c6..f6dd8293b672395c8c7ebb2a0d82fa9cb964019f 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2008-05-28  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/compiling.sgml: Explains single includes
+
 2008-05-28  Matthias Clasen  <mclasen@redhat.com>
 
        Bug 535250 - GtkToolButton reference page says "label" where 

diff --git a/docs/reference/gtk/compiling.sgml b/docs/reference/gtk/compiling.sgml
index d5b89dea8550f27097eb638c6a556c5f3e483b50..b5233723765b3c8ee5322361c0fbb0cb1e9b8889 100644 (file)
--- a/docs/reference/gtk/compiling.sgml
+++ b/docs/reference/gtk/compiling.sgml
@@ -58,6 +58,16 @@ symbol GDK_MULTIHEAD_SAFE by using the command line option
 <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>