Doc formatting tweaks.

2003-10-01  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtkmain.c: Doc formatting tweaks.

	* gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.

	* gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio):
	Use the same parameter names as in .c file, to pacify gtk-doc.

	* gtk/gtktoggletoolbutton.[hc]:
	* gtk/gtktoolbutton.[hc]:
	* gtk/gtktoolitem.[hc]:
	* gtk/gtktoolbar.[hc]:
	* gtk/gtkcolorbutton.[hc]:
	* gtk/gtkfontbutton.[hc]:
	* gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the
	source, not in the header.

	* gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio):
	Document these as 2.4 API additions.

	* gtk/tmpl/gtkaction.sgml: Fix cross reference to GtkMenuMerge.

	* gtk/gtk-sections.txt: Additions.

	* gtk/tmpl/gtkitemfactory.sgml: Add hint to use #GtkUIManager instead.

24 files changed, 173 insertions, 42 deletions

diff --git a/ChangeLog b/ChangeLog
index d513bd3a1..6e250c48f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: Doc formatting tweaks.
+
+	* gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+	* gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+	Use the same parameter names as in .c file, to pacify gtk-doc.
+
+	* gtk/gtktoggletoolbutton.[hc]: 
+	* gtk/gtktoolbutton.[hc]: 
+	* gtk/gtktoolitem.[hc]:
+	* gtk/gtktoolbar.[hc]: 
+	* gtk/gtkcolorbutton.[hc]: 
+	* gtk/gtkfontbutton.[hc]: 
+	* gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+	source, not in the header.
+
+	* gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+	Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
 	* gtk/gtkentry.c (gtk_entry_set_completion),
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index d513bd3a1..6e250c48f 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: Doc formatting tweaks.
+
+	* gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+	* gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+	Use the same parameter names as in .c file, to pacify gtk-doc.
+
+	* gtk/gtktoggletoolbutton.[hc]: 
+	* gtk/gtktoolbutton.[hc]: 
+	* gtk/gtktoolitem.[hc]:
+	* gtk/gtktoolbar.[hc]: 
+	* gtk/gtkcolorbutton.[hc]: 
+	* gtk/gtkfontbutton.[hc]: 
+	* gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+	source, not in the header.
+
+	* gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+	Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
 	* gtk/gtkentry.c (gtk_entry_set_completion),
diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index d513bd3a1..6e250c48f 100644
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: Doc formatting tweaks.
+
+	* gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+	* gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+	Use the same parameter names as in .c file, to pacify gtk-doc.
+
+	* gtk/gtktoggletoolbutton.[hc]: 
+	* gtk/gtktoolbutton.[hc]: 
+	* gtk/gtktoolitem.[hc]:
+	* gtk/gtktoolbar.[hc]: 
+	* gtk/gtkcolorbutton.[hc]: 
+	* gtk/gtkfontbutton.[hc]: 
+	* gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+	source, not in the header.
+
+	* gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+	Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
 	* gtk/gtkentry.c (gtk_entry_set_completion),
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index d513bd3a1..6e250c48f 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: Doc formatting tweaks.
+
+	* gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+	* gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+	Use the same parameter names as in .c file, to pacify gtk-doc.
+
+	* gtk/gtktoggletoolbutton.[hc]: 
+	* gtk/gtktoolbutton.[hc]: 
+	* gtk/gtktoolitem.[hc]:
+	* gtk/gtktoolbar.[hc]: 
+	* gtk/gtkcolorbutton.[hc]: 
+	* gtk/gtkfontbutton.[hc]: 
+	* gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+	source, not in the header.
+
+	* gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+	Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
 	* gtk/gtkentry.c (gtk_entry_set_completion),
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index d513bd3a1..6e250c48f 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,24 @@
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: Doc formatting tweaks.
+
+	* gtk/gtktoolitem.c (gtk_tool_item_set_is_important): Fix a typo.
+
+	* gtk/gtkcheckmenuitem.h (gtk_check_menu_item_set_draw_as_radio): 
+	Use the same parameter names as in .c file, to pacify gtk-doc.
+
+	* gtk/gtktoggletoolbutton.[hc]: 
+	* gtk/gtktoolbutton.[hc]: 
+	* gtk/gtktoolitem.[hc]:
+	* gtk/gtktoolbar.[hc]: 
+	* gtk/gtkcolorbutton.[hc]: 
+	* gtk/gtkfontbutton.[hc]: 
+	* gtk/gtkalignment.[hc]: Define GET_PRIVATE macros in the 
+	source, not in the header.
+
+	* gtk/gtkcheckmenuitem.c (gtk_check_menu_item_[sg]et_draw_as_radio): 
+	Document these as 2.4 API additions.
+
 Tue Sep 30 23:42:56 2003  Kristian Rietveld  <kris@gtk.org>
 
 	* gtk/gtkentry.c (gtk_entry_set_completion),
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index d10847aa2..5d621317c 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,7 +1,13 @@
-2003-09-30  Matthias Clasen  <maclas@gmx.de>
+2003-10-01  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/tmpl/gtkaction.sgml: Fix cross reference to GtkMenuMerge.
+
+	* gtk/gtk-sections.txt: Additions.
 
 	* gtk/tmpl/gtkitemfactory.sgml: Add hint to use #GtkUIManager instead.
 
