Commit f70fc49e authored by Cosimo Cecchi's avatar Cosimo Cecchi
Browse files

docs: fix a number of typos and obsolete references

parent ff28d3f4
......@@ -3167,7 +3167,6 @@ GTK_TYPE_SPINNER
GTK_SPINNER_CLASS
GTK_IS_SPINNER_CLASS
GTK_SPINNER_GET_CLASS
GTK_IS_SPINNER_CLASS
<SUBSECTION Private>
GtkSpinnerPrivate
......
......@@ -134,7 +134,7 @@
</simplelist>
<para>
One of the main differences to #GtkStyle-based engines is that the
One of the main differences to #GtkStyle<!-- -->-based engines is that the
rendered widget is totally isolated from the theme engine, all style
information is meant to be retrieved from the #GtkThemingEngine API,
or from the #GtkWidgetPath obtained from gtk_theming_engine_get_path(),
......@@ -171,7 +171,7 @@
</para>
<para>
The installed properties depend on the #GtkThemeEngine::name property,
The installed properties depend on the #GtkThemingEngine:name property,
so they should be added in the <literal>constructed()</literal> vfunc.
For example, if an engine with the name "Clearlooks" installs a
"focus-color" property with the type #GdkRGBA, the property
......
......@@ -295,7 +295,7 @@ my_widget_key_press_event_handler (GtkWidget *widget, GdkEventKey *event)
<para>
Named icons can be used for window icons (see gtk_window_set_icon_name())
and images (see gtk_image_set_icon_name()). You can also use named icons
and images (see gtk_image_set_from_icon_name()). You can also use named icons
for drag-and-drop (see gtk_drag_source_set_icon_name()) and in treeview
cells (see the #GtkCellRendererPixbuf:icon-name property).
</para>
......
......@@ -42,7 +42,7 @@
* @Title: GtkColorSelectionDialog
*
* The #GtkColorSelectionDialog provides a standard dialog which
* allows the user to select a color much like the #GtkFileSelection
* allows the user to select a color much like the #GtkFileChooserDialog
* provides a standard dialog for file selection.
*
* Use gtk_color_selection_dialog_get_color_selection() to get the
......
......@@ -1293,7 +1293,7 @@ gtk_font_selection_get_size_entry (GtkFontSelection *fontsel)
* gtk_font_selection_get_size_list:
* @fontsel: a #GtkFontSelection
*
* This returns the #GtkTreeeView used to list font sizes.
* This returns the #GtkTreeView used to list font sizes.
*
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
......
......@@ -1690,7 +1690,7 @@ gtk_rc_find_module_in_path (const gchar *module_file)
/**
* gtk_rc_parse_state:
* @scanner: a #GtkScanner (must be initialized for parsing an RC file)
* @scanner: a #GScanner (must be initialized for parsing an RC file)
* @state: (out): A pointer to a #GtkStateType variable in which to
* store the result.
*
......
......@@ -1462,6 +1462,7 @@ gtk_accelerator_parse (const gchar *accelerator,
* gtk_accelerator_name_with_keycode:
* @display: (allow-none): a #GdkDisplay or %NULL to use the default display
* @accelerator_key: accelerator keyval
* @keycode: accelerator keycode
* @accelerator_mods: accelerator modifier mask
*
* Converts an accelerator keyval and modifier mask
......@@ -1647,6 +1648,7 @@ gtk_accelerator_name (guint accelerator_key,
* gtk_accelerator_get_label_with_keycode:
* @display: (allow-none): a #GdkDisplay or %NULL to use the default display
* @accelerator_key: accelerator keyval
* @keycode: accelerator keycode
* @accelerator_mods: accelerator modifier mask
*
* Converts an accelerator keyval and modifier mask
......
......@@ -133,7 +133,7 @@ gtk_actionable_set_action_name (GtkActionable *actionable,
*
* Gets the current target value of @actionabe.
*
* See gtk_actionable_set_target_value() for more information.
* See gtk_actionable_set_action_target_value() for more information.
*
* Returns: (transfer none): the current target value
*
......@@ -224,8 +224,8 @@ gtk_actionable_set_action_target (GtkActionable *actionable,
* actionable widget.
*
* This allows for the effect of both gtk_actionable_set_action_name()
* and gtk_actionable_set_target() in the common case that the target is
* string-valued.
* and gtk_actionable_set_action_target_value() in the common case that
* the target is string-valued.
*
* @detailed_action_name is a string of the form
* <literal>"action::target"</literal> where <literal>action</literal>
......
......@@ -1363,7 +1363,7 @@ gtk_action_group_add_radio_actions_full (GtkActionGroup *action_group
* destroyed and when the translation function is changed again
*
* Sets a function to be used for translating the @label and @tooltip of
* #GtkActionGroupEntry<!-- -->s added by gtk_action_group_add_actions().
* #GtkActionEntry<!-- -->s added by gtk_action_group_add_actions().
*
* If you're using gettext(), it is enough to set the translation domain
* with gtk_action_group_set_translation_domain().
......@@ -1434,7 +1434,8 @@ gtk_action_group_set_translation_domain (GtkActionGroup *action_group,
* @action_group: a #GtkActionGroup
* @string: a string
*
* Translates a string using the specified translate_func(). This
* Translates a string using the function set with
* gtk_action_group_set_translate_func(). This
* is mainly intended for language bindings.
*
* Returns: the translation of @string
......
......@@ -409,7 +409,8 @@ gtk_activatable_action_notify (GtkAction *action,
*
* <note><para>Be careful to call this before setting the local
* copy of the #GtkAction property, since this function uses
* gtk_activatable_get_action() to retrieve the previous action</para></note>
* gtk_activatable_get_related_action() to retrieve the
* previous action</para></note>
*
* Since: 2.16
*/
......
......@@ -414,11 +414,11 @@ gtk_adjustment_get_value (GtkAdjustment *adjustment)
* @value: the new value.
*
* Sets the #GtkAdjustment value. The value is clamped to lie between
* #GtkAdjustment.lower and #GtkAdjustment.upper.
* #GtkAdjustment:lower and #GtkAdjustment:upper.
*
* Note that for adjustments which are used in a #GtkScrollbar, the effective
* range of allowed values goes from #GtkAdjustment.lower to
* #GtkAdjustment.upper - #GtkAdjustment.page_size.
* range of allowed values goes from #GtkAdjustment:lower to
* #GtkAdjustment:upper - #GtkAdjustment:page_size.
*/
void
gtk_adjustment_set_value (GtkAdjustment *adjustment,
......@@ -769,9 +769,9 @@ gtk_adjustment_value_changed (GtkAdjustment *adjustment)
* @lower: the lower value.
* @upper: the upper value.
*
* Updates the #GtkAdjustment #GtkAdjustment.value to ensure that the range
* Updates the #GtkAdjustment #GtkAdjustment:value to ensure that the range
* between @lower and @upper is in the current page (i.e. between
* #GtkAdjustment.value and #GtkAdjustment.value + #GtkAdjustment.page_size).
* #GtkAdjustment:value and #GtkAdjustment:value + #GtkAdjustment:page_size).
* If the range is larger than the page size, then only the start of it will
* be in the current page.
* A #GtkAdjustment::changed signal will be emitted if the value is changed.
......
......@@ -79,7 +79,7 @@
* gtk_application_set_app_menu(). The #GMenuModel that this function
* expects is usually constructed using #GtkBuilder, as seen in the
* following example. To specify a menubar that will be shown by
* #GApplicationWindows, use gtk_application_set_menubar(). Use the base
* #GtkApplicationWindow<!-- -->s, use gtk_application_set_menubar(). Use the base
* #GActionMap interface to add actions, to respond to the user
* selecting these menu items.
*
......@@ -763,7 +763,7 @@ gtk_application_class_init (GtkApplicationClass *class)
* as soon as the application gets registered as the primary instance.
*
* Concretely, gtk_init() is called in the default handler for the
* #GApplication:startup signal. Therefore, #GtkApplication subclasses should
* #GApplication::startup signal. Therefore, #GtkApplication subclasses should
* chain up in their #GApplication:startup handler before using any GTK+ API.
*
* Note that commandline arguments are not passed to gtk_init().
......@@ -923,7 +923,8 @@ gtk_application_get_window_by_id (GtkApplication *application,
* is pressed.
*
* @accelerator must be a string that can be parsed by
* gtk_accelerator_parse(), e.g. "<Primary>q" or "<Control><Alt>p".
* gtk_accelerator_parse(), e.g. "&lt;Primary&gt;q" or
* "&lt;Control&gt;&lt;Alt&gt;p".
*
* @action_name must be the name of an action as it would be used
* in the app menu, i.e. actions that have been added to the application
......@@ -1352,7 +1353,7 @@ gtk_application_startup_session_dbus (GtkApplication *app)
* that should not be interrupted, such as creating a CD or DVD. The
* types of actions that may be blocked are specified by the @flags
* parameter. When the application completes the operation it should
* call g_application_uninhibit() to remove the inhibitor. Note that
* call gtk_application_uninhibit() to remove the inhibitor. Note that
* an application can have multiple inhibitors, and all of the must
* be individually removed. Inhibitors are also cleared when the
* application exits.
......@@ -1367,7 +1368,7 @@ gtk_application_startup_session_dbus (GtkApplication *app)
* this window to find out more about why the action is inhibited.
*
* Returns: A non-zero cookie that is used to uniquely identify this
* request. It should be used as an argument to g_application_uninhibit()
* request. It should be used as an argument to gtk_application_uninhibit()
* in order to remove the request. If the platform does not support
* inhibiting or the request failed for some reason, 0 is returned.
*
......@@ -1420,9 +1421,9 @@ gtk_application_inhibit (GtkApplication *application,
/**
* gtk_application_uninhibit:
* @application: the #GApplication
* @cookie: a cookie that was returned by g_application_inhibit()
* @cookie: a cookie that was returned by gtk_application_inhibit()
*
* Removes an inhibitor that has been established with g_application_inhibit().
* Removes an inhibitor that has been established with gtk_application_inhibit().
* Inhibitors are also cleared when the application exits.
*
* Since: 3.4
......
......@@ -75,7 +75,7 @@
* will display the application menu, but not the menubar.
*
* If the desktop environment does not display the menubar, then
* #GApplicationWindow will automatically show a #GtkMenubar for it.
* #GtkApplicationWindow will automatically show a #GtkMenuBar for it.
* (see the #GtkApplication docs for some screenshots of how this
* looks on different platforms).
* This behaviour can be overridden with the #GtkApplicationWindow:show-menubar
......
......@@ -120,7 +120,7 @@ gtk_cell_editable_start_editing (GtkCellEditable *cell_editable,
/**
* gtk_cell_editable_editing_done:
* @cell_editable: A #GtkTreeEditable
* @cell_editable: A #GtkCellEditable
*
* Emits the #GtkCellEditable::editing-done signal.
**/
......@@ -134,7 +134,7 @@ gtk_cell_editable_editing_done (GtkCellEditable *cell_editable)
/**
* gtk_cell_editable_remove_widget:
* @cell_editable: A #GtkTreeEditable
* @cell_editable: A #GtkCellEditable
*
* Emits the #GtkCellEditable::remove-widget signal.
**/
......
......@@ -21,7 +21,7 @@
* @Title: GtkCellLayout
*
* #GtkCellLayout is an interface to be implemented by all objects which
* want to provide a #GtkTreeViewColumn-like API for packing cells, setting
* want to provide a #GtkTreeViewColumn<!-- -->-like API for packing cells, setting
* attributes and data funcs.
*
* One of the notable features provided by implementations of GtkCellLayout
......@@ -38,7 +38,7 @@
* <title>GtkCellLayouts as GtkBuildable</title>
* <para>
* Implementations of GtkCellLayout which also implement the GtkBuildable
* interface (#GtkCellView, #GtkIconView, #GtkComboBox, #GtkComboBoxEntry,
* interface (#GtkCellView, #GtkIconView, #GtkComboBox,
* #GtkEntryCompletion, #GtkTreeViewColumn) accept GtkCellRenderer objects
* as &lt;child&gt; elements in UI definitions. They support a custom
* &lt;attributes&gt; element for their children, which can contain
......
......@@ -36,7 +36,7 @@
*
* #GtkCellRendererCombo renders text in a cell like #GtkCellRendererText from
* which it is derived. But while #GtkCellRendererText offers a simple entry to
* edit the text, #GtkCellRendererCombo offers a #GtkComboBox or #GtkComboBoxEntry
* edit the text, #GtkCellRendererCombo offers a #GtkComboBox
* widget to edit the text. The values to display in the combo box are taken from
* the tree model specified in the #GtkCellRendererCombo:model property.
*
......
......@@ -916,7 +916,7 @@
* <row>
* <entry>text-shadow</entry>
* <entry>shadow list (see above)</entry>
* <entry>#GtkTextShadow</entry>
* <entry>internal use only</entry>
* <entry><literallayout>text-shadow: 1 1 0 blue, -4 -4 red;</literallayout></entry>
* </row>
* <row>
......
......@@ -168,10 +168,10 @@ gtk_css_section_get_section_type (const GtkCssSection *section)
*
* Gets the parent section for the given @section. The parent section is
* the section that contains this @section. A special case are sections of
* type #GTK_CSS_SECTION_TYPE_DOCUMENT. Their parent will either be %NULL
* type #GTK_CSS_SECTION_DOCUMENT. Their parent will either be %NULL
* if they are the original CSS document that was loaded by
* gtk_css_provider_load_from_file() or a section of type
* #GTK_CSS_SECTION_TYPE_IMPORT if it was loaded with an import rule from
* #GTK_CSS_SECTION_IMPORT if it was loaded with an import rule from
* a different file.
*
* Returns: the parent section or %NULL if none
......
......@@ -7197,7 +7197,7 @@ gtk_entry_get_text_length (GtkEntry *entry)
*
* (For experts: if @setting is %TRUE, the entry calls
* gtk_window_activate_default() on the window containing the entry, in
* the default handler for the #GtkWidget::activate signal.)
* the default handler for the #GtkEntry::activate signal.)
**/
void
gtk_entry_set_activates_default (GtkEntry *entry,
......@@ -8202,7 +8202,7 @@ gtk_entry_get_icon_at_pos (GtkEntry *entry,
/**
* gtk_entry_set_icon_drag_source:
* @entry: a #GtkIconEntry
* @entry: a #GtkEntry
* @icon_pos: icon position
* @target_list: the targets (data formats) in which the data can be provided
* @actions: a bitmask of the allowed drag actions
......@@ -8495,7 +8495,7 @@ gtk_entry_get_icon_tooltip_markup (GtkEntry *entry,
* Use %NULL for @tooltip to remove an existing tooltip.
*
* See also gtk_widget_set_tooltip_markup() and
* gtk_enty_set_icon_tooltip_text().
* gtk_entry_set_icon_tooltip_text().
*
* Since: 2.16
*/
......
......@@ -42,7 +42,7 @@
* #GtkFileChooserDialog is a dialog box suitable for use with
* "File/Open" or "File/Save as" commands. This widget works by
* putting a #GtkFileChooserWidget inside a #GtkDialog. It exposes
* the #GtkFileChooserIface interface, so you can use all of the
* the #GtkFileChooser interface, so you can use all of the
* #GtkFileChooser functions on the file chooser dialog as well as
* those for #GtkDialog.
*
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment