Some GDK doc additions

svn path=/trunk/; revision=20770

ChangeLog

@@ -1,3 +1,7 @@
+2008-07-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* gdk/x11/gdktestutils-x11.c: Small doc fixes
+
 2008-07-04  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/tests/defaultvalue.c: Omit some more untestable properties.

docs/reference/ChangeLog

@@ -1,3 +1,8 @@
+2008-07-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* gdk/tmpl/events.sgml:
+	* gdk/tmpl/gdktesting.sgml: Additions
+
 2008-07-03  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/images/iconview.png: Update

docs/reference/gdk/tmpl/events.sgml

@@ -92,7 +92,8 @@ for the possible window states
   was added in 2.6
 @GDK_GRAB_BROKEN: a pointer or keyboard grab was broken. This event type
   was added in 2.8.
-@GDK_DAMAGE: 
+@GDK_DAMAGE: the content of the window has been changed. This event type
+  was added in 2.14.
 
 <!-- ##### ENUM GdkEventMask ##### -->
 <para>

docs/reference/gdk/tmpl/gdktesting.sgml

@@ -0,0 +1,58 @@
+<!-- ##### SECTION Title ##### -->
+Testing
+
+<!-- ##### SECTION Short_Description ##### -->
+test utilities
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+The functions in this section are intended to be used in test programs.
+They allow to simulate some user input.
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION gdk_test_render_sync ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
+<!-- ##### FUNCTION gdk_test_simulate_button ##### -->
+<para>
+
+</para>
+
+@window: 
+@x: 
+@y: 
+@button: 
+@modifiers: 
+@button_pressrelease: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_test_simulate_key ##### -->
+<para>
+
+</para>
+
+@window: 
+@x: 
+@y: 
+@keyval: 
+@modifiers: 
+@key_pressrelease: 
+@Returns: 
+
+

gdk/x11/gdktestutils-x11.c

@@ -58,12 +58,14 @@ gdk_test_render_sync (GdkWindow *window)
  * If (@x,@y) are > (-1,-1), it will warp the mouse pointer to
  * the given (@x,@y) corrdinates within @window and simulate a
  * key press or release event.
+ *
  * When the mouse pointer is warped to the target location, use
  * of this function outside of test programs that run in their
  * own virtual windowing system (e.g. Xvfb) is not recommended.
  * If (@x,@y) are passed as (-1,-1), the mouse pointer will not
  * be warped and @window origin will be used as mouse pointer
  * location for the event.
+ *
  * Also, gtk_test_simulate_key() is a fairly low level function,
  * for most testing purposes, gtk_test_widget_send_key() is the
  * right function to call which will generate a key press event
@@ -162,6 +164,7 @@ gdk_test_simulate_key (GdkWindow      *window,
  * location, use of this function outside of test programs that
  * run in their own virtual windowing system (e.g. Xvfb) is not
  * recommended.
+ *
  * Also, gtk_test_simulate_button() is a fairly low level function,
  * for most testing purposes, gtk_test_widget_click() is the right
  * function to call which will generate a button press event followed