[maemo-commits] [maemo-commits] r10729 - in projects/haf/branches/gtk+/maemo-gtk-2-10: . docs/reference docs/reference/gtk docs/reference/gtk/tmpl gtk

From: subversion at stage.maemo.org subversion at stage.maemo.org
Date: Thu Mar 22 18:37:37 EET 2007
Author: tko
Date: 2007-03-22 18:37:32 +0200 (Thu, 22 Mar 2007)
New Revision: 10729

Modified:
   projects/haf/branches/gtk+/maemo-gtk-2-10/ChangeLog
   projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/ChangeLog
   projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-docs.sgml
   projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-sections.txt
   projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkenums.sgml
   projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkimcontext.sgml
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkbutton.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkcombobox.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkdialog.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkentry.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkfilechooserutils.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkimcontext.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkrange.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktextview.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktreeview.c
   projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkwidget.c
Log:
API documentation updates.

ChangeLog:

2007-03-22  Tommi Komulainen  <tommi.komulainen at nokia.com>

	API documentation updates.

	* gtk/gtkbutton.c (:image, :image-spacing, :tree-view-separator-area):
	* gtk/gtktreeview.c (:separator-height):
	Use single colon in the API doclet. Double colon is for signals and
	gets gtk-doc confused leaving the documentation out of the generated
	API docs.

	* gtk/gtkbutton.c
	* gtk/gtkcombobox.c
	* gtk/gtkdialog.c
	* gtk/gtkentry.c
	* gtk/gtkfilechooserutils.c
	* gtk/gtkimcontext.c
	* gtk/gtkrange.c
	* gtk/gtktextview.c
	* gtk/gtktreeview.c
	* gtk/gtkwidget.c: Tag all maemo additions (not backports) as
	'Stability: Unstable'

	* gtk/gtkwidget.c (::insensitive-press, :tap-and-hold,
	gtk_widget_insensitive_press): Tag as deprecated.

docs/reference/ChangeLog:

2007-03-22  Tommi Komulainen  <tommi.komulainen at nokia.com>

	* gtk/gtk-docs.sgml: Add 2.12 and maemo addition indices.
	* gtk/gtk-sections.txt: Add new symbols so that they get documented.
	* gtk/tmpl/gtkenums.sgml: Document GTK_BUTTONBOX_CENTER and
	GtkInvalidInputType
	* gtk/tmpl/gtkimcontext.sgml: Document GtkIMContextClipboardOperation
	and HildonGtkInputMode


Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/ChangeLog
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/ChangeLog	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/ChangeLog	2007-03-22 16:37:32 UTC (rev 10729)
@@ -1,3 +1,28 @@
+2007-03-22  Tommi Komulainen  <tommi.komulainen at nokia.com>
+
+	API documentation updates.
+
+	* gtk/gtkbutton.c (:image, :image-spacing, :tree-view-separator-area):
+	* gtk/gtktreeview.c (:separator-height):
+	Use single colon in the API doclet. Double colon is for signals and
+	gets gtk-doc confused leaving the documentation out of the generated
+	API docs.
+
+	* gtk/gtkbutton.c
+	* gtk/gtkcombobox.c
+	* gtk/gtkdialog.c
+	* gtk/gtkentry.c
+	* gtk/gtkfilechooserutils.c
+	* gtk/gtkimcontext.c
+	* gtk/gtkrange.c
+	* gtk/gtktextview.c
+	* gtk/gtktreeview.c
+	* gtk/gtkwidget.c: Tag all maemo additions (not backports) as
+	'Stability: Unstable'
+
+	* gtk/gtkwidget.c (::insensitive-press, :tap-and-hold,
+	gtk_widget_insensitive_press): Tag as deprecated.
+
 2007-03-20  Michael Natterer  <mitch at imendio.com>
 
 	* gtk/gtkmenuitem.c (gtk_menu_item_position_menu)

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/ChangeLog
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/ChangeLog	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/ChangeLog	2007-03-22 16:37:32 UTC (rev 10729)
@@ -1,3 +1,12 @@
+2007-03-22  Tommi Komulainen  <tommi.komulainen at nokia.com>
+
+	* gtk/gtk-docs.sgml: Add 2.12 and maemo addition indices.
+	* gtk/gtk-sections.txt: Add new symbols so that they get documented.
+	* gtk/tmpl/gtkenums.sgml: Document GTK_BUTTONBOX_CENTER and
+	GtkInvalidInputType
+	* gtk/tmpl/gtkimcontext.sgml: Document GtkIMContextClipboardOperation
+	and HildonGtkInputMode
+
 2007-01-19  Michael Natterer  <mitch at gimp.org>
 
 	Backport unbinding of keybindings:

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-docs.sgml
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-docs.sgml	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-docs.sgml	2007-03-22 16:37:32 UTC (rev 10729)
@@ -671,5 +671,20 @@
   <index role="2.10">
     <title>Index of new symbols in 2.10</title>
   </index>  
