GNOME.org
 

gtk+ r20639 - in trunk: . gtk

Author: johan
Date: Fri Jun 20 13:54:31 2008
New Revision: 20639
URL: http://svn.gnome.org/viewvc/gtk+?rev=20639&view=rev

Log:
2008-06-20  Johan Dahlin  <jdahlin async com br>

    * gtk/gtkaccelgroup.c:
    * gtk/gtkcolorseldialog.c:
    * gtk/gtkcontainer.c:
    * gtk/gtkdialog.c:
    * gtk/gtkentry.c (gtk_entry_class_init):
    * gtk/gtkfontsel.c:
    * gtk/gtkhandlebox.c:
    * gtk/gtklayout.c:
    * gtk/gtkmenu.c (gtk_menu_class_init):
    * gtk/gtkmenuitem.c (gtk_menu_item_class_init):
    * gtk/gtkplug.c (gtk_plug_class_init):
    * gtk/gtkselection.c:
    * gtk/gtksocket.c:
    * gtk/gtktreeselection.c:
    * gtk/gtkwidget.c (gtk_widget_class_init):
    * gtk/gtkwindow.c:
    Add missing Since: gtk-doc markup for newly added GSEAL API.
    Change all Since: GSEAL-branch to Since: 2.14.



Modified:
   trunk/ChangeLog
   trunk/gtk/gtkaccelgroup.c
   trunk/gtk/gtkcolorseldialog.c
   trunk/gtk/gtkcontainer.c
   trunk/gtk/gtkdialog.c
   trunk/gtk/gtkentry.c
   trunk/gtk/gtkfontsel.c
   trunk/gtk/gtkhandlebox.c
   trunk/gtk/gtklayout.c
   trunk/gtk/gtkmenu.c
   trunk/gtk/gtkmenuitem.c
   trunk/gtk/gtkplug.c
   trunk/gtk/gtkselection.c
   trunk/gtk/gtksocket.c
   trunk/gtk/gtktreeselection.c
   trunk/gtk/gtkwidget.c
   trunk/gtk/gtkwindow.c

Modified: trunk/gtk/gtkaccelgroup.c
==============================================================================
--- trunk/gtk/gtkaccelgroup.c	(original)
+++ trunk/gtk/gtkaccelgroup.c	Fri Jun 20 13:54:31 2008
@@ -225,6 +225,8 @@
  *
  * Locks are added and removed using gtk_accel_group_lock() and
  * gtk_accel_group_unlock().
+ *
+ * Since: 2.14
  */
 gboolean
 gtk_accel_group_get_is_locked (GtkAccelGroup *accel_group)
@@ -240,6 +242,8 @@
  *
  * @returns: #GdkModifierType representing the mask for this
  * @accel_group. For example, #GDK_CONTROL_MASK, #GDK_SHIFT_MASK, etc.
+ *
+ * Since: 2.14
  */
 GdkModifierType
 gtk_accel_group_get_modifier_mask (GtkAccelGroup *accel_group)

Modified: trunk/gtk/gtkcolorseldialog.c
==============================================================================
--- trunk/gtk/gtkcolorseldialog.c	(original)
+++ trunk/gtk/gtkcolorseldialog.c	Fri Jun 20 13:54:31 2008
@@ -193,7 +193,7 @@
  *
  * Retrieves the #GtkColorSelection widget embedded in the dialog.
  *
- * Since:  GSEAL-branch
+ * Since: 2.14
  **/
 GtkWidget*
 gtk_color_selection_dialog_get_color_selection (GtkColorSelectionDialog *colorsel)

Modified: trunk/gtk/gtkcontainer.c
==============================================================================
--- trunk/gtk/gtkcontainer.c	(original)
+++ trunk/gtk/gtkcontainer.c	Fri Jun 20 13:54:31 2008
@@ -1568,7 +1568,7 @@
  * Returns: The child widget which has the focus
  *          inside @container, or %NULL if none is set.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_container_get_focus_child (GtkContainer *container)

Modified: trunk/gtk/gtkdialog.c
==============================================================================
--- trunk/gtk/gtkdialog.c	(original)
+++ trunk/gtk/gtkdialog.c	Fri Jun 20 13:54:31 2008
@@ -1487,7 +1487,7 @@
  *
  * Returns: the action area.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_dialog_get_action_area (GtkDialog *dialog)
