diff --git a/ChangeLog b/ChangeLog index fbc879122a..d24288801b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2008-07-04 Matthias Clasen + + * gdk/x11/gdktestutils-x11.c: Small doc fixes + 2008-07-04 Matthias Clasen * gtk/tests/defaultvalue.c: Omit some more untestable properties. diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index d9e48efca1..1dadff3bd1 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2008-07-04 Matthias Clasen + + * gdk/tmpl/events.sgml: + * gdk/tmpl/gdktesting.sgml: Additions + 2008-07-03 Matthias Clasen * gtk/images/iconview.png: Update diff --git a/docs/reference/gdk/tmpl/events.sgml b/docs/reference/gdk/tmpl/events.sgml index f58d9c6cc0..b4dff1b5ef 100644 --- a/docs/reference/gdk/tmpl/events.sgml +++ b/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. diff --git a/docs/reference/gdk/tmpl/gdktesting.sgml b/docs/reference/gdk/tmpl/gdktesting.sgml new file mode 100644 index 0000000000..e16ea19242 --- /dev/null +++ b/docs/reference/gdk/tmpl/gdktesting.sgml @@ -0,0 +1,58 @@ + +Testing + + +test utilities + + + +The functions in this section are intended to be used in test programs. +They allow to simulate some user input. + + + + + + + + + + + + + + + + + +@window: + + + + + + + +@window: +@x: +@y: +@button: +@modifiers: +@button_pressrelease: +@Returns: + + + + + + + +@window: +@x: +@y: +@keyval: +@modifiers: +@key_pressrelease: +@Returns: + + diff --git a/gdk/x11/gdktestutils-x11.c b/gdk/x11/gdktestutils-x11.c index 920a87a333..c35b8a5ac4 100644 --- a/gdk/x11/gdktestutils-x11.c +++ b/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