Document.

2003-04-13  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtktreeviewcolumn.c
	(gtk_tree_view_column_cell_get_position): Document.

	* gtk/gtktextbuffer.c (gtk_text_buffer_select_range):
	* gtk/gtktreeviewcolumn.c (gtk_tree_view_column_[sg]et_expand):
	* gtk/gtkbutton.c (gtk_button_[sg]et_focus_on_click): Document
	these as 2.4 additions.

diff --git a/ChangeLog b/ChangeLog
index d0d824c16255a81836d844ea3c667a34386ca4f4..97a45ab3facba765be5be5ead844fa1704596d6e 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2003-04-13  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_cell_get_position): Document. 
+
+       * gtk/gtktextbuffer.c (gtk_text_buffer_select_range): 
+       * gtk/gtktreeviewcolumn.c (gtk_tree_view_column_[sg]et_expand): 
+       * gtk/gtkbutton.c (gtk_button_[sg]et_focus_on_click): Document
+       these as 2.4 additions.
+
 2003-04-09  Matthias Clasen  <maclas@gmx.de>
 
        * INSTALL.in: Fix the real thing.

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index d0d824c16255a81836d844ea3c667a34386ca4f4..97a45ab3facba765be5be5ead844fa1704596d6e 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,13 @@
+2003-04-13  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_cell_get_position): Document. 
+
+       * gtk/gtktextbuffer.c (gtk_text_buffer_select_range): 
+       * gtk/gtktreeviewcolumn.c (gtk_tree_view_column_[sg]et_expand): 
+       * gtk/gtkbutton.c (gtk_button_[sg]et_focus_on_click): Document
+       these as 2.4 additions.
+
 2003-04-09  Matthias Clasen  <maclas@gmx.de>
 
        * INSTALL.in: Fix the real thing.

diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index d0d824c16255a81836d844ea3c667a34386ca4f4..97a45ab3facba765be5be5ead844fa1704596d6e 100644 (file)
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,13 @@
+2003-04-13  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_cell_get_position): Document. 
+
+       * gtk/gtktextbuffer.c (gtk_text_buffer_select_range): 
+       * gtk/gtktreeviewcolumn.c (gtk_tree_view_column_[sg]et_expand): 
+       * gtk/gtkbutton.c (gtk_button_[sg]et_focus_on_click): Document
+       these as 2.4 additions.
+
 2003-04-09  Matthias Clasen  <maclas@gmx.de>
 
        * INSTALL.in: Fix the real thing.

diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index d0d824c16255a81836d844ea3c667a34386ca4f4..97a45ab3facba765be5be5ead844fa1704596d6e 100644 (file)
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,13 @@
+2003-04-13  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_cell_get_position): Document. 
+
+       * gtk/gtktextbuffer.c (gtk_text_buffer_select_range): 
+       * gtk/gtktreeviewcolumn.c (gtk_tree_view_column_[sg]et_expand): 
+       * gtk/gtkbutton.c (gtk_button_[sg]et_focus_on_click): Document
+       these as 2.4 additions.
+
 2003-04-09  Matthias Clasen  <maclas@gmx.de>
 
        * INSTALL.in: Fix the real thing.

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index d0d824c16255a81836d844ea3c667a34386ca4f4..97a45ab3facba765be5be5ead844fa1704596d6e 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,13 @@
+2003-04-13  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_cell_get_position): Document. 
+
+       * gtk/gtktextbuffer.c (gtk_text_buffer_select_range): 
+       * gtk/gtktreeviewcolumn.c (gtk_tree_view_column_[sg]et_expand): 
+       * gtk/gtkbutton.c (gtk_button_[sg]et_focus_on_click): Document
+       these as 2.4 additions.
+
 2003-04-09  Matthias Clasen  <maclas@gmx.de>
 
        * INSTALL.in: Fix the real thing.

diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index 165f60e270d0a68b9d10a9877767372d8b60a7c1..84ebed24ea0160f3e60ad08249124ade4c6e794c 100644 (file)
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -1262,6 +1262,8 @@ gtk_button_get_use_stock (GtkButton *button)
  * Making mouse clicks not grab focus is useful in places like toolbars where
  * you don't want the keyboard focus removed from the main area of the
  * application.
