Minor documentation fixes. (#80021, Yao Zhang; #75567, #75279, Vitaly

2002-09-01  Soeren Sandmann  <sandmann@daimi.au.dk>

	* gtk/gtkimcontext.c, gtk/gtktreeviewcolumn.c:

	Minor documentation fixes.
	(#80021, Yao Zhang; #75567, #75279, Vitaly Tishkov)

ChangeLog

@@ -1,3 +1,10 @@
+2002-09-01  Soeren Sandmann  <sandmann@daimi.au.dk>
+
+	* gtk/gtkimcontext.c, gtk/gtktreeviewcolumn.c:
+
+	Minor documentation fixes. 
+	(#80021, Yao Zhang; #75567, #75279, Vitaly Tishkov)
+
 2002-09-28  Matthias Clasen  <maclas@gmx.de>
 
 	* gdk/x11/gdkwindow-x11.c (_gdk_windowing_window_init): Make

ChangeLog.pre-2-10

@@ -1,3 +1,10 @@
+2002-09-01  Soeren Sandmann  <sandmann@daimi.au.dk>
+
+	* gtk/gtkimcontext.c, gtk/gtktreeviewcolumn.c:
+
+	Minor documentation fixes. 
+	(#80021, Yao Zhang; #75567, #75279, Vitaly Tishkov)
+
 2002-09-28  Matthias Clasen  <maclas@gmx.de>
 
 	* gdk/x11/gdkwindow-x11.c (_gdk_windowing_window_init): Make

ChangeLog.pre-2-2

@@ -1,3 +1,10 @@
+2002-09-01  Soeren Sandmann  <sandmann@daimi.au.dk>
+
+	* gtk/gtkimcontext.c, gtk/gtktreeviewcolumn.c:
+
+	Minor documentation fixes. 
+	(#80021, Yao Zhang; #75567, #75279, Vitaly Tishkov)
+
 2002-09-28  Matthias Clasen  <maclas@gmx.de>
 
 	* gdk/x11/gdkwindow-x11.c (_gdk_windowing_window_init): Make

ChangeLog.pre-2-4

@@ -1,3 +1,10 @@
+2002-09-01  Soeren Sandmann  <sandmann@daimi.au.dk>
+
+	* gtk/gtkimcontext.c, gtk/gtktreeviewcolumn.c:
+
+	Minor documentation fixes. 
+	(#80021, Yao Zhang; #75567, #75279, Vitaly Tishkov)
+
 2002-09-28  Matthias Clasen  <maclas@gmx.de>
 
 	* gdk/x11/gdkwindow-x11.c (_gdk_windowing_window_init): Make

ChangeLog.pre-2-6

@@ -1,3 +1,10 @@
+2002-09-01  Soeren Sandmann  <sandmann@daimi.au.dk>
+
+	* gtk/gtkimcontext.c, gtk/gtktreeviewcolumn.c:
+
+	Minor documentation fixes. 
+	(#80021, Yao Zhang; #75567, #75279, Vitaly Tishkov)
+
 2002-09-28  Matthias Clasen  <maclas@gmx.de>
 
 	* gdk/x11/gdkwindow-x11.c (_gdk_windowing_window_init): Make

ChangeLog.pre-2-8

@@ -1,3 +1,10 @@
+2002-09-01  Soeren Sandmann  <sandmann@daimi.au.dk>
+
+	* gtk/gtkimcontext.c, gtk/gtktreeviewcolumn.c:
+
+	Minor documentation fixes. 
+	(#80021, Yao Zhang; #75567, #75279, Vitaly Tishkov)
+
 2002-09-28  Matthias Clasen  <maclas@gmx.de>
 
 	* gdk/x11/gdkwindow-x11.c (_gdk_windowing_window_init): Make

docs/reference/gdk-pixbuf/tmpl/animation.sgml

@@ -20,12 +20,6 @@ Animated images.
     #GdkPixbufLoader
   </para>
 
-<!-- ##### STRUCT GdkPixbufFrame ##### -->
-<para>
- This object describes an individual frame of an animation.
-</para>
-
-
 <!-- ##### STRUCT GdkPixbufAnimation ##### -->
   <para>
     This object describes an animation.

docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml

@@ -365,6 +365,12 @@ XlibRGB
 
 @obj: A GTK+ object.
 
+<!-- ##### STRUCT GdkPixbufFrame ##### -->
+<para>
+ This object describes an individual frame of an animation.
+</para>
+
+
 <!-- ##### ENUM GdkPixbufFrameAction ##### -->
 <para>
 

docs/reference/gdk/tmpl/event_structs.sgml

@@ -466,6 +466,7 @@ Specifies the state of a toplevel window.
 @GDK_WINDOW_STATE_ICONIFIED: the window is minimized.
 @GDK_WINDOW_STATE_MAXIMIZED: the window is maximized.
 @GDK_WINDOW_STATE_STICKY: the window is sticky.
+@GDK_WINDOW_STATE_FULLSCREEN: 
 
 <!-- ##### ENUM GdkSettingAction ##### -->
 <para>

docs/reference/gdk/tmpl/events.sgml

@@ -274,8 +274,10 @@ gdk_event_handler_set().
 </para>
 
 @event: 
-@xid: 
+@winid: 
 @Returns: 
+<!-- # Unused Parameters # -->
+@xid: 
 
 
 <!-- ##### FUNCTION gdk_event_send_client_message_for_display ##### -->
@@ -285,8 +287,10 @@ gdk_event_handler_set().
 
 @display: 
 @event: 
-@xid: 
+@winid: 
 @Returns: 
+<!-- # Unused Parameters # -->
+@xid: 
 
 
 <!-- ##### FUNCTION gdk_event_send_clientmessage_toall ##### -->

docs/reference/gdk/tmpl/fonts.sgml

@@ -584,25 +584,6 @@ relation to the baseline. See gdk_text_extents().
 @Returns: the height of the character in pixels.
 
 
-<!-- ##### FUNCTION gdk_font_full_name_get ##### -->
-<para>
-Returns a comma-separated list of XLFDs for the
-fonts making up a given #GdkFont.
-</para>
-
-@font: a #GdkFont
-@Returns: a newly-allocated string containing a list of XLFDs, 
-  should be freed with gdk_font_full_name_free() when no longer needed.
-
-
-<!-- ##### FUNCTION gdk_font_full_name_free ##### -->
-<para>
-Frees a full font name obtained from gdk_font_full_name_get().
-</para>
-
-@name: a full font name.
-
-
 <!-- ##### TYPEDEF GdkWChar ##### -->
 <para>
 Specifies a wide character type, used to represent character codes.

docs/reference/gdk/tmpl/gdk-unused.sgml

@@ -596,6 +596,23 @@ status information, so the application does not need to do anything.
 </para>
 
 
+<!-- ##### FUNCTION gdk_font_full_name_free ##### -->
+<para>
+Frees a full font name obtained from gdk_font_full_name_get().
+</para>
+
+@name: a full font name.
+
+<!-- ##### FUNCTION gdk_font_full_name_get ##### -->
+<para>
+Returns a comma-separated list of XLFDs for the
+fonts making up a given #GdkFont.
+</para>
+
+@font: a #GdkFont
+@Returns: a newly-allocated string containing a list of XLFDs, 
+  should be freed with gdk_font_full_name_free() when no longer needed.
+
 <!-- ##### FUNCTION gdk_get_client_window ##### -->
 <para>
 
@@ -910,3 +927,12 @@ they will be ignored.
 
 @display: 
 
+<!-- ##### FUNCTION gdkx_visual_get_for_screen ##### -->
+<para>
+
+</para>
+
+@screen: 
+@xvisualid: 
+@Returns: 
+

docs/reference/gdk/tmpl/windows.sgml

@@ -197,6 +197,10 @@ and behaviour of the window. The hint must be set before mapping the window.
 @GDK_WINDOW_TYPE_HINT_DIALOG: Dialog window.
 @GDK_WINDOW_TYPE_HINT_MENU: Window used to implement a menu.
 @GDK_WINDOW_TYPE_HINT_TOOLBAR: Window used to implement toolbars.
+@GDK_WINDOW_TYPE_HINT_SPLASHSCREEN: 
+@GDK_WINDOW_TYPE_HINT_UTILITY: 
+@GDK_WINDOW_TYPE_HINT_DOCK: 
+@GDK_WINDOW_TYPE_HINT_DESKTOP: 
 
 <!-- ##### STRUCT GdkWindowAttr ##### -->
 <para>

docs/reference/gdk/tmpl/x_interaction.sgml

@@ -259,16 +259,6 @@ Returns a #GdkVisual corresponding to a X visual.
 @Returns: the #GdkVisual.
 
 
-<!-- ##### FUNCTION gdkx_visual_get_for_screen ##### -->
-<para>
-
-</para>
-
-@screen: 
-@xvisualid: 
-@Returns: 
-
-
 <!-- ##### FUNCTION gdkx_colormap_get ##### -->
 <para>
 </para>

docs/reference/gtk/tmpl/gtk-unused.sgml

@@ -2638,15 +2638,6 @@ Sets the function that GTK+ will use to load images
 
 @ruler: the gtkruler
 
-<!-- ##### FUNCTION gtk_selection_clear ##### -->
-<para>
-Internal function.
-</para>
-
-@widget: 
-@event: 
-@Returns: 
-
 <!-- ##### FUNCTION gtk_selection_incr_event ##### -->
 <para>
 Internal function.

docs/reference/gtk/tmpl/gtkselection.sgml

@@ -284,6 +284,16 @@ called by applications.
 @widget: a #GtkWidget
 
 
+<!-- ##### FUNCTION gtk_selection_clear ##### -->
+<para>
+Internal function.
+</para>
+
+@widget: 
+@event: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_selection_data_copy ##### -->
 <para>
 Makes a copy of a #GtkSelectionData structure and its data.

docs/reference/gtk/tmpl/gtksettings.sgml

@@ -209,6 +209,11 @@ GtkSettings
 
 </para>
 
+<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkwindow.sgml

@@ -844,6 +844,21 @@ Deprecated alias for gtk_window_set_position().
 
 </para>
 
+<!-- ##### ARG GtkWindow:type-hint ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:skip-taskbar-hint ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:skip-pager-hint ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkWindow:is-active ##### -->
 <para>
 

gtk/gtkimcontext.c

@@ -390,7 +390,8 @@ gtk_im_context_reset (GtkIMContext   *context)
  * @area: new location
  *
  * Notify the input method that a change in cursor 
- * position has been made.
+ * position has been made. The location is relative to the client
+ * window.
  **/
 void
 gtk_im_context_set_cursor_location (GtkIMContext *context,

gtk/gtktreeviewcolumn.c

@@ -1210,8 +1210,9 @@ gtk_tree_view_column_get_cell_info (GtkTreeViewColumn *tree_column,
  * @cell: The #GtkCellRenderer. 
  * @expand: %TRUE if @cell is to be given extra space allocated to box.
  *
- * Packs the @cell into the beginning column.  If @expand is %TRUE, then the
+ * Packs the @cell into the beginning of the column. If @expand is FALSE, then
- * @cell is allocated a share of all available space that the @tree_column has.
+ * the @cell is allocated no more space than it needs. Any unused space is divided
+ * evenly between cells for which @expand is TRUE.
  **/
 void
 gtk_tree_view_column_pack_start (GtkTreeViewColumn *tree_column,
@@ -1243,8 +1244,9 @@ gtk_tree_view_column_pack_start (GtkTreeViewColumn *tree_column,
  * @cell: The #GtkCellRenderer. 
  * @expand: %TRUE if @cell is to be given extra space allocated to box.
  *
- * Packs the @cell into the column.  If @expand is %TRUE, then the @cell is
+ * Adds the @cell to end of the column. If @expand is FALSE, then the @cell
- * allocated a share of all available space that the @tree_column has.
+ * is allocated no more space than it needs. Any unused space is divided
+ * evenly between cells for which @expand is TRUE.
  **/
 void
 gtk_tree_view_column_pack_end (GtkTreeViewColumn  *tree_column,
@@ -2254,9 +2256,9 @@ gtk_tree_view_column_get_sort_order      (GtkTreeViewColumn     *tree_column)
  * @is_expander: %TRUE, if the row has children
  * @is_expanded: %TRUE, if the row has visible children
  * 
- * Sets the cell renderer based on the @tree_model and @tree_node.  That is, for
+ * Sets the cell renderer based on the @tree_model and @iter.  That is, for
  * every attribute mapping in @tree_column, it will get a value from the set
- * column on the @tree_node, and use that value to set the attribute on the cell
+ * column on the @iter, and use that value to set the attribute on the cell
  * renderer.  This is used primarily by the #GtkTreeView.
  **/
 void