added gtkaccelmap.sgml. other updates.

Mon Nov 12 23:06:38 2001  Tim Janik  <timj@gtk.org>

        * added gtkaccelmap.sgml. other updates.

Mon Nov 12 23:08:37 2001  Tim Janik  <timj@gtk.org>

	* gtk/maketypes.awk: fix type utils generation on unix.

	* gtk/gtkaccelmap.[hc]: new files, implementing a global accelerator
	registry.

	* gtk/gtkaccelgroup.[hc]: major API/implementation revamp:
	removed GTK_ACCEL_SIGNAL_VISIBLE, gtk_accel_group_get_default,
	gtk_accel_group_get_entry, gtk_accel_group_(un)lock_entry,
	gtk_accel_group_add/remove, gtk_accel_group_handle_add/remove,
	gtk_accel_group_create_add/remove, gtk_accel_group_entries_from_object.
	introduced ::accel_changed signal for change notification, and
	gtk_accel_group_connect/disconnect to connect closures to accel groups.
	made gtk_accel_group_attach/detach and gtk_accel_group_activate private
	functions.
	deprecated gtk_accel_group_ref/unref.

	* gtk/gtkaccellabel.[hc]: changes to make accellabels pay attention
	to accel group changed notification and basically operate on closures.
	removed gtk_accel_label_get_accel_object and
	gtk_accel_label_set_accel_object.
	introduced gtk_accel_label_set_accel_closure, and for convenience,
	gtk_accel_label_set_accel_widget.

	* gtk/gtkitemfactory.[hc]: removed accelerator propagation code
	which mostly moved into gtkaccelmap.[hc].
	removed gtk_item_factory_parse_rc*, gtk_item_factory_dump_*
	and gtk_item_factory_print_func.

	* gtk/gtkmain.c: call _gtk_accel_map_init().

	* gtk/gtkmenuitem.[hc]: introduced gtk_menu_item_set_accel_path(),
	that associates an accelerator path with menu items, through which
	persistent accelerator settings on menu items are enabled.

	* gtk/gtkmenu.[hc]: added gtk_menu_set_accel_path() so accelerator
	paths of menu item can be default constructed to allow installation
	of accelerators on menu items that don't come with an accelerator
	binding by default.

	* gtk/gtksettings.c: fix STRING type rc settings by special casing
	them appropriately in the parser.

	* gtk/gtksignal.[hc]: allow a class function offset of 0 for
	gtk_signal_newv().

	* gtk/gtkwidget.[hc]: accelerator API revamp.
	removed ::accelerator_add/remove signals, gtk_widget_accelerator_signal,
	gtk_widget_accelerators_locked, gtk_widget_remove_accelerators and
	gtk_widget_(un)lock_accelerators.
	accelerators maintained through gtk_widget_add/remove_accelerator()
	are not runtime changable now, the correct sequence to setup a
	widget for runtime changable accelerators is now:
	  gtk_accel_map_add_entry(accel_path, key, mods);
	  _gtk_widget_set_accel_path(widget, accel_path, accel_group);

	* gtk/gtkwindow.[hc]: accelerator changes, proxy and coalesce accel
	group changes (as well as mnemonic changes) through the new signal
	::accels_changed.

Sat Nov 10 12:08:56 2001  Tim Janik  <timj@gtk.org>

	* gtk/gtksettings.c (_gtk_settings_parse_convert): properly handle
	GString->string conversions.

16 files changed, 325 insertions, 259 deletions

diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml
index 91412b12e..86e08b9c7 100644
--- a/docs/reference/gtk/tmpl/gtk-unused.sgml
+++ b/docs/reference/gtk/tmpl/gtk-unused.sgml
@@ -495,9 +495,9 @@ This is a private struct used by GTK+ internally, don't worry about it.
 @object: 
 @signal_id: 
 
-<!-- ##### ARG GtkAccelLabel:accel-widget ##### -->
+<!-- ##### ARG GtkAccelLabel:accel-object ##### -->
 <para>
-The widget whose accelerators are to be shown by the #GtkAccelLabel.
+
 </para>
 
 