+ *
+ * Since: 2.4
  **/
 void
 gtk_button_set_focus_on_click (GtkButton *button,
@@ -1288,6 +1290,8 @@ gtk_button_set_focus_on_click (GtkButton *button,
  *
  * Return value: %TRUE if the button grabs focus when it is clicked with
  *               the mouse.
+ *
+ * Since: 2.4
  **/
 gboolean
 gtk_button_get_focus_on_click (GtkButton *button)

diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index ec50c419cfbf9b49c84592e6a18ebf66a892ea9a..9f0b12738344b2f2b3983afad3358f71cbce8745 100644 (file)
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -2026,6 +2026,8 @@ gtk_text_buffer_place_cursor (GtkTextBuffer     *buffer,
  * inefficient since the temporarily-selected region will force stuff
  * to be recalculated. This function moves them as a unit, which can
  * be optimized.
+ *
+ * Since: 2.4
  **/
 void
 gtk_text_buffer_select_range (GtkTextBuffer     *buffer,

diff --git a/gtk/gtktreeviewcolumn.c b/gtk/gtktreeviewcolumn.c
index d6e07c4df00590075e3967fca1db1d5aa4df80d0..6195bed871842ab1df4e66299b357fbe3125638d 100644 (file)
--- a/gtk/gtktreeviewcolumn.c
+++ b/gtk/gtktreeviewcolumn.c
@@ -1642,9 +1642,9 @@ gtk_tree_view_column_set_resizable (GtkTreeViewColumn *tree_column,
  * gtk_tree_view_column_get_resizable:
  * @tree_column: A #GtkTreeViewColumn
  * 
- * Returns #TRUE if the @tree_column can be resized by the end user.
+ * Returns %TRUE if the @tree_column can be resized by the end user.
  * 
- * Return value: #TRUE, if the @tree_column can be resized.
+ * Return value: %TRUE, if the @tree_column can be resized.
  **/
 gboolean
 gtk_tree_view_column_get_resizable (GtkTreeViewColumn *tree_column)
@@ -1956,6 +1956,8 @@ gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column)
  * amongst all columns that have the expand set to %TRUE.  If no column has this
  * option set, then the last column gets all extra space.  By default, every
  * column is created with this %FALSE.
+ *
+ * Since: 2.4
  **/
 void
 gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column,
@@ -1985,6 +1987,8 @@ gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column,
  * Return %TRUE if the column expands to take any available space.
  * 
  * Return value: %TRUE, if the column expands
+ *
+ * Since: 2.4
  **/
 gboolean
 gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column)
@@ -2124,9 +2128,9 @@ gtk_tree_view_column_get_alignment (GtkTreeViewColumn *tree_column)
 /**
  * gtk_tree_view_column_set_reorderable:
  * @tree_column: A #GtkTreeViewColumn
- * @reorderable: #TRUE, if the column can be reordered.
+ * @reorderable: %TRUE, if the column can be reordered.
  * 
- * If @reorderable is #TRUE, then the column can be reordered by the end user
+ * If @reorderable is %TRUE, then the column can be reordered by the end user
  * dragging the header.
  **/
 void
@@ -2150,9 +2154,9 @@ gtk_tree_view_column_set_reorderable (GtkTreeViewColumn *tree_column,
  * gtk_tree_view_column_get_reorderable:
  * @tree_column: A #GtkTreeViewColumn
  * 
- * Returns #TRUE if the @tree_column can be reordered by the user.
+ * Returns %TRUE if the @tree_column can be reordered by the user.
  * 
- * Return value: #TRUE if the @tree_column can be reordered by the user.
+ * Return value: %TRUE if the @tree_column can be reordered by the user.
  **/
 gboolean
 gtk_tree_view_column_get_reorderable (GtkTreeViewColumn *tree_column)
@@ -3209,11 +3213,11 @@ _gtk_tree_view_column_cell_draw_focus (GtkTreeViewColumn       *tree_column,
  * gtk_tree_view_column_cell_is_visible:
  * @tree_column: A #GtkTreeViewColumn
  * 
- * Returns #TRUE if any of the cells packed into the @tree_column are visible.
+ * Returns %TRUE if any of the cells packed into the @tree_column are visible.
  * For this to be meaningful, you must first initialize the cells with
  * gtk_tree_view_column_cell_set_cell_data()
  * 
- * Return value: #TRUE, if any of the cells packed into the @tree_column are currently visible
+ * Return value: %TRUE, if any of the cells packed into the @tree_column are currently visible
  **/
 gboolean
 gtk_tree_view_column_cell_is_visible (GtkTreeViewColumn *tree_column)
@@ -3390,6 +3394,20 @@ _gtk_tree_view_column_get_neighbor_sizes (GtkTreeViewColumn *column,
     }
 }
 
+/**
+ * gtk_tree_view_column_cell_get_position:
+ * @tree_column: a #GtkTreeViewColumn
+ * @cell: a #GtkCellRenderer
+ * @start_pos: return location for the horizontal position of @cell within
+ *            @tree_column, may be %NULL
+ * @width: return location for the width of @cell, may be %NULL
+ *
+ * Obtains the horizontal position and size of a cell in a column. If the
+ * cell is not found in the column, @start_pos and @width are not changed and
+ * %FALSE is returned.
+ * 
+ * Return value: %TRUE if @cell belongs to @tree_column.
+ */
 gboolean
 gtk_tree_view_column_cell_get_position (GtkTreeViewColumn *tree_column,
                                        GtkCellRenderer   *cell_renderer,
@@ -3425,3 +3443,4 @@ gtk_tree_view_column_cell_get_position (GtkTreeViewColumn *tree_column,
 
   return found_cell;
 }
+