+  <index role="2.12">
+    <title>Index of new symbols in 2.12 (backported to Maemo)</title>
+  </index>  
+  <index role="maemo 1.0">
+    <title>Index of new symbols in Maemo 1.0</title>
+  </index>
+  <index role="maemo 2.0">
+    <title>Index of new symbols in Maemo 2.x (mistral/scirocco/gregale)</title>
+  </index>
+  <index role="maemo 3.0">
+    <title>Index of new symbols in Maemo 3.x (bora)</title>
+  </index>
+  <index role="maemo 4.0">
+    <title>Index of new symbols in Maemo 4.x</title>
+  </index>
 
 </book>

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-sections.txt
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-sections.txt	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/gtk-sections.txt	2007-03-22 16:37:32 UTC (rev 10729)
@@ -1138,6 +1138,9 @@
 gtk_entry_get_visibility
 gtk_entry_set_completion
 gtk_entry_get_completion
+<SUBSECTION Hildon>
+hildon_gtk_entry_get_input_mode
+hildon_gtk_entry_set_input_mode
 <SUBSECTION Standard>
 GTK_ENTRY
 GTK_IS_ENTRY
@@ -1846,6 +1849,18 @@
 gtk_im_context_set_surrounding
 gtk_im_context_get_surrounding
 gtk_im_context_delete_surrounding
+<SUBSECTION Hildon>
+GtkIMContextClipboardOperation
+HildonGtkInputMode
+gtk_im_context_hide
+gtk_im_context_show
+hildon_gtk_im_context_copy
+hildon_gtk_im_context_cut
+hildon_gtk_im_context_filter_event
+hildon_gtk_im_context_has_selection
+hildon_gtk_im_context_hide
+hildon_gtk_im_context_paste
+hildon_gtk_im_context_show
 <SUBSECTION Standard>
 GTK_IM_CONTEXT
 GTK_IS_IM_CONTEXT
@@ -2746,6 +2761,12 @@
 gtk_range_get_lower_stepper_sensitivity
 gtk_range_set_upper_stepper_sensitivity
 gtk_range_get_upper_stepper_sensitivity
+gtk_range_get_fill_level
+gtk_range_set_fill_level
+gtk_range_get_restrict_to_fill_level
+gtk_range_set_restrict_to_fill_level
+gtk_range_get_show_fill_level
+gtk_range_set_show_fill_level
 <SUBSECTION Standard>
 GTK_RANGE
 GTK_IS_RANGE
@@ -3695,6 +3716,9 @@
 gtk_text_view_get_accepts_tab
 gtk_text_view_get_default_attributes
 GTK_TEXT_VIEW_PRIORITY_VALIDATE
+<SUBSECTION Hildon>
+hildon_gtk_text_view_get_input_mode
+hildon_gtk_text_view_set_input_mode
 <SUBSECTION Standard>
 GTK_TEXT_VIEW
 GTK_IS_TEXT_VIEW
@@ -5092,6 +5116,13 @@
 gtk_widget_remove_mnemonic_label
 gtk_widget_get_action
 gtk_widget_is_composited
+gtk_widget_error_bell
+gtk_widget_keynav_failed
+<SUBSECTION Hildon>
+gtk_widget_tap_and_hold_flags_get_type
+gtk_widget_tap_and_hold_menu_position_top
+gtk_widget_tap_and_hold_setup
+gtk_widget_insensitive_press
 <SUBSECTION>
 gtk_requisition_copy
 gtk_requisition_free
@@ -5844,7 +5875,8 @@
 GtkWindowPosition
 GtkWindowType
 GtkSortType
-
+<SUBSECTION Hildon>
+GtkInvalidInputType
 <SUBSECTION Private>
 GtkMenuCallback
 GtkMenuEntry

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkenums.sgml
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkenums.sgml	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkenums.sgml	2007-03-22 16:37:32 UTC (rev 10729)
@@ -84,6 +84,7 @@
 left for a HBox, or the top for a VBox).
 @GTK_BUTTONBOX_END: Buttons are grouped towards the end of a box, (on the
 right for a HBox, or the bottom for a VBox).