@@ -1186,6 +1186,29 @@ produce superscript and subscript.
 @parent: 
 @priv: 
 
+<!-- ##### USER_FUNCTION GtkTreeViewDraggableFunc ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@context: 
+@path: 
+@user_data: 
+@Returns: 
+
+<!-- ##### USER_FUNCTION GtkTreeViewDroppableFunc ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@context: 
+@path: 
+@pos: 
+@user_data: 
+@Returns: 
+
 <!-- ##### ARG GtkVScale:adjustment ##### -->
 <para>
 the #GtkAdjustment which sets the range of the scale.
@@ -1207,6 +1230,18 @@ the #GtkAdjustment which sets the range of the scale.
 @arg1: 
 @Returns: 
 
+<!-- ##### SIGNAL GtkWidget::add-accelerator ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@accel_signal_id: 
+@accel_group: 
+@accel_key: 
+@accel_mods: 
+@accel_flags: 
+
 <!-- ##### SIGNAL GtkWidget::debug-msg ##### -->
 <para>
 
@@ -1237,6 +1272,16 @@ the #GtkAdjustment which sets the range of the scale.
 
 @widget: the object which received the signal.
 
+<!-- ##### SIGNAL GtkWidget::remove-accelerator ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@accel_group: 
+@accel_key: 
+@accel_mods: 
+
 <!-- ##### ARG GtkWidget:height ##### -->
 <para>
 
@@ -1273,6 +1318,37 @@ If the window shrinks automatically when widgets within it shrink.
 </para>
 
 
+<!-- ##### FUNCTION gtk_accel_group_activate ##### -->
+<para>
+
+</para>
+
+@accel_group: 
+@accel_key: 
+@accel_mods: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_accel_group_add ##### -->
+<para>
+
+</para>
+
+@accel_group: 
+@path: 
+@accel_key: 
+@accel_mods: 
+@accel_flags: 
+@object: 
+@accel_signal: 
+
+<!-- ##### FUNCTION gtk_accel_group_attach ##### -->
+<para>
+
+</para>
+
+@accel_group: 
+@object: 
+
 <!-- ##### FUNCTION gtk_accel_group_create_add ##### -->
 <para>
 
@@ -1293,6 +1369,14 @@ If the window shrinks automatically when widgets within it shrink.
 @handler_offset: 
 @Returns: 
 
+<!-- ##### FUNCTION gtk_accel_group_detach ##### -->
+<para>
+
+</para>
+
+@accel_group: 
+@object: 
+
 <!-- ##### FUNCTION gtk_accel_group_entries_from_object ##### -->
 <para>
 
@@ -1301,6 +1385,13 @@ If the window shrinks automatically when widgets within it shrink.
 @object: 
 @Returns: 
 
+<!-- ##### FUNCTION gtk_accel_group_get_default ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
 <!-- ##### FUNCTION gtk_accel_group_get_entry ##### -->
 <para>
 
@@ -1342,6 +1433,24 @@ If the window shrinks automatically when widgets within it shrink.
 @accel_key: 
 @accel_mods: 
 
+<!-- ##### MACRO gtk_accel_group_ref ##### -->
+<para>
+
+</para>
+
+@Returns: 
+@accel_group: 
+
+<!-- ##### FUNCTION gtk_accel_group_remove ##### -->
+<para>
+
+</para>
+
+@accel_group: 
+@accel_key: 
+@accel_mods: 
+@object: 
+
 <!-- ##### FUNCTION gtk_accel_group_unlock_entry ##### -->
 <para>
 
@@ -1351,6 +1460,13 @@ If the window shrinks automatically when widgets within it shrink.
 @accel_key: 
 @accel_mods: 
 
+<!-- ##### MACRO gtk_accel_group_unref ##### -->
+<para>
+
+</para>
+
+@accel_group: 
+
 <!-- ##### FUNCTION gtk_accel_groups_from_object ##### -->
 <para>
 
@@ -1359,6 +1475,22 @@ If the window shrinks automatically when widgets within it shrink.
 @object: 
 @Returns: 
 