@@ -1508,7 +1508,7 @@
  * This function similar to gtk_box_pack_start() packs @widget
  * with reference to the start of @dialog.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 void
 gtk_dialog_pack_start (GtkDialog *dialog,
@@ -1535,7 +1535,7 @@
  * This function similar to gtk_box_pack_end() packs @widget
  * with reference to the end of @dialog.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 void
 gtk_dialog_pack_end (GtkDialog *dialog,

Modified: trunk/gtk/gtkentry.c
==============================================================================
--- trunk/gtk/gtkentry.c	(original)
+++ trunk/gtk/gtkentry.c	Fri Jun 20 13:54:31 2008
@@ -639,7 +639,7 @@
    *
    * If text is overwritten when typing in the #GtkEntry.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    */
   g_object_class_install_property (gobject_class,
                                    PROP_OVERWRITE_MODE,
@@ -653,7 +653,7 @@
    *
    * The length of the text in the #GtkEntry.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    */
   g_object_class_install_property (gobject_class,
                                    PROP_TEXT_LENGTH,
@@ -4679,7 +4679,7 @@
  * 
  * Sets whether the text is overwritten when typing in the #GtkEntry.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 void
 gtk_entry_set_overwrite_mode (GtkEntry *entry,
@@ -4703,7 +4703,7 @@
  * 
  * Return value: whether the text is overwritten when typing.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 gboolean
 gtk_entry_get_overwrite_mode (GtkEntry *entry)
@@ -4809,7 +4809,7 @@
  * Return value: the current number of characters
  *               in #GtkEntry, or 0 if there are none.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 guint16
 gtk_entry_get_text_length (GtkEntry *entry)

Modified: trunk/gtk/gtkfontsel.c
==============================================================================
--- trunk/gtk/gtkfontsel.c	(original)
+++ trunk/gtk/gtkfontsel.c	Fri Jun 20 13:54:31 2008
@@ -1129,7 +1129,9 @@
  * This returns the #GtkEntry that allows the user to manually enter
  * the font family they want to use.
  * 
- * Return value: A #GtkWidget. 
+ * Return value: A #GtkWidget.
+ *
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_font_selection_get_family_entry (GtkFontSelection *fontsel)
@@ -1147,6 +1149,8 @@
  * example, 'Sans', 'Serif', etc.
  * 
  * Return value: A #GtkWidget. 
+ *
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_font_selection_get_family_list (GtkFontSelection *fontsel)
@@ -1164,6 +1168,8 @@
  * configuration of the font style.
  * 
  * Return value: A #GtkWidget. 
+ *
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_font_selection_get_face_entry (GtkFontSelection *fontsel)
@@ -1181,6 +1187,8 @@
  * the selected font. For example, 'Regular', 'Bold', etc.
  * 
  * Return value: A #GtkWidget. 
+ *
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_font_selection_get_face_list (GtkFontSelection *fontsel)
@@ -1198,6 +1206,8 @@
  * number manually instead of selecting it from the list of font sizes. 
  * 
  * Return value: A #GtkWidget. 
+ *
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_font_selection_get_size_entry (GtkFontSelection *fontsel)
@@ -1214,6 +1224,8 @@
  * This returns the #GtkTreeeView used to list font sizes. 
  * 
  * Return value: A #GtkWidget. 
+ *
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_font_selection_get_size_list (GtkFontSelection *fontsel)
@@ -1230,6 +1242,8 @@
  * This returns the #GtkEntry used to display the font as a preview.
  *
  * Return value: A #GtkWidget. 
+ *
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_font_selection_get_preview_entry (GtkFontSelection *fontsel)
@@ -1245,6 +1259,8 @@
  * 
  * Return value: A #PangoFontFamily representing the selected font
  * family. Font families are a collection of font faces.
+ *
+ * Since: 2.14
  **/
 PangoFontFamily *
 gtk_font_selection_get_family (GtkFontSelection *fontsel)
@@ -1260,6 +1276,8 @@
  * 
  * Return value: A #PangoFontFace representing the selected font group
  * details (i.e. family, slant, weight, width, etc).   
+ *
+ * Since: 2.14
  **/
 PangoFontFace *
 gtk_font_selection_get_face (GtkFontSelection *fontsel)
@@ -1275,6 +1293,8 @@
  * 
  * Return value: A #gint representing the font size selected, or -1
  * if not.
+ *
+ * Since: 2.14
  **/
 gint
 gtk_font_selection_get_size (GtkFontSelection *fontsel)
@@ -1583,6 +1603,8 @@
  * @fsd: a #GtkFontSelectionDialog
  *
  * Return value: the #GtkWidget used in the dialog for the 'OK' button.
+ *
+ * Since: 2.14
  */
 GtkWidget *
 gtk_font_selection_dialog_get_ok_button (GtkFontSelectionDialog *fsd)
@@ -1597,6 +1619,8 @@
  * @fsd: a #GtkFontSelectionDialog
  *
  * Return value: the #GtkWidget used in the dialog for the 'Apply' button.
+ *
+ * Since: 2.14
  */
 GtkWidget *
 gtk_font_selection_dialog_get_apply_button (GtkFontSelectionDialog *fsd)

Modified: trunk/gtk/gtkhandlebox.c
==============================================================================
--- trunk/gtk/gtkhandlebox.c	(original)
+++ trunk/gtk/gtkhandlebox.c	Fri Jun 20 13:54:31 2008
@@ -870,7 +870,7 @@
  *
  * Return value: %TRUE if the child is currently detached, otherwise %FALSE
  *
- * Since:  GSEAL-branch
+ * Since: 2.14
  **/
 gboolean
 gtk_handle_box_get_child_detached (GtkHandleBox *handle_box)

Modified: trunk/gtk/gtklayout.c
==============================================================================
--- trunk/gtk/gtklayout.c	(original)
+++ trunk/gtk/gtklayout.c	Fri Jun 20 13:54:31 2008
@@ -150,9 +150,11 @@
  * Retrieve the bin window of the layout used for drawing operations.
  * 
  * Return value: a #GdkWindow
+ *
+ * Since: 2.14
  **/
 GdkWindow*
-gtk_layout_get_bin_window (GtkLayout     *layout)
+gtk_layout_get_bin_window (GtkLayout *layout)
 {
   g_return_val_if_fail (GTK_IS_LAYOUT (layout), NULL);
 

Modified: trunk/gtk/gtkmenu.c
==============================================================================
--- trunk/gtk/gtkmenu.c	(original)
+++ trunk/gtk/gtkmenu.c	Fri Jun 20 13:54:31 2008
@@ -493,7 +493,7 @@
    *
    * The currently selected menu item.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_ACTIVE,
@@ -508,7 +508,7 @@
    *
    * The accel group holding accelerators for the menu.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_ACCEL_GROUP,
@@ -523,7 +523,7 @@
    *
    * An accel path used to conveniently construct accel paths of child items.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_ACCEL_PATH,
@@ -538,7 +538,7 @@
    *
    * The widget the menu is attached to.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_ACCEL_PATH,
@@ -576,7 +576,7 @@
    *
    * The monitor the menu will be popped up on.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_MONITOR,
@@ -1767,11 +1767,11 @@
 
 /**
  * gtk_menu_get_accel_path
- * @menu:       a valid #GtkMenu
+ * @menu: a valid #GtkMenu
  *
  * Retrieves the accelerator path set on the menu.
  *
- * Since:  GSEAL-branch
+ * Since: 2.14
  */
 const gchar*
 gtk_menu_get_accel_path (GtkMenu     *menu)
@@ -5051,10 +5051,10 @@
  *
  * Retrieves the number of the monitor on which to show the menu.
  *
- * Since: GSEAL-branch
- *
  * Returns: the number of the monitor on which the menu should
  *    be popped up or -1
+ *
+ * Since: 2.14
  **/
 gint
 gtk_menu_get_monitor (GtkMenu *menu)

Modified: trunk/gtk/gtkmenuitem.c
==============================================================================
--- trunk/gtk/gtkmenuitem.c	(original)
+++ trunk/gtk/gtkmenuitem.c	Fri Jun 20 13:54:31 2008
@@ -196,7 +196,7 @@
    *
    * Sets whether the menu item appears justified at the right side of a menu bar.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_RIGHT_JUSTIFIED,
@@ -228,7 +228,7 @@
    * changes of the menu item's accelerator caused by the user can be
    * identified and saved to persistant storage.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_ACCEL_PATH,
@@ -1688,6 +1688,8 @@
  *
  * Returns: the accelerator path corresponding to this menu item's
  *              functionality, or %NULL if not set
+ *
+ * Since: 2.14
  */
 G_CONST_RETURN gchar *
 gtk_menu_item_get_accel_path (GtkMenuItem *menu_item)

Modified: trunk/gtk/gtkplug.c
==============================================================================
--- trunk/gtk/gtkplug.c	(original)
+++ trunk/gtk/gtkplug.c	Fri Jun 20 13:54:31 2008
@@ -157,7 +157,7 @@
    *
    * The window of the socket the plug is embedded in.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    */
   g_object_class_install_property (gobject_class,
 				   PROP_SOCKET_WINDOW,
@@ -270,6 +270,8 @@
  * Determines whether the plug is embedded in a socket.
  *
  * Return value: %TRUE if the plug is embedded in a socket
+ *
+ * Since: 2.14
  **/
 gboolean
 gtk_plug_get_embedded (GtkPlug *plug)
@@ -286,6 +288,8 @@
  * Retrieves the socket the plug is embedded in.
  *
  * Return value: the window of the socket, or %NULL
+ *
+ * Since: 2.14
  **/
 GdkWindow *
 gtk_plug_get_socket_window (GtkPlug *plug)

Modified: trunk/gtk/gtkselection.c
==============================================================================
--- trunk/gtk/gtkselection.c	(original)
+++ trunk/gtk/gtkselection.c	Fri Jun 20 13:54:31 2008
@@ -1115,7 +1115,7 @@
  *
  * Retrieves the target of the selection.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GdkAtom
 gtk_selection_data_get_target (GtkSelectionData *selection_data)
@@ -1131,7 +1131,7 @@
  *
  * Retrieves the data type of the selection.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GdkAtom
 gtk_selection_data_get_data_type (GtkSelectionData *selection_data)
@@ -1147,7 +1147,7 @@
  *
  * Retrieves the format of the selection.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 gint
 gtk_selection_data_get_format (GtkSelectionData *selection_data)
@@ -1166,7 +1166,7 @@
  *
  * If @length is not %NULL it is filled with the length of data.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 const guchar*
 gtk_selection_data_get_data (GtkSelectionData *selection_data,
@@ -1186,7 +1186,7 @@
  *
  * Retrieves the display of the selection.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GdkDisplay *
 gtk_selection_data_get_display (GtkSelectionData *selection_data)

Modified: trunk/gtk/gtksocket.c
==============================================================================
--- trunk/gtk/gtksocket.c	(original)
+++ trunk/gtk/gtksocket.c	Fri Jun 20 13:54:31 2008
@@ -309,7 +309,7 @@
  *
  * Return value: the window of the plug if available, or %NULL
  *
- * Since:  GSEAL-branch
+ * Since:  2.14
  **/
 GdkWindow*
 gtk_socket_get_plug_window (GtkSocket *socket)

Modified: trunk/gtk/gtktreeselection.c
==============================================================================
--- trunk/gtk/gtktreeselection.c	(original)
+++ trunk/gtk/gtktreeselection.c	Fri Jun 20 13:54:31 2008
@@ -282,7 +282,7 @@
  *
  * Return value: The function.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GtkTreeSelectionFunc
 gtk_tree_selection_get_select_function (GtkTreeSelection *selection)

Modified: trunk/gtk/gtkwidget.c
==============================================================================
--- trunk/gtk/gtkwidget.c	(original)
+++ trunk/gtk/gtkwidget.c	Fri Jun 20 13:54:31 2008
@@ -679,7 +679,7 @@
    *
    * The widget's window if it is realized, %NULL otherwise.
    *
-   * Since: GSEAL-branch
+   * Since: 2.14
    */
   g_object_class_install_property (gobject_class,
 				   PROP_WINDOW,
@@ -9894,7 +9894,7 @@
  *
  * Return value: widget's allocation
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  */
 GtkAllocation
 gtk_widget_get_allocation (GtkWidget *widget)
@@ -9913,7 +9913,7 @@
  *
  * Return value: @widget's window.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  */
 GdkWindow*
 gtk_widget_get_window (GtkWidget *widget)

Modified: trunk/gtk/gtkwindow.c
==============================================================================
--- trunk/gtk/gtkwindow.c	(original)
+++ trunk/gtk/gtkwindow.c	Fri Jun 20 13:54:31 2008
@@ -1522,7 +1522,7 @@
  *
  * Returns: the default widget, or %NULL if there is none.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GtkWidget *
 gtk_window_get_default (GtkWindow *window)
@@ -7464,7 +7464,7 @@
  *
  * Returns: A newly-allocated list of windows inside the group.
  *
- * Since: GSEAL-branch
+ * Since: 2.14
  **/
 GList *
 gtk_window_group_list_windows (GtkWindowGroup *window_group)
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]