+2003-09-30  Matthias Clasen  <maclas@gmx.de>
+
 	* gtk/tmpl/gtkuimanager.sgml: Add a section about empty menus.
 
 	* gdk/tmpl/keys.sgml: Small addition.
diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index 5f2044fe7..6e2f7db2a 100644
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -201,6 +201,7 @@ GTK_IS_ALIGNMENT_CLASS
 GTK_ALIGNMENT_GET_CLASS
 <SUBSECTION Private>
 gtk_alignment_get_type
+GtkAlignmentPrivate
 </SECTION>
 
 <SECTION>
@@ -401,6 +402,8 @@ gtk_check_menu_item_set_show_toggle
 gtk_check_menu_item_toggled
 gtk_check_menu_item_get_inconsistent
 gtk_check_menu_item_set_inconsistent
+gtk_check_menu_item_set_draw_as_radio
+gtk_check_menu_item_get_draw_as_radio
 
 <SUBSECTION Standard>
 GTK_CHECK_MENU_ITEM
@@ -537,6 +540,7 @@ gtk_clist_get_type
 <TITLE>GtkColorButton</TITLE>
 GtkColorButton
 gtk_color_button_new
+gtk_color_button_new_with_color
 gtk_color_button_set_color
 gtk_color_button_get_color
 gtk_color_button_set_alpha
@@ -552,9 +556,9 @@ GTK_TYPE_COLOR_BUTTON
 GTK_COLOR_BUTTON_CLASS
 GTK_IS_COLOR_BUTTON_CLASS
 GTK_COLOR_BUTTON_GET_CLASS
-GTK_COLOR_BUTTON_GET_PRIVATE
 <SUBSECTION Private>
 gtk_color_button_get_type
+GtkColorButtonPrivate
 </SECTION>
 
 <SECTION>
@@ -940,6 +944,10 @@ gtk_entry_get_type
 <TITLE>GtkEventBox</TITLE>
 GtkEventBox
 gtk_event_box_new
+gtk_event_box_set_above_child
+gtk_event_box_get_above_child
+gtk_event_box_set_visible_window
+gtk_event_box_get_visible_window
 <SUBSECTION Standard>
 GTK_EVENT_BOX
 GTK_IS_EVENT_BOX
@@ -976,6 +984,7 @@ GTK_IS_EXPANDER_CLASS
 GTK_EXPANDER_GET_CLASS
 <SUBSECTION Private>
 gtk_expander_get_type
+GtkExpanderPrivate
 </SECTION>
 
 <SECTION>
@@ -1048,7 +1057,6 @@ GTK_TYPE_FONT_BUTTON
 GTK_FONT_BUTTON_CLASS
 GTK_IS_FONT_BUTTON_CLASS
 GTK_FONT_BUTTON_GET_CLASS
-GTK_FONT_BUTTON_GET_PRIVATE
 <SUBSECTION Private>
 gtk_font_button_get_type
 </SECTION>