+<!-- ##### FUNCTION gtk_accel_label_get_accel_object ##### -->
+<para>
+
+</para>
+
+@accel_label: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_accel_label_set_accel_object ##### -->
+<para>
+
+</para>
+
+@accel_label: 
+@accel_object: 
+
 <!-- ##### FUNCTION gtk_arg_copy ##### -->
 <para>
 It will either copy data into an existing argument or allocate a new argument
@@ -1905,6 +2037,54 @@ Get the type of GtkIdentifier.
 
 @Returns: 
 
+<!-- ##### FUNCTION gtk_item_factory_dump_items ##### -->
+<para>
+
+</para>
+
+@path_pspec: 
+@modified_only: 
+@print_func: 
+@func_data: 
+
+<!-- ##### FUNCTION gtk_item_factory_dump_rc ##### -->
+<para>
+
+</para>
+
+@file_name: 
+@path_pspec: 
+@modified_only: 
+
+<!-- ##### FUNCTION gtk_item_factory_parse_rc ##### -->
+<para>
+
+</para>
+
+@file_name: 
+
+<!-- ##### FUNCTION gtk_item_factory_parse_rc_scanner ##### -->
+<para>
+
+</para>
+
+@scanner: 
+
+<!-- ##### FUNCTION gtk_item_factory_parse_rc_string ##### -->
+<para>
+
+</para>
+
+@rc_string: 
+
+<!-- ##### FUNCTION gtk_item_factory_print_func ##### -->
+<para>
+
+</para>
+
+@FILE_pointer: 
+@string: 
+
 <!-- ##### FUNCTION gtk_label_set_markup_with_accel ##### -->
 <para>
 
@@ -2715,6 +2895,31 @@ a gtk_object_unref().
 @width: 
 @size: 
 
+<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_dest ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@targets: 
+@n_targets: 
+@actions: 
+@location_droppable_func: 
+@user_data: 
+
+<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_source ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@start_button_mask: 
+@targets: 
+@n_targets: 
+@actions: 
+@row_draggable_func: 
+@user_data: 
+
 <!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
 <para>
 Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
@@ -2829,6 +3034,25 @@ Set the varargs type for a fundamental type @foreign_type.
 fundamental type.
 @varargs_type: Must be a GtkType which is either structured or flag, or NONE.
 
+<!-- ##### FUNCTION gtk_widget_accelerator_signal ##### -->
+<para>
+
+</para>
+
+@widget: 
+@accel_group: 
+@accel_key: 
+@accel_mods: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_widget_accelerators_locked ##### -->
+<para>
+
+</para>
+
+@widget: 
+@Returns: 
+
 <!-- ##### FUNCTION gtk_widget_activate_mnemonic ##### -->
 <para>
 
@@ -2847,6 +3071,13 @@ fundamental type.
 @width: 
 @height: 
 
+<!-- ##### FUNCTION gtk_widget_lock_accelerators ##### -->
+<para>
+
+</para>
+
+@widget: 
+
 <!-- ##### FUNCTION gtk_widget_pop_style ##### -->
 <para>
 
@@ -2869,6 +3100,15 @@ fundamental type.
 
 @style: 
 
+<!-- ##### FUNCTION gtk_widget_remove_accelerators ##### -->
+<para>
+
+</para>
+
+@widget: 
+@accel_signal: 
+@visible_only: 
+
 <!-- ##### FUNCTION gtk_widget_set_default_style ##### -->
 <para>
 
@@ -2876,6 +3116,13 @@ fundamental type.
 
 @style: 
 
+<!-- ##### FUNCTION gtk_widget_unlock_accelerators ##### -->
+<para>
+
+</para>
+
+@widget: 
+
 <!-- ##### FUNCTION gtk_window_activate_mnemonic ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
index a0fc59a52..b069f7e73 100644
--- a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
@@ -1,9 +1,9 @@
 <!-- ##### SECTION Title ##### -->
-Keyboard Accelerators
+Keyboard Accelerator Groups
 
 <!-- ##### SECTION Short_Description ##### -->
 