+ at GTK_BUTTONBOX_CENTER: Buttons are grouped in the middle of the ButtonBox.
 
 <!-- ##### ENUM GtkCornerType ##### -->
 <para>
@@ -479,3 +480,11 @@
 @GTK_SORT_ASCENDING: Sorting is in ascending order.
 @GTK_SORT_DESCENDING: Sorting is in descending order.
 
+<!-- ##### ENUM GtkInvalidInputType ##### -->
+<para>
+Reason why the "invalid-input" signal was emitted.
+</para>
+
+ at GTK_INVALID_INPUT_MAX_CHARS_REACHED: Text exceeds the maximum allowed length for the widget.
+ at GTK_INVALID_INPUT_MODE_RESTRICTION: Text contains characters forbidden in the selected #HildonGtkInputMode
+

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkimcontext.sgml
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkimcontext.sgml	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/docs/reference/gtk/tmpl/gtkimcontext.sgml	2007-03-22 16:37:32 UTC (rev 10729)
@@ -175,3 +175,27 @@
 @Returns: 
 
 
+<!-- ##### ENUM GtkIMContextClipboardOperation ##### -->
+<para>
+Determines the type of the requested clipboard operation. 
+</para>
+
+ at GTK_IM_CONTEXT_CLIPBOARD_OP_COPY: Copy the currently selected text to the clipboard.
+ at GTK_IM_CONTEXT_CLIPBOARD_OP_CUT: Copy the currently selected text to the clipboard and then delete it from the widget.
+ at GTK_IM_CONTEXT_CLIPBOARD_OP_PASTE: Paste the contents of the clipboard.
+
+<!-- ##### ENUM HildonGtkInputMode ##### -->
+<para>
+Determines the input mode. Setting the mode allows the input method
+to focus on the type of input that the application is expecting.
+</para>
+
+ at HILDON_GTK_INPUT_MODE_ALPHA: alphabetical characters and whitespace
+ at HILDON_GTK_INPUT_MODE_NUMERIC: numbers 0-9 and the '-' character
+ at HILDON_GTK_INPUT_MODE_SPECIAL: special characters
+ at HILDON_GTK_INPUT_MODE_HEXA: hexadecimal characters; numbers 0-9, characters a-f, and A-F
+ at HILDON_GTK_INPUT_MODE_TELE: telephone numbers; numbers 0-9, whitespace, and the characters "pwPW/().-+*#?,"
+ at HILDON_GTK_INPUT_MODE_FULL: unrestricted entry mode, combination of the alpha, numeric and special modes.
+ at HILDON_GTK_INPUT_MODE_INVISIBLE: do not echo or save the input in the IM when entering sensitive information such as passwords.
+ at HILDON_GTK_INPUT_MODE_AUTOCAP: automatically capitalize the first letter at the start of a sentence.
+

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkbutton.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkbutton.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkbutton.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -273,7 +273,7 @@
                                                       GTK_PARAM_READWRITE));
 
   /**
-   * GtkButton::image:
+   * GtkButton:image:
    * 
    * The child widget to appear next to the button text.
    * 
@@ -465,7 +465,7 @@
                                                                GTK_PARAM_READABLE));
 
   /**
-   * GtkButton::image-spacing:
+   * GtkButton:image-spacing:
    * 
    * Spacing in pixels between the image and label.
    * 
@@ -482,14 +482,15 @@
 
 #ifdef MAEMO_CHANGES
   /**
-   * GtkButton::tree-view-separator-area:
+   * GtkButton:tree-view-separator-area:
    *
    * Specifies the amount of pixels to reserve for drawing a separator
    * below the button.  This is used to visually separate column headers
    * from the tree view.  The separator which will be drawn is exactly
    * 1px thick.  When 0, no separator will be drawn.
    *
-   * Since: maemo 1.0
+   * Since: maemo 4.0
+   * Stability: Unstable
    */
   gtk_widget_class_install_style_property (widget_class,
                                            g_param_spec_int ("tree-view-separator-area",

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkcombobox.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkcombobox.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkcombobox.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -782,6 +782,7 @@
    * When TRUE, automatically dims the button if the list is empty.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   gtk_widget_class_install_style_property (widget_class,
                                            g_param_spec_boolean ("autodimmed-button",

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkdialog.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkdialog.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkdialog.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -153,6 +153,7 @@
    * Spacing between elements of the main dialog area.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   gtk_widget_class_install_style_property (widget_class,
                                            g_param_spec_int ("content-area-spacing",

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkentry.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkentry.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkentry.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -613,6 +613,7 @@
    * Allowed characters and input mode for the entry. See #HildonGtkInputMode.
    *
    * Since: maemo 2.0
+   * Stability: Unstable
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_HILDON_INPUT_MODE,
@@ -734,6 +735,7 @@
    * has been reached.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   signals[INVALID_INPUT] =
     g_signal_new ("invalid_input",

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkfilechooserutils.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkfilechooserutils.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkfilechooserutils.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -127,6 +127,7 @@
  * but exported for hildon-fm.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  */
 void
 hildon_gtk_file_chooser_install_properties (GObjectClass *klass)

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkimcontext.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkimcontext.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkimcontext.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -177,6 +177,7 @@
    * any text selected in the widget. Return TRUE if there is.
    *
    * Since: maemo 2.0
+   * Stability: Unstable
    **/
   im_context_signals[HAS_SELECTION] =
     g_signal_new ("has_selection",
@@ -195,6 +196,7 @@
    * text. The widget needs to implement these operations.
    *
    * Since: maemo 2.0
+   * Stability: Unstable
    **/
   im_context_signals[CLIPBOARD_OPERATION] =
     g_signal_new ("clipboard_operation",
@@ -212,6 +214,7 @@
    * See #HildonGtkInputMode.
    *
    * Since: maemo 2.0
+   * Stability: Unstable
    **/
   g_object_class_install_property (gobject_class,
 				   PROP_HILDON_INPUT_MODE,
@@ -711,11 +714,11 @@
  * or gtk_im_context_filter_keypress() for focus and keypress events
  * where applicable.
  * </para></note>
- * </para></note>
  *
  * Return value: %TRUE if the input method handled the event.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  */
 gboolean hildon_gtk_im_context_filter_event (GtkIMContext   *context,
                                              GdkEvent        *event)
@@ -737,6 +740,7 @@
  * input method show be opened.
  *
  * Since: maemo 1.0
+ * Stability: Unstable
  *
  * Deprecated: Use hildon_gtk_im_context_show() instead.
  **/
@@ -754,6 +758,7 @@
  * input method show be closed.
  *
  * Since: maemo 1.0
+ * Stability: Unstable
  *
  * Deprecated: Use hildon_gtk_im_context_hide() instead.
  **/
@@ -771,6 +776,7 @@
  * input method show be opened.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  **/
 void
 hildon_gtk_im_context_show (GtkIMContext *context)
@@ -792,6 +798,7 @@
  * input method show be closed.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  **/
 void
 hildon_gtk_im_context_hide (GtkIMContext *context)
@@ -813,6 +820,7 @@
  * text selected in it.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  **/
 gboolean
 hildon_gtk_im_context_has_selection (GtkIMContext *context)
@@ -836,6 +844,7 @@
  * selected text in it is copied to clipboard.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  **/
 void
 hildon_gtk_im_context_copy (GtkIMContext *context)
@@ -854,6 +863,7 @@
  * selected text is cut and copied to clipboard.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  **/
 void
 hildon_gtk_im_context_cut (GtkIMContext *context)
@@ -872,6 +882,7 @@
  * text in clipboard is pasted to it.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  **/
 void
 hildon_gtk_im_context_paste (GtkIMContext *context)

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkrange.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkrange.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkrange.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -514,6 +514,7 @@
    * Allows to use images instead of normal arrows.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   gtk_widget_class_install_style_property (widget_class,
                                            g_param_spec_boolean ("arrow-paint-box-layout",

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktextview.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktextview.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktextview.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -656,6 +656,7 @@
    * See #HildonGtkInputMode.
    *
    * Since: maemo 2.0
+   * Stability: Unstable
    **/
   g_object_class_install_property (gobject_class,
                                    PROP_HILDON_INPUT_MODE,
@@ -8785,6 +8786,7 @@
  * Sets input mode of the widget.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  */
 void
 hildon_gtk_text_view_set_input_mode (GtkTextView       *text_view,
@@ -8809,6 +8811,7 @@
  * Return value: the input mode of the widget.
  *
  * Since: maemo 2.0
+ * Stability: Unstable
  */
 HildonGtkInputMode
 hildon_gtk_text_view_get_input_mode (GtkTextView *text_view)

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktreeview.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktreeview.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtktreeview.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -852,11 +852,12 @@
 
 #ifdef MAEMO_CHANGES
   /**
-   * GtkTreeView::separator-height:
+   * GtkTreeView:separator-height:
    *
    * Height in pixels of a separator.
    *
    * Since: maemo 3.0
+   * Stability: Unstable
    */
   gtk_widget_class_install_style_property (widget_class,
 					   g_param_spec_int ("separator-height",
@@ -1105,6 +1106,7 @@
    * Emitted when the user tries to move cursor to an insesitive row.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   tree_view_signals[ROW_INSENSITIVE] =
      g_signal_new ("row_insensitive",

Modified: projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkwidget.c
===================================================================
--- projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkwidget.c	2007-03-22 16:07:06 UTC (rev 10728)
+++ projects/haf/branches/gtk+/maemo-gtk-2-10/gtk/gtkwidget.c	2007-03-22 16:37:32 UTC (rev 10729)
@@ -623,10 +623,11 @@
    * Sets the state (#GtkStateType) to be used to the tap and hold
    * functionality. The default is GTK_STATE_NORMAL.
    *
-   * Warning: Functionality for setting and getting this propery is not
+   * Deprecated: Functionality for setting and getting this propery is not
    * implemented.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   g_object_class_install_property (gobject_class,
 				   PROP_TAP_AND_HOLD,
@@ -1590,9 +1591,12 @@
    *
    * If a widget is insensitive and it receives click event,
    * the signal is emited.  Signal is made to clarify situations where
-   * a widget is not easily noticable as an insenitive widget.
+   * a widget is not easily noticable as an insensitive widget.
    *
+   * Deprecated: Use hildon_helper_set_insensitive_message() instead.
+   *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   widget_signals[INSENSITIVE_PRESS] =
     g_signal_new ("insensitive_press",
@@ -1609,6 +1613,7 @@
    * The signal is emited when tap and hold activity occurs.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   widget_signals[TAP_AND_HOLD] =
     g_signal_new("tap_and_hold", G_TYPE_FROM_CLASS(gobject_class),
@@ -1622,7 +1627,7 @@
    * @widget: the object which received the signal
    * @menu: the menu to be opened.
    * @func: the menu position function
-   * @flags: debricated
+   * @flags: deprecated
    *
    * Enables the tap and hold functionality to the @widget.
    * Usually a @menu is used at tap and hold signal,
@@ -1630,11 +1635,8 @@
    * may be connected to it as well.  Usually this signal is not used,
    * instead the virtual function is over written.
    *
-   * Signal is deprecated and should not be used.
-   *
-   * @Deprecated
-   *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
   widget_signals[TAP_AND_HOLD_SETUP] =
     g_signal_new("tap_and_hold_setup", G_TYPE_FROM_CLASS(gobject_class),
@@ -1655,6 +1657,7 @@
    * tap and hold.
    *
    * Since: maemo 1.0
+   * Stability: Unstable
    */
     widget_signals[TAP_AND_HOLD_QUERY] =
     g_signal_new ("tap_and_hold_query",
@@ -8639,6 +8642,7 @@
  * It positiones the @menu over the @widget.
  *
  * Since: maemo 1.0
+ * Stability: Unstable
  **/
 void
 gtk_widget_tap_and_hold_menu_position_top (GtkWidget *menu,
@@ -8685,10 +8689,10 @@
 
 /**
  * gtk_widget_tap_and_hold_setup:
- * @widget : a @GtkWidget
- * @menu : a @GtkWidget
- * @func : a @GtkCallback
- * @flags : a @GtkWidgetTapAndHoldFlags
+ * @widget : a #GtkWidget
+ * @menu : a #GtkMenu or %NULL
+ * @func : a #GtkMenuPositionFunc or %NULL
+ * @flags : a #GtkWidgetTapAndHoldFlags
  *
  * Setups the tap and hold functionality to the @widget.
  * The @menu is shown when the functionality is activated.
@@ -8697,6 +8701,7 @@
  * Fourth parameter, @flags is deprecated and has no effect.
  *
  * Since: maemo 1.0
+ * Stability: Unstable
  */
 void
 gtk_widget_tap_and_hold_setup (GtkWidget                *widget,
@@ -8882,7 +8887,10 @@
  *
  * Emits the "insensitive-press" signal.
  *
+ * Deprecated: Use hildon_helper_set_insensitive_message() instead.
+ *
  * Since: maemo 1.0
+ * Stability: Unstable
  */
 void
 gtk_widget_insensitive_press ( GtkWidget *widget )


More information about the maemo-commits mailing list