docs: use proper quotations instead of '*'

This commit is contained in:
William Jon McCann 2014-02-07 14:03:49 -05:00
parent 4dee965116
commit 13998c55e7
60 changed files with 124 additions and 124 deletions

View File

@ -944,7 +944,7 @@ gdk_threads_add_idle (GSourceFunc function,
* event sources. Thus they should not be relied on for precise timing. * event sources. Thus they should not be relied on for precise timing.
* After each call to the timeout function, the time of the next * After each call to the timeout function, the time of the next
* timeout is recalculated based on the current time and the given interval * timeout is recalculated based on the current time and the given interval
* (it does not try to 'catch up' time lost in delays). * (it does not try to catch up time lost in delays).
* *
* This variant of g_timeout_add_full() can be thought of a MT-safe version * This variant of g_timeout_add_full() can be thought of a MT-safe version
* for GTK+ widgets for the following use case: * for GTK+ widgets for the following use case:

View File

@ -132,12 +132,12 @@ G_DEFINE_BOXED_TYPE (GdkColor, gdk_color,
* *
* The string can either one of a large set of standard names * The string can either one of a large set of standard names
* (taken from the X11 `rgb.txt` file), or * (taken from the X11 `rgb.txt` file), or
* it can be a hex value in the form '#rgb' '#rrggbb' * it can be a hex value in the form #rgb #rrggbb
* '#rrrgggbbb' or '#rrrrggggbbbb' where 'r', 'g' and * #rrrgggbbb or #rrrrggggbbbb where r, g and
* 'b' are hex digits of the red, green, and blue components * b are hex digits of the red, green, and blue components
* of the color, respectively. (White in the four forms is * of the color, respectively. (White in the four forms is
* '#fff', '#ffffff', '#fffffffff' and * #fff, #ffffff, #fffffffff and
* '#ffffffffffff'). * #ffffffffffff).
* *
* Return value: %TRUE if the parsing succeeded * Return value: %TRUE if the parsing succeeded
*/ */

View File

@ -282,8 +282,8 @@ gdk_cursor_new_from_name (GdkDisplay *display,
* gdk_cursor_new_from_pixbuf: * gdk_cursor_new_from_pixbuf:
* @display: the #GdkDisplay for which the cursor will be created * @display: the #GdkDisplay for which the cursor will be created
* @pixbuf: the #GdkPixbuf containing the cursor image * @pixbuf: the #GdkPixbuf containing the cursor image
* @x: the horizontal offset of the 'hotspot' of the cursor. * @x: the horizontal offset of the hotspot of the cursor.
* @y: the vertical offset of the 'hotspot' of the cursor. * @y: the vertical offset of the hotspot of the cursor.
* *
* Creates a new cursor from a pixbuf. * Creates a new cursor from a pixbuf.
* *
@ -353,8 +353,8 @@ gdk_cursor_new_from_pixbuf (GdkDisplay *display,
* gdk_cursor_new_from_surface: * gdk_cursor_new_from_surface:
* @display: the #GdkDisplay for which the cursor will be created * @display: the #GdkDisplay for which the cursor will be created
* @surface: the cairo image surface containing the cursor pixel data * @surface: the cairo image surface containing the cursor pixel data
* @x: the horizontal offset of the 'hotspot' of the cursor * @x: the horizontal offset of the hotspot of the cursor
* @y: the vertical offset of the 'hotspot' of the cursor * @y: the vertical offset of the hotspot of the cursor
* *
* Creates a new cursor from a cairo image surface. * Creates a new cursor from a cairo image surface.
* *

View File

@ -755,7 +755,7 @@ struct _GdkEventTouch
* usually configured to generate button press events for buttons 4 and 5 * usually configured to generate button press events for buttons 4 and 5
* when the wheel is turned. * when the wheel is turned.
* *
* Some GDK backends can also generate 'smooth' scroll events, which * Some GDK backends can also generate smooth scroll events, which
* can be recognized by the %GDK_SCROLL_SMOOTH scroll direction. For * can be recognized by the %GDK_SCROLL_SMOOTH scroll direction. For
* these, the scroll deltas can be obtained with * these, the scroll deltas can be obtained with
* gdk_event_get_scroll_deltas(). * gdk_event_get_scroll_deltas().

View File

@ -99,7 +99,7 @@ gdk_rgba_free (GdkRGBA *rgba)
* - For non-percentage values, we accept floats in the range 0-255 * - For non-percentage values, we accept floats in the range 0-255
* not just [0-9]+ integers * not just [0-9]+ integers
* - For percentage values we accept any float, not just * - For percentage values we accept any float, not just
* [ 0-9]+ | [0-9]* '.' [0-9]+ * [ 0-9]+ | [0-9]* . [0-9]+
* - We accept mixed percentages and non-percentages in a single * - We accept mixed percentages and non-percentages in a single
* rgb() or rgba() specification. * rgb() or rgba() specification.
*/ */
@ -142,13 +142,13 @@ parse_rgb_value (const gchar *str,
* *
* The string can be either one of: * The string can be either one of:
* - A standard name (Taken from the X11 rgb.txt file). * - A standard name (Taken from the X11 rgb.txt file).
* - A hex value in the form '#rgb' '#rrggbb' '#rrrgggbbb' * - A hex value in the form #rgb #rrggbb #rrrgggbbb
* or '#rrrrggggbbbb' * or #rrrrggggbbbb
* - A RGB color in the form 'rgb(r,g,b)' (In this case the color will * - A RGB color in the form rgb(r,g,b) (In this case the color will
* have full opacity) * have full opacity)
* - A RGBA color in the form 'rgba(r,g,b,a)' * - A RGBA color in the form rgba(r,g,b,a)
* *
* Where 'r', 'g', 'b' and 'a' are respectively the red, green, blue and * Where r, g, b and a are respectively the red, green, blue and
* alpha color values. In the last two cases, r g and b are either integers * alpha color values. In the last two cases, r g and b are either integers
* in the range 0 to 255 or precentage values in the range 0% to 100%, and * in the range 0 to 255 or precentage values in the range 0% to 100%, and
* a is a floating point value in the range 0 to 1. * a is a floating point value in the range 0 to 1.
@ -332,7 +332,7 @@ gdk_rgba_equal (gconstpointer p1,
* Returns a textual specification of @rgba in the form * Returns a textual specification of @rgba in the form
* `rgb (r, g, b)` or * `rgb (r, g, b)` or
* `rgba (r, g, b, a)`, * `rgba (r, g, b, a)`,
* where 'r', 'g', 'b' and 'a' represent the red, green, * where r, g, b and a represent the red, green,
* blue and alpha values respectively. r, g, and b are * blue and alpha values respectively. r, g, and b are
* represented as integers in the range 0 to 255, and a * represented as integers in the range 0 to 255, and a
* is represented as floating point value in the range 0 to 1. * is represented as floating point value in the range 0 to 1.

View File

@ -687,7 +687,7 @@ gdk_screen_get_n_monitors (GdkScreen *screen)
* @screen: a #GdkScreen. * @screen: a #GdkScreen.
* *
* Gets the primary monitor for @screen. The primary monitor * Gets the primary monitor for @screen. The primary monitor
* is considered the monitor where the 'main desktop' lives. * is considered the monitor where the main desktop lives.
* While normal application windows typically allow the window * While normal application windows typically allow the window
* manager to place the windows, specialized desktop applications * manager to place the windows, specialized desktop applications
* such as panels should place themselves on the primary monitor. * such as panels should place themselves on the primary monitor.

View File

@ -6830,11 +6830,11 @@ static const gdk_key gdk_keys_by_name[] = {
#if 0 #if 0
/* /*
* Translators, the strings in the 'keyboard label' context are * Translators, the strings in the keyboard label context are
* display names for keyboard keys. Some of them have prefixes like * display names for keyboard keys. Some of them have prefixes like
* XF86 or ISO_ - these should be removed in the translation. Similarly, * XF86 or ISO_ - these should be removed in the translation. Similarly,
* underscores should be replaced by spaces. The prefix 'KP_' stands * underscores should be replaced by spaces. The prefix KP_ stands
* for 'key pad' and you may want to include that in your translation. * for key pad and you may want to include that in your translation.
* Here are some examples of English translations: * Here are some examples of English translations:
* XF86AudioMute - Audio mute * XF86AudioMute - Audio mute
* Scroll_lock - Scroll lock * Scroll_lock - Scroll lock

View File

@ -88,7 +88,7 @@ static guint run_loop_n_pollfds; /* Number of file descriptors in the array *
* we need to make sure that the poll function is always called even * we need to make sure that the poll function is always called even
* when there are no file descriptors that need to be polled. To do * when there are no file descriptors that need to be polled. To do
* this, we add a dummy GPollFD to our event source with a file * this, we add a dummy GPollFD to our event source with a file
* descriptor of '-1'. Then any time that GLib is polling the event * descriptor of -1. Then any time that GLib is polling the event
* source, it will call our poll function. * source, it will call our poll function.
*/ */
static GPollFD event_poll_fd; static GPollFD event_poll_fd;

View File

@ -2630,7 +2630,7 @@ gtk_color_selection_get_current_alpha (GtkColorSelection *colorsel)
* @colorsel: a #GtkColorSelection * @colorsel: a #GtkColorSelection
* @color: a #GdkColor to set the previous color with * @color: a #GdkColor to set the previous color with
* *
* Sets the 'previous' color to be @color. * Sets the previous color to be @color.
* *
* This function should be called with some hesitations, * This function should be called with some hesitations,
* as it might seem confusing to have that color change. * as it might seem confusing to have that color change.
@ -2669,7 +2669,7 @@ gtk_color_selection_set_previous_color (GtkColorSelection *colorsel,
* @colorsel: a #GtkColorSelection * @colorsel: a #GtkColorSelection
* @alpha: an integer between 0 and 65535 * @alpha: an integer between 0 and 65535
* *
* Sets the 'previous' alpha to be @alpha. * Sets the previous alpha to be @alpha.
* *
* This function should be called with some hesitations, * This function should be called with some hesitations,
* as it might seem confusing to have that alpha change. * as it might seem confusing to have that alpha change.
@ -2811,7 +2811,7 @@ gtk_color_selection_get_current_rgba (GtkColorSelection *colorsel,
* @colorsel: a #GtkColorSelection * @colorsel: a #GtkColorSelection
* @rgba: a #GdkRGBA to set the previous color with * @rgba: a #GdkRGBA to set the previous color with
* *
* Sets the 'previous' color to be @rgba. * Sets the previous color to be @rgba.
* *
* This function should be called with some hesitations, * This function should be called with some hesitations,
* as it might seem confusing to have that color change. * as it might seem confusing to have that color change.

View File

@ -1206,7 +1206,7 @@ gtk_font_selection_update_preview (GtkFontSelection *fontsel)
* @fontsel: a #GtkFontSelection * @fontsel: a #GtkFontSelection
* *
* This returns the #GtkTreeView that lists font families, for * This returns the #GtkTreeView that lists font families, for
* example, 'Sans', 'Serif', etc. * example, Sans, Serif, etc.
* *
* Return value: (transfer none): A #GtkWidget that is part of @fontsel * Return value: (transfer none): A #GtkWidget that is part of @fontsel
* *
@ -1227,7 +1227,7 @@ gtk_font_selection_get_family_list (GtkFontSelection *fontsel)
* @fontsel: a #GtkFontSelection * @fontsel: a #GtkFontSelection
* *
* This returns the #GtkTreeView which lists all styles available for * This returns the #GtkTreeView which lists all styles available for
* the selected font. For example, 'Regular', 'Bold', etc. * the selected font. For example, Regular, Bold, etc.
* *
* Return value: (transfer none): A #GtkWidget that is part of @fontsel * Return value: (transfer none): A #GtkWidget that is part of @fontsel
* *
@ -1759,10 +1759,10 @@ gtk_font_selection_dialog_get_font_selection (GtkFontSelectionDialog *fsd)
* gtk_font_selection_dialog_get_ok_button: * gtk_font_selection_dialog_get_ok_button:
* @fsd: a #GtkFontSelectionDialog * @fsd: a #GtkFontSelectionDialog
* *
* Gets the 'OK' button. * Gets the OK button.
* *
* Return value: (transfer none): the #GtkWidget used in the dialog * Return value: (transfer none): the #GtkWidget used in the dialog
* for the 'OK' button. * for the OK button.
* *
* Since: 2.14 * Since: 2.14
* *
@ -1780,10 +1780,10 @@ gtk_font_selection_dialog_get_ok_button (GtkFontSelectionDialog *fsd)
* gtk_font_selection_dialog_get_cancel_button: * gtk_font_selection_dialog_get_cancel_button:
* @fsd: a #GtkFontSelectionDialog * @fsd: a #GtkFontSelectionDialog
* *
* Gets the 'Cancel' button. * Gets the Cancel button.
* *
* Return value: (transfer none): the #GtkWidget used in the dialog * Return value: (transfer none): the #GtkWidget used in the dialog
* for the 'Cancel' button. * for the Cancel button.
* *
* Since: 2.14 * Since: 2.14
* *

View File

@ -38,7 +38,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* *
* A button box should be used to provide a consistent layout of buttons * A button box should be used to provide a consistent layout of buttons
* throughout your application. The layout/spacing can be altered by the * throughout your application. The layout/spacing can be altered by the
* programmer, or if desired, by the user to alter the 'feel' of a * programmer, or if desired, by the user to alter the feel of a
* program to a small degree. * program to a small degree.
* *
* A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are * A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are

View File

@ -44,11 +44,11 @@
/** /**
* SECTION:gtkhsv * SECTION:gtkhsv
* @Short_description: A 'color wheel' widget * @Short_description: A color wheel widget
* @Title: GtkHSV * @Title: GtkHSV
* @See_also: #GtkColorSelection, #GtkColorSelectionDialog * @See_also: #GtkColorSelection, #GtkColorSelectionDialog
* *
* #GtkHSV is the 'color wheel' part of a complete color selector widget. * #GtkHSV is the color wheel part of a complete color selector widget.
* It allows to select a color by determining its HSV components in an * It allows to select a color by determining its HSV components in an
* intuitive way. Moving the selection around the outer ring changes the hue, * intuitive way. Moving the selection around the outer ring changes the hue,
* and moving the selection point inside the inner triangle changes value and * and moving the selection point inside the inner triangle changes value and

View File

@ -249,8 +249,8 @@
* # Toplevel declarations # * # Toplevel declarations #
* *
* An RC file is a text file which is composed of a sequence * An RC file is a text file which is composed of a sequence
* of declarations. `'#'` characters delimit comments and * of declarations. `#` characters delimit comments and
* the portion of a line after a `'#'` is ignored when parsing * the portion of a line after a `#` is ignored when parsing
* an RC file. * an RC file.
* *
* The possible toplevel declarations are: * The possible toplevel declarations are:

View File

@ -721,7 +721,7 @@ gtk_table_resize (GtkTable *table,
* @xpadding: An integer value specifying the padding on the left and right of the widget being added to the table. * @xpadding: An integer value specifying the padding on the left and right of the widget being added to the table.
* @ypadding: The amount of padding above and below the child widget. * @ypadding: The amount of padding above and below the child widget.
* *
* Adds a widget to a table. The number of 'cells' that a widget will occupy is * Adds a widget to a table. The number of cells that a widget will occupy is
* specified by @left_attach, @right_attach, @top_attach and @bottom_attach. * specified by @left_attach, @right_attach, @top_attach and @bottom_attach.
* These each represent the leftmost, rightmost, uppermost and lowest column * These each represent the leftmost, rightmost, uppermost and lowest column
* and row numbers of the table. (Columns and rows are indexed from zero). * and row numbers of the table. (Columns and rows are indexed from zero).

View File

@ -113,9 +113,9 @@
* *
* If a name is not specified, it defaults to the action. If an action is * If a name is not specified, it defaults to the action. If an action is
* not specified either, the element name is used. The name and action * not specified either, the element name is used. The name and action
* attributes must not contain '/' characters after parsing (since that * attributes must not contain / characters after parsing (since that
* would mess up path lookup) and must be usable as XML attributes when * would mess up path lookup) and must be usable as XML attributes when
* enclosed in doublequotes, thus they must not '"' characters or references * enclosed in doublequotes, thus they must not "” characters or references
* to the " entity. * to the " entity.
* *
* # A UI definition # * # A UI definition #
@ -1092,7 +1092,7 @@ gtk_ui_manager_get_accel_group (GtkUIManager *manager)
* *
* Looks up a widget by following a path. * Looks up a widget by following a path.
* The path consists of the names specified in the XML description of the UI. * The path consists of the names specified in the XML description of the UI.
* separated by '/'. Elements which dont have a name or action attribute in * separated by /. Elements which dont have a name or action attribute in
* the XML (e.g. <popup>) can be addressed by their XML element name * the XML (e.g. <popup>) can be addressed by their XML element name
* (e.g. "popup"). The root element ("/ui") can be omitted in the path. * (e.g. "popup"). The root element ("/ui") can be omitted in the path.
* *

View File

@ -38,7 +38,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* *
* A button box should be used to provide a consistent layout of buttons * A button box should be used to provide a consistent layout of buttons
* throughout your application. The layout/spacing can be altered by the * throughout your application. The layout/spacing can be altered by the
* programmer, or if desired, by the user to alter the 'feel' of a * programmer, or if desired, by the user to alter the feel of a
* program to a small degree. * program to a small degree.
* *
* A #GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons are * A #GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons are

View File

@ -94,7 +94,7 @@
* *
* It is also possible to show a #GtkAboutDialog like any other #GtkDialog, * It is also possible to show a #GtkAboutDialog like any other #GtkDialog,
* e.g. using gtk_dialog_run(). In this case, you might need to know that * e.g. using gtk_dialog_run(). In this case, you might need to know that
* the 'Close' button returns the #GTK_RESPONSE_CANCEL response id. * the Close button returns the #GTK_RESPONSE_CANCEL response id.
*/ */
/* Translators: this is the license preamble; the string at the end /* Translators: this is the license preamble; the string at the end

View File

@ -37,9 +37,9 @@
* particular context into a single action group, with namespacing. * particular context into a single action group, with namespacing.
* *
* Consider the case of two action groups -- one containing actions * Consider the case of two action groups -- one containing actions
* applicable to an entire application (such as 'quit') and one * applicable to an entire application (such as quit) and one
* containing actions applicable to a particular window in the * containing actions applicable to a particular window in the
* application (such as 'fullscreen'). * application (such as fullscreen).
* *
* In this case, each of these action groups could be added to a * In this case, each of these action groups could be added to a
* #GtkActionMuxer with the prefixes app and win, respectively. This * #GtkActionMuxer with the prefixes app and win, respectively. This

View File

@ -67,7 +67,7 @@
* actions invoked in a predictable context it is therefore recommended * actions invoked in a predictable context it is therefore recommended
* that the GDK lock be held while invoking actions locally with * that the GDK lock be held while invoking actions locally with
* g_action_group_activate_action(). The same applies to actions * g_action_group_activate_action(). The same applies to actions
* associated with #GtkApplicationWindow and to the 'activate' and * associated with #GtkApplicationWindow and to the activate and
* 'open' #GApplication methods. * 'open' #GApplication methods.
* *
* To set an application menu for a GtkApplication, use * To set an application menu for a GtkApplication, use
@ -1082,7 +1082,7 @@ gtk_application_update_accels (GtkApplication *application)
* are referred to with an app. prefix, and window-specific actions * are referred to with an app. prefix, and window-specific actions
* with a win. prefix. * with a win. prefix.
* *
* GtkApplication also extracts accelerators out of 'accel' attributes * GtkApplication also extracts accelerators out of accel attributes
* in the #GMenuModels passed to gtk_application_set_app_menu() and * in the #GMenuModels passed to gtk_application_set_app_menu() and
* gtk_application_set_menubar(), which is usually more convenient * gtk_application_set_menubar(), which is usually more convenient
* than calling this function for each accelerator. * than calling this function for each accelerator.

View File

@ -29,7 +29,7 @@
* *
* A button box should be used to provide a consistent layout of buttons * A button box should be used to provide a consistent layout of buttons
* throughout your application. The layout/spacing can be altered by the * throughout your application. The layout/spacing can be altered by the
* programmer, or if desired, by the user to alter the 'feel' of a * programmer, or if desired, by the user to alter the feel of a
* program to a small degree. * program to a small degree.
* *
* gtk_button_box_get_layout() and gtk_button_box_set_layout() retrieve and * gtk_button_box_get_layout() and gtk_button_box_set_layout() retrieve and

View File

@ -49,7 +49,7 @@
* *
* # Installing a key binding * # Installing a key binding
* *
* A CSS file binding consists of a 'binding-set' definition and a match * A CSS file binding consists of a binding-set definition and a match
* statement to apply the binding set to specific widget types. Details * statement to apply the binding set to specific widget types. Details
* on the matching mechanism are described under * on the matching mechanism are described under
* [Selectors][gtkcssprovider-selectors] * [Selectors][gtkcssprovider-selectors]

View File

@ -1375,7 +1375,7 @@ gtk_button_new_from_stock (const gchar *stock_id)
* *
* Creates a new #GtkButton containing a label. * Creates a new #GtkButton containing a label.
* If characters in @label are preceded by an underscore, they are underlined. * If characters in @label are preceded by an underscore, they are underlined.
* If you need a literal underscore character in a label, use '__' (two * If you need a literal underscore character in a label, use __ (two
* underscores). The first underlined character represents a keyboard * underscores). The first underlined character represents a keyboard
* accelerator called a mnemonic. * accelerator called a mnemonic.
* Pressing Alt and that key activates the button. * Pressing Alt and that key activates the button.

View File

@ -165,8 +165,8 @@ _blurcol (guchar* pixels,
* @aprec: precision of alpha parameter in fixed-point format 0.aprec * @aprec: precision of alpha parameter in fixed-point format 0.aprec
* @zprec: precision of state parameters zR,zG,zB and zA in fp format 8.zprec * @zprec: precision of state parameters zR,zG,zB and zA in fp format 8.zprec
* *
* Performs an in-place blur of image data 'pixels' * Performs an in-place blur of image data pixels
* with kernel of approximate radius 'radius'. * with kernel of approximate radius radius.
* *
* Blurs with two sided exponential impulse response. * Blurs with two sided exponential impulse response.
* *

View File

@ -1394,7 +1394,7 @@ gtk_cell_renderer_real_get_aligned_area (GtkCellRenderer *cell,
* cell alignment in a target allocation (used to draw focus and align * cell alignment in a target allocation (used to draw focus and align
* cells in the icon view). * cells in the icon view).
* *
* Note this is only a trivial 'align * (allocation - request)' operation. * Note this is only a trivial align * (allocation - request) operation.
*/ */
void void
_gtk_cell_renderer_calc_offset (GtkCellRenderer *cell, _gtk_cell_renderer_calc_offset (GtkCellRenderer *cell,

View File

@ -80,7 +80,7 @@
* not restricted to a flat list, it can be a real tree, and the popup will * not restricted to a flat list, it can be a real tree, and the popup will
* reflect the tree structure. * reflect the tree structure.
* *
* To allow the user to enter values not in the model, the 'has-entry' * To allow the user to enter values not in the model, the has-entry
* property allows the GtkComboBox to contain a #GtkEntry. This entry * property allows the GtkComboBox to contain a #GtkEntry. This entry
* can be accessed by calling gtk_bin_get_child() on the combo box. * can be accessed by calling gtk_bin_get_child() on the combo box.
* *

View File

@ -44,7 +44,7 @@
* or gtk_combo_box_text_prepend_text() and remove options with * or gtk_combo_box_text_prepend_text() and remove options with
* gtk_combo_box_text_remove(). * gtk_combo_box_text_remove().
* *
* If the GtkComboBoxText contains an entry (via the 'has-entry' property), * If the GtkComboBoxText contains an entry (via the has-entry property),
* its contents can be retrieved using gtk_combo_box_text_get_active_text(). * its contents can be retrieved using gtk_combo_box_text_get_active_text().
* The entry itself can be accessed by calling gtk_bin_get_child() on the * The entry itself can be accessed by calling gtk_bin_get_child() on the
* combo box. * combo box.

View File

@ -185,7 +185,7 @@ gtk_css_custom_property_create_initial_value (GParamSpec *pspec)
* be the theme engine name. * be the theme engine name.
* *
* For any type a @parse_func may be provided, being this function * For any type a @parse_func may be provided, being this function
* used for turning any property value (between ':' and ';') in * used for turning any property value (between : and ;) in
* CSS to the #GValue needed. For basic types there is already * CSS to the #GValue needed. For basic types there is already
* builtin parsing support, so %NULL may be provided for these * builtin parsing support, so %NULL may be provided for these
* cases. * cases.

View File

@ -74,7 +74,7 @@
* # Style sheets * # Style sheets
* *
* The basic structure of the style sheets understood by this provider is * The basic structure of the style sheets understood by this provider is
* a series of statements, which are either rule sets or '@-rules', separated * a series of statements, which are either rule sets or @-rules, separated
* by whitespace. * by whitespace.
* *
* A rule set consists of a selector and a declaration block, which is * A rule set consists of a selector and a declaration block, which is
@ -96,7 +96,7 @@
* Selectors work very similar to the way they do in CSS, with widget class * Selectors work very similar to the way they do in CSS, with widget class
* names taking the role of element names, and widget names taking the role * names taking the role of element names, and widget names taking the role
* of IDs. When used in a selector, widget names must be prefixed with a * of IDs. When used in a selector, widget names must be prefixed with a
* '#' character. The '*' character represents the so-called universal * '#' character. The * character represents the so-called universal
* selector, which matches any widget. * selector, which matches any widget.
* *
* To express more complicated situations, selectors can be combined in * To express more complicated situations, selectors can be combined in
@ -111,7 +111,7 @@
* that occur inside a GtkToolBar. * that occur inside a GtkToolBar.
* - In the previous example, the GtkButton is matched even * - In the previous example, the GtkButton is matched even
* if it occurs deeply nested inside the toolbar. To restrict the match * if it occurs deeply nested inside the toolbar. To restrict the match
* to direct children of the parent widget, insert a '>' character between * to direct children of the parent widget, insert a > character between
* the two selectors. E.g. `GtkNotebook > GtkLabel` matches * the two selectors. E.g. `GtkNotebook > GtkLabel` matches
* GtkLabel widgets that are direct children of a GtkNotebook. * GtkLabel widgets that are direct children of a GtkNotebook.
* *
@ -153,7 +153,7 @@
* ]| * ]|
* *
* Widgets may also define style classes, which can be used for matching. * Widgets may also define style classes, which can be used for matching.
* When used in a selector, style classes must be prefixed with a '.' * When used in a selector, style classes must be prefixed with a .
* character. * character.
* *
* Refer to the documentation of individual widgets to learn which * Refer to the documentation of individual widgets to learn which
@ -425,12 +425,12 @@
* color-stop (@position, @color), * color-stop (@position, @color),
* ...)</literallayout> * ...)</literallayout>
* where @start_x and @end_x can be either a floating point number between * where @start_x and @end_x can be either a floating point number between
* 0 and 1 or one of the special values 'left', 'right' or 'center', @start_y * 0 and 1 or one of the special values left, right or center, @start_y
* and @end_y can be either a floating point number between 0 and 1 or one * and @end_y can be either a floating point number between 0 and 1 or one
* of the special values 'top', 'bottom' or 'center', @position is a floating * of the special values top, bottom or center, @position is a floating
* point number between 0 and 1 and @color is a color expression (see above). * point number between 0 and 1 and @color is a color expression (see above).
* The color-stop can be repeated multiple times to add more than one color * The color-stop can be repeated multiple times to add more than one color
* stop. 'from (@color)' and 'to (@color)' can be used as abbreviations for * stop. from (@color) and to (@color) can be used as abbreviations for
* color stops with position 0 and 1, respectively. * color stops with position 0 and 1, respectively.
* *
* An example for a linear gradient: * An example for a linear gradient:
@ -558,12 +558,12 @@
* outlined by border-width. * outlined by border-width.
* The default (stretch) is to resize the slice to fill in the whole * The default (stretch) is to resize the slice to fill in the whole
* allocated area. * allocated area.
* If the value of this property is 'repeat', the image slice * If the value of this property is repeat, the image slice
* will be tiled to fill the area. * will be tiled to fill the area.
* If the value of this property is 'round', the image slice will * If the value of this property is round, the image slice will
* be tiled to fill the area, and scaled to fit it exactly * be tiled to fill the area, and scaled to fit it exactly
* a whole number of times. * a whole number of times.
* If the value of this property is 'space', the image slice will * If the value of this property is space, the image slice will
* be tiled to fill the area, and if it doesnt fit it exactly a whole * be tiled to fill the area, and if it doesnt fit it exactly a whole
* number of times, the extra space is distributed as padding around * number of times, the extra space is distributed as padding around
* the slices. * the slices.
@ -803,7 +803,7 @@
* center center, 0.8, * center center, 0.8,
* color-stop (0.0, &num;fff), * color-stop (0.0, &num;fff),
* color-stop (1.0, &num;000)); * color-stop (1.0, &num;000));
* url ('background.png');</literallayout> * url ("background.png");</literallayout>
* </entry> * </entry>
* </row> * </row>
* <row> * <row>

View File

@ -66,11 +66,11 @@
* recommended; it allows you to set the dialog title, some convenient * recommended; it allows you to set the dialog title, some convenient
* flags, and add simple buttons. * flags, and add simple buttons.
* *
* If 'dialog' is a newly created dialog, the two primary areas of the * If dialog is a newly created dialog, the two primary areas of the
* window can be accessed through gtk_dialog_get_content_area() and * window can be accessed through gtk_dialog_get_content_area() and
* gtk_dialog_get_action_area(), as can be seen from the example below. * gtk_dialog_get_action_area(), as can be seen from the example below.
* *
* A 'modal' dialog (that is, one which freezes the rest of the application * A modal dialog (that is, one which freezes the rest of the application
* from user input), can be created by calling gtk_window_set_modal() on the * from user input), can be created by calling gtk_window_set_modal() on the
* dialog. Use the GTK_WINDOW() macro to cast the widget returned from * dialog. Use the GTK_WINDOW() macro to cast the widget returned from
* gtk_dialog_new() into a #GtkWindow. When using gtk_dialog_new_with_buttons() * gtk_dialog_new() into a #GtkWindow. When using gtk_dialog_new_with_buttons()

View File

@ -83,7 +83,7 @@
* *
* When using an entry for passwords and other sensitive information, * When using an entry for passwords and other sensitive information,
* it can be put into password mode using gtk_entry_set_visibility(). * it can be put into password mode using gtk_entry_set_visibility().
* In this mode, entered text is displayed using a 'invisible' character. * In this mode, entered text is displayed using a invisible character.
* By default, GTK+ picks the best invisible character that is available * By default, GTK+ picks the best invisible character that is available
* in the current font, but it can be changed with * in the current font, but it can be changed with
* gtk_entry_set_invisible_char(). Since 2.16, GTK+ displays a warning * gtk_entry_set_invisible_char(). Since 2.16, GTK+ displays a warning

View File

@ -1207,10 +1207,10 @@ G_END_DECLS
* The difference between @GTK_INPUT_PURPOSE_DIGITS and * The difference between @GTK_INPUT_PURPOSE_DIGITS and
* @GTK_INPUT_PURPOSE_NUMBER is that the former accepts only digits * @GTK_INPUT_PURPOSE_NUMBER is that the former accepts only digits
* while the latter also some punctuation (like commas or points, plus, * while the latter also some punctuation (like commas or points, plus,
* minus) and 'e' or 'E' as in 3.14E+000. * minus) and e or E as in 3.14E+000.
* *
* This enumeration may be extended in the future; input methods should * This enumeration may be extended in the future; input methods should
* interpret unknown values as 'free form'. * interpret unknown values as free form.
* *
* Since: 3.6 * Since: 3.6
*/ */

View File

@ -1648,7 +1648,7 @@ gtk_expander_new (const gchar *label)
* *
* Creates a new expander using @label as the text of the label. * Creates a new expander using @label as the text of the label.
* If characters in @label are preceded by an underscore, they are underlined. * If characters in @label are preceded by an underscore, they are underlined.
* If you need a literal underscore character in a label, use '__' (two * If you need a literal underscore character in a label, use __ (two
* underscores). The first underlined character represents a keyboard * underscores). The first underlined character represents a keyboard
* accelerator called a mnemonic. * accelerator called a mnemonic.
* Pressing Alt and that key activates the button. * Pressing Alt and that key activates the button.

View File

@ -1152,7 +1152,7 @@ key_is_left_or_right (GdkEventKey *event)
} }
/* Handles key press events on the file list, so that we can trap Enter to /* Handles key press events on the file list, so that we can trap Enter to
* activate the default button on our own. Also, checks to see if '/' has been * activate the default button on our own. Also, checks to see if / has been
* pressed. * pressed.
*/ */
static gboolean static gboolean

View File

@ -1823,7 +1823,7 @@ gtk_grid_new (void)
* Adds a widget to the grid. * Adds a widget to the grid.
* *
* The position of @child is determined by @left and @top. The * The position of @child is determined by @left and @top. The
* number of 'cells' that @child will occupy is determined by * number of cells that @child will occupy is determined by
* @width and @height. * @width and @height.
*/ */
void void

View File

@ -4317,7 +4317,7 @@ _gtk_icon_info_load_symbolic_internal (GtkIconInfo *icon_info,
* *
* As implementation details, the icon loaded needs to be of SVG type, * As implementation details, the icon loaded needs to be of SVG type,
* contain the symbolic term as the last component of the icon name, * contain the symbolic term as the last component of the icon name,
* and use the 'fg', 'success', 'warning' and 'error' CSS styles in the * and use the fg, success, warning and error CSS styles in the
* SVG file itself. * SVG file itself.
* *
* See the [Symbolic Icons Specification](http://www.freedesktop.org/wiki/SymbolicIcons) * See the [Symbolic Icons Specification](http://www.freedesktop.org/wiki/SymbolicIcons)
@ -4853,7 +4853,7 @@ gtk_icon_info_load_symbolic_for_style (GtkIconInfo *icon_info,
* icons, they are in a 1000x1000 coordinate space that is scaled * icons, they are in a 1000x1000 coordinate space that is scaled
* to the final size of the icon. You can determine if the icon is an SVG * to the final size of the icon. You can determine if the icon is an SVG
* icon by using gtk_icon_info_get_filename(), and seeing if it is non-%NULL * icon by using gtk_icon_info_get_filename(), and seeing if it is non-%NULL
* and ends in '.svg'. * and ends in .svg.
* *
* This function is provided primarily to allow compatibility wrappers * This function is provided primarily to allow compatibility wrappers
* for older API's, and is not expected to be useful for applications. * for older API's, and is not expected to be useful for applications.

View File

@ -639,10 +639,10 @@ _gtk_im_module_create (const gchar *context_id)
/* Match @locale against @against. /* Match @locale against @against.
* *
* 'en_US' against 'en_US' => 4 * 'en_US' against en_US => 4
* 'en_US' against 'en' => 3 * 'en_US' against en => 3
* 'en', 'en_UK' against 'en_US' => 2 * 'en', en_UK against en_US => 2
* all locales, against '*' => 1 * all locales, against * => 1
*/ */
static gint static gint
match_locale (const gchar *locale, match_locale (const gchar *locale,

View File

@ -955,7 +955,7 @@ gtk_info_bar_set_default_response (GtkInfoBar *info_bar,
* @info_bar: a #GtkInfoBar * @info_bar: a #GtkInfoBar
* @response_id: a response ID * @response_id: a response ID
* *
* Emits the 'response' signal with the given @response_id. * Emits the response signal with the given @response_id.
* *
* Since: 2.18 * Since: 2.18
*/ */

View File

@ -254,7 +254,7 @@ struct _GtkLabelPrivate
* There are some new fields for links. The links field contains the list * There are some new fields for links. The links field contains the list
* of GtkLabelLink structs that describe the links which are embedded in * of GtkLabelLink structs that describe the links which are embedded in
* the label. The active_link field points to the link under the mouse * the label. The active_link field points to the link under the mouse
* pointer. For keyboard navigation, the 'focus' link is determined by * pointer. For keyboard navigation, the focus link is determined by
* finding the link which contains the selection_anchor position. * finding the link which contains the selection_anchor position.
* The link_clicked field is used with button press and release events * The link_clicked field is used with button press and release events
* to ensure that pressing inside a link and releasing outside of it * to ensure that pressing inside a link and releasing outside of it

View File

@ -679,7 +679,7 @@ gtk_link_button_query_tooltip_cb (GtkWidget *widget,
* @uri: a valid URI * @uri: a valid URI
* *
* Sets @uri as the URI where the #GtkLinkButton points. As a side-effect * Sets @uri as the URI where the #GtkLinkButton points. As a side-effect
* this unsets the 'visited' state of the button. * this unsets the visited state of the button.
* *
* Since: 2.10 * Since: 2.10
*/ */
@ -724,9 +724,9 @@ gtk_link_button_get_uri (GtkLinkButton *link_button)
/** /**
* gtk_link_button_set_visited: * gtk_link_button_set_visited:
* @link_button: a #GtkLinkButton * @link_button: a #GtkLinkButton
* @visited: the new 'visited' state * @visited: the new visited state
* *
* Sets the 'visited' state of the URI where the #GtkLinkButton * Sets the visited state of the URI where the #GtkLinkButton
* points. See gtk_link_button_get_visited() for more details. * points. See gtk_link_button_get_visited() for more details.
* *
* Since: 2.14 * Since: 2.14
@ -762,9 +762,9 @@ gtk_link_button_set_visited (GtkLinkButton *link_button,
* gtk_link_button_get_visited: * gtk_link_button_get_visited:
* @link_button: a #GtkLinkButton * @link_button: a #GtkLinkButton
* *
* Retrieves the 'visited' state of the URI where the #GtkLinkButton * Retrieves the visited state of the URI where the #GtkLinkButton
* points. The button becomes visited when it is clicked. If the URI * points. The button becomes visited when it is clicked. If the URI
* is changed on the button, the 'visited' state is unset again. * is changed on the button, the visited state is unset again.
* *
* The state may also be changed using gtk_link_button_set_visited(). * The state may also be changed using gtk_link_button_set_visited().
* *

View File

@ -5075,7 +5075,7 @@ gtk_menu_set_screen (GtkMenu *menu,
* @top_attach: The row number to attach the top of the item to * @top_attach: The row number to attach the top of the item to
* @bottom_attach: The row number to attach the bottom of the item to * @bottom_attach: The row number to attach the bottom of the item to
* *
* Adds a new #GtkMenuItem to a (table) menu. The number of 'cells' that * Adds a new #GtkMenuItem to a (table) menu. The number of cells that
* an item will occupy is specified by @left_attach, @right_attach, * an item will occupy is specified by @left_attach, @right_attach,
* @top_attach and @bottom_attach. These each represent the leftmost, * @top_attach and @bottom_attach. These each represent the leftmost,
* rightmost, uppermost and lower column and row numbers of the table. * rightmost, uppermost and lower column and row numbers of the table.

View File

@ -38,7 +38,7 @@
* text direction) of the menu aligned with the starting edge of the button. * text direction) of the menu aligned with the starting edge of the button.
* If there is not enough space below the button, the menu is popped up above * If there is not enough space below the button, the menu is popped up above
* the button instead. If the alignment would move part of the menu offscreen, * the button instead. If the alignment would move part of the menu offscreen,
* it is 'pushed in'. * it is pushed in.
* *
* ## Direction = Down * ## Direction = Down
* *

View File

@ -1549,7 +1549,7 @@ gtk_menu_shell_select_submenu_first (GtkMenuShell *menu_shell)
* menubars working, if submenu_placement is different for * menubars working, if submenu_placement is different for
* the menu and its MenuShell then the following apply: * the menu and its MenuShell then the following apply:
* *
* - For 'parent' the current menu is not just moved to * - For parent the current menu is not just moved to
* the parent, but moved to the previous entry in the parent * the parent, but moved to the previous entry in the parent
* - For 'child', if there is no child, then current is * - For 'child', if there is no child, then current is
* moved to the next item in the parent. * moved to the next item in the parent.

View File

@ -146,7 +146,7 @@ gtk_menu_tracker_section_find_model (GtkMenuTrackerSection *section,
* before us (ie: we should add a separator if we have content in * before us (ie: we should add a separator if we have content in
* order to divide us from the items above) * order to divide us from the items above)
* *
* - if we had a 'label' attribute set for this section * - if we had a label attribute set for this section
* *
* parent_model and parent_index are passed in so that we can give them * parent_model and parent_index are passed in so that we can give them
* to the insertion callback so that it can see the label (and anything * to the insertion callback so that it can see the label (and anything

View File

@ -6953,7 +6953,7 @@ gtk_notebook_menu_detacher (GtkWidget *widget,
* @notebook: a #GtkNotebook * @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page * @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label * @tab_label: (allow-none): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, 'page N' * for the page, or %NULL to use the default label, page N
* *
* Appends a page to @notebook. * Appends a page to @notebook.
* *
@ -6977,7 +6977,7 @@ gtk_notebook_append_page (GtkNotebook *notebook,
* @notebook: a #GtkNotebook * @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page * @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label * @tab_label: (allow-none): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, 'page N' * for the page, or %NULL to use the default label, page N
* @menu_label: (allow-none): the widget to use as a label for the * @menu_label: (allow-none): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label * page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly * is a #GtkLabel or %NULL, then the menu label will be a newly
@ -7010,7 +7010,7 @@ gtk_notebook_append_page_menu (GtkNotebook *notebook,
* @notebook: a #GtkNotebook * @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page * @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label * @tab_label: (allow-none): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, 'page N' * for the page, or %NULL to use the default label, page N
* *
* Prepends a page to @notebook. * Prepends a page to @notebook.
* *
@ -7034,7 +7034,7 @@ gtk_notebook_prepend_page (GtkNotebook *notebook,
* @notebook: a #GtkNotebook * @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page * @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label * @tab_label: (allow-none): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, 'page N' * for the page, or %NULL to use the default label, page N
* @menu_label: (allow-none): the widget to use as a label for the * @menu_label: (allow-none): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label * page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly * is a #GtkLabel or %NULL, then the menu label will be a newly
@ -7067,7 +7067,7 @@ gtk_notebook_prepend_page_menu (GtkNotebook *notebook,
* @notebook: a #GtkNotebook * @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page * @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label * @tab_label: (allow-none): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, 'page N' * for the page, or %NULL to use the default label, page N
* @position: the index (starting at 0) at which to insert the page, * @position: the index (starting at 0) at which to insert the page,
* or -1 to append the page after all other pages * or -1 to append the page after all other pages
* *
@ -7125,7 +7125,7 @@ gtk_notebook_mnemonic_activate_switch_page (GtkWidget *child,
* @notebook: a #GtkNotebook * @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page * @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label * @tab_label: (allow-none): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, 'page N' * for the page, or %NULL to use the default label, page N
* @menu_label: (allow-none): the widget to use as a label for the * @menu_label: (allow-none): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label * page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly * is a #GtkLabel or %NULL, then the menu label will be a newly
@ -7812,7 +7812,7 @@ gtk_notebook_get_tab_label (GtkNotebook *notebook,
* *
* Changes the tab label for @child. * Changes the tab label for @child.
* If %NULL is specified for @tab_label, then the page will * If %NULL is specified for @tab_label, then the page will
* have the label 'page N'. * have the label page N.
*/ */
void void
gtk_notebook_set_tab_label (GtkNotebook *notebook, gtk_notebook_set_tab_label (GtkNotebook *notebook,

View File

@ -37,7 +37,7 @@
* realized as subclasses of a common base class (e.g #GtkBox/#GtkHBox/#GtkVBox * realized as subclasses of a common base class (e.g #GtkBox/#GtkHBox/#GtkVBox
* or #GtkScale/#GtkHScale/#GtkVScale). #GtkOrientable is more flexible in that * or #GtkScale/#GtkHScale/#GtkVScale). #GtkOrientable is more flexible in that
* it allows the orientation to be changed at runtime, allowing the widgets * it allows the orientation to be changed at runtime, allowing the widgets
* to 'flip'. * to flip.
* *
* #GtkOrientable was introduced in GTK+ 2.16. * #GtkOrientable was introduced in GTK+ 2.16.
*/ */

View File

@ -358,7 +358,7 @@ _gtk_pango_get_default_attributes (AtkAttributeSet *attributes,
* @end_offset: return location for the ending offset of the * @end_offset: return location for the ending offset of the
* current run * current run
* *
* Finds the 'run' around index (i.e. the maximal range of characters * Finds the run around index (i.e. the maximal range of characters
* where the set of applicable attributes remains constant) and * where the set of applicable attributes remains constant) and
* returns the starting and ending offsets for it. * returns the starting and ending offsets for it.
* *

View File

@ -2061,7 +2061,7 @@ _gtk_style_context_check_region_name (const gchar *str)
* would apply to even and odd rows, respectively. * would apply to even and odd rows, respectively.
* *
* Region names must only contain lowercase letters * Region names must only contain lowercase letters
* and '-', starting always with a lowercase letter. * and -, starting always with a lowercase letter.
* *
* Since: 3.0 * Since: 3.0
**/ **/
@ -2552,7 +2552,7 @@ gtk_style_context_lookup_icon_set (GtkStyleContext *context,
* *
* Attaches @context to the given screen. * Attaches @context to the given screen.
* *
* The screen is used to add style information from 'global' style * The screen is used to add style information from global style
* providers, such as the screens #GtkSettings instance. * providers, such as the screens #GtkSettings instance.
* *
* If you are using a #GtkStyleContext returned from * If you are using a #GtkStyleContext returned from

View File

@ -307,7 +307,7 @@ struct _GtkStyleContextClass
* *
* A CSS class to match primary toolbars. * A CSS class to match primary toolbars.
* *
* This should be used for the 'main' toolbar of an application, * This should be used for the main toolbar of an application,
* right below its menubar. * right below its menubar.
*/ */
#define GTK_STYLE_CLASS_PRIMARY_TOOLBAR "primary-toolbar" #define GTK_STYLE_CLASS_PRIMARY_TOOLBAR "primary-toolbar"
@ -473,7 +473,7 @@ struct _GtkStyleContextClass
/** /**
* GTK_STYLE_CLASS_SPINNER: * GTK_STYLE_CLASS_SPINNER:
* *
* A CSS class to use when rendering activity as a 'spinner'. * A CSS class to use when rendering activity as a spinner.
* *
* This is used by #GtkSpinner and #GtkCellRendererSpinner. * This is used by #GtkSpinner and #GtkCellRendererSpinner.
*/ */

View File

@ -270,7 +270,7 @@ gtk_test_spin_button_click (GtkSpinButton *spinner,
* *
* This function will search @widget and all its descendants for a GtkLabel * This function will search @widget and all its descendants for a GtkLabel
* widget with a text string matching @label_pattern. * widget with a text string matching @label_pattern.
* The @label_pattern may contain asterisks '*' and question marks '?' as * The @label_pattern may contain asterisks * and question marks ? as
* placeholders, g_pattern_match() is used for the matching. * placeholders, g_pattern_match() is used for the matching.
* Note that locales other than "C“ tend to alter (translate” label strings, * Note that locales other than "C“ tend to alter (translate” label strings,
* so this function is genrally only useful in test programs with * so this function is genrally only useful in test programs with

View File

@ -43,7 +43,7 @@
* @Title: GtkToggleButton * @Title: GtkToggleButton
* @See_also: #GtkButton, #GtkCheckButton, #GtkCheckMenuItem * @See_also: #GtkButton, #GtkCheckButton, #GtkCheckMenuItem
* *
* A #GtkToggleButton is a #GtkButton which will remain 'pressed-in' when * A #GtkToggleButton is a #GtkButton which will remain pressed-in when
* clicked. Clicking again will cause the toggle button to return to its * clicked. Clicking again will cause the toggle button to return to its
* normal state. * normal state.
* *
@ -451,7 +451,7 @@ gtk_toggle_button_get_mode (GtkToggleButton *toggle_button)
* @is_active: %TRUE or %FALSE. * @is_active: %TRUE or %FALSE.
* *
* Sets the status of the toggle button. Set to %TRUE if you want the * Sets the status of the toggle button. Set to %TRUE if you want the
* GtkToggleButton to be 'pressed in', and %FALSE to raise it. * GtkToggleButton to be pressed in, and %FALSE to raise it.
* This action causes the #GtkToggleButton::toggled signal and the * This action causes the #GtkToggleButton::toggled signal and the
* #GtkButton::clicked signal to be emitted. * #GtkButton::clicked signal to be emitted.
*/ */

View File

@ -438,7 +438,7 @@ gtk_toggle_tool_button_new_from_stock (const gchar *stock_id)
* @is_active: whether @button should be active * @is_active: whether @button should be active
* *
* Sets the status of the toggle tool button. Set to %TRUE if you * Sets the status of the toggle tool button. Set to %TRUE if you
* want the GtkToggleButton to be 'pressed in', and %FALSE to raise it. * want the GtkToggleButton to be pressed in, and %FALSE to raise it.
* This action causes the toggled signal to be emitted. * This action causes the toggled signal to be emitted.
* *
* Since: 2.4 * Since: 2.4

View File

@ -1199,7 +1199,7 @@ gtk_tool_button_get_label (GtkToolButton *button)
* should be used for the mnemonic accelerator key in the overflow menu. For * should be used for the mnemonic accelerator key in the overflow menu. For
* example, if the label property is _Open and @use_underline is %TRUE, * example, if the label property is _Open and @use_underline is %TRUE,
* the label on the tool button will be Open and the item on the overflow * the label on the tool button will be Open and the item on the overflow
* menu will have an underlined 'O'. * menu will have an underlined O.
* *
* Labels shown on tool buttons never have mnemonics on them; this property * Labels shown on tool buttons never have mnemonics on them; this property
* only affects the menu item on the overflow menu. * only affects the menu item on the overflow menu.

View File

@ -176,7 +176,7 @@
* gint int_data; * gint int_data;
* *
* /&ast; Make sure you terminate calls to gtk_tree_model_get() * /&ast; Make sure you terminate calls to gtk_tree_model_get()
* &ast; with a '-1' value * &ast; with a -1 value
* &ast;/ * &ast;/
* gtk_tree_model_get (list_store, &iter, * gtk_tree_model_get (list_store, &iter,
* STRING_COLUMN, &str_data, * STRING_COLUMN, &str_data,
@ -712,7 +712,7 @@ gtk_tree_path_new_from_indicesv (gint *indices,
* *
* Generates a string representation of the path. * Generates a string representation of the path.
* *
* This string is a ':' separated list of numbers. * This string is a : separated list of numbers.
* For example, 4:10:0:3 would be an acceptable * For example, 4:10:0:3 would be an acceptable
* return value for this string. * return value for this string.
* *
@ -1301,7 +1301,7 @@ gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model,
* *
* Generates a string representation of the iter. * Generates a string representation of the iter.
* *
* This string is a ':' separated list of numbers. * This string is a : separated list of numbers.
* For example, 4:10:0:3 would be an acceptable * For example, 4:10:0:3 would be an acceptable
* return value for this string. * return value for this string.
* *

View File

@ -2691,10 +2691,10 @@ gtk_tree_model_sort_clear_cache_helper (GtkTreeModelSort *tree_model_sort,
* gtk_tree_model_sort_reset_default_sort_func: * gtk_tree_model_sort_reset_default_sort_func:
* @tree_model_sort: A #GtkTreeModelSort * @tree_model_sort: A #GtkTreeModelSort
* *
* This resets the default sort function to be in the 'unsorted' state. That * This resets the default sort function to be in the unsorted state. That
* is, it is in the same order as the child model. It will re-sort the model * is, it is in the same order as the child model. It will re-sort the model
* to be in the same order as the child model only if the #GtkTreeModelSort * to be in the same order as the child model only if the #GtkTreeModelSort
* is in 'unsorted' state. * is in unsorted state.
**/ **/
void void
gtk_tree_model_sort_reset_default_sort_func (GtkTreeModelSort *tree_model_sort) gtk_tree_model_sort_reset_default_sort_func (GtkTreeModelSort *tree_model_sort)

View File

@ -1468,7 +1468,7 @@ _gtk_tree_selection_row_is_selectable (GtkTreeSelection *selection,
*/ */
/* /*
* docs about the 'override_browse_mode', we set this flag when we want to * docs about the override_browse_mode, we set this flag when we want to
* unset select the node and override the select browse mode behaviour (that is * unset select the node and override the select browse mode behaviour (that is
* 'one node should *always* be selected'). * 'one node should *always* be selected').
*/ */

View File

@ -7792,7 +7792,7 @@ gtk_widget_has_focus (GtkWidget *widget)
* To find out if the widget has the global input focus, use * To find out if the widget has the global input focus, use
* gtk_widget_has_focus(). * gtk_widget_has_focus().
* *
* Return value: %TRUE if the widget should display a 'focus rectangle' * Return value: %TRUE if the widget should display a focus rectangle
* *
* Since: 3.2 * Since: 3.2
*/ */
@ -15714,7 +15714,7 @@ _gtk_widget_get_action_muxer (GtkWidget *widget)
* *
* Inserts @group into @widget. Children of @widget that implement * Inserts @group into @widget. Children of @widget that implement
* #GtkActionable can then be associated with actions in @group by * #GtkActionable can then be associated with actions in @group by
* setting their 'action-name' to * setting their action-name to
* @prefix.`action-name`. * @prefix.`action-name`.
* *
* If @group is %NULL, a previously inserted group for @name is removed * If @group is %NULL, a previously inserted group for @name is removed

View File

@ -52,7 +52,7 @@ typedef enum
} GtkWidgetHelpType; } GtkWidgetHelpType;
/* Macro for casting a pointer to a GtkWidget or GtkWidgetClass pointer. /* Macro for casting a pointer to a GtkWidget or GtkWidgetClass pointer.
* Macros for testing whether `widget' or `klass' are of type GTK_TYPE_WIDGET. * Macros for testing whether widget or klass are of type GTK_TYPE_WIDGET.
*/ */
#define GTK_TYPE_WIDGET (gtk_widget_get_type ()) #define GTK_TYPE_WIDGET (gtk_widget_get_type ())
#define GTK_WIDGET(widget) (G_TYPE_CHECK_INSTANCE_CAST ((widget), GTK_TYPE_WIDGET, GtkWidget)) #define GTK_WIDGET(widget) (G_TYPE_CHECK_INSTANCE_CAST ((widget), GTK_TYPE_WIDGET, GtkWidget))

View File

@ -978,7 +978,7 @@ gtk_widget_path_iter_has_class (const GtkWidgetPath *path,
* gtk_style_context_add_region(). * gtk_style_context_add_region().
* *
* Region names must only contain lowercase letters * Region names must only contain lowercase letters
* and '-', starting always with a lowercase letter. * and -, starting always with a lowercase letter.
* *
* Since: 3.0 * Since: 3.0
**/ **/

View File

@ -11370,7 +11370,7 @@ gtk_XParseGeometry (const char *string,
* @geometry: geometry string * @geometry: geometry string
* *
* Parses a standard X Window System geometry string - see the * Parses a standard X Window System geometry string - see the
* manual page for X (type 'man X') for details on this. * manual page for X (type man X) for details on this.
* gtk_window_parse_geometry() does work on all GTK+ ports * gtk_window_parse_geometry() does work on all GTK+ ports
* including Win32 but is primarily intended for an X environment. * including Win32 but is primarily intended for an X environment.
* *
@ -11425,7 +11425,7 @@ gtk_XParseGeometry (const char *string,
* if (argc > 1) * if (argc > 1)
* { * {
* if (!gtk_window_parse_geometry (GTK_WINDOW (window), argv[1])) * if (!gtk_window_parse_geometry (GTK_WINDOW (window), argv[1]))
* fprintf (stderr, "Failed to parse '%s'\n", argv[1]); * fprintf (stderr, "Failed to parse “%s”\n", argv[1]);
* } * }
* *
* gtk_widget_show_all (window); * gtk_widget_show_all (window);
@ -12040,7 +12040,7 @@ _gtk_window_schedule_mnemonics_visible (GtkWindow *window)
* *
* Gets the value of the #GtkWindow:focus-visible property. * Gets the value of the #GtkWindow:focus-visible property.
* *
* Returns: %TRUE if 'focus rectangles' are supposed to be visible * Returns: %TRUE if focus rectangles are supposed to be visible
* in this window. * in this window.
* *
* Since: 3.2 * Since: 3.2

View File

@ -575,7 +575,7 @@ maybe_cache_icon_data (Image *image,
} }
/* /*
* Finds all dir separators and replaces them with '/'. * Finds all dir separators and replaces them with /.
* This makes sure that only /-separated paths are written in cache files, * This makes sure that only /-separated paths are written in cache files,
* maintaining compatibility with theme index files that use slashes as * maintaining compatibility with theme index files that use slashes as
* directory separators on all platforms. * directory separators on all platforms.