-global keyboard accelerators (for an entire #GtkWindow)
+Groups of global keyboard accelerators for an entire #GtkWindow
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -11,14 +11,15 @@ A #GtkAccelGroup represents a group of keyboard accelerators,
 typically attached to a toplevel #GtkWindow (with
 gtk_window_add_accel_group()). Usually you won't need to create a
 #GtkAccelGroup directly; instead, when using #GtkItemFactory, GTK+
-automatically sets up the accelerators for your menus.
+automatically sets up the accelerators for your menus in the item
+factory's #GtkAccelGroup.
 </para>
 
 <para>
 Note that <firstterm>accelerators</firstterm> are different from
 <firstterm>mnemonics</firstterm>. Accelerators are shortcuts for
 activating a menu item; they appear alongside the menu item they're a
-shortcut for, for example "Ctrl+Q" might appear alongside the "Quit"
+shortcut for. For example "Ctrl+Q" might appear alongside the "Quit"
 menu item. Mnemonics are shortcuts for GUI elements such as text
 entries or buttons; they appear as underlined characters. See
 gtk_label_new_with_mnemonic(). Menu items can have both accelerators
@@ -27,16 +28,17 @@ and mnemonics, of course.
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-gtk_label_new_with_mnemonic(), gtk_window_add_accel_group()
+gtk_window_add_accel_group(), gtk_accel_map_change_entry(),
+gtk_item_factory_new(), gtk_label_new_with_mnemonic()
 </para>
 
 <!-- ##### STRUCT GtkAccelGroup ##### -->
 <para>
-On opaque data type representing a group of accelerators.
+An object representing and maintaining a group of accelerators.
 </para>
 
 
-<!-- ##### FUNCTION gtk_accel_group_new ##### -->
+<!-- ##### FUNCTION gtk_accel_group_get_type ##### -->
 <para>
 
 </para>
@@ -44,32 +46,15 @@ On opaque data type representing a group of accelerators.
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_accel_group_get_default ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_accel_group_ref ##### -->
+<!-- ##### FUNCTION gtk_accel_group_new ##### -->
 <para>
 
 </para>
 
-@accel_group: 
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_accel_group_unref ##### -->
-<para>
-
-</para>
-
-@accel_group: 
-
-
-<!-- ##### FUNCTION gtk_accel_group_activate ##### -->
+<!-- ##### FUNCTION gtk_accel_group_connect ##### -->
 <para>
 
 </para>
@@ -77,39 +62,25 @@ On opaque data type representing a group of accelerators.
 @accel_group: 
 @accel_key: 
 @accel_mods: 
-@Returns: 
+@accel_flags: 
+@closure: 
+@accel_path_quark: 
+<!-- # Unused Parameters # -->
+@path_quark: 
 
 
-<!-- ##### FUNCTION gtk_accel_groups_activate ##### -->
+<!-- ##### FUNCTION gtk_accel_group_disconnect ##### -->
 <para>
 
 </para>
 
-@object: 
+@accel_group: 
 @accel_key: 
 @accel_mods: 
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_accel_group_attach ##### -->
-<para>
-
-</para>
-
-@accel_group: 
-@object: 
-
-
-<!-- ##### FUNCTION gtk_accel_group_detach ##### -->
-<para>
-
-</para>
-
-@accel_group: 
-@object: 
-
-
-<!-- ##### FUNCTION gtk_accel_group_add ##### -->
+<!-- ##### FUNCTION gtk_accel_group_query ##### -->
 <para>
 
 </para>
@@ -117,19 +88,20 @@ On opaque data type representing a group of accelerators.
 @accel_group: 
 @accel_key: 
 @accel_mods: 
-@accel_flags: 
-@object: 
-@accel_signal: 
+@n_entries: 
+@Returns: 
 
 
-<!-- ##### FUNCTION gtk_accel_group_remove ##### -->
+<!-- ##### FUNCTION gtk_accel_groups_activate ##### -->
 <para>
 
 </para>
 
-@accel_group: 
+@acceleratable: 
 @accel_key: 
 @accel_mods: 
