Index: gtk/gtknotebook.c
===================================================================
--- gtk/gtknotebook.c	(revision 19967)
+++ gtk/gtknotebook.c	(arbetskopia)
@@ -869,6 +869,18 @@
                   _gtk_marshal_BOOLEAN__INT,
                   G_TYPE_BOOLEAN, 1,
                   G_TYPE_INT);
+  /**
+   * GtkNotebook::move-focus-out:
+   * @notebook: a #GtkNotebook
+   * @direction_type: a #GtkDirectionType describing where the focus
+   *   should move
+   *
+   * Emitted when a keybinding would cause focus to move away from the
+   * notebook. The ::move-focus signal is emitted with @direction_type
+   * as argument on the notebooks toplevel parent in the container
+   * hierarchy. The toplevel should, using the @direction_type
+   * argument, move focus to the appropriate widget.
+   **/
   notebook_signals[MOVE_FOCUS_OUT] =
     g_signal_new (I_("move_focus_out"),
                   G_TYPE_FROM_CLASS (gobject_class),
Index: gtk/gtkscrolledwindow.c
===================================================================
--- gtk/gtkscrolledwindow.c	(revision 19967)
+++ gtk/gtkscrolledwindow.c	(arbetskopia)
@@ -318,7 +318,17 @@
 						    GTK_CORNER_TOP_LEFT,
 						    G_PARAM_READABLE | G_PARAM_WRITABLE));
 
-
+  /**
+   * GtkScrolledWindow::scroll-child:
+   * @scrolled_window: a #GtkScrolledWindow
+   * @scroll: a #GtkScrollType describing how much to scroll 
+   * @horizontal: whether the keybinding scrolls the child
+   *   horizontally or not
+   *
+   * Emitted when a keybinding is pressed that scrolls. The horizontal
+   * or vertical adjustment is updated which triggers a signal that
+   * the scrolled windows child may listen to and scroll itself.
+   **/
   signals[SCROLL_CHILD] =
     g_signal_new (I_("scroll_child"),
                   G_TYPE_FROM_CLASS (object_class),
@@ -329,6 +339,20 @@
                   G_TYPE_BOOLEAN, 2,
                   GTK_TYPE_SCROLL_TYPE,
 		  G_TYPE_BOOLEAN);
+  /**
+   * GtkScrolledWindow::move-focus-out:
+   * @scrolled_window: a #GtkScrolledWindow
+   * @direction_type: either %GTK_DIR_TAB_FORWARD or
+   *   %GTK_DIR_TAB_BACKWARD
+   *
+   * Emits the ::move-focus signal with @direction_type on this
+   * scrolled windows toplevel parent in the container hierarchy. This
+   * signal is triggered when focus is moved away from the scrolled
+   * window by a key binding, by default
+   * <keycap>Tab</keycap>/<keycap>KP_Tab</keycap>+<keycap>Ctrl</keycap>
+   * and
+   * <keycap>Tab</keycap>/<keycap>KP_Tab</keycap>+<keycap>Ctrl</keycap>+<keycap>Shift</keycap>.
+   **/
   signals[MOVE_FOCUS_OUT] =
     g_signal_new (I_("move_focus_out"),
                   G_TYPE_FROM_CLASS (object_class),
