callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Documentation: Correct references to properties.

Browse Source 
These should use :, not ::, though signals would use ::.
See
http://developer.gnome.org/gtk-doc-manual/unstable/documenting_syntax.html.en
and
http://developer.gnome.org/gtk-doc-manual/unstable/documenting_symbols.html.en
This commit is contained in:
Murray Cumming 2012-02-15 11:43:33 +01:00
parent 87d979f498
commit a0b4ab109d
15 changed files with 27 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
gtk/deprecated/gtkcolorsel.c
View File

@ -3071,7 +3071,7 @@ gtk_color_selection_palette_to_string (const GdkColor *colors,
* tries to modify the palette in a color selection. * tries to modify the palette in a color selection.
* *
* This function should save the new palette contents, and update * This function should save the new palette contents, and update
* the #GtkSettings::gtk-color-palette GtkSettings property so all * the #GtkSettings:gtk-color-palette GtkSettings property so all
* GtkColorSelection widgets will be modified. * GtkColorSelection widgets will be modified.
* *
* Return value: the previous change palette hook (that was replaced) * Return value: the previous change palette hook (that was replaced)

2
gtk/deprecated/gtkhbox.c
View File

@ -49,7 +49,7 @@
* very quick and easy change. If you have derived your own classes from * very quick and easy change. If you have derived your own classes from
* GtkHBox, you can simply change the inheritance to derive directly * GtkHBox, you can simply change the inheritance to derive directly
* from #GtkBox. No further changes are needed, since the default * from #GtkBox. No further changes are needed, since the default
* value of the #GtkOrientable::orientation property is * value of the #GtkOrientable:orientation property is
* %GTK_ORIENTATION_HORIZONTAL. * %GTK_ORIENTATION_HORIZONTAL.
* If you want your code to be future-proof, the recommendation is to * If you want your code to be future-proof, the recommendation is to
* switch to #GtkGrid, since #GtkBox is going to be deprecated in favor * switch to #GtkGrid, since #GtkBox is going to be deprecated in favor

2
gtk/deprecated/gtkvbox.c
View File

@ -49,7 +49,7 @@
* GtkVBox has been deprecated. You can use #GtkBox instead, which is a * GtkVBox has been deprecated. You can use #GtkBox instead, which is a
* very quick and easy change. If you have derived your own classes from * very quick and easy change. If you have derived your own classes from
* GtkVBox, you can simply change the inheritance to derive directly * GtkVBox, you can simply change the inheritance to derive directly
* from #GtkBox, and set the #GtkOrientable::orientation property to * from #GtkBox, and set the #GtkOrientable:orientation property to
* %GTK_ORIENTATION_VERTICAL in your instance init function, with a * %GTK_ORIENTATION_VERTICAL in your instance init function, with a
* call like: * call like:
* |[ * |[

4
gtk/gtkactivatable.c
View File

@ -340,9 +340,9 @@ gtk_activatable_update (GtkActivatable *activatable,
* @action: (allow-none): the related #GtkAction or %NULL * @action: (allow-none): the related #GtkAction or %NULL
* *
* This is called to update the activatable completely, this is called * This is called to update the activatable completely, this is called
* internally when the #GtkActivatable::related-action property is set * internally when the #GtkActivatable:related-action property is set
* or unset and by the implementing class when * or unset and by the implementing class when
* #GtkActivatable::use-action-appearance changes. * #GtkActivatable:use-action-appearance changes.
* *
* Since: 2.16 * Since: 2.16
**/ **/

4
gtk/gtkactivatable.h
View File

@ -45,8 +45,8 @@ typedef struct _GtkActivatableIface GtkActivatableIface;
* You must check the #GtkActivatable:use-action-appearance property only apply action * You must check the #GtkActivatable:use-action-appearance property only apply action
* properties that are meant to effect the appearance accordingly. * properties that are meant to effect the appearance accordingly.
* @sync_action_properties: Called to update the activatable completely, this is called internally when * @sync_action_properties: Called to update the activatable completely, this is called internally when
* #GtkActivatable::related-action property is set or unset and by the implementor when * #GtkActivatable:related-action property is set or unset and by the implementor when
* #GtkActivatable::use-action-appearance changes.<note><para>This method can be called * #GtkActivatable:use-action-appearance changes.<note><para>This method can be called
* with a %NULL action at times</para></note> * with a %NULL action at times</para></note>
* *
* Since: 2.16 * Since: 2.16

6
gtk/gtkappchooserbutton.c
View File

@ -31,14 +31,14 @@
* *
* Initially, a #GtkAppChooserButton selects the first application * Initially, a #GtkAppChooserButton selects the first application
* in its list, which will either be the most-recently used application * in its list, which will either be the most-recently used application
* or, if #GtkAppChooserButton::show-default-item is %TRUE, the * or, if #GtkAppChooserButton:show-default-item is %TRUE, the
* default application. * default application.
* *
* The list of applications shown in a #GtkAppChooserButton includes * The list of applications shown in a #GtkAppChooserButton includes
* the recommended applications for the given content type. When * the recommended applications for the given content type. When
* #GtkAppChooserButton::show-default-item is set, the default application * #GtkAppChooserButton:show-default-item is set, the default application
* is also included. To let the user chooser other applications, * is also included. To let the user chooser other applications,
* you can set the #GtkAppChooserButton::show-dialog-item property, * you can set the #GtkAppChooserButton:show-dialog-item property,
* which allows to open a full #GtkAppChooserDialog. * which allows to open a full #GtkAppChooserDialog.
* *
* It is possible to add custom items to the list, using * It is possible to add custom items to the list, using

4
gtk/gtkbbox.c
View File

@ -42,10 +42,10 @@
* same size. GtkButtonBox gives all children the same size, but it does allow * same size. GtkButtonBox gives all children the same size, but it does allow
* 'outliers' to keep their own larger size. To force all children to be * 'outliers' to keep their own larger size. To force all children to be
* strictly the same size without exceptions, you can set the * strictly the same size without exceptions, you can set the
* #GtkButtonBox::homogeneous property to %TRUE. * #GtkButtonBox:homogeneous property to %TRUE.
* *
* To excempt individual children from homogeneous sizing regardless of their * To excempt individual children from homogeneous sizing regardless of their
* 'outlier' status, you can set the #GtkButtonBox::non-homogeneous child * 'outlier' status, you can set the #GtkButtonBox:non-homogeneous child
* property. * property.
*/ */

2
gtk/gtkcomboboxtext.c
View File

@ -467,7 +467,7 @@ gtk_combo_box_text_prepend (GtkComboBoxText *combo_box,
* *
* Inserts @text at @position in the list of strings stored in @combo_box. * Inserts @text at @position in the list of strings stored in @combo_box.
* If @id is non-%NULL then it is used as the ID of the row. See * If @id is non-%NULL then it is used as the ID of the row. See
* #GtkComboBox::id-column. * #GtkComboBox:id-column.
* *
* If @position is negative then @text is appended. * If @position is negative then @text is appended.
* *

2
gtk/gtkentry.c
View File

@ -1392,7 +1392,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* *
* The invisible character is used when masking entry contents (in * The invisible character is used when masking entry contents (in
* \"password mode\")"). When it is not explicitly set with the * \"password mode\")"). When it is not explicitly set with the
* #GtkEntry::invisible-char property, GTK+ determines the character * #GtkEntry:invisible-char property, GTK+ determines the character
* to use from a list of possible candidates, depending on availability * to use from a list of possible candidates, depending on availability
* in the current font. * in the current font.
* *

2
gtk/gtkiconview.c
View File

@ -4494,7 +4494,7 @@ gtk_icon_view_set_tooltip_query_cb (GtkWidget *widget,
* for you. @column should be set to the column in @icon_view's model * for you. @column should be set to the column in @icon_view's model
* containing the tooltip texts, or -1 to disable this feature. * containing the tooltip texts, or -1 to disable this feature.
* *
* When enabled, #GtkWidget::has-tooltip will be set to %TRUE and * When enabled, #GtkWidget:has-tooltip will be set to %TRUE and
* @icon_view will connect a #GtkWidget::query-tooltip signal handler. * @icon_view will connect a #GtkWidget::query-tooltip signal handler.
* *
* Note that the signal handler sets the text with gtk_tooltip_set_markup(), * Note that the signal handler sets the text with gtk_tooltip_set_markup(),

6
gtk/gtkoverlay.c
View File

@ -37,8 +37,8 @@
* *
* GtkOverlay is a container which contains a single main child, on top * GtkOverlay is a container which contains a single main child, on top
* of which it can place <firstterm>overlay</firstterm> widgets. The * of which it can place <firstterm>overlay</firstterm> widgets. The
* position of each overlay widget is determined by its #GtkWidget::halign * position of each overlay widget is determined by its #GtkWidget:halign
* and #GtkWidget::valign properties. E.g. a widget with both alignments * and #GtkWidget:valign properties. E.g. a widget with both alignments
* set to %GTK_ALIGN_START will be placed at the top left corner of the * set to %GTK_ALIGN_START will be placed at the top left corner of the
* main widget, whereas an overlay with halign set to %GTK_ALIGN_CENTER * main widget, whereas an overlay with halign set to %GTK_ALIGN_CENTER
* and valign set to %GTK_ALIGN_END will be placed a the bottom edge of * and valign set to %GTK_ALIGN_END will be placed a the bottom edge of
@ -605,7 +605,7 @@ gtk_overlay_new (void)
* added with gtk_container_add(). * added with gtk_container_add().
* *
* The position at which @widget is placed is determined * The position at which @widget is placed is determined
* from its #GtkWidget::halign and #GtkWidget::valign properties. * from its #GtkWidget:halign and #GtkWidget:valign properties.
* *
* Since: 3.2 * Since: 3.2
*/ */

6
gtk/gtkprintoperation.c
View File

@ -2420,7 +2420,7 @@ gtk_print_operation_set_embed_page_setup (GtkPrintOperation *op,
* gtk_print_operation_get_embed_page_setup: * gtk_print_operation_get_embed_page_setup:
* @op: a #GtkPrintOperation * @op: a #GtkPrintOperation
* *
* Gets the value of #GtkPrintOperation::embed-page-setup property. * Gets the value of #GtkPrintOperation:embed-page-setup property.
* *
* Returns: whether page setup selection combos are embedded * Returns: whether page setup selection combos are embedded
* *
@ -3305,7 +3305,7 @@ gtk_print_operation_set_support_selection (GtkPrintOperation *op,
* gtk_print_operation_get_support_selection: * gtk_print_operation_get_support_selection:
* @op: a #GtkPrintOperation * @op: a #GtkPrintOperation
* *
* Gets the value of #GtkPrintOperation::support-selection property. * Gets the value of #GtkPrintOperation:support-selection property.
* *
* Returns: whether the application supports print of selection * Returns: whether the application supports print of selection
* *
@ -3354,7 +3354,7 @@ gtk_print_operation_set_has_selection (GtkPrintOperation *op,
* gtk_print_operation_get_has_selection: * gtk_print_operation_get_has_selection:
* @op: a #GtkPrintOperation * @op: a #GtkPrintOperation
* *
* Gets the value of #GtkPrintOperation::has-selection property. * Gets the value of #GtkPrintOperation:has-selection property.
* *
* Returns: whether there is a selection * Returns: whether there is a selection
* *

8
gtk/gtkprintunixdialog.c
View File

@ -4272,7 +4272,7 @@ gtk_print_unix_dialog_set_manual_capabilities (GtkPrintUnixDialog *dialog,
* gtk_print_unix_dialog_get_manual_capabilities: * gtk_print_unix_dialog_get_manual_capabilities:
* @dialog: a #GtkPrintUnixDialog * @dialog: a #GtkPrintUnixDialog
* *
* Gets the value of #GtkPrintUnixDialog::manual-capabilities property. * Gets the value of #GtkPrintUnixDialog:manual-capabilities property.
* *
* Returns: the printing capabilities * Returns: the printing capabilities
* *
@ -4332,7 +4332,7 @@ gtk_print_unix_dialog_set_support_selection (GtkPrintUnixDialog *dialog,
* gtk_print_unix_dialog_get_support_selection: * gtk_print_unix_dialog_get_support_selection:
* @dialog: a #GtkPrintUnixDialog * @dialog: a #GtkPrintUnixDialog
* *
* Gets the value of #GtkPrintUnixDialog::support-selection property. * Gets the value of #GtkPrintUnixDialog:support-selection property.
* *
* Returns: whether the application supports print of selection * Returns: whether the application supports print of selection
* *
@ -4386,7 +4386,7 @@ gtk_print_unix_dialog_set_has_selection (GtkPrintUnixDialog *dialog,
* gtk_print_unix_dialog_get_has_selection: * gtk_print_unix_dialog_get_has_selection:
* @dialog: a #GtkPrintUnixDialog * @dialog: a #GtkPrintUnixDialog
* *
* Gets the value of #GtkPrintUnixDialog::has-selection property. * Gets the value of #GtkPrintUnixDialog:has-selection property.
* *
* Returns: whether there is a selection * Returns: whether there is a selection
* *
@ -4454,7 +4454,7 @@ gtk_print_unix_dialog_set_embed_page_setup (GtkPrintUnixDialog *dialog,
* gtk_print_unix_dialog_get_embed_page_setup: * gtk_print_unix_dialog_get_embed_page_setup:
* @dialog: a #GtkPrintUnixDialog * @dialog: a #GtkPrintUnixDialog
* *
* Gets the value of #GtkPrintUnixDialog::embed-page-setup property. * Gets the value of #GtkPrintUnixDialog:embed-page-setup property.
* *
* Returns: whether there is a selection * Returns: whether there is a selection
* *

2
gtk/gtktoolitem.c
View File

@ -788,7 +788,7 @@ gtk_tool_item_get_orientation (GtkToolItem *tool_item)
* show text</listitem> * show text</listitem>
* <listitem> GTK_TOOLBAR_BOTH_HORIZ, meaning the tool item should show * <listitem> GTK_TOOLBAR_BOTH_HORIZ, meaning the tool item should show
* both an icon and a label, arranged horizontally (however, note the * both an icon and a label, arranged horizontally (however, note the
* #GtkToolButton::has_text_horizontally that makes tool buttons not * #GtkToolButton:has_text_horizontally property that makes tool buttons not
* show labels when the toolbar style is GTK_TOOLBAR_BOTH_HORIZ. * show labels when the toolbar style is GTK_TOOLBAR_BOTH_HORIZ.
* </listitem> * </listitem>
* </itemizedlist> * </itemizedlist>

2
gtk/gtkwidget.c
View File

@ -1494,7 +1494,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
* The ::state-changed signal is emitted when the widget state changes. * The ::state-changed signal is emitted when the widget state changes.
* See gtk_widget_get_state(). * See gtk_widget_get_state().
* *
* Deprecated: 3.0. Use #GtkWidget::state-flags-changed instead. * Deprecated: 3.0. Use #GtkWidget:state-flags-changed instead.
*/ */
widget_signals[STATE_CHANGED] = widget_signals[STATE_CHANGED] =
g_signal_new (I_("state-changed"), g_signal_new (I_("state-changed"),