+@Returns: 
+<!-- # Unused Parameters # -->
 @object: 
 
 
diff --git a/docs/reference/gtk/tmpl/gtkaccellabel.sgml b/docs/reference/gtk/tmpl/gtkaccellabel.sgml
index a434252bb..4587cf751 100644
--- a/docs/reference/gtk/tmpl/gtkaccellabel.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccellabel.sgml
@@ -94,7 +94,7 @@ Creates a new #GtkAccelLabel.
 @Returns: a new #GtkAccelLabel.
 
 
-<!-- ##### FUNCTION gtk_accel_label_get_accel_object ##### -->
+<!-- ##### FUNCTION gtk_accel_label_get_accel_widget ##### -->
 <para>
 
 </para>
@@ -103,24 +103,7 @@ Creates a new #GtkAccelLabel.
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_accel_label_set_accel_object ##### -->
-<para>
-
-</para>
-
-@accel_label: 
-@accel_object: 
-
-
-<!-- ##### MACRO gtk_accel_label_get_accel_widget ##### -->
-<para>
-
-</para>
-
-@accel_label:
-
-
-<!-- ##### MACRO gtk_accel_label_set_accel_widget ##### -->
+<!-- ##### FUNCTION gtk_accel_label_set_accel_widget ##### -->
 <para>
 Sets the widget whose accelerators are to be shown.
 </para>
@@ -151,8 +134,13 @@ accelerators are added or removed from the associated widget.
 @Returns: always returns %FALSE.
 
 
-<!-- ##### ARG GtkAccelLabel:accel-object ##### -->
+<!-- ##### ARG GtkAccelLabel:accel-closure ##### -->
 <para>
 
 </para>
 
+<!-- ##### ARG GtkAccelLabel:accel-widget ##### -->
+<para>
+The widget whose accelerators are to be shown by the #GtkAccelLabel.
+</para>
+
diff --git a/docs/reference/gtk/tmpl/gtkcolorsel.sgml b/docs/reference/gtk/tmpl/gtkcolorsel.sgml
index 73907ce28..5bb58e122 100644
--- a/docs/reference/gtk/tmpl/gtkcolorsel.sgml
+++ b/docs/reference/gtk/tmpl/gtkcolorsel.sgml
@@ -225,7 +225,7 @@ time.
 
 </para>
 
-@colorsel:
+@colorsel: 
 @color: 
 
 
@@ -234,8 +234,8 @@ time.
 
 </para>
 
-@colorsel:
-@color:
+@colorsel: 
+@color: 
 
 
 <!-- ##### SIGNAL GtkColorSelection::color-changed ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkcombo.sgml b/docs/reference/gtk/tmpl/gtkcombo.sgml
index 8034f9cb7..4f6ed7b6f 100644
--- a/docs/reference/gtk/tmpl/gtkcombo.sgml
+++ b/docs/reference/gtk/tmpl/gtkcombo.sgml
@@ -178,7 +178,7 @@ worried about differences in case.
 </para>
 
 @combo: a #GtkCombo.
-@val: %TRUE if the text in the list items is case sensitive. 
+@val: %TRUE if the text in the list items is case sensitive.
 
 
 <!-- ##### FUNCTION gtk_combo_set_item_string ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkdialog.sgml b/docs/reference/gtk/tmpl/gtkdialog.sgml
index f677af775..7eb449fe1 100644
--- a/docs/reference/gtk/tmpl/gtkdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkdialog.sgml
@@ -169,7 +169,7 @@ Creates a new dialog box. Widgets should not be packed into this #GtkWindow
 directly, but into the vbox and action_area, as described above. 
 </para>
 
-@Returns: a new #GtkDialog. 
+@Returns: a new #GtkDialog.
 
 
 <!-- ##### FUNCTION gtk_dialog_new_with_buttons ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml
index 6c19bccb7..304ae8d02 100644
--- a/docs/reference/gtk/tmpl/gtkenums.sgml
+++ b/docs/reference/gtk/tmpl/gtkenums.sgml
@@ -20,7 +20,6 @@ Public enumerated types used throughout GTK+.
 </para>
 
 @GTK_ACCEL_VISIBLE: 