@@ -1403,6 +1411,7 @@ GTK_IS_IM_MULTICONTEXT_CLASS
 GTK_IM_MULTICONTEXT_GET_CLASS
 <SUBSECTION Private>
 gtk_im_multicontext_get_type
+GtkIMMulticontextPrivate
 </SECTION>
 
 <SECTION>
@@ -1646,6 +1655,7 @@ gtk_menu_append
 gtk_menu_prepend
 gtk_menu_insert
 gtk_menu_reorder_child
+gtk_menu_attach
 gtk_menu_popup
 gtk_menu_set_accel_group
 gtk_menu_get_accel_group
@@ -2840,6 +2850,8 @@ gtk_text_view_set_indent
 gtk_text_view_get_indent
 gtk_text_view_set_tabs
 gtk_text_view_get_tabs
+gtk_text_view_set_accepts_tab
+gtk_text_view_get_accepts_tab
 gtk_text_view_get_default_attributes
 GTK_TEXT_VIEW_PRIORITY_VALIDATE
 <SUBSECTION Standard>
@@ -2987,6 +2999,7 @@ GTK_IS_TOOLBAR_CLASS
 GTK_TOOLBAR_GET_CLASS
 <SUBSECTION Private>
 gtk_toolbar_get_type
+GtkToolbarPrivate
 </SECTION>
 
 <SECTION>
@@ -3007,9 +3020,12 @@ gtk_tool_item_set_visible_horizontal
 gtk_tool_item_get_visible_horizontal
 gtk_tool_item_set_visible_vertical
 gtk_tool_item_get_visible_vertical
+gtk_tool_item_set_is_important
+gtk_tool_item_get_is_important
 gtk_tool_item_get_icon_size
 gtk_tool_item_get_orientation
 gtk_tool_item_get_toolbar_style
+gtk_tool_item_get_relief_style
 gtk_tool_item_retrieve_proxy_menu_item
 gtk_tool_item_get_proxy_menu_item
 gtk_tool_item_set_proxy_menu_item
@@ -3021,7 +3037,6 @@ GTK_TOOL_ITEM_CLASS
 GTK_IS_TOOL_ITEM
 GTK_IS_TOOL_ITEM_CLASS
 GTK_TOOL_ITEM_GET_CLASS
-GTK_TOOL_ITEM_GET_PRIVATE
 
 <SUBSECTION Private>
 gtk_tool_item_get_type
@@ -3070,7 +3085,6 @@ GTK_TOOL_BUTTON_CLASS
 GTK_IS_TOOL_BUTTON
 GTK_IS_TOOL_BUTTON_CLASS
 GTK_TOOL_BUTTON_GET_CLASS
-GTK_TOOL_BUTTON_GET_PRIVATE
 
 <SUBSECTION Private>
 gtk_tool_button_get_type
@@ -3121,7 +3135,6 @@ GTK_TOGGLE_TOOL_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_toggle_tool_button_get_type
 GtkToggleToolButtonPrivate
-GTK_TOGGLE_TOOL_BUTTON_GET_PRIVATE
 </SECTION>
 
 <SECTION>
@@ -3924,6 +3937,7 @@ gtk_widget_realize
 gtk_widget_unrealize
 gtk_widget_queue_draw
 gtk_widget_queue_resize
+gtk_widget_queue_resize_no_redraw
 gtk_widget_draw
 gtk_widget_size_request
 gtk_widget_get_child_requisition
diff --git a/docs/reference/gtk/tmpl/gtkaction.sgml b/docs/reference/gtk/tmpl/gtkaction.sgml
index f7aa54862..ca740fe8b 100644
--- a/docs/reference/gtk/tmpl/gtkaction.sgml
+++ b/docs/reference/gtk/tmpl/gtkaction.sgml
@@ -45,7 +45,7 @@ activate its action.
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-#GtkActionGroup, #GtkMenuMerge
+#GtkActionGroup, #GtkUIManager
 </para>
 
 <!-- ##### STRUCT GtkAction ##### -->