-@GTK_ACCEL_SIGNAL_VISIBLE: 
 @GTK_ACCEL_LOCKED: 
 @GTK_ACCEL_MASK: 
 
diff --git a/docs/reference/gtk/tmpl/gtkitemfactory.sgml b/docs/reference/gtk/tmpl/gtkitemfactory.sgml
index abda89259..57c1fd8f7 100644
--- a/docs/reference/gtk/tmpl/gtkitemfactory.sgml
+++ b/docs/reference/gtk/tmpl/gtkitemfactory.sgml
@@ -84,11 +84,6 @@ GtkItemFactory
 </para>
 
 @path: 
-@accelerator_key: 
-@accelerator_mods: 
-@modified: 
-@in_propagation: 
-@dummy: 
 @widgets: 
 
 <!-- ##### FUNCTION gtk_item_factory_new ##### -->
@@ -113,30 +108,6 @@ GtkItemFactory
 @accel_group: 
 
 
-<!-- ##### FUNCTION gtk_item_factory_parse_rc ##### -->
-<para>
-
-</para>
-
-@file_name: 
-
-
-<!-- ##### FUNCTION gtk_item_factory_parse_rc_string ##### -->
-<para>
-
-</para>
-
-@rc_string: 
-
-
-<!-- ##### FUNCTION gtk_item_factory_parse_rc_scanner ##### -->
-<para>
-
-</para>
-
-@scanner: 
-
-
 <!-- ##### FUNCTION gtk_item_factory_add_foreign ##### -->
 <para>
 
@@ -207,36 +178,6 @@ GtkItemFactory
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_item_factory_dump_items ##### -->
-<para>
-
-</para>
-
-@path_pspec: 
-@modified_only: 
-@print_func: 
-@func_data: 
-
-
-<!-- ##### FUNCTION gtk_item_factory_dump_rc ##### -->
-<para>
-
-</para>
-
-@file_name: 
-@path_pspec: 
-@modified_only: 
-
-
-<!-- ##### FUNCTION gtk_item_factory_print_func ##### -->
-<para>
-
-</para>
-
-@FILE_pointer: 
-@string: 
-
-
 <!-- ##### FUNCTION gtk_item_factory_create_item ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkmenu.sgml b/docs/reference/gtk/tmpl/gtkmenu.sgml
index 8bb20423d..eb37062f0 100644
--- a/docs/reference/gtk/tmpl/gtkmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenu.sgml
@@ -96,9 +96,9 @@ Creates a new #GtkMenu.
 Adds a new #GtkMenuItem to the end of the menu's item list.
 </para>
 
-<!-- # Unused Parameters # -->
 @menu: a #GtkMenu.
 @child: The #GtkMenuItem to add.
+<!-- # Unused Parameters # -->
 @m: 
 @c: 
 
@@ -108,9 +108,9 @@ Adds a new #GtkMenuItem to the end of the menu's item list.
 Adds a new #GtkMenuItem to the beginning of the menu's item list.
 </para>
 
-<!-- # Unused Parameters # -->
 @menu: a #GtkMenu.
 @child: The #GtkMenuItem to add.
+<!-- # Unused Parameters # -->
 @menu_child: 
 @m: 
 @c: 
@@ -122,10 +122,10 @@ Adds a new #GtkMenuItem to the menu's item list at the position
 indicated by @position. 
 </para>
 
-<!-- # Unused Parameters # -->
 @menu: a #GtkMenu.
 @child: The #GtkMenuItem to add.
 @pos: 
+<!-- # Unused Parameters # -->
 @position: The position in the item list where @child is added.
 Positions are numbered from 0 to n-1.
 
@@ -162,6 +162,9 @@ at the current pointer position.
 <!-- ##### FUNCTION gtk_menu_set_accel_group ##### -->
 <para>
 Set the #GtkAccelGroup which holds global accelerators for the menu.
+This accelerator group needs to also be added to all windows that
+this menu is being used in with gtk_window_add_accel_group(), in order
+for those windows to support all the accelerators contained in this group.
 </para>
 
 @menu: a #GtkMenu.
@@ -178,6 +181,15 @@ See gtk_menu_set_accel_group().
 @Returns: the #GtkAccelGroup associated with the menu.
 
 
+<!-- ##### FUNCTION gtk_menu_set_accel_path ##### -->
+<para>
+
+</para>
+
+@menu: 
+@accel_path: 
+
+
 <!-- ##### FUNCTION gtk_menu_set_title ##### -->
 <para>
 Sets the title string for the menu.  The title is displayed when the menu
diff --git a/docs/reference/gtk/tmpl/gtkmenuitem.sgml b/docs/reference/gtk/tmpl/gtkmenuitem.sgml
index 76b4e8639..d65e13a75 100644
--- a/docs/reference/gtk/tmpl/gtkmenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenuitem.sgml
@@ -83,6 +83,15 @@ Sets the widget submenu, or changes it.
 @submenu: the submenu
 
 
+<!-- ##### FUNCTION gtk_menu_item_set_accel_path ##### -->
+<para>
+
+</para>
+
+@menu_item: 
+@accel_path: 
+
+
 <!-- ##### FUNCTION gtk_menu_item_remove_submenu ##### -->
 <para>
 Removes the widget's submenu.
diff --git a/docs/reference/gtk/tmpl/gtkpaned.sgml b/docs/reference/gtk/tmpl/gtkpaned.sgml
index f3a7e01e0..95369862d 100644
--- a/docs/reference/gtk/tmpl/gtkpaned.sgml
+++ b/docs/reference/gtk/tmpl/gtkpaned.sgml
@@ -112,6 +112,9 @@ Old name for gtk_paned_set_handle_size()
 Old name for gtk_paned_set_gutter_size()
 </para>
 
+@p: 
+@s: 
+
 
 <!-- ##### FUNCTION gtk_paned_pack1 ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktoolbar.sgml b/docs/reference/gtk/tmpl/gtktoolbar.sgml
index 9ee5eb854..74562454d 100644
--- a/docs/reference/gtk/tmpl/gtktoolbar.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolbar.sgml
@@ -47,8 +47,8 @@ Widgets can be visibly grouped by adding gaps between widgets using gtk_toolbar_
 to a #GtkToolbar.
 </para>
 
-@GTK_TOOLBAR_CHILD_SPACE: a space in the style of the toolbar's #GtkToolbarSpaceStyle. 
-@GTK_TOOLBAR_CHILD_BUTTON: a #GtkButton. 
+@GTK_TOOLBAR_CHILD_SPACE: a space in the style of the toolbar's #GtkToolbarSpaceStyle.
+@GTK_TOOLBAR_CHILD_BUTTON: a #GtkButton.
 @GTK_TOOLBAR_CHILD_TOGGLEBUTTON: a #GtkToggleButton.
 @GTK_TOOLBAR_CHILD_RADIOBUTTON: a #GtkRadioButton.
 @GTK_TOOLBAR_CHILD_WIDGET: a standard #GtkWidget.
diff --git a/docs/reference/gtk/tmpl/gtktreednd.sgml b/docs/reference/gtk/tmpl/gtktreednd.sgml
index 842769a89..9414655b6 100644
--- a/docs/reference/gtk/tmpl/gtktreednd.sgml
+++ b/docs/reference/gtk/tmpl/gtktreednd.sgml
@@ -43,6 +43,7 @@ GtkTreeView drag-and-drop
 </para>
 
 @g_iface: 
+@row_draggable: 
 @drag_data_get: 
 @drag_data_delete: 
 
diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index 3234cc1c0..b8480449e 100644
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -49,18 +49,6 @@ GtkTreeView
 @Returns: 
 
 
-<!-- ##### USER_FUNCTION GtkTreeViewDraggableFunc ##### -->
-<para>
-
-</para>
-
-@tree_view: 
-@context: 
-@path: 
-@user_data: 
-@Returns: 
-
-
 <!-- ##### USER_FUNCTION GtkTreeViewMappingFunc ##### -->
 <para>
 