diff --git a/gtk/gtkalignment.c b/gtk/gtkalignment.c
index 01ba01418..275189595 100644
--- a/gtk/gtkalignment.c
+++ b/gtk/gtkalignment.c
@@ -43,6 +43,8 @@ enum {
   PROP_LAST
 };
 
+#define GTK_ALIGNMENT_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_ALIGNMENT, GtkAlignmentPrivate))
+
 struct _GtkAlignmentPrivate
 {
   guint padding_top;
diff --git a/gtk/gtkcheckmenuitem.c b/gtk/gtkcheckmenuitem.c
index 75db42a7f..fda728812 100644
--- a/gtk/gtkcheckmenuitem.c
+++ b/gtk/gtkcheckmenuitem.c
@@ -322,6 +322,7 @@ gtk_check_menu_item_get_inconsistent (GtkCheckMenuItem *check_menu_item)
  *
  * Sets whether @check_menu_item is drawn like a #GtkRadioMenuItem
  *
+ * Since: 2.4
  **/
 void
 gtk_check_menu_item_set_draw_as_radio (GtkCheckMenuItem *check_menu_item,
@@ -348,6 +349,8 @@ gtk_check_menu_item_set_draw_as_radio (GtkCheckMenuItem *check_menu_item,
  * Returns whether @check_menu_item looks like a #GtkRadioMenuItem
  * 
  * Return value: Whether @check_menu_item looks like a #GtkRadioMenuItem
+ * 
+ * Since: 2.4
  **/
 gboolean
 gtk_check_menu_item_get_draw_as_radio (GtkCheckMenuItem *check_menu_item)
diff --git a/gtk/gtkcheckmenuitem.h b/gtk/gtkcheckmenuitem.h
index 3572b7708..74b1ef133 100644
--- a/gtk/gtkcheckmenuitem.h
+++ b/gtk/gtkcheckmenuitem.h
@@ -87,7 +87,7 @@ void       gtk_check_menu_item_set_inconsistent  (GtkCheckMenuItem *check_menu_i
 						  gboolean          setting);
 gboolean   gtk_check_menu_item_get_inconsistent  (GtkCheckMenuItem *check_menu_item);
 void       gtk_check_menu_item_set_draw_as_radio (GtkCheckMenuItem *check_menu_item,
-						  gboolean          draw_radio_indicator);
+						  gboolean          draw_as_radio);
 gboolean   gtk_check_menu_item_get_draw_as_radio (GtkCheckMenuItem *check_menu_item);
     
 
diff --git a/gtk/gtkcolorbutton.c b/gtk/gtkcolorbutton.c
index b6896279d..c9cd5cdb7 100644
--- a/gtk/gtkcolorbutton.c
+++ b/gtk/gtkcolorbutton.c
@@ -50,6 +50,8 @@
 #define CHECK_DARK  21845  /* 65535 / 3     */
 #define CHECK_LIGHT 43690 
 
+#define GTK_COLOR_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButtonPrivate))
+
 struct _GtkColorButtonPrivate 
 {
   GdkPixbuf *pixbuf;    /* Pixbuf for rendering sample */
diff --git a/gtk/gtkcolorbutton.h b/gtk/gtkcolorbutton.h
index ed67ccfda..be8ec8fe7 100644
--- a/gtk/gtkcolorbutton.h
+++ b/gtk/gtkcolorbutton.h
@@ -49,7 +49,6 @@ G_BEGIN_DECLS
 #define GTK_IS_COLOR_BUTTON(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_COLOR_BUTTON))
 #define GTK_IS_COLOR_BUTTON_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_COLOR_BUTTON))
 #define GTK_COLOR_BUTTON_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButtonClass))
-#define GTK_COLOR_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButtonPrivate))
 
 typedef struct _GtkColorButton          GtkColorButton;
 typedef struct _GtkColorButtonClass     GtkColorButtonClass;
diff --git a/gtk/gtkfontbutton.c b/gtk/gtkfontbutton.c
index 05bfc3f42..fea8f2087 100644
--- a/gtk/gtkfontbutton.c
+++ b/gtk/gtkfontbutton.c
@@ -44,6 +44,8 @@
 #include <string.h>
 #include <stdio.h>
 
+#define GTK_FONT_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_FONT_BUTTON, GtkFontButtonPrivate))
+
 struct _GtkFontButtonPrivate 
 {
   gchar         *title;
diff --git a/gtk/gtkfontbutton.h b/gtk/gtkfontbutton.h
index 896ef335d..8952569b9 100644
--- a/gtk/gtkfontbutton.h
+++ b/gtk/gtkfontbutton.h
@@ -41,7 +41,6 @@ G_BEGIN_DECLS
 #define GTK_IS_FONT_BUTTON(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_FONT_BUTTON))
 #define GTK_IS_FONT_BUTTON_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_FONT_BUTTON))
 #define GTK_FONT_BUTTON_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_FONT_BUTTON, GtkFontButtonClass))
-#define GTK_FONT_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_FONT_BUTTON, GtkFontButtonPrivate))
 
 typedef struct _GtkFontButton        GtkFontButton;
 typedef struct _GtkFontButtonClass   GtkFontButtonClass;
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index 78dc4d1c0..ea9297be3 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -413,8 +413,8 @@ module_build_la_path (const gchar *directory,
  * @name: the name of the module
  * @type: the type of the module, for instance 'modules', 'engines', immodules'
  * 
- * Looks for a dynamically module named @name of type @type in the standard GTK+
- *  module search path.
+ * Looks for a dynamically loadable module named @name of type @type in the
+ * standard GTK+ module search path.
  * 
  * Return value: the pathname to the found module, or %NULL if it wasn't found.
  *  Free with g_free().
@@ -611,8 +611,8 @@ display_opened_cb (GdkDisplayManager *display_manager,
 
 /**
  * gdk_parse_args:
- * @argc: the number of command line arguments.
- * @argv: the array of command line arguments.
+ * @argc: a pointer to the number of command line arguments.
+ * @argv: a pointer to the array of command line arguments.
  * 
  * Parses command line arguments, and initializes global
  * attributes of GTK+, but does not actually open a connection
@@ -847,11 +847,9 @@ gtk_parse_args (int    *argc,
 /**
  * gtk_init_check:
  * @argc: Address of the <parameter>argc</parameter> parameter of your 
- *   <function>main()</function> function. Changed if any arguments were 
- *   handled.
- * @argv: Address of the <parameter>argv</parameter> parameter of 
- *   <function>main()</function>. Any parameters understood by gtk_init() 
- *   are stripped before return.
+ *   main() function. Changed if any arguments were handled.
+ * @argv: Address of the <parameter>argv</parameter> parameter of main(). 
+ *   Any parameters understood by gtk_init() are stripped before return.
  * 
  * This function does the same work as gtk_init() with only 
  * a single change: It does not terminate the program if the GUI can't be 
@@ -878,15 +876,13 @@ gtk_init_check (int	 *argc,
 /**
  * gtk_init:
  * @argc: Address of the <parameter>argc</parameter> parameter of your 
- *   <function>main()</function> function. Changed if any arguments were 
- *   handled.
- * @argv: Address of the <parameter>argv</parameter> parameter of 
- *   <function>main()</function>. Any parameters understood by gtk_init() 
- *   are stripped before return.
+ *   main() function. Changed if any arguments were handled.
+ * @argv: Address of the <parameter>argv</parameter> parameter of main(). 
+ *   Any parameters understood by gtk_init() are stripped before return.
  * 
  * Call this function before using any other GTK+ functions in your GUI
- * applications.  It will initialize everything needed to operate the toolkit and
- * parses some standard command line options. @argc and 
+ * applications.  It will initialize everything needed to operate the 
+ * toolkit and parses some standard command line options. @argc and 
  * @argv are adjusted accordingly so your own code will 
  * never see those standard arguments.
  *
@@ -989,13 +985,12 @@ gtk_exit (gint errorcode)
  * <literal>setlocale (LC_ALL, "")</literal> but also takes care of the 
  * locale specific setup of the windowing system used by GDK.
  * 
- * Return: a string corresponding to the locale set, typically in the
+ * Returns: a string corresponding to the locale set, typically in the
  * form lang_COUNTRY, where lang is an ISO-639 language code, and
  * COUNTRY is an ISO-3166 country code. On Unix, this form matches the
- * result of the <function>setlocale()</function>; it is also used on
- * other machines, such as Windows, where the C library returns a
- * different result. The string is owned by GTK+ and should not be
- * modified or freed.
+ * result of the setlocale(); it is also used on other machines, such as 
+ * Windows, where the C library returns a different result. The string is 
+ * owned by GTK+ and should not be modified or freed.
  **/
 gchar *
 gtk_set_locale (void)
@@ -1018,11 +1013,11 @@ gtk_set_locale (void)
  * 
  * On Windows, the C library doesn't use any such environment
  * variables, and setting them won't affect the behaviour of functions
- * like <function>ctime()</function>. The user sets the locale through
- * the Regional Options in the Control Panel. The C library (in the
- * <function>setlocale()</function> function) does not use country and
- * language codes, but country and language names spelled out in
- * English. However, this function does check the above environment
+ * like ctime(). The user sets the locale through the Regional Options 
+ * in the Control Panel. The C library (in the setlocale() function) 
+ * does not use country and language codes, but country and language 
+ * names spelled out in English. 
+ * However, this function does check the above environment
  * variables, and does return a Unix-style locale string based on
  * either said environment variables or the thread's current locale.
  *
@@ -1071,7 +1066,7 @@ _gtk_get_lc_ctype (void)
  * application.)  The default language is derived from the current
  * locale. It determines, for example, whether GTK+ uses the
  * right-to-left or left-to-right text direction. See
- * _gtk_get_lc_ctype for notes on behaviour on Windows.
+ * _gtk_get_lc_ctype() for notes on behaviour on Windows.
  * 
  * Return value: the default language as a #PangoLanguage, must not be
  * freed
diff --git a/gtk/gtktoggletoolbutton.c b/gtk/gtktoggletoolbutton.c
index 02c076fee..a994b2b90 100644
--- a/gtk/gtktoggletoolbutton.c
+++ b/gtk/gtktoggletoolbutton.c
@@ -34,6 +34,8 @@ enum {
   LAST_SIGNAL
 };
 
+#define GTK_TOGGLE_TOOL_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON, GtkToggleToolButtonPrivate))
+
 struct _GtkToggleToolButtonPrivate
 {
   guint active : 1;
diff --git a/gtk/gtktoggletoolbutton.h b/gtk/gtktoggletoolbutton.h
index 341cdcbeb..0d5b1ad19 100644
--- a/gtk/gtktoggletoolbutton.h
+++ b/gtk/gtktoggletoolbutton.h
@@ -33,7 +33,6 @@ G_BEGIN_DECLS
 #define GTK_IS_TOGGLE_TOOL_BUTTON(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON))
 #define GTK_IS_TOGGLE_TOOL_BUTTON_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON))
 #define GTK_TOGGLE_TOOL_BUTTON_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON, GtkToggleToolButtonClass))
-#define GTK_TOGGLE_TOOL_BUTTON_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOGGLE_TOOL_BUTTON, GtkToggleToolButtonPrivate))
 
 typedef struct _GtkToggleToolButton        GtkToggleToolButton;
 typedef struct _GtkToggleToolButtonClass   GtkToggleToolButtonClass;
diff --git a/gtk/gtktoolbar.c b/gtk/gtktoolbar.c
index bb802079c..dd5e8328d 100644
--- a/gtk/gtktoolbar.c
+++ b/gtk/gtktoolbar.c
@@ -191,6 +191,8 @@ typedef enum {
   NEW_API
 } ApiMode;
 
+#define GTK_TOOLBAR_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOLBAR, GtkToolbarPrivate))
+
 struct _GtkToolbarPrivate
 {
   GList     *items;
diff --git a/gtk/gtktoolbar.h b/gtk/gtktoolbar.h
index fce9b7b2a..f4e64d31d 100644
--- a/gtk/gtktoolbar.h
+++ b/gtk/gtktoolbar.h
@@ -55,7 +55,6 @@ G_BEGIN_DECLS
 #define GTK_IS_TOOLBAR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TOOLBAR))
 #define GTK_IS_TOOLBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_TOOLBAR))
 #define GTK_TOOLBAR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TOOLBAR, GtkToolbarClass))
-#define GTK_TOOLBAR_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOLBAR, GtkToolbarPrivate))
 
 #ifndef GTK_DISABLE_DEPRECATED
 typedef enum
diff --git a/gtk/gtktoolbutton.c b/gtk/gtktoolbutton.c
index 5382b7d11..8fe2b6b74 100644
--- a/gtk/gtktoolbutton.c
+++ b/gtk/gtktoolbutton.c
@@ -76,6 +76,8 @@ static void gtk_tool_button_construct_contents (GtkToolItem *tool_item);
 static GObjectClass *parent_class = NULL;
 static guint         toolbutton_signals[LAST_SIGNAL] = { 0 };
 
+#define GTK_TOOL_BUTTON_GET_PRIVATE(obj)(G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOOL_BUTTON, GtkToolButtonPrivate))
+
 struct _GtkToolButtonPrivate
 {
   GtkWidget *button;
diff --git a/gtk/gtktoolbutton.h b/gtk/gtktoolbutton.h
index 591857aa4..236905bb4 100644
--- a/gtk/gtktoolbutton.h
+++ b/gtk/gtktoolbutton.h
@@ -33,7 +33,6 @@ G_BEGIN_DECLS
 #define GTK_IS_TOOL_BUTTON(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TOOL_BUTTON))
 #define GTK_IS_TOOL_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj), GTK_TYPE_TOOL_BUTTON))
 #define GTK_TOOL_BUTTON_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj), GTK_TYPE_TOOL_BUTTON, GtkToolButtonClass))
-#define GTK_TOOL_BUTTON_GET_PRIVATE(obj)(G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TOOL_BUTTON, GtkToolButtonPrivate))
 
 typedef struct _GtkToolButton        GtkToolButton;
 typedef struct _GtkToolButtonClass   GtkToolButtonClass;
diff --git a/gtk/gtktoolitem.c b/gtk/gtktoolitem.c
index a75cd6232..3f6652001 100644
--- a/gtk/gtktoolitem.c
+++ b/gtk/gtktoolitem.c
@@ -43,6 +43,8 @@ enum {
   PROP_IS_IMPORTANT
 };
 
+#define GTK_TOOL_ITEM_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOL_ITEM, GtkToolItemPrivate))
+
 struct _GtkToolItemPrivate
 {
   gchar *tip_text;
@@ -779,7 +781,7 @@ gtk_tool_item_get_is_important (GtkToolItem *tool_item)
 /**
  * gtk_tool_item_set_is_important:
  * @tool_item: a #GtkToolItem
- * @is_imporatnt: whether the tool item should be considered important
+ * @is_important: whether the tool item should be considered important
  * 
  * Sets whether @tool_item should be considered important. The #GtkToolButton
  * class uses this property to determine whether to show or hide its label
diff --git a/gtk/gtktoolitem.h b/gtk/gtktoolitem.h
index ea5d4c642..9d9b34ecc 100644
--- a/gtk/gtktoolitem.h
+++ b/gtk/gtktoolitem.h
@@ -33,7 +33,6 @@
 #define GTK_IS_TOOL_ITEM(o)           (G_TYPE_CHECK_INSTANCE_TYPE ((o), GTK_TYPE_TOOL_ITEM))
 #define GTK_IS_TOOL_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((o), GTK_TYPE_TOOL_ITEM))
 #define GTK_TOOL_ITEM_GET_CLASS(o)    (G_TYPE_INSTANCE_GET_CLASS((o), GTK_TYPE_TOOL_ITEM, GtkToolItemClass))
-#define GTK_TOOL_ITEM_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOL_ITEM, GtkToolItemPrivate))
 
 typedef struct _GtkToolItem        GtkToolItem;
 typedef struct _GtkToolItemClass   GtkToolItemClass;