@@ -71,19 +59,6 @@ GtkTreeView
 @user_data: 
 
 
-<!-- ##### USER_FUNCTION GtkTreeViewDroppableFunc ##### -->
-<para>
-
-</para>
-
-@tree_view: 
-@context: 
-@path: 
-@pos: 
-@user_data: 
-@Returns: 
-
-
 <!-- ##### USER_FUNCTION GtkTreeViewSearchEqualFunc ##### -->
 <para>
 
@@ -559,33 +534,6 @@ GtkTreeView
 @wy: 
 
 
-<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_source ##### -->
-<para>
-
-</para>
-
-@tree_view: 
-@start_button_mask: 
-@targets: 
-@n_targets: 
-@actions: 
-@row_draggable_func: 
-@user_data: 
-
-
-<!-- ##### FUNCTION gtk_tree_view_set_rows_drag_dest ##### -->
-<para>
-
-</para>
-
-@tree_view: 
-@targets: 
-@n_targets: 
-@actions: 
-@location_droppable_func: 
-@user_data: 
-
-
 <!-- ##### FUNCTION gtk_tree_view_unset_rows_drag_source ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml
index 4781aee5f..76769b73b 100644
--- a/docs/reference/gtk/tmpl/gtkwidget.sgml
+++ b/docs/reference/gtk/tmpl/gtkwidget.sgml
@@ -527,27 +527,6 @@ GtkWidget
 @accel_group: 
 @accel_key: 
 @accel_mods: 
-
-
-<!-- ##### FUNCTION gtk_widget_remove_accelerators ##### -->
-<para>
-
-</para>
-
-@widget: 
-@accel_signal: 
-@visible_only: 
-
-
-<!-- ##### FUNCTION gtk_widget_accelerator_signal ##### -->
-<para>
-
-</para>
-
-@widget: 
-@accel_group: 
-@accel_key: 
-@accel_mods: 
 @Returns: 
 
 
@@ -1000,14 +979,6 @@ GtkWidget
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_widget_lock_accelerators ##### -->
-<para>
-
-</para>
-
-@widget: 
-
-
 <!-- ##### FUNCTION gtk_widget_modify_style ##### -->
 <para>
 
@@ -1207,23 +1178,6 @@ GtkWidget
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_widget_unlock_accelerators ##### -->
-<para>
-
-</para>
-
-@widget: 
-
-
-<!-- ##### FUNCTION gtk_widget_accelerators_locked ##### -->
-<para>
-
-</para>
-
-@widget: 
-@Returns: 
-
-
 <!-- ##### FUNCTION gtk_widget_mnemonic_activate ##### -->
 <para>
 
@@ -1456,17 +1410,12 @@ GtkWidget
 @requisition: 
 
 
-<!-- ##### SIGNAL GtkWidget::add-accelerator ##### -->
+<!-- ##### SIGNAL GtkWidget::accel-closures-changed ##### -->
 <para>
 
 </para>
 
 @widget: the object which received the signal.
-@accel_signal_id: 
-@accel_group: 
-@accel_key: 
-@accel_mods: 
-@accel_flags: 
 
 <!-- ##### SIGNAL GtkWidget::button-press-event ##### -->
 <para>
@@ -1834,16 +1783,6 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 
-<!-- ##### SIGNAL GtkWidget::remove-accelerator ##### -->
-<para>
-
-</para>
-
-@widget: the object which received the signal.
-@accel_group: 
-@accel_key: 
-@accel_mods: 
-
 <!-- ##### SIGNAL GtkWidget::scroll-event ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml
index 66ea51639..b8111b436 100644
--- a/docs/reference/gtk/tmpl/gtkwindow.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindow.sgml
@@ -694,6 +694,13 @@ it's larger
 @height: 
 
 
+<!-- ##### SIGNAL GtkWindow::accels-changed ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+
 <!-- ##### SIGNAL GtkWindow::activate-default ##### -->
 <para>