docs: use proper quotes

This commit is contained in:
William Jon McCann 2014-02-05 13:07:34 -05:00
parent c3dfb17031
commit 2a45418b67
141 changed files with 668 additions and 668 deletions

View File

@ -494,7 +494,7 @@ find_item_label (GtkWidget *item)
/* This function returns a string of the form A;B;C where A is
* the keybinding for the widget; B is the keybinding to traverse
* from the menubar and C is the accelerator. The items in the
* keybinding to traverse from the menubar are separated by ":".
* keybinding to traverse from the menubar are separated by :.
*/
static const gchar *
gtk_menu_item_accessible_get_keybinding (AtkAction *action,

View File

@ -456,7 +456,7 @@ gtk_widget_accessible_get_index_in_parent (AtkObject *accessible)
/* This function is the default implementation for the notify_gtk
* vfunc which gets called when a property changes value on the
* GtkWidget associated with a GtkWidgetAccessible. It constructs
* an AtkPropertyValues structure and emits a "property_changed"
* an AtkPropertyValues structure and emits a property_changed
* signal which causes the user specified AtkPropertyChangeHandler
* to be called.
*/

View File

@ -68,7 +68,7 @@
* Apart from regular actions, there are <link linkend="GtkToggleAction">toggle
* actions</link>, which can be toggled between two states and <link
* linkend="GtkRadioAction">radio actions</link>, of which only one in a group
* can be in the "active" state. Other actions can be implemented as #GtkAction
* can be in the active state. Other actions can be implemented as #GtkAction
* subclasses.
*
* Each action can have one or more proxy widgets. To act as an action proxy,
@ -862,7 +862,7 @@ disconnect_proxy (GtkAction *action,
* - if @action is invisible, @proxy is too
*
* - if @empty is %TRUE, hide @proxy unless the "hide-if-empty"
* - if @empty is %TRUE, hide @proxy unless the hide-if-empty
* property of @action indicates otherwise
*
* This function is used in the implementation of #GtkUIManager.
@ -922,7 +922,7 @@ _gtk_action_emit_activate (GtkAction *action)
* gtk_action_activate:
* @action: the action object
*
* Emits the "activate" signal on the specified action, if it isn't
* Emits the activate signal on the specified action, if it isn't
* insensitive. This gets called by the proxy widgets when they get
* activated.
*

View File

@ -1108,7 +1108,7 @@ gtk_action_group_list_actions (GtkActionGroup *action_group)
* This is a convenience function to create a number of actions and add them
* to the action group.
*
* The "activate" signals of the actions are connected to the callbacks and
* The activate signals of the actions are connected to the callbacks and
* their accel paths are set to
* `&lt;Actions&gt;/group-name/action-name`.
*
@ -1243,7 +1243,7 @@ gtk_action_group_add_actions_full (GtkActionGroup *action_group,
* This is a convenience function to create a number of toggle actions and add them
* to the action group.
*
* The "activate" signals of the actions are connected to the callbacks and
* The activate signals of the actions are connected to the callbacks and
* their accel paths are set to
* `&lt;Actions&gt;/group-name/action-name`.
*
@ -1363,7 +1363,7 @@ gtk_action_group_add_toggle_actions_full (GtkActionGroup *action_gro
* This is a convenience routine to create a group of radio actions and
* add them to the action group.
*
* The "changed" signal of the first radio action is connected to the
* The changed signal of the first radio action is connected to the
* @on_change callback and the accel paths of the actions are set to
* `&lt;Actions&gt;/group-name/action-name`.
*

View File

@ -107,7 +107,7 @@
* G_OBJECT_CLASS (foo_bar_parent_class)->dispose (object);
* }
*
* ... Handle the "related-action" and "use-action-appearance" properties ...
* ... Handle the related-action and use-action-appearance properties ...
*
* static void
* foo_bar_set_property (GObject *object,

View File

@ -55,8 +55,8 @@
*
* The GtkColorSelectionDialog implementation of the GtkBuildable interface
* exposes the embedded #GtkColorSelection as internal child with the
* name "color_selection". It also exposes the buttons with the names
* "ok_button", "cancel_button" and "help_button".
* name color_selection. It also exposes the buttons with the names
* ok_button, cancel_button and help_button.
*/

View File

@ -1380,8 +1380,8 @@ gtk_font_selection_get_size (GtkFontSelection *fontsel)
* Note that this can be a different string than what you set with
* gtk_font_selection_set_font_name(), as the font selection widget may
* normalize font names and thus return a string with a different structure.
* For example, "Helvetica Italic Bold 12" could be normalized to
* "Helvetica Bold Italic 12". Use pango_font_description_equal()
* For example, Helvetica Italic Bold 12 could be normalized to
* Helvetica Bold Italic 12. Use pango_font_description_equal()
* if you want to compare two font descriptions.
*
* Return value: A string with the name of the current font, or %NULL if
@ -1510,7 +1510,7 @@ gtk_font_selection_select_font_desc (GtkFontSelection *fontsel,
/**
* gtk_font_selection_set_font_name:
* @fontsel: a #GtkFontSelection
* @fontname: a font name like "Helvetica 12" or "Times Bold 18"
* @fontname: a font name like Helvetica 12 or Times Bold 18
*
* Sets the currently-selected font.
*
@ -1630,8 +1630,8 @@ gtk_font_selection_set_preview_text (GtkFontSelection *fontsel,
*
* The GtkFontSelectionDialog implementation of the GtkBuildable interface
* exposes the embedded #GtkFontSelection as internal child with the
* name "font_selection". It also exposes the buttons with the names
* "ok_button", "cancel_button" and "apply_button".
* name font_selection. It also exposes the buttons with the names
* ok_button, cancel_button and apply_button.
*/
static void gtk_font_selection_dialog_buildable_interface_init (GtkBuildableIface *iface);
@ -1834,8 +1834,8 @@ gtk_font_selection_dialog_buildable_get_internal_child (GtkBuildable *buildable,
* Note that this can be a different string than what you set with
* gtk_font_selection_dialog_set_font_name(), as the font selection widget
* may normalize font names and thus return a string with a different
* structure. For example, "Helvetica Italic Bold 12" could be normalized
* to "Helvetica Bold Italic 12". Use pango_font_description_equal()
* structure. For example, Helvetica Italic Bold 12 could be normalized
* to Helvetica Bold Italic 12. Use pango_font_description_equal()
* if you want to compare two font descriptions.
*
* Return value: A string with the name of the current font, or %NULL if no
@ -1858,7 +1858,7 @@ gtk_font_selection_dialog_get_font_name (GtkFontSelectionDialog *fsd)
/**
* gtk_font_selection_dialog_set_font_name:
* @fsd: a #GtkFontSelectionDialog
* @fontname: a font name like "Helvetica 12" or "Times Bold 18"
* @fontname: a font name like Helvetica 12 or Times Bold 18
*
* Sets the currently selected font.
*

View File

@ -145,7 +145,7 @@ enum {
* of the drag offset by the distance that the cursor
* has moved.
*
* 2) These rectangles must have one edge, the "snap_edge"
* 2) These rectangles must have one edge, the snap_edge
* of the handlebox, aligned within TOLERANCE.
*
* 3) On the other dimension, the extents of one rectangle
@ -999,7 +999,7 @@ gtk_handle_box_get_handle_position (GtkHandleBox *handle_box)
*
* Sets the snap edge of a handlebox. The snap edge is
* the edge of the detached child that must be aligned
* with the corresponding edge of the "ghost" left
* with the corresponding edge of the ghost left
* behind when the child was detached to reattach
* the torn-off window. Usually, the snap edge should
* be chosen so that it stays in the same place on

View File

@ -284,7 +284,7 @@ gtk_icon_factory_new (void)
*
* Adds the given @icon_set to the icon factory, under the name
* @stock_id. @stock_id should be namespaced for your application,
* e.g. "myapp-whatever-icon". Normally applications create a
* e.g. myapp-whatever-icon. Normally applications create a
* #GtkIconFactory, then add it to the list of default factories with
* gtk_icon_factory_add_default(). Then they pass the @stock_id to
* widgets such as #GtkImage to display the icon. Themes can provide
@ -1695,7 +1695,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS;
}
/* Order sources by their "wildness", so that "wilder" sources are
* greater than "specific" sources; for determining ordering,
* greater than specific sources; for determining ordering,
* direction beats state beats size.
*/
@ -1743,7 +1743,7 @@ icon_source_compare (gconstpointer ap, gconstpointer bp)
* icons). So a single icon set would contain all those variants of
* the icon, and you might add a separate source for each one.
*
* You should nearly always add a "default" icon source with all
* You should nearly always add a default icon source with all
* fields wildcarded, which will be used as a fallback if no more
* specific source matches. #GtkIconSet always prefers more specific
* icon sources to more generic icon sources. The order in which you
@ -1861,10 +1861,10 @@ gtk_icon_set_get_sizes (GtkIconSet *icon_set,
* image filename) that serves as the base image for one or more of the
* icons in a #GtkIconSet, along with a specification for which icons in the
* icon set will be based on that pixbuf or image file. An icon set contains
* a set of icons that represent "the same" logical concept in different states,
* a set of icons that represent the same logical concept in different states,
* different global text directions, and different sizes.
*
* So for example a web browser's "Back to Previous Page" icon might
* So for example a web browser's Back to Previous Page icon might
* point in a different direction in Hebrew and in English; it might
* look different when insensitive; and it might change size depending
* on toolbar mode (small/large icons). So a single icon set would

View File

@ -382,18 +382,18 @@
* * `font = font`
*
* Starting with GTK+ 2.0, the "font" and "fontset"
* declarations are ignored; use "font_name" declarations instead.
* Starting with GTK+ 2.0, the font and fontset
* declarations are ignored; use font_name declarations instead.
*
* * `fontset = font`
*
* Starting with GTK+ 2.0, the "font" and "fontset"
* declarations are ignored; use "font_name" declarations instead.
* Starting with GTK+ 2.0, the font and fontset
* declarations are ignored; use font_name declarations instead.
*
* * `font_name = font`
*
* Sets the font for a widget. font must be
* a Pango font name, e.g. `"Sans Italic 10"`.
* a Pango font name, e.g. Sans Italic 10 .
* For details about Pango font names, see
* pango_font_description_from_string().
*

View File

@ -332,7 +332,7 @@ guint gtk_rc_parse_priority (GScanner *scanner,
* GtkRcProperty:
* @type_name: quark-ified type identifier
* @property_name: quark-ified property identifier like
* "GtkScrollbar::spacing"
* GtkScrollbar::spacing
* @origin: field similar to one found in #GtkSettingsValue
* @value:field similar to one found in #GtkSettingsValue
*
@ -340,7 +340,7 @@ guint gtk_rc_parse_priority (GScanner *scanner,
*/
struct _GtkRcProperty
{
/* quark-ified property identifier like "GtkScrollbar::spacing" */
/* quark-ified property identifier like “GtkScrollbar::spacing” */
GQuark type_name;
GQuark property_name;

View File

@ -40,7 +40,7 @@ Prebuilt common menu/toolbar items and corresponding icons
* @Title: Stock Items
*
* Stock items represent commonly-used menu or toolbar items such as
* "Open" or "Exit". Each stock item is identified by a stock ID;
* Open or Exit. Each stock item is identified by a stock ID;
* stock IDs are just strings, but macros such as #GTK_STOCK_OPEN are
* provided to avoid typing mistakes in the strings.
* Applications can register their own stock items in addition to those

View File

@ -112,7 +112,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ABOUT:
*
* The "About" item.
* The About item.
* ![](help-about.png)
*
* Since: 2.6
@ -124,7 +124,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ADD:
*
* The "Add" item.
* The Add item.
* ![](list-add.png)
*
* Deprecated: 3.10: Use named icon &quot;list-add&quot; or the label &quot;_Add&quot;.
@ -134,7 +134,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_APPLY:
*
* The "Apply" item.
* The Apply item.
* ![](gtk-apply.png)
*
* Deprecated: 3.10: Do not use an icon. Use label &quot;_Apply&quot;.
@ -144,7 +144,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_BOLD:
*
* The "Bold" item.
* The Bold item.
* ![](format-text-bold.png)
*
* Deprecated: 3.10: Use named icon &quot;format-text-bold&quot;.
@ -154,7 +154,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CANCEL:
*
* The "Cancel" item.
* The Cancel item.
* ![](gtk-cancel.png)
*
* Deprecated: 3.10: Do not use an icon. Use label &quot;_Cancel&quot;.
@ -164,7 +164,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CAPS_LOCK_WARNING:
*
* The "Caps Lock Warning" icon.
* The Caps Lock Warning icon.
* ![](gtk-caps-lock-warning.png)
*
* Since: 2.16
@ -176,7 +176,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CDROM:
*
* The "CD-Rom" item.
* The CD-Rom item.
* ![](media-optical.png)
*
* Deprecated: 3.10: Use named icon &quot;media-optical&quot;.
@ -186,7 +186,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CLEAR:
*
* The "Clear" item.
* The Clear item.
* ![](edit-clear.png)
*
* Deprecated: 3.10: Use named icon &quot;edit-clear&quot;.
@ -196,7 +196,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CLOSE:
*
* The "Close" item.
* The Close item.
* ![](window-close.png)
*
* Deprecated: 3.10: Use named icon &quot;window-close&quot; or the label &quot;_Close&quot;.
@ -206,7 +206,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_COLOR_PICKER:
*
* The "Color Picker" item.
* The Color Picker item.
* ![](gtk-color-picker.png)
*
* Since: 2.2
@ -218,7 +218,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CONNECT:
*
* The "Connect" icon.
* The Connect icon.
* ![](gtk-connect.png)
*
* Since: 2.6
@ -230,7 +230,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CONVERT:
*
* The "Convert" item.
* The Convert item.
* ![](gtk-convert.png)
*
* Deprecated: 3.10
@ -240,7 +240,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_COPY:
*
* The "Copy" item.
* The Copy item.
* ![](edit-copy.png)
*
* Deprecated: 3.10: Do not use an icon. Use label &quot;_Copy&quot;.
@ -250,7 +250,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_CUT:
*
* The "Cut" item.
* The Cut item.
* ![](edit-cut.png)
*
* Deprecated: 3.10: Do not use an icon. Use label &quot;Cu_t&quot;.
@ -260,7 +260,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DELETE:
*
* The "Delete" item.
* The Delete item.
* ![](edit-delete.png)
*
* Deprecated: 3.10: Do not use an icon. Use label &quot;_Delete&quot;.
@ -270,7 +270,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DIALOG_AUTHENTICATION:
*
* The "Authentication" item.
* The Authentication item.
* ![](dialog-password.png)
*
* Since: 2.4
@ -282,7 +282,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DIALOG_INFO:
*
* The "Information" item.
* The Information item.
* ![](dialog-information.png)
*
* Deprecated: 3.10: Use named icon &quot;dialog-information&quot;.
@ -292,7 +292,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DIALOG_WARNING:
*
* The "Warning" item.
* The Warning item.
* ![](dialog-warning.png)
*
* Deprecated: 3.10: Use named icon &quot;dialog-warning&quot;.
@ -302,7 +302,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DIALOG_ERROR:
*
* The "Error" item.
* The Error item.
* ![](dialog-error.png)
*
* Deprecated: 3.10: Use named icon &quot;dialog-error&quot;.
@ -312,7 +312,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DIALOG_QUESTION:
*
* The "Question" item.
* The Question item.
* ![](dialog-question.png)
*
* Deprecated: 3.10: Use named icon &quot;dialog-question&quot;.
@ -322,7 +322,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DIRECTORY:
*
* The "Directory" icon.
* The Directory icon.
* ![](folder.png)
*
* Since: 2.6
@ -334,7 +334,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DISCARD:
*
* The "Discard" item.
* The Discard item.
*
* Since: 2.12
*
@ -345,7 +345,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DISCONNECT:
*
* The "Disconnect" icon.
* The Disconnect icon.
* ![](gtk-disconnect.png)
*
* Since: 2.6
@ -357,7 +357,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DND:
*
* The "Drag-And-Drop" icon.
* The Drag-And-Drop icon.
* ![](gtk-dnd.png)
*
* Deprecated: 3.10
@ -367,7 +367,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_DND_MULTIPLE:
*
* The "Drag-And-Drop multiple" icon.
* The Drag-And-Drop multiple icon.
* ![](gtk-dnd-multiple.png)
*
* Deprecated: 3.10
@ -377,7 +377,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_EDIT:
*
* The "Edit" item.
* The Edit item.
* ![](gtk-edit.png)
*
* Since: 2.6
@ -389,7 +389,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_EXECUTE:
*
* The "Execute" item.
* The Execute item.
* ![](system-run.png)
*
* Deprecated: 3.10: Use named icon &quot;system-run&quot;.
@ -399,7 +399,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_FILE:
*
* The "File" item.
* The File item.
* ![](text-x-generic.png)
*
* Since 3.0, this item has a label, before it only had an icon.
@ -413,7 +413,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_FIND:
*
* The "Find" item.
* The Find item.
* ![](edit-find.png)
*
* Deprecated: 3.10: Use named icon &quot;edit-find&quot;.
@ -423,7 +423,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_FIND_AND_REPLACE:
*
* The "Find and Replace" item.
* The Find and Replace item.
* ![](edit-find-replace.png)
*
* Deprecated: 3.10: Use named icon &quot;edit-find-replace&quot;.
@ -433,7 +433,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_FLOPPY:
*
* The "Floppy" item.
* The Floppy item.
* ![](media-floppy.png)
*
* Deprecated: 3.10
@ -443,7 +443,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_FULLSCREEN:
*
* The "Fullscreen" item.
* The Fullscreen item.
* ![](view-fullscreen.png)
*
* Since: 2.8
@ -455,7 +455,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GOTO_BOTTOM:
*
* The "Bottom" item.
* The Bottom item.
* ![](go-bottom.png)
*
* Deprecated: 3.10: Use named icon &quot;go-bottom&quot;.
@ -465,7 +465,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GOTO_FIRST:
*
* The "First" item.
* The First item.
* ![](go-first-ltr.png)
* RTL variant
* ![](go-first-rtl.png)
@ -477,7 +477,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GOTO_LAST:
*
* The "Last" item.
* The Last item.
* ![](go-last-ltr.png)
* RTL variant
* ![](go-last-rtl.png)
@ -489,7 +489,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GOTO_TOP:
*
* The "Top" item.
* The Top item.
* ![](go-top.png)
*
* Deprecated: 3.10: Use named icon &quot;go-top&quot;.
@ -499,7 +499,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GO_BACK:
*
* The "Back" item.
* The Back item.
* ![](go-previous-ltr.png)
* RTL variant
* ![](go-previous-rtl.png)
@ -511,7 +511,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GO_DOWN:
*
* The "Down" item.
* The Down item.
* ![](go-down.png)
*
* Deprecated: 3.10: Use named icon &quot;go-down&quot;.
@ -521,7 +521,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GO_FORWARD:
*
* The "Forward" item.
* The Forward item.
* ![](go-next-ltr.png)
* RTL variant
* ![](go-next-rtl.png)
@ -533,7 +533,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_GO_UP:
*
* The "Up" item.
* The Up item.
* ![](go-up.png)
*
* Deprecated: 3.10: Use named icon &quot;go-up&quot;.
@ -543,7 +543,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_HARDDISK:
*
* The "Harddisk" item.
* The Harddisk item.
* ![](drive-harddisk.png)
*
* Since: 2.4
@ -555,7 +555,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_HELP:
*
* The "Help" item.
* The Help item.
* ![](help-contents.png)
*
* Deprecated: 3.10: Use named icon &quot;help-browser&quot;.
@ -565,7 +565,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_HOME:
*
* The "Home" item.
* The Home item.
* ![](go-home.png)
*
* Deprecated: 3.10: Use named icon &quot;go-home&quot;.
@ -575,7 +575,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_INDEX:
*
* The "Index" item.
* The Index item.
* ![](gtk-index.png)
*
* Deprecated: 3.10
@ -585,7 +585,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_INDENT:
*
* The "Indent" item.
* The Indent item.
* ![](format-indent-more-ltr.png)
* RTL variant
* ![](format-indent-more-rtl.png)
@ -599,7 +599,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_INFO:
*
* The "Info" item.
* The Info item.
* ![](dialog-information.png)
*
* Since: 2.8
@ -611,7 +611,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ITALIC:
*
* The "Italic" item.
* The Italic item.
* ![](format-text-italic.png)
*
* Deprecated: 3.10: Use named icon &quot;format-text-italic&quot;.
@ -621,7 +621,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_JUMP_TO:
*
* The "Jump to" item.
* The Jump to item.
* ![](go-jump-ltr.png)
* RTL-variant
* ![](go-jump-rtl.png)
@ -633,7 +633,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_JUSTIFY_CENTER:
*
* The "Center" item.
* The Center item.
* ![](format-justify-center.png)
*
* Deprecated: 3.10: Use named icon &quot;format-justify-center&quot;.
@ -643,7 +643,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_JUSTIFY_FILL:
*
* The "Fill" item.
* The Fill item.
* ![](format-justify-fill.png)
*
* Deprecated: 3.10: Use named icon &quot;format-justify-fill&quot;.
@ -653,7 +653,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_JUSTIFY_LEFT:
*
* The "Left" item.
* The Left item.
* ![](format-justify-left.png)
*
* Deprecated: 3.10: Use named icon &quot;format-justify-left&quot;.
@ -663,7 +663,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_JUSTIFY_RIGHT:
*
* The "Right" item.
* The Right item.
* ![](format-justify-right.png)
*
* Deprecated: 3.10: Use named icon &quot;format-justify-right&quot;.
@ -673,7 +673,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_LEAVE_FULLSCREEN:
*
* The "Leave Fullscreen" item.
* The Leave Fullscreen item.
* ![](view-restore.png)
*
* Since: 2.8
@ -685,7 +685,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MISSING_IMAGE:
*
* The "Missing image" icon.
* The Missing image icon.
* ![](image-missing.png)
*
* Deprecated: 3.10: Use named icon &quot;image-missing&quot;.
@ -695,7 +695,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_FORWARD:
*
* The "Media Forward" item.
* The Media Forward item.
* ![](media-seek-forward-ltr.png)
* RTL variant
* ![](media-seek-forward-rtl.png)
@ -709,7 +709,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_NEXT:
*
* The "Media Next" item.
* The Media Next item.
* ![](media-skip-forward-ltr.png)
* RTL variant
* ![](media-skip-forward-rtl.png)
@ -723,7 +723,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_PAUSE:
*
* The "Media Pause" item.
* The Media Pause item.
* ![](media-playback-pause.png)
*
* Since: 2.6
@ -735,7 +735,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_PLAY:
*
* The "Media Play" item.
* The Media Play item.
* ![](media-playback-start-ltr.png)
* RTL variant
* ![](media-playback-start-rtl.png)
@ -749,7 +749,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_PREVIOUS:
*
* The "Media Previous" item.
* The Media Previous item.
* ![](media-skip-backward-ltr.png)
* RTL variant
* ![](media-skip-backward-rtl.png)
@ -763,7 +763,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_RECORD:
*
* The "Media Record" item.
* The Media Record item.
* ![](media-record.png)
*
* Since: 2.6
@ -775,7 +775,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_REWIND:
*
* The "Media Rewind" item.
* The Media Rewind item.
* ![](media-seek-backward-ltr.png)
* RTL variant
* ![](media-seek-backward-rtl.png)
@ -789,7 +789,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_MEDIA_STOP:
*
* The "Media Stop" item.
* The Media Stop item.
* ![](media-playback-stop.png)
*
* Since: 2.6
@ -801,7 +801,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_NETWORK:
*
* The "Network" item.
* The Network item.
* ![](network-idle.png)
*
* Since: 2.4
@ -813,7 +813,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_NEW:
*
* The "New" item.
* The New item.
* ![](document-new.png)
*
* Deprecated: 3.10: Use named icon &quot;document-new&quot; or the label &quot;_New&quot;.
@ -823,7 +823,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_NO:
*
* The "No" item.
* The No item.
* ![](gtk-no.png)
*
* Deprecated: 3.10
@ -833,7 +833,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_OK:
*
* The "OK" item.
* The OK item.
* ![](gtk-ok.png)
*
* Deprecated: 3.10: Do not use an icon. Use label &quot;_OK&quot;.
@ -843,7 +843,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_OPEN:
*
* The "Open" item.
* The Open item.
* ![](document-open.png)
*
* Deprecated: 3.10: Use named icon &quot;document-open&quot; or the label &quot;_Open&quot;.
@ -853,7 +853,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ORIENTATION_PORTRAIT:
*
* The "Portrait Orientation" item.
* The Portrait Orientation item.
* ![](gtk-orientation-portrait.png)
*
* Since: 2.10
@ -865,7 +865,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ORIENTATION_LANDSCAPE:
*
* The "Landscape Orientation" item.
* The Landscape Orientation item.
* ![](gtk-orientation-landscape.png)
*
* Since: 2.10
@ -877,7 +877,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE:
*
* The "Reverse Landscape Orientation" item.
* The Reverse Landscape Orientation item.
* ![](gtk-orientation-reverse-landscape.png)
*
* Since: 2.10
@ -889,7 +889,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT:
*
* The "Reverse Portrait Orientation" item.
* The Reverse Portrait Orientation item.
* ![](gtk-orientation-reverse-portrait.png)
*
* Since: 2.10
@ -901,7 +901,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PAGE_SETUP:
*
* The "Page Setup" item.
* The Page Setup item.
* ![](gtk-page-setup.png)
*
* Since: 2.14
@ -913,7 +913,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PASTE:
*
* The "Paste" item.
* The Paste item.
* ![](edit-paste.png)
*
* Deprecated: 3.10: Do not use an icon. Use label &quot;_Paste&quot;.
@ -923,7 +923,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PREFERENCES:
*
* The "Preferences" item.
* The Preferences item.
* ![](gtk-preferences.png)
*
* Deprecated: 3.10: Use named icon &quot;preferences-system&quot; or the label &quot;_Preferences&quot;.
@ -933,7 +933,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PRINT:
*
* The "Print" item.
* The Print item.
* ![](document-print.png)
*
* Deprecated: 3.10: Use named icon &quot;document-print&quot; or the label &quot;_Print&quot;.
@ -943,7 +943,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PRINT_ERROR:
*
* The "Print Error" icon.
* The Print Error icon.
* ![](printer-error.png)
*
* Since: 2.14
@ -955,7 +955,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PRINT_PAUSED:
*
* The "Print Paused" icon.
* The Print Paused icon.
* ![](printer-paused.png)
*
* Since: 2.14
@ -967,7 +967,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PRINT_PREVIEW:
*
* The "Print Preview" item.
* The Print Preview item.
* ![](document-print-preview.png)
*
* Deprecated: 3.10: Use label &quot;Pre_view&quot;.
@ -977,7 +977,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PRINT_REPORT:
*
* The "Print Report" icon.
* The Print Report icon.
* ![](printer-info.png)
*
* Since: 2.14
@ -990,7 +990,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PRINT_WARNING:
*
* The "Print Warning" icon.
* The Print Warning icon.
* ![](printer-warning.png)
*
* Since: 2.14
@ -1002,7 +1002,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_PROPERTIES:
*
* The "Properties" item.
* The Properties item.
* ![](document-properties.png)
*
* Deprecated: 3.10: Use named icon &quot;document-properties&quot; or the label &quot;_Properties&quot;.
@ -1012,7 +1012,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_QUIT:
*
* The "Quit" item.
* The Quit item.
* ![](application-exit.png)
*
* Deprecated: 3.10: Use named icon &quot;application-exit&quot; or the label &quot;_Quit&quot;.
@ -1022,7 +1022,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_REDO:
*
* The "Redo" item.
* The Redo item.
* ![](edit-redo-ltr.png)
* RTL variant
* ![](edit-redo-rtl.png)
@ -1034,7 +1034,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_REFRESH:
*
* The "Refresh" item.
* The Refresh item.
* ![](view-refresh.png)
*
* Deprecated: 3.10: Use named icon &quot;view-refresh&quot; or the label &quot;_Refresh&quot;.
@ -1044,7 +1044,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_REMOVE:
*
* The "Remove" item.
* The Remove item.
* ![](list-remove.png)
*
* Deprecated: 3.10: Use named icon &quot;list-remove&quot; or the label &quot;_Remove&quot;.
@ -1054,7 +1054,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_REVERT_TO_SAVED:
*
* The "Revert" item.
* The Revert item.
* ![](document-revert-ltr.png)
* RTL variant
* ![](document-revert-rtl.png)
@ -1066,7 +1066,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SAVE:
*
* The "Save" item.
* The Save item.
* ![](document-save.png)
*
* Deprecated: 3.10: Use named icon &quot;document-save&quot; or the label &quot;_Save&quot;.
@ -1076,7 +1076,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SAVE_AS:
*
* The "Save As" item.
* The Save As item.
* ![](document-save-as.png)
*
* Deprecated: 3.10: Use named icon &quot;document-save-as&quot; or the label &quot;Save _As&quot;.
@ -1086,7 +1086,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SELECT_ALL:
*
* The "Select All" item.
* The Select All item.
* ![](edit-select-all.png)
*
* Since: 2.10
@ -1098,7 +1098,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SELECT_COLOR:
*
* The "Color" item.
* The Color item.
* ![](gtk-select-color.png)
*
* Deprecated: 3.10
@ -1108,7 +1108,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SELECT_FONT:
*
* The "Font" item.
* The Font item.
* ![](gtk-font.png)
*
* Deprecated: 3.10
@ -1118,7 +1118,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SORT_ASCENDING:
*
* The "Ascending" item.
* The Ascending item.
* ![](view-sort-ascending.png)
*
* Deprecated: 3.10: Use named icon &quot;view-sort-ascending&quot;.
@ -1128,7 +1128,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SORT_DESCENDING:
*
* The "Descending" item.
* The Descending item.
* ![](view-sort-descending.png)
*
* Deprecated: 3.10: Use named icon &quot;view-sort-descending&quot;.
@ -1138,7 +1138,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_SPELL_CHECK:
*
* The "Spell Check" item.
* The Spell Check item.
* ![](tools-check-spelling.png)
*
* Deprecated: 3.10: Use named icon &quot;tools-check-spelling&quot;.
@ -1148,7 +1148,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_STOP:
*
* The "Stop" item.
* The Stop item.
* ![](process-stop.png)
*
* Deprecated: 3.10: Use named icon &quot;process-stop&quot; or the label &quot;_Stop&quot;.
@ -1158,7 +1158,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_STRIKETHROUGH:
*
* The "Strikethrough" item.
* The Strikethrough item.
* ![](format-text-strikethrough.png)
*
* Deprecated: 3.10: Use named icon &quot;format-text-strikethrough&quot; or the label &quot;_Strikethrough&quot;.
@ -1168,7 +1168,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_UNDELETE:
*
* The "Undelete" item.
* The Undelete item.
* ![](gtk-undelete-ltr.png)
* RTL variant
* ![](gtk-undelete-rtl.png)
@ -1180,7 +1180,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_UNDERLINE:
*
* The "Underline" item.
* The Underline item.
* ![](format-text-underline.png)
*
* Deprecated: 3.10: Use named icon &quot;format-text-underline&quot; or the label &quot;_Underline&quot;.
@ -1190,7 +1190,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_UNDO:
*
* The "Undo" item.
* The Undo item.
* ![](edit-undo-ltr.png)
* RTL variant
* ![](edit-undo-rtl.png)
@ -1202,7 +1202,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_UNINDENT:
*
* The "Unindent" item.
* The Unindent item.
* ![](format-indent-less-ltr.png)
* RTL variant
* ![](format-indent-less-rtl.png)
@ -1216,7 +1216,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_YES:
*
* The "Yes" item.
* The Yes item.
* ![](gtk-yes.png)
*
* Deprecated: 3.10
@ -1226,7 +1226,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ZOOM_100:
*
* The "Zoom 100%" item.
* The Zoom 100% item.
* ![](zoom-original.png)
*
* Deprecated: 3.10: Use named icon &quot;zoom-original&quot; or the label &quot;_Normal Size&quot;.
@ -1236,7 +1236,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ZOOM_FIT:
*
* The "Zoom to Fit" item.
* The Zoom to Fit item.
* ![](zoom-fit-best.png)
*
* Deprecated: 3.10: Use named icon &quot;zoom-fit-best&quot; or the label &quot;Best _Fit&quot;.
@ -1246,7 +1246,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ZOOM_IN:
*
* The "Zoom In" item.
* The Zoom In item.
* ![](zoom-in.png)
*
* Deprecated: 3.10: Use named icon &quot;zoom-in&quot; or the label &quot;Zoom _In&quot;.
@ -1256,7 +1256,7 @@ typedef char * GtkStock;
/**
* GTK_STOCK_ZOOM_OUT:
*
* The "Zoom Out" item.
* The Zoom Out item.
* ![](zoom-out.png)
*
* Deprecated: 3.10: Use named icon &quot;zoom-out&quot; or the label &quot;Zoom _Out&quot;.

View File

@ -3853,8 +3853,8 @@ gtk_paint_handle (GtkStyle *style,
*
* Draws an expander as used in #GtkTreeView. @x and @y specify the
* center the expander. The size of the expander is determined by the
* "expander-size" style property of @widget. (If widget is not
* specified or doesn't have an "expander-size" property, an
* expander-size style property of @widget. (If widget is not
* specified or doesn't have an expander-size property, an
* unspecified default size will be used, since the caller doesn't
* have sufficient information to position the expander, this is
* likely not useful.) The expander is expander_size pixels tall
@ -4071,9 +4071,9 @@ gtk_widget_get_default_style (void)
* widget->style = gtk_style_attach (widget->style, widget->window);
* ]|
*
* and should only ever be called in a derived widget's "realize"
* and should only ever be called in a derived widget's realize
* implementation which does not chain up to its parent class'
* "realize" implementation, because one of the parent classes
* realize implementation, because one of the parent classes
* (finally #GtkWidget) would attach the style itself.
*
* Since: 2.20
@ -4376,7 +4376,7 @@ gtk_widget_modify_fg (GtkWidget *widget,
* See also gtk_widget_modify_style().
*
* <note><para>
* Note that "no window" widgets (which have the %GTK_NO_WINDOW
* Note that no window widgets (which have the %GTK_NO_WINDOW
* flag set) draw on their parent container's window and thus may
* not draw any background themselves. This is the case for e.g.
* #GtkLabel.
@ -4476,7 +4476,7 @@ gtk_widget_modify_text (GtkWidget *widget,
* and #GtkTextView. See also gtk_widget_modify_style().
*
* <note><para>
* Note that "no window" widgets (which have the %GTK_NO_WINDOW
* Note that no window widgets (which have the %GTK_NO_WINDOW
* flag set) draw on their parent container's window and thus may
* not draw any background themselves. This is the case for e.g.
* #GtkLabel.
@ -4600,7 +4600,7 @@ gtk_widget_reset_rc_styles (GtkWidget *widget)
* periods. The name of a widget comes from
* gtk_widget_get_name(). Paths are used to apply styles to a widget
* in gtkrc configuration files. Widget names are the type of the
* widget by default (e.g. "GtkButton") or can be set to an
* widget by default (e.g. GtkButton) or can be set to an
* application-specific value with gtk_widget_set_name(). By setting
* the name of a widget, you allow users or theme authors to apply
* styles to that specific widget in their gtkrc

View File

@ -44,7 +44,7 @@
* @Title: GtkToggleAction
*
* A #GtkToggleAction corresponds roughly to a #GtkCheckMenuItem. It has an
* "active" state specifying whether the action has been checked or not.
* active state specifying whether the action has been checked or not.
*/
struct _GtkToggleActionPrivate
@ -264,7 +264,7 @@ gtk_toggle_action_activate (GtkAction *action)
* gtk_toggle_action_toggled:
* @action: the action object
*
* Emits the "toggled" signal on the toggle action.
* Emits the toggled signal on the toggle action.
*
* Since: 2.4
*

View File

@ -190,9 +190,9 @@
*
* a keyboard accelerator
*
* The "position" attribute determines where a constructed widget is positioned
* The position attribute determines where a constructed widget is positioned
* wrt. to its siblings in the partially constructed tree. If it is
* "top", the widget is prepended, otherwise it is appended.
* top, the widget is prepended, otherwise it is appended.
*
* # UI Merging # {#UI-Merging}
*
@ -201,7 +201,7 @@
*
* Merging is done based on the names of the XML elements. Each element is
* identified by a path which consists of the names of its anchestors, separated
* by slashes. For example, the menuitem named "Left" in the example above
* by slashes. For example, the menuitem named Left in the example above
* has the path `/ui/menubar/JustifyMenu/Left` and the
* toolitem with the same name has path
* `/ui/toolbar1/JustifyToolItems/Left`.
@ -215,7 +215,7 @@
*
* # Smart Separators # {#Smart-Separators}
*
* The separators created by #GtkUIManager are "smart", i.e. they do not show up
* The separators created by #GtkUIManager are smart, i.e. they do not show up
* in the UI unless they end up between two visible menu or tool items. Separators
* which are located at the very beginning or end of the menu or toolbar
* containing them, or multiple separators next to each other, are hidden. This
@ -235,9 +235,9 @@
*
* - make them disappear by hiding the menu item they're attached to
*
* - add an insensitive "Empty" item
* - add an insensitive Empty item
*
* The behaviour is chosen based on the "hide_if_empty" property of the action
* The behaviour is chosen based on the hide_if_empty property of the action
* to which the submenu is associated.
*
* # GtkUIManager as GtkBuildable # {#GtkUIManager-BUILDER-UI}
@ -250,7 +250,7 @@
*
* The widgets that are constructed by a GtkUIManager can be embedded in
* other parts of the constructed user interface with the help of the
* "constructor" attribute. See the example below.
* constructor attribute. See the example below.
*
* ## An embedded GtkUIManager UI definition
*
@ -873,7 +873,7 @@ gtk_ui_manager_get_add_tearoffs (GtkUIManager *manager)
* @manager: a #GtkUIManager
* @add_tearoffs: whether tearoff menu items are added
*
* Sets the "add_tearoffs" property, which controls whether menus
* Sets the add_tearoffs property, which controls whether menus
* generated by this #GtkUIManager will have tearoff menu items.
*
* Note that this only affects regular menus. Generated popup

View File

@ -1656,9 +1656,9 @@ gtk_about_dialog_get_translator_credits (GtkAboutDialog *about)
* |[<!-- language="C" -->
* gtk_about_dialog_set_translator_credits (about, _("translator-credits"));
* ]|
* It is a good idea to use the customary msgid "translator-credits" for this
* It is a good idea to use the customary msgid translator-credits for this
* purpose, since translators will already know the purpose of that msgid, and
* since #GtkAboutDialog will detect if "translator-credits" is untranslated
* since #GtkAboutDialog will detect if translator-credits is untranslated
* and hide the tab.
*
* Since: 2.6

View File

@ -52,7 +52,7 @@
* Note that accelerators are different from
* mnemonics. Accelerators are shortcuts for
* activating a menu item; they appear alongside the menu item they're a
* shortcut for. For example "Ctrl+Q" might appear alongside the "Quit"
* shortcut for. For example Ctrl+Q might appear alongside the Quit
* menu item. Mnemonics are shortcuts for GUI elements such as text
* entries or buttons; they appear as underlined characters. See
* gtk_label_new_with_mnemonic(). Menu items can have both accelerators
@ -964,7 +964,7 @@ gtk_accel_groups_activate (GObject *object,
*
* Determines whether a given keyval and modifier mask constitute
* a valid keyboard accelerator. For example, the #GDK_KEY_a keyval
* plus #GDK_CONTROL_MASK is valid - this is a "Ctrl+a" accelerator.
* plus #GDK_CONTROL_MASK is valid - this is a Ctrl+a accelerator.
* But, you can't, for instance, use the #GDK_KEY_Control_L keyval
* as an accelerator.
*
@ -1442,14 +1442,14 @@ out:
* modifier mask, %NULL
*
* Parses a string representing an accelerator. The
* format looks like "&lt;Control&gt;a" or "&lt;Shift&gt;&lt;Alt&gt;F1"
* or "&lt;Release&gt;z" (the last one is for key release).
* format looks like &lt;Control&gt;a or &lt;Shift&gt;&lt;Alt&gt;F1
* or &lt;Release&gt;z (the last one is for key release).
*
* The parser is fairly liberal and allows lower or upper case,
* and also abbreviations such as "&lt;Ctl&gt;" and "&lt;Ctrl&gt;".
* and also abbreviations such as &lt;Ctl&gt; and &lt;Ctrl&gt;.
* Key names are parsed using gdk_keyval_from_name(). For character
* keys the name is not the symbol, but the lowercase name, e.g. one
* would use "&lt;Ctrl&gt;minus" instead of "&lt;Ctrl&gt;-".
* would use &lt;Ctrl&gt;minus instead of &lt;Ctrl&gt;-.
*
* If the parse fails, @accelerator_key and @accelerator_mods will
* be set to 0 (zero).
@ -1512,7 +1512,7 @@ gtk_accelerator_name_with_keycode (GdkDisplay *display,
* Converts an accelerator keyval and modifier mask
* into a string parseable by gtk_accelerator_parse().
* For example, if you pass in #GDK_KEY_q and #GDK_CONTROL_MASK,
* this function returns "&lt;Control&gt;q".
* this function returns &lt;Control&gt;q.
*
* If you need to display accelerators in the user interface,
* see gtk_accelerator_get_label().

View File

@ -42,7 +42,7 @@
* @See_also: #GtkAccelGroup
*
* The #GtkAccelLabel widget is a subclass of #GtkLabel that also displays an
* accelerator key on the right of the label text, e.g. 'Ctl+S'.
* accelerator key on the right of the label text, e.g. Ctl+S.
* It is commonly used in menus to show the keyboard short-cuts for commands.
*
* The accelerator key to display is not set explicitly.
@ -51,10 +51,10 @@
* gtk_accel_label_set_accel_widget().
*
* For example, a #GtkMenuItem widget may have an accelerator added to emit the
* "activate" signal when the 'Ctl+S' key combination is pressed.
* activate signal when the Ctl+S key combination is pressed.
* A #GtkAccelLabel is created and added to the #GtkMenuItem, and
* gtk_accel_label_set_accel_widget() is called with the #GtkMenuItem as the
* second argument. The #GtkAccelLabel will now display 'Ctl+S' after its label.
* second argument. The #GtkAccelLabel will now display Ctl+S after its label.
*
* Note that creating a #GtkMenuItem with gtk_menu_item_new_with_label() (or
* one of the similar functions for #GtkCheckMenuItem and #GtkRadioMenuItem)
@ -612,7 +612,7 @@ gtk_accel_label_get_string (GtkAccelLabel *accel_label)
}
/* Underscores in key names are better displayed as spaces
* E.g., Page_Up should be "Page Up".
* E.g., Page_Up should be Page Up.
*
* Some keynames also have prefixes that are not suitable
* for display, e.g XF86AudioMute, so strip those out, too.

View File

@ -45,7 +45,7 @@
* Accelerator maps are used to define runtime configurable accelerators.
* Functions for manipulating them are are usually used by higher level
* convenience mechanisms like #GtkUIManager and are thus considered
* "low-level". You'll want to use them if you're manually creating menus that
* low-level. You'll want to use them if you're manually creating menus that
* should have user-configurable accelerators.
*
* An accelerator is uniquely defined by:
@ -54,15 +54,15 @@
* - accelerator modifiers
*
* The accelerator path must consist of
* "&lt;WINDOWTYPE&gt;/Category1/Category2/.../Action", where WINDOWTYPE
* &lt;WINDOWTYPE&gt;/Category1/Category2/.../Action, where WINDOWTYPE
* should be a unique application-specific identifier that corresponds
* to the kind of window the accelerator is being used in, e.g.
* "Gimp-Image", "Abiword-Document" or "Gnumeric-Settings".
* The "Category1/.../Action" portion is most appropriately chosen by
* Gimp-Image, Abiword-Document or Gnumeric-Settings.
* The Category1/.../Action portion is most appropriately chosen by
* the action the accelerator triggers, i.e. for accelerators on menu
* items, choose the item's menu path, e.g. "File/Save As",
* "Image/View/Zoom" or "Edit/Select All". So a full valid accelerator
* path may look like: "&lt;Gimp-Toolbox&gt;/File/Dialogs/Tool Options...".
* items, choose the item's menu path, e.g. File/Save As,
* Image/View/Zoom or Edit/Select All. So a full valid accelerator
* path may look like: &lt;Gimp-Toolbox&gt;/File/Dialogs/Tool Options....
*
* All accelerators are stored inside one global #GtkAccelMap that can
* be obtained using gtk_accel_map_get(). See <link

View File

@ -110,7 +110,7 @@ gtk_actionable_get_action_name (GtkActionable *actionable)
* Usually this function is used when the widget is located (or will be
* located) within the hierarchy of a #GtkApplicationWindow.
*
* Names are of the form "win.save" or "app.quit" for actions on the
* Names are of the form win.save or app.quit for actions on the
* containing #GtkApplicationWindow or its associated #GtkApplication,
* respectively. This is the same form used for actions in the #GMenu
* associated with the window.
@ -160,11 +160,11 @@ gtk_actionable_get_action_target_value (GtkActionable *actionable)
* The target value has two purposes. First, it is used as the
* parameter to activation of the action associated with the
* #GtkActionable widget. Second, it is used to determine if the widget
* should be rendered as "active" - the widget is active if the state
* should be rendered as active - the widget is active if the state
* is equal to the given target.
*
* Consider the example of associating a set of buttons with a #GAction
* with string state in a typical "radio button" situation. Each button
* with string state in a typical radio button situation. Each button
* will be associated with the same action, but with a different target
* value for that action. Clicking on a particular button will activate
* the action with the target of that button, which will typically cause

View File

@ -42,14 +42,14 @@
* application (such as 'fullscreen').
*
* In this case, each of these action groups could be added to a
* #GtkActionMuxer with the prefixes "app" and "win", respectively. This
* would expose the actions as "app.quit" and "win.fullscreen" on the
* #GtkActionMuxer with the prefixes app and win, respectively. This
* would expose the actions as app.quit and win.fullscreen on the
* #GActionGroup interface presented by the #GtkActionMuxer.
*
* Activations and state change requests on the #GtkActionMuxer are wired
* through to the underlying action group in the expected way.
*
* This class is typically only used at the site of "consumption" of
* This class is typically only used at the site of consumption of
* actions (eg: when displaying a menu that contains many actions on
* different objects).
*/
@ -653,12 +653,12 @@ gtk_action_muxer_class_init (GObjectClass *class)
* action `x` in @action_group, there is an equivalent
* action @prefix`.x` in @muxer.
*
* For example, if @prefix is "`app`" and @action_group
* contains an action called "`quit`", then @muxer will
* now contain an action called "`app.quit`".
* For example, if @prefix is `app` and @action_group
* contains an action called `quit`, then @muxer will
* now contain an action called `app.quit`.
*
* If any #GtkActionObservers are registered for actions in the group,
* "action_added" notifications will be emitted, as appropriate.
* action_added notifications will be emitted, as appropriate.
*
* @prefix must not contain a dot ('.').
*/
@ -704,7 +704,7 @@ gtk_action_muxer_insert (GtkActionMuxer *muxer,
* Removes a #GActionGroup from the #GtkActionMuxer.
*
* If any #GtkActionObservers are registered for actions in the group,
* "action_removed" notifications will be emitted, as appropriate.
* action_removed notifications will be emitted, as appropriate.
*/
void
gtk_action_muxer_remove (GtkActionMuxer *muxer,

View File

@ -163,7 +163,7 @@ gtk_action_observer_action_removed (GtkActionObserver *observer,
* @observer: a #GtkActionObserver
* @observable: the source of the event
* @action_name: the name of the action
* @action_and_target: detailed action of the changed accel, in "action and target" format
* @action_and_target: detailed action of the changed accel, in action and target format
*
* This function is called when an action that the observer is
* registered to receive events for has one of its accelerators changed.

View File

@ -1022,7 +1022,7 @@ gtk_application_get_window_by_id (GtkApplication *application,
* gtk_application_get_active_window:
* @application: a #GtkApplication
*
* Gets the "active" window for the application.
* Gets the active window for the application.
*
* The active window is the one that was most recently focused (within
* the application). This window may not have the focus at the moment
@ -1064,12 +1064,12 @@ gtk_application_update_accels (GtkApplication *application)
*
* @accelerator must be a string that can be parsed by
* gtk_accelerator_parse(), e.g. "&lt;Primary&gt;q" or
* "&lt;Control&gt;&lt;Alt&gt;p".
* &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
* are referred to with an "app." prefix, and window-specific actions
* with a "win." prefix.
* are referred to with an app. prefix, and window-specific actions
* with a win. prefix.
*
* GtkApplication also extracts accelerators out of 'accel' attributes
* in the #GMenuModels passed to gtk_application_set_app_menu() and
@ -1141,8 +1141,8 @@ gtk_application_remove_accelerator (GtkApplication *application,
* The application menu is a single menu containing items that typically
* impact the application as a whole, rather than acting on a specific
* window or document. For example, you would expect to see
* "Preferences" or "Quit" in an application menu, but not "Save" or
* "Print".
* Preferences or Quit in an application menu, but not Save or
* Print.
*
* If supported, the application menu will be rendered by the desktop
* environment.

View File

@ -47,8 +47,8 @@
* This class implements the #GActionGroup and #GActionMap interfaces,
* to let you add window-specific actions that will be exported by the
* associated #GtkApplication, together with its application-wide
* actions. Window-specific actions are prefixed with the "win."
* prefix and application-wide actions are prefixed with the "app."
* actions. Window-specific actions are prefixed with the win.
* prefix and application-wide actions are prefixed with the app.
* prefix. Actions must be addressed with the prefixed name when
* referring to them from a #GMenuModel.
*

View File

@ -38,7 +38,7 @@
* drawing a small preview of a larger image. #GtkAspectFrame
* derives from #GtkFrame, so it can draw a label and
* a frame around the child. The frame will be
* "shrink-wrapped" to the size of the child.
* shrink-wrapped to the size of the child.
*/
#include "config.h"

View File

@ -45,7 +45,7 @@
*
* The GtkAssistant implementation of the #GtkBuildable interface
* exposes the @action_area as internal children with the name
* "action_area".
* action_area.
*
* To add pages to an assistant in #GtkBuilder, simply add it as a
* child to the GtkAssistant object, and set its child properties

View File

@ -64,7 +64,7 @@ G_BEGIN_DECLS
* %GTK_ASSISTANT_PAGE_CONFIRM, %GTK_ASSISTANT_PAGE_SUMMARY or
* %GTK_ASSISTANT_PAGE_PROGRESS to be correct.
*
* The Cancel button will only be shown if the page isn't "committed".
* The Cancel button will only be shown if the page isn't committed.
* See gtk_assistant_commit() for details.
*/
typedef enum
@ -125,8 +125,8 @@ struct _GtkAssistantClass
*
* A function used by gtk_assistant_set_forward_page_func() to know which
* is the next page given a current one. It's called both for computing the
* next page when the user presses the "forward" button and for handling
* the behavior of the "last" button.
* next page when the user presses the forward button and for handling
* the behavior of the last button.
*
* Returns: The next page number.
*/

View File

@ -88,7 +88,7 @@
* precedence over the default bindings shipped with GTK+, overriding
* existing bindings as demonstrated in
* <link linkend="gtk-bindings-install">Installing a key binding</link>
* works as expected. The same mechanism can not be used to "unbind"
* works as expected. The same mechanism can not be used to unbind
* existing bindings, however.
*
* |[
@ -104,15 +104,15 @@
* ]|
*
* The above example will not have the desired effect of causing
* "&lt;Control&gt;Right" and "&lt;Control&gt;Left" key presses to
* &lt;Control&gt;Right and &lt;Control&gt;Left key presses to
* be ignored by GTK+. Instead, it just causes any existing bindings
* from the bindings set "MoveCursor3" to be deleted, so when
* "&lt;Control&gt;Right" or "&lt;Control&gt;Left" are pressed, no
* binding for these keys is found in binding set "MoveCursor3".
* from the bindings set MoveCursor3 to be deleted, so when
* &lt;Control&gt;Right or &lt;Control&gt;Left are pressed, no
* binding for these keys is found in binding set MoveCursor3.
* GTK+ will thus continue to search for matching key bindings, and
* will eventually lookup and find the default GTK+ bindings for
* entries which implement word movement. To keep GTK+ from activating
* its default bindings, the "unbind" keyword can be used like this:
* its default bindings, the unbind keyword can be used like this:
*
* |[
* @binding-set MoveCursor3
@ -126,9 +126,9 @@
* }
* ]|
*
* Now, GTK+ will find a match when looking up "&lt;Control&gt;Right"
* and "&lt;Control&gt;Left" key presses before it resorts to its default
* bindings, and the match instructs it to abort ("unbind") the search,
* Now, GTK+ will find a match when looking up &lt;Control&gt;Right
* and &lt;Control&gt;Left key presses before it resorts to its default
* bindings, and the match instructs it to abort (unbind) the search,
* so the key presses are not consumed by this widget. As usual, further
* processing of the key presses, e.g. by an entry's parent widget, is
* now possible.

View File

@ -202,7 +202,7 @@ gtk_buildable_parser_finished (GtkBuildable *buildable,
*
* Constructs a child of @buildable with the name @name.
*
* #GtkBuilder calls this function if a "constructor" has been
* #GtkBuilder calls this function if a constructor has been
* specified in the UI definition.
*
* Returns: (transfer full): the constructed child

View File

@ -42,7 +42,7 @@ typedef struct _GtkBuildableIface GtkBuildableIface;
* @g_iface: the parent class
* @set_name: Stores the name attribute given in the GtkBuilder UI definition.
* #GtkWidget stores the name as object data. Implement this method if your
* object has some notion of "name" and it makes sense to map the XML name
* object has some notion of name and it makes sense to map the XML name
* attribute to it.
* @get_name: The getter corresponding to @set_name. Implement this
* if you implement @set_name.
@ -57,7 +57,7 @@ typedef struct _GtkBuildableIface GtkBuildableIface;
* (i.e. setting the #GtkWidget:visible property) until the whole interface
* is created.
* @construct_child: Constructs a child of a buildable that has been
* specified as "constructor" in the UI definition. #GtkUIManager implements
* specified as constructor in the UI definition. #GtkUIManager implements
* this to reference to a widget created in a &lt;ui&gt; tag which is outside
* of the normal GtkBuilder UI definition hierarchy. A reference to the
* constructed object is returned and becomes owned by the caller.

View File

@ -72,7 +72,7 @@
* [RELAX NG Compact Syntax](https://git.gnome.org/browse/gtk+/tree/gtk/gtkbuilder.rnc)
*
* The toplevel element is &lt;interface&gt;. It optionally takes a
* "domain" attribute, which will make the builder look for translated
* domain attribute, which will make the builder look for translated
* strings using dgettext() in the domain specified. This can also be
* done by calling gtk_builder_set_translation_domain() on the builder.
* Objects are described by &lt;object&gt; elements, which can contain
@ -82,33 +82,33 @@
* also e.g. actions in an action group, or columns in a tree model).
* A &lt;child&gt; element contains an &lt;object&gt; element which
* describes the child object. The target toolkit version(s) are
* described by &lt;requires&gt; elements, the "lib" attribute specifies
* described by &lt;requires&gt; elements, the lib attribute specifies
* the widget library in question (currently the only supported value
* s "gtk+") and the "version" attribute specifies the target version
* in the form "&lt;major&gt;.&lt;minor&gt;". The builder will error
* s gtk+) and the version attribute specifies the target version
* in the form &lt;major&gt;.&lt;minor&gt;. The builder will error
* out if the version requirements are not met.
*
* Typically, the specific kind of object represented by an &lt;object&gt;
* element is specified by the "class" attribute. If the type has not been
* element is specified by the class attribute. If the type has not been
* loaded yet, GTK+ tries to find the get_type() function from the
* class name by applying heuristics. This works in most cases, but
* if necessary, it is possible to specify the name of the
* get_type() function explictly with the "type-func" attribute.
* As a special case, GtkBuilder allows to use an object that has been
* constructed by a #GtkUIManager in another part of the UI definition
* by specifying the id of the #GtkUIManager in the "constructor"
* attribute and the name of the object in the "id" attribute.
* by specifying the id of the #GtkUIManager in the constructor
* attribute and the name of the object in the id attribute.
*
* Objects may be given a name with the "id" attribute, which allows the
* Objects may be given a name with the id attribute, which allows the
* application to retrieve them from the builder with gtk_builder_get_object().
* An id is also necessary to use the object as property value in other
* parts of the UI definition. GTK+ reserves ids starting and ending
* with ___ (3 underscores) for its own purposes.
*
* Setting properties of objects is pretty straightforward with the
* &lt;property&gt; element: the "name" attribute specifies the name
* &lt;property&gt; element: the name attribute specifies the name
* of the property, and the content of the element specifies the value.
* If the "translatable" attribute is set to a true value, GTK+ uses
* If the translatable attribute is set to a true value, GTK+ uses
* gettext() (or dgettext() if the builder has a translation domain set)
* to find a translation for the value. This happens before the value
* is parsed, so it can be used for properties of any type, but it is
@ -118,11 +118,11 @@
*
* GtkBuilder can parse textual representations for the most common
* property types: characters, strings, integers, floating-point numbers,
* booleans (strings like "TRUE", "t", "yes", "y", "1" are interpreted
* as %TRUE, strings like "FALSE", "f", "no", "n", "0" are interpreted
* booleans (strings like TRUE, t, yes, y, 1 are interpreted
* as %TRUE, strings like FALSE, f, no, n, 0 are interpreted
* as %FALSE), enumerations (can be specified by their name, nick or
* integer value), flags (can be specified by their name, nick, integer
* value, optionally combined with "|", e.g. "GTK_VISIBLE|GTK_REALIZED")
* value, optionally combined with |, e.g. GTK_VISIBLE|GTK_REALIZED)
* and colors (in a format understood by gdk_color_parse()). Pixbufs can
* be specified as a filename of an image file to load. Objects can be
* referred to by their name and by default refer to objects declared
@ -136,29 +136,29 @@
* a construct-only property.
*
* Signal handlers are set up with the &lt;signal&gt; element. The
* "name" attribute specifies the name of the signal, and the "handler"
* name attribute specifies the name of the signal, and the handler
* attribute specifies the function to connect to the signal. By default,
* GTK+ tries to find the handler using g_module_symbol(), but this can
* be changed by passing a custom #GtkBuilderConnectFunc to
* gtk_builder_connect_signals_full(). The remaining attributes, "after",
* "swapped" and "object", have the same meaning as the corresponding
* gtk_builder_connect_signals_full(). The remaining attributes, after,
* swapped and object, have the same meaning as the corresponding
* parameters of the g_signal_connect_object() or
* g_signal_connect_data() functions. A "last_modification_time"
* g_signal_connect_data() functions. A last_modification_time
* attribute is also allowed, but it does not have a meaning to the
* builder.
*
* Sometimes it is necessary to refer to widgets which have implicitly
* been constructed by GTK+ as part of a composite widget, to set
* properties on them or to add further children (e.g. the @vbox of
* a #GtkDialog). This can be achieved by setting the "internal-child"
* a #GtkDialog). This can be achieved by setting the internal-child
* propery of the &lt;child&gt; element to a true value. Note that
* GtkBuilder still requires an &lt;object&gt; element for the internal
* child, even if it has already been constructed.
*
* A number of widgets have different places where a child can be added
* (e.g. tabs vs. page content in notebooks). This can be reflected in
* a UI definition by specifying the "type" attribute on a &lt;child&gt;.
* The possible values for the "type" attribute are described in the
* a UI definition by specifying the type attribute on a &lt;child&gt;.
* The possible values for the type attribute are described in the
* sections describing the widget-specific portions of UI definitions.
*
* # A GtkBuilder UI Definition

View File

@ -1317,7 +1317,7 @@ gtk_button_new_with_label (const gchar *label)
*
* Creates a new button containing an icon from the current icon theme.
*
* If the icon name isn't known, a "broken image" icon will be
* If the icon name isn't known, a broken image icon will be
* displayed instead. If the current icon theme is changed, the icon
* will be updated appropriately.
*

View File

@ -53,7 +53,7 @@
*
* It's also important for areas to maintain some cell
* alignments with areas rendered for adjacent rows (cells can
* appear "columnized" inside an area even when the size of
* appear columnized inside an area even when the size of
* cells are different in each row). For this reason the #GtkCellArea
* uses a #GtkCellAreaContext object to store the alignments
* and sizes along the way (as well as the overall largest minimum
@ -322,9 +322,9 @@
* <link linkend="child-properties">child properties</link>
* for #GtkWidgets. This provides some general interfaces for defining
* the relationship cell areas have with their cells. For instance in a
* #GtkCellAreaBox a cell might "expand" and receive extra space when
* #GtkCellAreaBox a cell might expand and receive extra space when
* the area is allocated more than its full natural request, or a cell
* might be configured to "align" with adjacent rows which were requested
* might be configured to align with adjacent rows which were requested
* and rendered with the same #GtkCellAreaContext.
*
* Use gtk_cell_area_class_install_cell_property() to install cell

View File

@ -159,7 +159,7 @@ struct _GtkCellArea
* focus from cell to cell inside the area and return %FALSE if focus
* logically leaves the area with the following exceptions: When the
* area contains no activatable cells, the entire area recieves focus.
* Focus should not be given to cells that are actually "focus siblings"
* Focus should not be given to cells that are actually focus siblings
* of other sibling cells (see gtk_cell_area_get_focus_from_sibling()).
* Focus is set by calling gtk_cell_area_set_focus_cell().
* @is_activatable: Returns whether the #GtkCellArea can respond to

View File

@ -481,7 +481,7 @@ gtk_cell_layout_set_attributes (GtkCellLayout *cell_layout,
* The @column is the column of the model to get a value from, and the
* @attribute is the parameter on @cell to be set from the value. So for
* example if column 2 of the model contains strings, you could have the
* "text" attribute of a #GtkCellRendererText get its values from column 2.
* text attribute of a #GtkCellRendererText get its values from column 2.
*
* Since: 2.4
*/

View File

@ -62,8 +62,8 @@
* #GtkCellRendererClass.start_editing virtual functions, respectively.
*
* Many properties of #GtkCellRenderer and its subclasses have a
* corresponding "set" property, e.g. "cell-background-set" corresponds
* to "cell-background". These "set" properties reflect whether a property
* corresponding set property, e.g. cell-background-set corresponds
* to cell-background. These set properties reflect whether a property
* has been set or not. You should not set them independently.
*/

View File

@ -227,7 +227,7 @@ gtk_cell_renderer_combo_init (GtkCellRendererCombo *self)
* Adjust how text is drawn using object properties.
* Object properties can be set globally (with g_object_set()).
* Also, with #GtkTreeViewColumn, you can bind a property to a value
* in a #GtkTreeModel. For example, you can bind the "text" property
* in a #GtkTreeModel. For example, you can bind the text property
* on the cell renderer to a string value in the model, thus rendering
* a different string in each row of the #GtkTreeView.
*

View File

@ -406,7 +406,7 @@ gtk_cell_renderer_pixbuf_set_property (GObject *object,
* parameters using object properties. Object properties can be set
* globally (with g_object_set()). Also, with #GtkTreeViewColumn, you
* can bind a property to a value in a #GtkTreeModel. For example, you
* can bind the "pixbuf" property on the cell renderer to a pixbuf value
* can bind the pixbuf property on the cell renderer to a pixbuf value
* in the model, thus rendering a different image in each row of the
* #GtkTreeView.
*

View File

@ -1549,7 +1549,7 @@ gtk_cell_renderer_text_set_property (GObject *object,
* object properties. Object properties can be
* set globally (with g_object_set()). Also, with #GtkTreeViewColumn,
* you can bind a property to a value in a #GtkTreeModel. For example,
* you can bind the "text" property on the cell renderer to a string
* you can bind the text property on the cell renderer to a string
* value in the model, thus rendering a different string in each row
* of the #GtkTreeView
*
@ -2086,8 +2086,8 @@ gtk_cell_renderer_text_start_editing (GtkCellRenderer *cell,
* @renderer: A #GtkCellRendererText
* @number_of_rows: Number of rows of text each cell renderer is allocated, or -1
*
* Sets the height of a renderer to explicitly be determined by the "font" and
* "y_pad" property set on it. Further changes in these properties do not
* Sets the height of a renderer to explicitly be determined by the font and
* y_pad property set on it. Further changes in these properties do not
* affect the height, so they must be accompanied by a subsequent call to this
* function. Using this function is unflexible, and should really only be used
* if calculating the size of a cell is too slow (ie, a massive number of cells

View File

@ -271,7 +271,7 @@ gtk_cell_renderer_toggle_set_property (GObject *object,
* parameters using object properties. Object properties can be set
* globally (with g_object_set()). Also, with #GtkTreeViewColumn, you
* can bind a property to a value in a #GtkTreeModel. For example, you
* can bind the "active" property on the cell renderer to a boolean value
* can bind the active property on the cell renderer to a boolean value
* in the model, thus causing the check button to reflect the state of
* the model.
*

View File

@ -1173,7 +1173,7 @@ gtk_cell_view_get_model (GtkCellView *cell_view)
*
* Sets the row of the model that is currently displayed
* by the #GtkCellView. If the path is unset, then the
* contents of the cellview "stick" at their last value;
* contents of the cellview stick at their last value;
* this is not normally a desired result, but may be
* a needed intermediate state if say, the model for
* the #GtkCellView becomes temporarily empty.

View File

@ -381,13 +381,13 @@ gtk_check_menu_item_toggled (GtkCheckMenuItem *check_menu_item)
/**
* gtk_check_menu_item_set_inconsistent:
* @check_menu_item: a #GtkCheckMenuItem
* @setting: %TRUE to display an "inconsistent" third state check
* @setting: %TRUE to display an inconsistent third state check
*
* If the user has selected a range of elements (such as some text or
* spreadsheet cells) that are affected by a boolean setting, and the
* current values in that range are inconsistent, you may want to
* display the check in an "in between" state. This function turns on
* "in between" display. Normally you would turn off the inconsistent
* display the check in an in between state. This function turns on
* in between display. Normally you would turn off the inconsistent
* state again if the user explicitly selects a setting. This has to be
* done manually, gtk_check_menu_item_set_inconsistent() only affects
* visual appearance, it doesn't affect the semantics of the widget.

View File

@ -56,8 +56,8 @@
* the same process. Each clipboard is identified by a name encoded as a
* #GdkAtom. (Conversion to and from strings can be done with
* gdk_atom_intern() and gdk_atom_name().) The default clipboard
* corresponds to the "CLIPBOARD" atom; another commonly used clipboard
* is the "PRIMARY" clipboard, which, in X, traditionally contains
* corresponds to the CLIPBOARD atom; another commonly used clipboard
* is the PRIMARY clipboard, which, in X, traditionally contains
* the currently selected text.
*
* To support having a number of different formats on the clipboard
@ -333,7 +333,7 @@ clipboard_display_closed (GdkDisplay *display,
*
* See the
* [FreeDesktop Clipboard Specification](http://www.freedesktop.org/Standards/clipboards-spec)
* for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY"
* for a detailed discussion of the CLIPBOARD vs. PRIMARY
* selections under the X window system. On Win32 the
* #GDK_SELECTION_PRIMARY clipboard is essentially ignored.)
*
@ -341,8 +341,8 @@ clipboard_display_closed (GdkDisplay *display,
* new clipboards, you should prefix the selection name with an
* underscore (because the ICCCM requires that nonstandard atoms are
* underscore-prefixed), and namespace it as well. For example,
* if your application called "Foo" has a special-purpose
* clipboard, you might call it "_FOO_SPECIAL_CLIPBOARD".
* if your application called Foo has a special-purpose
* clipboard, you might call it _FOO_SPECIAL_CLIPBOARD.
*
* Return value: (transfer none): the appropriate clipboard object. If no
* clipboard already exists, a new one will be created. Once a clipboard
@ -674,7 +674,7 @@ gtk_clipboard_set_with_data (GtkClipboard *clipboard,
* @clear_func: (scope async): when the clipboard contents are set again,
* this function will be called, and @get_func will not be subsequently
* called
* @owner: an object that "owns" the data. This object will be passed
* @owner: an object that owns the data. This object will be passed
* to the callbacks when called
*
* Virtually sets the contents of the specified clipboard by providing
@ -1957,7 +1957,7 @@ gtk_clipboard_owner_change (GtkClipboard *clipboard,
* @target: A #GdkAtom indicating which target to look for.
*
* Checks if a clipboard supports pasting data of a given type. This
* function can be used to determine if a "Paste" menu item should be
* function can be used to determine if a Paste menu item should be
* insensitive or not.
*
* If you want to see if there's text available on the clipboard, use

View File

@ -57,9 +57,9 @@
* The GtkComboBoxText implementation of the GtkBuildable interface
* supports adding items directly using the &lt;items&gt; element
* and specifying &lt;item&gt; elements for each item. Each &lt;item&gt;
* element can specify the "id" corresponding to the appended text and
* also supports the regular translation attributes "translatable",
* "context" and "comments".
* element can specify the id corresponding to the appended text and
* also supports the regular translation attributes translatable,
* context and comments.
*
* Here is a a UI definition fragment specifying GtkComboBoxText items:
* |[

View File

@ -220,7 +220,7 @@
* ]|
*
* Since 2.16, child properties can also be marked as translatable using
* the same "translatable", "comments" and "context" attributes that are used
* the same translatable, comments and context attributes that are used
* for regular properties.
*/
@ -1831,7 +1831,7 @@ _gtk_container_queue_restyle (GtkContainer *container)
* _gtk_container_queue_resize:
* @container: a #GtkContainer
*
* Determines the "resize container" in the hierarchy above this container
* Determines the resize container in the hierarchy above this container
* (typically the toplevel, but other containers can be set as resize
* containers with gtk_container_set_resize_mode()), marks the container
* and all parents up to and including the resize container as needing
@ -2094,7 +2094,7 @@ gtk_container_get_request_mode (GtkWidget *widget)
*
* gtk_container_class_handle_border_width() is necessary because it
* would break API too badly to make this behavior the default. So
* subclasses must "opt in" to the parent class handling border_width
* subclasses must opt in to the parent class handling border_width
* for them.
*/
void
@ -2112,8 +2112,8 @@ gtk_container_class_handle_border_width (GtkContainerClass *klass)
* @callback_data: callback user data
*
* Invokes @callback on each child of @container, including children
* that are considered "internal" (implementation details of the
* container). "Internal" children generally weren't added by the user
* that are considered internal (implementation details of the
* container). Internal children generally weren't added by the user
* of the container, but were added by the container implementation
* itself. Most applications should use gtk_container_foreach(),
* rather than gtk_container_forall().
@ -2142,7 +2142,7 @@ gtk_container_forall (GtkContainer *container,
*
* Invokes @callback on each non-internal child of @container. See
* gtk_container_forall() for details on what constitutes an
* "internal" child. Most applications should use
* internal child. Most applications should use
* gtk_container_foreach(), rather than gtk_container_forall().
**/
void

View File

@ -68,11 +68,11 @@ _gtk_css_lookup_is_missing (const GtkCssLookup *lookup,
* @lookup: the lookup
* @id: id of the property to set, see _gtk_style_property_get_id()
* @section: (allow-none): The @section the value was defined in or %NULL
* @value: the "cascading value" to use
* @value: the cascading value to use
*
* Sets the @value for a given @id. No value may have been set for @id
* before. See _gtk_css_lookup_is_missing(). This function is used to
* set the "winning declaration" of a lookup. Note that for performance
* set the winning declaration of a lookup. Note that for performance
* reasons @value and @section are not copied. It is your responsibility
* to ensure they are kept alive until _gtk_css_lookup_free() is called.
**/
@ -96,11 +96,11 @@ _gtk_css_lookup_set (GtkCssLookup *lookup,
* @lookup: the lookup
* @id: id of the property to set, see _gtk_style_property_get_id()
* @section: (allow-none): The @section the value was defined in or %NULL
* @value: the "computed value" to use
* @value: the computed value to use
*
* Sets the @value for a given @id. No value may have been set for @id
* before. See _gtk_css_lookup_is_missing(). This function is used to
* set the "winning declaration" of a lookup. Note that for performance
* set the winning declaration of a lookup. Note that for performance
* reasons @value and @section are not copied. It is your responsibility
* to ensure they are kept alive until _gtk_css_lookup_free() is called.
*
@ -132,9 +132,9 @@ _gtk_css_lookup_set_computed (GtkCssLookup *lookup,
* @values: a new #GtkCssComputedValues to be filled with the new properties
*
* Resolves the current lookup into a styleproperties object. This is done
* by converting from the "winning declaration" to the "computed value".
* by converting from the winning declaration to the computed value.
*
* XXX: This bypasses the notion of "specified value". If this ever becomes
* XXX: This bypasses the notion of specified value. If this ever becomes
* an issue, go fix it.
**/
void

View File

@ -540,7 +540,7 @@
* <literallayout>border-image-slice: @top @right @bottom @left</literallayout>
* The sizes specified by the @top, @right, @bottom and @left parameters
* are the offsets, in pixels, from the relevant edge where the image
* should be "cut off" to build the slices used for the rendering
* should be cut off to build the slices used for the rendering
* of the border.
*
* <literallayout>border-image-width: @top @right @bottom @left</literallayout>

View File

@ -131,11 +131,11 @@
* # GtkDialog as GtkBuildable
*
* The GtkDialog implementation of the #GtkBuildable interface exposes the
* @vbox and @action_area as internal children with the names "vbox" and
* "action_area".
* @vbox and @action_area as internal children with the names vbox and
* action_area.
*
* GtkDialog supports a custom &lt;action-widgets&gt; element, which
* can contain multiple &lt;action-widget&gt; elements. The "response"
* can contain multiple &lt;action-widget&gt; elements. The response
* attribute specifies a numeric response, and the content of the element
* is the id of widget (which should be a child of the dialogs @action_area).
*
@ -1081,7 +1081,7 @@ gtk_dialog_set_response_sensitive (GtkDialog *dialog,
* @response_id: a response ID
*
* Sets the last widget in the dialog's action area with the given @response_id
* as the default widget for the dialog. Pressing "Enter" normally activates
* as the default widget for the dialog. Pressing Enter normally activates
* the default widget.
**/
void

View File

@ -1741,7 +1741,7 @@ gtk_drag_source_set_icon_name (GtkWidget *widget,
*
* Changes the icon for a widget to a given widget. GTK+
* will not destroy the icon, so if you don't want
* it to persist, you should connect to the "drag-end"
* it to persist, you should connect to the drag-end
* signal and destroy it yourself.
**/
void

View File

@ -3197,7 +3197,7 @@ gtk_drag_set_icon_window (GdkDragContext *context,
*
* Changes the icon for a widget to a given widget. GTK+
* will not destroy the icon, so if you don't want
* it to persist, you should connect to the "drag-end"
* it to persist, you should connect to the drag-end
* signal and destroy it yourself.
**/
void
@ -4329,7 +4329,7 @@ gtk_drag_cancel (GtkDragSourceInfo *info, GtkDragResult result, guint32 time)
/*************************************************************
* gtk_drag_motion_cb:
* "motion-notify-event" callback during drag.
* motion-notify-event callback during drag.
* arguments:
*
* results:
@ -4362,7 +4362,7 @@ gtk_drag_motion_cb (GtkWidget *widget,
/*************************************************************
* gtk_drag_key_cb:
* "key-press/release-event" callback during drag.
* key-press/release-event callback during drag.
* arguments:
*
* results:
@ -4501,7 +4501,7 @@ gtk_drag_grab_notify_cb (GtkWidget *widget,
/*************************************************************
* gtk_drag_button_release_cb:
* "button-release-event" callback during drag.
* button-release-event callback during drag.
* arguments:
*
* results:

View File

@ -94,7 +94,7 @@
*
* Draw signals are normally delivered when a drawing area first comes
* onscreen, or when it's covered by another window and then uncovered.
* You can also force an expose event by adding to the "damage region"
* You can also force an expose event by adding to the damage region
* of the drawing area's window; gtk_widget_queue_draw_area() and
* gdk_window_invalidate_rect() are equally good ways to do this.
* You'll then get a draw signal for the invalid region.
@ -105,7 +105,7 @@
*
* To receive mouse events on a drawing area, you will need to enable
* them with gtk_widget_add_events(). To receive keyboard events, you
* will need to set the "can-focus" property on the drawing area, and you
* will need to set the can-focus property on the drawing area, and you
* should probably draw some user-visible indication that the drawing
* area is focused. Use gtk_widget_has_focus() in your expose event
* handler to decide whether to draw the focus indicator. See

View File

@ -82,7 +82,7 @@
* position is visible.
*
* 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.
* By default, GTK+ picks the best invisible character that is available
* in the current font, but it can be changed with
@ -7571,7 +7571,7 @@ gtk_entry_get_visibility (GtkEntry *entry)
*
* Sets the character to use in place of the actual text when
* gtk_entry_set_visibility() has been called to set text visibility
* to %FALSE. i.e. this is the character used in "password mode" to
* to %FALSE. i.e. this is the character used in password mode to
* show the user how many characters have been typed. By default, GTK+
* picks the best invisible char available in the current font. If you
* set the invisible char to 0, then the user will get no feedback
@ -8109,7 +8109,7 @@ gtk_entry_text_index_to_layout_index (GtkEntry *entry,
* is clicked.
*
* Note that as the user scrolls around in the entry the offsets will
* change; you'll need to connect to the "notify::scroll-offset"
* change; you'll need to connect to the notify::scroll-offset
* signal to track this. Remember when using the #PangoLayout
* functions you need to convert to and from pixels using
* PANGO_PIXELS() or #PANGO_SCALE.
@ -8335,7 +8335,7 @@ gtk_entry_set_icon_from_stock (GtkEntry *entry,
* Sets the icon shown in the entry at the specified position
* from the current icon theme.
*
* If the icon name isn't known, a "broken image" icon will be displayed
* If the icon name isn't known, a broken image icon will be displayed
* instead.
*
* If @icon_name is %NULL, no icon will be shown in the specified position.
@ -8401,7 +8401,7 @@ gtk_entry_set_icon_from_icon_name (GtkEntry *entry,
*
* Sets the icon shown in the entry at the specified position
* from the current icon theme.
* If the icon isn't known, a "broken image" icon will be displayed
* If the icon isn't known, a broken image icon will be displayed
* instead.
*
* If @icon is %NULL, no icon will be shown in the specified position.
@ -10193,7 +10193,7 @@ gtk_entry_get_cursor_hadjustment (GtkEntry *entry)
* @entry: a #GtkEntry
* @fraction: fraction of the task that's been completed
*
* Causes the entry's progress indicator to "fill in" the given
* Causes the entry's progress indicator to fill in the given
* fraction of the bar. The fraction should be between 0.0 and 1.0,
* inclusive.
*
@ -10314,7 +10314,7 @@ gtk_entry_get_progress_pulse_step (GtkEntry *entry)
* @entry: a #GtkEntry
*
* Indicates that some progress is made, but you don't know how much.
* Causes the entry's progress indicator to enter "activity mode,"
* Causes the entry's progress indicator to enter activity mode,
* where a block bounces back and forth. Each call to
* gtk_entry_progress_pulse() causes the block to move by a little bit
* (the amount of movement per pulse is determined by

View File

@ -25,7 +25,7 @@
* #GtkCellLayout interface, to allow the user to add extra cells to the
* #GtkTreeView with completion matches.
*
* "Completion functionality" means that when the user modifies the text
* Completion functionality means that when the user modifies the text
* in the entry, #GtkEntryCompletion checks which rows in the model match
* the current content of the entry, and displays a list of matches.
* By default, the matching is done by comparing the entry text
@ -44,7 +44,7 @@
*
* In addition to regular completion matches, which will be inserted into the
* entry when they are selected, #GtkEntryCompletion also allows to display
* "actions" in the popup window. Their appearance is similar to menuitems,
* actions in the popup window. Their appearance is similar to menuitems,
* to differentiate them clearly from completion strings. When an action is
* selected, the #GtkEntryCompletion::action-activated signal is emitted.
*

View File

@ -56,7 +56,7 @@ G_BEGIN_DECLS
* Controls how a widget deals with extra space in a single (x or y)
* dimension.
*
* Alignment only matters if the widget receives a "too large" allocation,
* Alignment only matters if the widget receives a too large allocation,
* for example if you packed the widget with the #GtkWidget:expand
* flag inside a #GtkBox, then the widget might get extra space. If
* you have for example a 16x16 icon inside a 32x32 space, the icon
@ -730,7 +730,7 @@ typedef enum
* @GTK_WINDOW_POPUP: A special window such as a tooltip.
*
* A #GtkWindow can be one of these types. Most things you'd consider a
* "window" should have type #GTK_WINDOW_TOPLEVEL; windows with this type
* window should have type #GTK_WINDOW_TOPLEVEL; windows with this type
* are managed by the window manager and have a frame by default (call
* gtk_window_set_decorated() to toggle the frame). Windows with type
* #GTK_WINDOW_POPUP are ignored by the window manager; window manager

View File

@ -73,7 +73,7 @@
*
* The GtkExpander implementation of the GtkBuildable interface
* supports placing a child in the label position by specifying
* "label" as the "type" attribute of a &lt;child&gt; element.
* label as the type attribute of a &lt;child&gt; element.
* A normal content child can be specified without specifying
* a &lt;child&gt; type attribute.
*
@ -2114,7 +2114,7 @@ gtk_expander_set_resize_toplevel (GtkExpander *expander,
* Returns whether the expander will resize the toplevel widget
* containing the expander upon resizing and collpasing.
*
* Return value: the "resize toplevel" setting.
* Return value: the resize toplevel setting.
*
* Since: 3.2
*/

View File

@ -45,7 +45,7 @@
* sources and in various flavours, so lets explain the terminology here:
*
* - Bookmarks: are created by the user, by dragging folders from the
* right pane to the left pane, or by using the "Add". Bookmarks
* right pane to the left pane, or by using the Add. Bookmarks
* can be renamed and deleted by the user.
*
* - Shortcuts: can be provided by the application. For example, a Paint
@ -53,7 +53,7 @@
* cannot be modified by the user.
*
* - Volumes: are provided by the underlying filesystem abstraction. They are
* the "roots" of the filesystem.
* the roots of the filesystem.
*
* # File Names and Encodings
*
@ -962,8 +962,8 @@ gtk_file_chooser_get_current_folder (GtkFileChooser *chooser)
* Sets the current name in the file selector, as if entered
* by the user. Note that the name passed in here is a UTF-8
* string rather than a filename. This function is meant for
* such uses as a suggested name in a "Save As..." dialog. You can
* pass "Untitled.doc" or a similarly suitable suggestion for the @name.
* such uses as a suggested name in a Save As... dialog. You can
* pass Untitled.doc or a similarly suitable suggestion for the @name.
*
* If you want to preselect a particular existing file, you should use
* gtk_file_chooser_set_filename() or gtk_file_chooser_set_uri() instead.
@ -987,15 +987,15 @@ gtk_file_chooser_set_current_name (GtkFileChooser *chooser,
* @chooser: a #GtkFileChooser
*
* Gets the current name in the file selector, as entered by the user in the
* text entry for "Name".
* text entry for Name.
*
* This is meant to be used in save dialogs, to get the currently typed filename
* when the file itself does not exist yet. For example, an application that
* adds a custom extra widget to the file chooser for "file format" may want to
* adds a custom extra widget to the file chooser for file format may want to
* change the extension of the typed filename based on the chosen format, say,
* from ".jpg" to ".png".
* from .jpg to .png.
*
* Returns: The raw text from the file chooser's "Name" entry. Free this with
* Returns: The raw text from the file chooser's Name entry. Free this with
* g_free(). Note that this string is not a full pathname or URI; it is
* whatever the contents of the entry are. Note also that this string is in
* UTF-8 encoding, which is not necessarily the system's encoding for filenames.
@ -1980,7 +1980,7 @@ gtk_file_chooser_get_filter (GtkFileChooser *chooser)
* Adds a folder to be displayed with the shortcut folders in a file chooser.
* Note that shortcut folders do not get saved, as they are provided by the
* application. For example, you can use this to add a
* "/usr/share/mydrawprogram/Clipart" folder to the volume list.
* /usr/share/mydrawprogram/Clipart folder to the volume list.
*
* Return value: %TRUE if the folder could be added successfully, %FALSE
* otherwise. In the latter case, the @error will be set as appropriate.
@ -2078,7 +2078,7 @@ gtk_file_chooser_list_shortcut_folders (GtkFileChooser *chooser)
* Adds a folder URI to be displayed with the shortcut folders in a file
* chooser. Note that shortcut folders do not get saved, as they are provided
* by the application. For example, you can use this to add a
* "file:///usr/share/mydrawprogram/Clipart" folder to the volume list.
* file:///usr/share/mydrawprogram/Clipart” folder to the volume list.
*
* Return value: %TRUE if the folder could be added successfully, %FALSE
* otherwise. In the latter case, the @error will be set as appropriate.

View File

@ -2775,7 +2775,7 @@ combo_box_changed_cb (GtkComboBox *combo_box,
/* Calback for the "notify::popup-shown" signal on the combo box.
* When the combo is popped up, we don't want the ROW_TYPE_EMPTY_SELECTION to be visible
* at all; otherwise we would be showing a "(None)" item in the combo box's popup.
* at all; otherwise we would be showing a (None) item in the combo box's popup.
*
* However, when the combo box is *not* popped up, we want the empty-selection row
* to be visible depending on the selection.

View File

@ -37,12 +37,12 @@
/**
* SECTION:gtkfilechooserdialog
* @Short_description: A file chooser dialog, suitable for "File/Open" or "File/Save" commands
* @Short_description: A file chooser dialog, suitable for File/Open or File/Save commands
* @Title: GtkFileChooserDialog
* @See_also: #GtkFileChooser, #GtkDialog
*
* #GtkFileChooserDialog is a dialog box suitable for use with
* "File/Open" or "File/Save as" commands. This widget works by
* File/Open or File/Save as commands. This widget works by
* putting a #GtkFileChooserWidget inside a #GtkDialog. It exposes
* the #GtkFileChooser interface, so you can use all of the
* #GtkFileChooser functions on the file chooser dialog as well as
@ -116,7 +116,7 @@
* - To select a file for opening. Use #GTK_FILE_CHOOSER_ACTION_OPEN.
*
* - To save a file for the first time. Use #GTK_FILE_CHOOSER_ACTION_SAVE,
* and suggest a name such as "Untitled" with gtk_file_chooser_set_current_name().
* and suggest a name such as Untitled with gtk_file_chooser_set_current_name().
*
* - To save a file under a different name. Use #GTK_FILE_CHOOSER_ACTION_SAVE,
* and set the existing filename with gtk_file_chooser_set_filename().
@ -152,11 +152,11 @@
* NULL);
* ]|
*
* This will create buttons for "Cancel" and "Open" that use stock
* This will create buttons for Cancel and Open that use stock
* response identifiers from #GtkResponseType. For most dialog
* boxes you can use your own custom response codes rather than the
* ones in #GtkResponseType, but #GtkFileChooserDialog assumes that
* its "accept"-type action, e.g. an "Open" or "Save" button,
* its accept-type action, e.g. an Open or Save button,
* will have one of the following response codes:
*
* - #GTK_RESPONSE_ACCEPT

View File

@ -2421,7 +2421,7 @@ save_path_bar (GtkFileChooserWidget *impl)
}
/* Reparents the path bar and the "Create folder" button to the right place:
* Above the file list in Open mode, or to the right of the "Save in folder:"
* Above the file list in Open mode, or to the right of the Save in folder:
* label in Save mode. The save_path_bar() function must be called before this
* one.
*/
@ -3012,7 +3012,7 @@ toplevel_set_focus_cb (GtkWindow *window,
}
/* We monitor the focus widget on our toplevel to be able to know which widget
* was last focused at the time our "should_respond" method gets called.
* was last focused at the time our should_respond method gets called.
*/
static void
gtk_file_chooser_widget_hierarchy_changed (GtkWidget *widget,
@ -4787,7 +4787,7 @@ gtk_file_chooser_widget_unselect_all (GtkFileChooser *chooser)
* is_empty_ret - whether the file entry is totally empty
*
* is_file_part_empty_ret - whether the file part is empty (will be if user types "foobar/", and
* the path will be "$cwd/foobar")
* the path will be $cwd/foobar)
*/
static void
check_save_entry (GtkFileChooserWidget *impl,
@ -5386,7 +5386,7 @@ struct GetDisplayNameData
};
/* Every time we request a response explicitly, we need to save the selection to the recently-used list,
* as requesting a response means, "the dialog is confirmed".
* as requesting a response means, the dialog is confirmed.
*/
static void
request_response_and_add_to_recent_list (GtkFileChooserWidget *impl)

View File

@ -41,7 +41,7 @@
/* The pointers we return for a GtkFileSystemVolume are opaque tokens; they are
* really pointers to GDrive, GVolume or GMount objects. We need an extra
* token for the fake "File System" volume. So, we'll return a pointer to
* token for the fake File System volume. So, we'll return a pointer to
* this particular string.
*/
static const gchar *root_volume_token = N_("File System");

View File

@ -39,7 +39,7 @@
*
* 2. The caller populates the model by hand, with files not necessarily in the same folder. This happens
* if you use _gtk_file_system_model_new() and then _gtk_file_system_model_add_and_query_file(). This is
* the special kind of usage for "search" and "recent-files", where the file chooser gives the model the
* the special kind of usage for search and recent-files, where the file chooser gives the model the
* files to be displayed.
*
* Internal data structure
@ -70,7 +70,7 @@
* Each FileModelNode has a node->visible field, which indicates whether the node is visible in the GtkTreeView.
* A node may be invisible if, for example, it corresponds to a hidden file and the file chooser is not showing
* hidden files. Also, a file filter may be explicitly set onto the model, for example, to only show files that
* match "*.jpg". In this case, node->filtered_out says whether the node failed the filter. The ultimate
* match *.jpg. In this case, node->filtered_out says whether the node failed the filter. The ultimate
* decision on whether a node is visible or not in the treeview is distilled into the node->visible field.
* The reason for having a separate node->filtered_out field is so that the file chooser can query whether
* a (filtered-out) folder should be made sensitive in the GUI.
@ -82,12 +82,12 @@
* the treeview to array indexes in our array of files. And thus we introduce a bit of terminology:
*
* index - An index in the model->files array. All variables/fields that represent indexes are either called
* "index" or "i_*", or simply "i" for things like loop counters.
* index or i_*, or simply i for things like loop counters.
*
* row - An index in the GtkTreeView, i.e. the index of a row within the outward-facing API of the
* GtkFileSystemModel. However, note that our rows are 1-based, not 0-based, for the reason explained in the
* following paragraph. Variables/fields that represent visible rows are called "row", or "r_*", or simply
* "r".
* following paragraph. Variables/fields that represent visible rows are called row, or r_*, or simply
* r.
*
* Each FileModelNode has a node->row field which is the number of visible rows in the treeview, *before and
* including* that node. This means that node->row is 1-based, instead of 0-based --- this makes some code
@ -95,7 +95,7 @@
* turn the 0-based treepath into a 1-based row for our purposes. If a node is not visible, it will have the
* same row number as its closest preceding visible node.
*
* We try to compute the node->row fields lazily. A node is said to be "valid" if its node->row is accurate.
* We try to compute the node->row fields lazily. A node is said to be valid if its node->row is accurate.
* For this, the model keeps a model->n_nodes_valid field which is the count of valid nodes starting from the
* beginning of the model->files array. When a node changes its information, or when a node gets deleted, that
* node and the following ones get invalidated by simply setting model->n_nodes_valid to the array index of the
@ -244,7 +244,7 @@ static void remove_file (GtkFileSystemModel *model,
*
* If you want to validate up to an index or up to a row, specify the index or
* the row you want and specify G_MAXUINT for the other argument. Pass
* G_MAXUINT for both arguments for "validate everything".
* G_MAXUINT for both arguments for validate everything.
*/
static void
node_validate_rows (GtkFileSystemModel *model, guint up_to_index, guint up_to_row)
@ -1995,7 +1995,7 @@ _gtk_file_system_model_set_filter (GtkFileSystemModel *model,
* @model: a #GtkFileSystemModel
* @iter: Location to return the iter corresponding to the editable row
*
* Adds an "empty" row at the beginning of the model. This does not refer to
* Adds an empty row at the beginning of the model. This does not refer to
* any file, but is a temporary placeholder for a file name that the user will
* type when a corresponding cell is made editable. When your code is done
* using this temporary row, call _gtk_file_system_model_remove_editable().
@ -2014,7 +2014,7 @@ _gtk_file_system_model_add_editable (GtkFileSystemModel *model, GtkTreeIter *ite
* _gtk_file_system_model_remove_editable:
* @model: a #GtkFileSystemModel
*
* Removes the "empty" row at the beginning of the model that was
* Removes the empty row at the beginning of the model that was
* created with _gtk_file_system_model_add_editable(). You should call
* this function when your code is finished editing this temporary row.
**/

View File

@ -201,8 +201,8 @@ gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser)
* Note that this can be a different string than what you set with
* gtk_font_chooser_set_font(), as the font chooser widget may
* normalize font names and thus return a string with a different
* structure. For example, "Helvetica Italic Bold 12" could be
* normalized to "Helvetica Bold Italic 12".
* structure. For example, Helvetica Italic Bold 12 could be
* normalized to Helvetica Bold Italic 12.
*
* Use pango_font_description_equal() if you want to compare two
* font descriptions.
@ -229,7 +229,7 @@ gtk_font_chooser_get_font (GtkFontChooser *fontchooser)
/**
* gtk_font_chooser_set_font:
* @fontchooser: a #GtkFontChooser
* @fontname: a font name like "Helvetica 12" or "Times Bold 18"
* @fontname: a font name like Helvetica 12 or Times Bold 18
*
* Sets the currently-selected font.
*
@ -254,8 +254,8 @@ gtk_font_chooser_set_font (GtkFontChooser *fontchooser,
* Note that this can be a different string than what you set with
* gtk_font_chooser_set_font(), as the font chooser widget may
* normalize font names and thus return a string with a different
* structure. For example, "Helvetica Italic Bold 12" could be
* normalized to "Helvetica Bold Italic 12".
* structure. For example, Helvetica Italic Bold 12 could be
* normalized to Helvetica Bold Italic 12.
*
* Use pango_font_description_equal() if you want to compare two
* font descriptions.

View File

@ -57,8 +57,8 @@ struct _GtkFontChooserDialogPrivate
* # GtkFontChooserDialog as GtkBuildable
*
* The GtkFontChooserDialog implementation of the #GtkBuildable
* interface exposes the buttons with the names "select_button"
* and "cancel_button".
* interface exposes the buttons with the names select_button
* and cancel_button.
*
* Since: 3.2
*/

View File

@ -49,7 +49,7 @@
*
* The GtkFrame implementation of the GtkBuildable interface
* supports placing a child in the label position by specifying
* "label" as the "type" attribute of a &lt;child&gt; element.
* label as the type attribute of a &lt;child&gt; element.
* A normal content child can be specified without specifying
* a &lt;child&gt; type attribute.
*

View File

@ -1233,7 +1233,7 @@ gtk_header_bar_get_subtitle (GtkHeaderBar *bar)
* The title should help a user identify the current view. This
* supersedes any title set by gtk_header_bar_set_title() or
* gtk_header_bar_set_subtitle(). To achieve the same style as
* the builtin title and subtitle, use the "title" and "subtitle"
* the builtin title and subtitle, use the title and subtitle
* style classes.
*
* You should set the custom title to %NULL, for the header title
@ -2047,7 +2047,7 @@ gtk_header_bar_get_has_subtitle (GtkHeaderBar *bar)
* maximize, close, icon (the window icon) and menu (a menu button
* for the fallback app menu).
*
* For example, "menu:minimize,maximize,close" specifies a menu
* For example, menu:minimize,maximize,close specifies a menu
* on the left, and minimize, maximize and close buttons on the right.
*
* Since: 3.12

View File

@ -102,7 +102,7 @@
* terms of one or more named icons. (An example of the
* more than one case is icons that depend on writing direction;
* %GTK_STOCK_GO_FORWARD uses the two themed icons
* "gtk-stock-go-forward-ltr" and "gtk-stock-go-forward-rtl".)
* gtk-stock-go-forward-ltr and gtk-stock-go-forward-rtl.)
*
* In many cases, named themes are used indirectly, via #GtkImage
* or stock items, rather than directly, but looking up icons
@ -2381,8 +2381,8 @@ add_key_to_list (gpointer key,
* Lists the icons in the current icon theme. Only a subset
* of the icons can be listed by providing a context string.
* The set of values for the context string is system dependent,
* but will typically include such values as "Applications" and
* "MimeTypes".
* but will typically include such values as Applications and
* MimeTypes.
*
* Return value: (element-type utf8) (transfer full): a #GList list
* holding the names of all the icons in the theme. You must first
@ -4316,7 +4316,7 @@ _gtk_icon_info_load_symbolic_internal (GtkIconInfo *icon_info,
* g_themed_icon_new_with_default_fallbacks() to load the icon.
*
* 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
* SVG file itself.
*
@ -4370,7 +4370,7 @@ gtk_icon_info_load_symbolic (GtkIconInfo *icon_info,
* success, warning and error colors provided. If the icon is not a symbolic
* one, the function will return the result from gtk_icon_info_load_icon().
* This function uses the regular foreground color and the symbolic colors
* with the names "success_color", "warning_color" and "error_color" from
* with the names success_color, warning_color and error_color from
* the context.
*
* This allows loading symbolic icons that will match the system theme.
@ -5089,7 +5089,7 @@ gtk_icon_theme_add_builtin_icon (const gchar *icon_name,
/* Look up a builtin icon; the min_difference_p and
* has_larger_p out parameters allow us to combine
* this lookup with searching through the actual directories
* of the "hicolor" icon theme. See theme_lookup_icon()
* of the hicolor icon theme. See theme_lookup_icon()
* for how they are used.
*/
static BuiltinIcon *

View File

@ -57,7 +57,7 @@
* image = gtk_image_new_from_file ("myfile.png");
* ]|
* If the file isn't loaded successfully, the image will contain a
* "broken image" icon similar to that used in many web browsers.
* broken image icon similar to that used in many web browsers.
* If you want to handle errors in loading the file yourself,
* for example by displaying an error message, then load the image with
* gdk_pixbuf_new_from_file(), then create the #GtkImage with
@ -70,7 +70,7 @@
* align it (center, left, right) and add padding to it, using
* #GtkMisc methods.
*
* #GtkImage is a "no window" widget (has no #GdkWindow of its own),
* #GtkImage is a no window widget (has no #GdkWindow of its own),
* so by default does not receive events. If you want to receive events
* on the image, such as button clicks, place the image inside a
* #GtkEventBox, then connect to the event signals on the event box.
@ -551,7 +551,7 @@ gtk_image_get_property (GObject *object,
*
* Creates a new #GtkImage displaying the file @filename. If the file
* isn't found or can't be loaded, the resulting #GtkImage will
* display a "broken image" icon. This function never returns %NULL,
* display a broken image icon. This function never returns %NULL,
* it always returns a valid #GtkImage widget.
*
* If the file contains an animation, the image will contain an
@ -586,7 +586,7 @@ gtk_image_new_from_file (const gchar *filename)
*
* Creates a new #GtkImage displaying the resource file @resource_path. If the file
* isn't found or can't be loaded, the resulting #GtkImage will
* display a "broken image" icon. This function never returns %NULL,
* display a broken image icon. This function never returns %NULL,
* it always returns a valid #GtkImage widget.
*
* If the file contains an animation, the image will contain an
@ -772,7 +772,7 @@ gtk_image_new_from_animation (GdkPixbufAnimation *animation)
* @size: (type int): a stock icon size
*
* Creates a #GtkImage displaying an icon from the current icon theme.
* If the icon name isn't known, a "broken image" icon will be
* If the icon name isn't known, a broken image icon will be
* displayed instead. If the current icon theme is changed, the icon
* will be updated appropriately.
*
@ -799,7 +799,7 @@ gtk_image_new_from_icon_name (const gchar *icon_name,
* @size: (type int): a stock icon size
*
* Creates a #GtkImage displaying an icon from the current icon theme.
* If the icon name isn't known, a "broken image" icon will be
* If the icon name isn't known, a broken image icon will be
* displayed instead. If the current icon theme is changed, the icon
* will be updated appropriately.
*

View File

@ -48,7 +48,7 @@
* may provide feedback about this process by displaying the intermediate
* composition states as preedit text. For instance, the default GTK+ input
* method implements the input of arbitrary Unicode code points by holding down
* the Control and Shift keys and then typing "U" followed by the hexadecimal
* the Control and Shift keys and then typing U followed by the hexadecimal
* digits of the code point. When releasing the Control and Shift keys,
* preediting ends and the character is inserted as text. Ctrl+Shift+u20AC for
* example results in the sign.

View File

@ -73,7 +73,7 @@
* @domain: Translation domain to be used with dgettext()
* @domain_dirname: Name of locale directory for use with bindtextdomain()
* @default_locales: A colon-separated list of locales where this input method
* should be the default. The asterisk "*" sets the default for all locales.
* should be the default. The asterisk * sets the default for all locales.
*
* Bookkeeping information about a loadable input method.
*/

View File

@ -102,10 +102,10 @@
*
* The GtkInfoBar implementation of the GtkBuildable interface exposes
* the content area and action area as internal children with the names
* "content_area" and "action_area".
* content_area and action_area.
*
* GtkInfoBar supports a custom &lt;action-widgets&gt; element, which
* can contain multiple &lt;action-widget&gt; elements. The "response"
* can contain multiple &lt;action-widget&gt; elements. The response
* attribute specifies a numeric response, and the content of the element
* is the id of widget (which should be a child of the dialogs @action_area).
*/
@ -736,7 +736,7 @@ gtk_info_bar_get_content_area (GtkInfoBar *info_bar)
* @response_id: response ID for the button
*
* Adds a button with the given text and sets things up so that
* clicking the button will emit the "response" signal with the given
* clicking the button will emit the response signal with the given
* response_id. The button is appended to the end of the info bars's
* action area. The button widget is returned, but usually you don't
* need it.
@ -859,7 +859,7 @@ gtk_info_bar_new (void)
* some arbitrary text. A response ID can be any positive number,
* or one of the values in the #GtkResponseType enumeration. If the
* user clicks one of these dialog buttons, GtkInfoBar will emit
* the "response" signal with the corresponding response ID.
* the response signal with the corresponding response ID.
*
* Returns: a new #GtkInfoBar
*/
@ -921,7 +921,7 @@ gtk_info_bar_set_response_sensitive (GtkInfoBar *info_bar,
*
* Sets the last widget in the info bar's action area with
* the given response_id as the default widget for the dialog.
* Pressing "Enter" normally activates the default widget.
* Pressing Enter normally activates the default widget.
*
* Note that this function currently requires @info_bar to
* be added to a widget hierarchy.

View File

@ -320,7 +320,7 @@ gtk_invisible_get_property (GObject *object,
}
/* We use a constructor here so that we can realize the invisible on
* the correct screen after the "screen" property has been set
* the correct screen after the screen property has been set
*/
static GObject*
gtk_invisible_constructor (GType type,

View File

@ -1898,7 +1898,7 @@ label_mnemonic_widget_weak_notify (gpointer data,
* If the label has been set so that it has an mnemonic key (using
* i.e. gtk_label_set_markup_with_mnemonic(),
* gtk_label_set_text_with_mnemonic(), gtk_label_new_with_mnemonic()
* or the "use_underline" property) the label can be associated with a
* or the use_underline property) the label can be associated with a
* widget that is the target of the mnemonic. When the label is inside
* a widget (like a #GtkButton or a #GtkNotebook tab) it is
* automatically associated with the correct widget, but sometimes
@ -2756,8 +2756,8 @@ gtk_label_set_pattern_internal (GtkLabel *label,
*
* The pattern of underlines you want under the existing text within the
* #GtkLabel widget. For example if the current text of the label says
* "FooBarBaz" passing a pattern of "___ ___" will underline
* "Foo" and "Baz" but not "Bar".
* FooBarBaz passing a pattern of ___ ___ will underline
* Foo and Baz but not Bar.
*/
void
gtk_label_set_pattern (GtkLabel *label,

View File

@ -46,7 +46,7 @@
* @Title: GtkLayout
* @See_also: #GtkDrawingArea, #GtkScrolledWindow
*
* #GtkLayout is similar to #GtkDrawingArea in that it's a "blank slate"
* #GtkLayout is similar to #GtkDrawingArea in that it's a blank slate
* and doesn't do anything but paint a blank background by default. It's
* different in that it supports scrolling natively (you can add it to a
* #GtkScrolledWindow), and it can contain child widgets, since it's a

View File

@ -137,7 +137,7 @@
* The GtkListStore implementation of the GtkBuildable interface allows
* to specify the model columns with a &lt;columns&gt; element that may
* contain multiple &lt;column&gt; elements, each specifying one model
* column. The "type" attribute specifies the data type for the column.
* column. The type attribute specifies the data type for the column.
*
* Additionally, it is possible to specify content for the list store
* in the UI definition, with the &lt;data&gt; element. It can contain
@ -1166,7 +1166,7 @@ gtk_list_store_set_valist (GtkListStore *list_store,
* The variable argument list should contain integer column numbers,
* each column number followed by the value to be set.
* The list is terminated by a -1. For example, to set column 0 with type
* %G_TYPE_STRING to "Foo", you would write `gtk_list_store_set (store, iter,
* %G_TYPE_STRING to Foo, you would write `gtk_list_store_set (store, iter,
* 0, "Foo", -1)`.
*
* The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it

View File

@ -39,7 +39,7 @@
* Like all GUI toolkits, GTK+ uses an event-driven programming model. When the
* user is doing nothing, GTK+ sits in the main loop and
* waits for input. If the user performs some action - say, a mouse click - then
* the main loop "wakes up" and delivers an event to GTK+. GTK+ forwards the
* the main loop wakes up and delivers an event to GTK+. GTK+ forwards the
* event to one or more widgets.
*
* When widgets receive an event, they frequently emit one or more

View File

@ -2034,7 +2034,7 @@ gtk_menu_real_can_activate_accel (GtkWidget *widget,
* each menu item of this menu, that contains a label describing its
* purpose, automatically gets an accel path assigned.
*
* For example, a menu containing menu items "New" and "Exit", will, after
* For example, a menu containing menu items New and Exit, will, after
* `gtk_menu_set_accel_path (menu, "&lt;Gnumeric-Sheet&gt;/File");`
* has been called, assign its items the accel paths:
* `"&lt;Gnumeric-Sheet&gt;/File/New"` and `"&lt;Gnumeric-Sheet&gt;/File/Exit"`.
@ -2635,7 +2635,7 @@ gtk_menu_focus (GtkWidget *widget,
}
/* See notes in gtk_menu_popup() for information
* about the "grab transfer window"
* about the grab transfer window
*/
static GdkWindow *
menu_grab_transfer_window_get (GtkMenu *menu)

View File

@ -61,7 +61,7 @@ typedef struct _GtkMenuPrivate GtkMenuPrivate;
* into the visible area, effectively modifying the popup
* position. Note that moving and possibly resizing the menu
* around will alter the scroll position to keep the menu items
* "in place", i.e. at the same monitor position they would have
* in place, i.e. at the same monitor position they would have
* been without resizing. In practice, this behavior is only
* useful for combobox popups or option menus and cannot be used
* to simply confine a menu to monitor boundaries. In that case,

View File

@ -592,7 +592,7 @@ menu_detacher (GtkWidget *widget,
}
/* This function is used in GtkMenuToolButton, the call back will
* be called when GtkMenuToolButton would have emitted the "show-menu"
* be called when GtkMenuToolButton would have emitted the show-menu
* signal.
*/
void

View File

@ -74,7 +74,7 @@
* # GtkMenuItem as GtkBuildable
*
* The GtkMenuItem implementation of the #GtkBuildable interface
* supports adding a submenu by specifying "submenu" as the "type"
* supports adding a submenu by specifying submenu as the type
* attribute of a &lt;child&gt; element.
*
* An example of UI definition fragment with submenus:
@ -1132,7 +1132,7 @@ activatable_update_label (GtkMenuItem *menu_item, GtkAction *action)
* @menu: (allow-none): a #GtkMenu or %NULL
*
* Determines whether @menu is empty. A menu is considered empty if it
* the only visible children are tearoff menu items or "filler" menu
* the only visible children are tearoff menu items or filler menu
* items which were inserted to mark the menu as empty.
*
* This function is used by #GtkAction.
@ -2238,7 +2238,7 @@ gtk_menu_item_position_menu (GtkMenu *menu,
* far right if added to a menu bar
*
* Sets whether the menu item appears justified at the right
* side of a menu bar. This was traditionally done for "Help"
* side of a menu bar. This was traditionally done for Help
* menu items, but is now considered a bad idea. (If the widget
* layout is reversed for a right-to-left language like Hebrew
* or Arabic, right-justified-menu-items appear at the left.)

View File

@ -37,11 +37,11 @@
*
* # Terminology
*
* A menu item can be "selected", this means that it is displayed
* A menu item can be selected, this means that it is displayed
* in the prelight state, and if it has a submenu, that submenu
* will be popped up.
*
* A menu is "active" when it is visible onscreen and the user
* A menu is active when it is visible onscreen and the user
* is selecting from it. A menubar is not active until the user
* clicks on one of its menuitems. When a menu is active,
* passing the mouse over a submenu will pop it up.
@ -2136,18 +2136,18 @@ gtk_menu_shell_tracker_insert_func (GtkMenuTrackerItem *item,
*
* If @action_namespace is non-%NULL then the effect is as if all
* actions mentioned in the @model have their names prefixed with the
* namespace, plus a dot. For example, if the action "quit" is
* mentioned and @action_namespace is "app" then the effective action
* name is "app.quit".
* namespace, plus a dot. For example, if the action quit is
* mentioned and @action_namespace is app then the effective action
* name is app.quit.
*
* This function uses #GtkActionable to define the action name and
* target values on the created menu items. If you want to use an
* action group other than "app" and "win", or if you want to use a
* action group other than app and win, or if you want to use a
* #GtkMenuShell outside of a #GtkApplicationWindow, then you will need
* to attach your own action group to the widget hierarchy using
* gtk_widget_insert_action_group(). As an example, if you created a
* group with a "quit" action and inserted it with the name "mygroup"
* then you would use the action name "mygroup.quit" in your
* group with a quit action and inserted it with the name mygroup
* then you would use the action name mygroup.quit in your
* #GMenuModel.
*
* For most cases you are probably better off using

View File

@ -51,7 +51,7 @@
* # GtkMenuToolButton as GtkBuildable
*
* The GtkMenuToolButton implementation of the GtkBuildable interface
* supports adding a menu by specifying "menu" as the "type"
* supports adding a menu by specifying menu as the type
* attribute of a &lt;child&gt; element.
*
* An example for a UI definition fragment with menus:

View File

@ -50,7 +50,7 @@
*
* The idea of @with_separators is for special cases where menu models may
* be tracked in places where separators are not available, like in toplevel
* "File", "Edit" menu bars. Ignoring separator items is wrong, as #GtkMenuTracker
* "File", Edit menu bars. Ignoring separator items is wrong, as #GtkMenuTracker
* expects the position to change, so we must tell #GtkMenuTracker to ignore
* separators itself.
*/
@ -520,7 +520,7 @@ gtk_menu_tracker_section_new (GtkMenuTracker *tracker,
* information about the menu item to insert. @action_namespace is the
* action namespace that actions referred to from that item should place
* themselves in. Note that if the item is a submenu and the
* "action-namespace" attribute is defined on the item, it will _not_ be
* action-namespace attribute is defined on the item, it will _not_ be
* applied to the @action_namespace argument as it is meant for the
* items inside of the submenu, not the submenu item itself.
*
@ -528,7 +528,7 @@ gtk_menu_tracker_section_new (GtkMenuTracker *tracker,
* separator. @model and @item_index will still be meaningfully set in
* this case -- to the section menu item corresponding to the separator.
* This is useful if the section specifies a label, for example. If
* there is an "action-namespace" attribute on this menu item then it
* there is an action-namespace attribute on this menu item then it
* should be ignored by the consumer because #GtkMenuTracker has already
* handled it.
*

View File

@ -90,7 +90,7 @@
* # GtkMessageDialog as GtkBuildable
*
* The GtkMessageDialog implementation of the GtkBuildable interface exposes
* the message area as an internal child with the name "message_area".
* the message area as an internal child with the name message_area.
*/
struct _GtkMessageDialogPrivate
@ -529,7 +529,7 @@ gtk_message_dialog_get_property (GObject *object,
*
* Creates a new message dialog, which is a simple dialog with an icon
* indicating the dialog type (error, warning, etc.) and some text the
* user may want to see. When the user clicks a button a "response"
* user may want to see. When the user clicks a button a response
* signal is emitted with response IDs from #GtkResponseType. See
* #GtkDialog for more details.
*
@ -594,7 +594,7 @@ gtk_message_dialog_new (GtkWindow *parent,
* Creates a new message dialog, which is a simple dialog with an icon
* indicating the dialog type (error, warning, etc.) and some text which
* is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
* When the user clicks a button a "response" signal is emitted with
* When the user clicks a button a response signal is emitted with
* response IDs from #GtkResponseType. See #GtkDialog for more details.
*
* Special XML characters in the printf() arguments passed to this
@ -604,7 +604,7 @@ gtk_message_dialog_new (GtkWindow *parent,
* Pango markup string that you want to use literally as the
* label, then you need to use gtk_message_dialog_set_markup()
* instead, since you can't pass the markup string either
* as the format (it might contain '%' characters) or as a string
* as the format (it might contain % characters) or as a string
* argument.
* |[<!-- language="C" -->
* GtkWidget *dialog;
@ -853,7 +853,7 @@ gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog,
* function in the parent #GtkDialog.
*
* Return value: (transfer none): A #GtkVBox corresponding to the
* "message area" in the @message_dialog.
* message area in the @message_dialog.
*
* Since: 2.22
**/

View File

@ -67,14 +67,14 @@
* # GtkNotebook as GtkBuildable
*
* The GtkNotebook implementation of the #GtkBuildable interface
* supports placing children into tabs by specifying "tab" as the
* "type" attribute of a &lt;child&gt; element. Note that the content
* supports placing children into tabs by specifying tab as the
* type attribute of a &lt;child&gt; element. Note that the content
* of the tab must be created before the tab can be filled.
* A tab child can be specified without specifying a &lt;child&gt;
* type attribute.
*
* To add a child widget in the notebooks action area, specify
* "action-start" or "action-end" as the "type" attribute of the &lt;child&gt;
* "action-start" or action-end as the type attribute of the &lt;child&gt;
* element.
*
* An example of a UI definition fragment with GtkNotebook:
@ -808,7 +808,7 @@ gtk_notebook_class_init (GtkNotebookClass *class)
/**
* GtkNotebook:has-secondary-backward-stepper:
*
* The "has-secondary-backward-stepper" property determines whether
* The has-secondary-backward-stepper property determines whether
* a second backward arrow button is displayed on the opposite end
* of the tab area.
*
@ -824,7 +824,7 @@ gtk_notebook_class_init (GtkNotebookClass *class)
/**
* GtkNotebook:has-secondary-forward-stepper:
*
* The "has-secondary-forward-stepper" property determines whether
* The has-secondary-forward-stepper property determines whether
* a second forward arrow button is displayed on the opposite end
* of the tab area.
*
@ -840,7 +840,7 @@ gtk_notebook_class_init (GtkNotebookClass *class)
/**
* GtkNotebook:has-backward-stepper:
*
* The "has-backward-stepper" property determines whether
* The has-backward-stepper property determines whether
* the standard backward arrow button is displayed.
*
* Since: 2.4
@ -855,7 +855,7 @@ gtk_notebook_class_init (GtkNotebookClass *class)
/**
* GtkNotebook:has-forward-stepper:
*
* The "has-forward-stepper" property determines whether
* The has-forward-stepper property determines whether
* the standard forward arrow button is displayed.
*
* Since: 2.4
@ -870,7 +870,7 @@ gtk_notebook_class_init (GtkNotebookClass *class)
/**
* GtkNotebook:tab-overlap:
*
* The "tab-overlap" property defines size of tab overlap
* The tab-overlap property defines size of tab overlap
* area.
*
* Since: 2.10
@ -887,7 +887,7 @@ gtk_notebook_class_init (GtkNotebookClass *class)
/**
* GtkNotebook:tab-curvature:
*
* The "tab-curvature" property defines size of tab curvature.
* The tab-curvature property defines size of tab curvature.
*
* Since: 2.10
*/
@ -8392,7 +8392,7 @@ gtk_notebook_get_tab_detachable (GtkNotebook *notebook,
*
* If you want a widget to interact with a notebook through DnD
* (i.e.: accept dragged tabs from it) it must be set as a drop
* destination and accept the target "GTK_NOTEBOOK_TAB". The notebook
* destination and accept the target GTK_NOTEBOOK_TAB. The notebook
* will fill the selection with a GtkWidget** pointing to the child
* widget that corresponds to the dropped tab.
* |[<!-- language="C" -->
@ -8476,7 +8476,7 @@ gtk_notebook_get_action_widget (GtkNotebook *notebook,
* the widget will be placed before or after the tabs. You can use
* a #GtkBox if you need to pack more than one widget on the same side.
*
* Note that action widgets are "internal" children of the notebook and thus
* Note that action widgets are internal children of the notebook and thus
* not included in the list returned from gtk_container_foreach().
*
* Since: 2.20

View File

@ -49,8 +49,8 @@
* # GtkOverlay as GtkBuildable
*
* The GtkOverlay implementation of the GtkBuildable interface
* supports placing a child as an overlay by specifying "overlay" as
* the "type" attribute of a `&lt;child&gt;` element.
* supports placing a child as an overlay by specifying overlay as
* the type attribute of a `&lt;child&gt;` element.
*/
struct _GtkOverlayPrivate

View File

@ -37,7 +37,7 @@
* long before user prints.
*
* ## Margins ## {#print-margins}
* The margins specified in this object are the "print margins", i.e. the
* The margins specified in this object are the print margins, i.e. the
* parts of the page that the printer cannot print on. These are different
* from the layout margins that a word processor uses; they are typically
* used to determine the minimal size for the layout
@ -608,7 +608,7 @@ string_to_enum (GType type,
* @setup: a #GtkPageSetup
* @key_file: the #GKeyFile to retrieve the page_setup from
* @group_name: (allow-none): the name of the group in the key_file to read, or %NULL
* to use the default name "Page Setup"
* to use the default name Page Setup
* @error: (allow-none): return location for an error, or %NULL
*
* Reads the page setup from the group @group_name in the key file
@ -696,7 +696,7 @@ out:
* gtk_page_setup_new_from_key_file:
* @key_file: the #GKeyFile to retrieve the page_setup from
* @group_name: (allow-none): the name of the group in the key_file to read, or %NULL
* to use the default name "Page Setup"
* to use the default name Page Setup
* @error: (allow-none): return location for an error, or %NULL
*
* Reads the page setup from the group @group_name in the key file
@ -789,7 +789,7 @@ enum_to_string (GType type,
* @setup: a #GtkPageSetup
* @key_file: the #GKeyFile to save the page setup to
* @group_name: the group to add the settings to in @key_file,
* or %NULL to use the default name "Page Setup"
* or %NULL to use the default name Page Setup
*
* This function adds the page setup from @setup to @key_file.
*

View File

@ -1899,7 +1899,7 @@ _gtk_path_bar_set_file_system (GtkPathBar *path_bar,
* _gtk_path_bar_up:
* @path_bar: a #GtkPathBar
*
* If the selected button in the pathbar is not the furthest button "up" (in the
* If the selected button in the pathbar is not the furthest button up (in the
* root direction), act as if the user clicked on the next button up.
**/
void
@ -1926,7 +1926,7 @@ _gtk_path_bar_up (GtkPathBar *path_bar)
* _gtk_path_bar_down:
* @path_bar: a #GtkPathBar
*
* If the selected button in the pathbar is not the furthest button "down" (in the
* If the selected button in the pathbar is not the furthest button down (in the
* leaf direction), act as if the user clicked on the next button down.
**/
void

View File

@ -4413,19 +4413,19 @@ shortcuts_model_new (GtkPlacesSidebar *sidebar)
*
* Sets the way in which the calling application can open new locations from
* the places sidebar. For example, some applications only open locations
* "directly" into their main view, while others may support opening locations
* directly into their main view, while others may support opening locations
* in a new notebook tab or a new window.
*
* This function is used to tell the places @sidebar about the ways in which the
* application can open new locations, so that the sidebar can display (or not)
* the "Open in new tab" and "Open in new window" menu items as appropriate.
* the Open in new tab and Open in new window menu items as appropriate.
*
* When the #GtkPlacesSidebar::open-location signal is emitted, its flags
* argument will be set to one of the @flags that was passed in
* gtk_places_sidebar_set_open_flags().
*
* Passing 0 for @flags will cause #GTK_PLACES_OPEN_NORMAL to always be sent
* to callbacks for the "open-location" signal.
* to callbacks for the open-location signal.
*
* Since: 3.10
*/
@ -4645,7 +4645,7 @@ gtk_places_sidebar_set_show_connect_to_server (GtkPlacesSidebar *sidebar,
*
* Returns the value previously set with gtk_places_sidebar_set_show_connect_to_server()
*
* Return value: %TRUE if the sidebar will display a "Connect to Server" item.
* Return value: %TRUE if the sidebar will display a Connect to Server item.
*
* Since: 3.10
*/
@ -4724,8 +4724,8 @@ find_shortcut_link (GtkPlacesSidebar *sidebar,
*
* Applications may want to present some folders in the places sidebar if
* they could be immediately useful to users. For example, a drawing
* program could add a "/usr/share/clipart" location when the sidebar is
* being used in an "Insert Clipart" dialog box.
* program could add a /usr/share/clipart location when the sidebar is
* being used in an Insert Clipart dialog box.
*
* This function adds the specified @location to a special place for immutable
* shortcuts. The shortcuts are application-specific; they are not shared
@ -4811,11 +4811,11 @@ gtk_places_sidebar_list_shortcuts (GtkPlacesSidebar *sidebar)
*
* This function queries the bookmarks added by the user to the places sidebar,
* and returns one of them. This function is used by #GtkFileChooser to implement
* the "Alt-1", "Alt-2", etc. shortcuts, which activate the cooresponding bookmark.
* the Alt-1, Alt-2, etc. shortcuts, which activate the cooresponding bookmark.
*
* Return value: (transfer full): The bookmark specified by the index @n, or
* #NULL if no such index exist. Note that the indices start at 0, even though
* the file chooser starts them with the keyboard shortcut "Alt-1".
* the file chooser starts them with the keyboard shortcut Alt-1.
*
* Since: 3.10
*/

View File

@ -620,7 +620,7 @@ gtk_plug_construct_for_display (GtkPlug *plug,
* @socket_id: the window ID of the socket, or 0.
*
* Creates a new plug widget inside the #GtkSocket identified
* by @socket_id. If @socket_id is 0, the plug is left "unplugged" and
* by @socket_id. If @socket_id is 0, the plug is left unplugged and
* can later be plugged into a #GtkSocket by gtk_socket_add_id().
*
* Return value: the new #GtkPlug widget.

View File

@ -41,7 +41,7 @@
/* This defines the max file length that the file chooser
* button should display. The total length will be
* FILENAME_LENGTH_MAX+3 because the truncated name is prefixed
* with "...".
* with ....
*/
#define FILENAME_LENGTH_MAX 27

View File

@ -540,7 +540,7 @@ gtk_print_job_get_surface (GtkPrintJob *job,
*
* If track_status is %TRUE, the print job will try to continue report
* on the status of the print job in the printer queues and printer. This
* can allow your application to show things like "out of paper" issues,
* can allow your application to show things like out of paper issues,
* and when the print job actually reaches the printer.
*
* This function is often implemented using some form of polling, so it should

View File

@ -1198,7 +1198,7 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class)
*
* If %TRUE, the print operation will try to continue report on
* the status of the print job in the printer queues and printer.
* This can allow your application to show things like "out of paper"
* This can allow your application to show things like out of paper
* issues, and when the print job actually reaches the printer.
* However, this is often implemented using polling, and should
* not be enabled unless needed.
@ -1280,10 +1280,10 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class)
* Currently, PDF is the only supported format.
*
* The intended use of this property is for implementing
* "Export to PDF" actions.
* Export to PDF actions.
*
* "Print to PDF" support is independent of this and is done
* by letting the user pick the "Print to PDF" item from the
* Print to PDF support is independent of this and is done
* by letting the user pick the Print to PDF item from the
* list of printers in the print dialog.
*
* Since: 2.10
@ -1737,7 +1737,7 @@ gtk_print_operation_set_unit (GtkPrintOperation *op,
*
* If track_status is %TRUE, the print operation will try to continue report
* on the status of the print job in the printer queues and printer. This
* can allow your application to show things like "out of paper" issues,
* can allow your application to show things like out of paper issues,
* and when the print job actually reaches the printer.
*
* This function is often implemented using some form of polling, so it should
@ -1970,11 +1970,11 @@ gtk_print_operation_set_custom_tab_label (GtkPrintOperation *op,
*
* Sets up the #GtkPrintOperation to generate a file instead
* of showing the print dialog. The indended use of this function
* is for implementing "Export to PDF" actions. Currently, PDF
* is for implementing Export to PDF actions. Currently, PDF
* is the only supported format.
*
* "Print to PDF" support is independent of this and is done
* by letting the user pick the "Print to PDF" item from the list
* Print to PDF support is independent of this and is done
* by letting the user pick the Print to PDF item from the list
* of printers in the print dialog.
*
* Since: 2.10
@ -2365,7 +2365,7 @@ update_progress (PrintPagesData *data)
* gtk_print_operation_draw_page_finish() from application. It can
* be used for drawing page in another thread.
*
* This function must be called in the callback of "draw-page" signal.
* This function must be called in the callback of draw-page signal.
*
* Since: 2.16
**/

View File

@ -132,7 +132,7 @@ struct _GtkPrintOperation
* doing everything required for printing.
* @begin_print: Signal emitted after the user has finished changing
* print settings in the dialog, before the actual rendering starts.
* @paginate: Signal emitted after the "begin-print" signal, but
* @paginate: Signal emitted after the begin-print signal, but
* before the actual rendering starts.
* @request_page_setup: Emitted once for every page that is printed,
* to give the application a chance to modify the page setup.
@ -141,8 +141,8 @@ struct _GtkPrintOperation
* @status_changed: Emitted at between the various phases of the print
* operation.
* @create_custom_widget: Signal emitted when displaying the print dialog.
* @custom_widget_apply: Signal emitted right before "begin-print" if
* you added a custom widget in the "create-custom-widget" handler.
* @custom_widget_apply: Signal emitted right before begin-print if
* you added a custom widget in the create-custom-widget handler.
* @preview: Signal emitted when a preview is requested from the
* native dialog.
* @update_custom_widget: Emitted after change of selected printer.

View File

@ -241,7 +241,7 @@ gtk_print_settings_has_key (GtkPrintSettings *settings,
* Returns the boolean represented by the value
* that is associated with @key.
*
* The string "true" represents %TRUE, any other
* The string true represents %TRUE, any other
* string %FALSE.
*
* Return value: %TRUE, if @key maps to a true value.
@ -271,8 +271,8 @@ gtk_print_settings_get_bool (GtkPrintSettings *settings,
* that is associated with @key, or @default_val
* if the value does not represent a boolean.
*
* The string "true" represents %TRUE, the string
* "false" represents %FALSE.
* The string true represents %TRUE, the string
* false represents %FALSE.
*
* Return value: the boolean value associated with @key
*
@ -1765,7 +1765,7 @@ gtk_print_settings_new_from_file (const gchar *file_name,
* @settings: a #GtkPrintSettings
* @key_file: the #GKeyFile to retrieve the settings from
* @group_name: (allow-none): the name of the group to use, or %NULL to use the default
* "Print Settings"
* Print Settings
* @error: (allow-none): return location for errors, or %NULL
*
* Reads the print settings from the group @group_name in @key_file. If the
@ -1826,7 +1826,7 @@ gtk_print_settings_load_key_file (GtkPrintSettings *settings,
* gtk_print_settings_new_from_key_file:
* @key_file: the #GKeyFile to retrieve the settings from
* @group_name: (allow-none): the name of the group to use, or %NULL to use
* the default "Print Settings"
* the default Print Settings
* @error: (allow-none): return location for errors, or %NULL
*
* Reads the print settings from the group @group_name in @key_file. Returns a
@ -1920,7 +1920,7 @@ add_value_to_key_file (const gchar *key,
* @settings: a #GtkPrintSettings
* @key_file: the #GKeyFile to save the print settings to
* @group_name: the group to add the settings to in @key_file, or
* %NULL to use the default "Print Settings"
* %NULL to use the default Print Settings
*
* This function adds the print settings from @settings to @key_file.
*

View File

@ -169,7 +169,7 @@ void gtk_print_settings_set_int (GtkPrintSettings
/**
* GTK_PRINT_SETTINGS_OUTPUT_DIR:
*
* The key used by the "Print to file" printer to store the
* The key used by the Print to file printer to store the
* directory to which the output should be written.
*
* Since: 3.6
@ -179,7 +179,7 @@ void gtk_print_settings_set_int (GtkPrintSettings
/**
* GTK_PRINT_SETTINGS_OUTPUT_BASENAME:
*
* The key used by the "Print to file" printer to store the file
* The key used by the Print to file printer to store the file
* name of the output without the path to the directory and the
* file extension.
*
@ -190,17 +190,17 @@ void gtk_print_settings_set_int (GtkPrintSettings
/**
* GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT:
*
* The key used by the "Print to file" printer to store the format
* of the output. The supported values are "PS" and "PDF".
* The key used by the Print to file printer to store the format
* of the output. The supported values are PS and PDF.
*/
#define GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT "output-file-format"
/**
* GTK_PRINT_SETTINGS_OUTPUT_URI:
*
* The key used by the "Print to file" printer to store the URI
* The key used by the Print to file printer to store the URI
* to which the output should be written. GTK+ itself supports
* only "file://" URIs.
* only file://” URIs.
*/
#define GTK_PRINT_SETTINGS_OUTPUT_URI "output-uri"

View File

@ -76,16 +76,16 @@
* gtk_print_job_new().
*
* #GtkPrintUnixDialog uses the following response values:
* - %GTK_RESPONSE_OK: for the "Print" button
* - %GTK_RESPONSE_APPLY: for the "Preview" button
* - %GTK_RESPONSE_CANCEL: for the "Cancel" button
* - %GTK_RESPONSE_OK: for the Print button
* - %GTK_RESPONSE_APPLY: for the Preview button
* - %GTK_RESPONSE_CANCEL: for the Cancel button
*
* Printing support was added in GTK+ 2.10.
*
* # GtkPrintUnixDialog as GtkBuildable
*
* The GtkPrintUnixDialog implementation of the GtkBuildable interface exposes its
* @notebook internal children with the name "notebook".
* @notebook internal children with the name notebook.
*
* An example of a #GtkPrintUnixDialog UI definition fragment:
* |[

View File

@ -1055,7 +1055,7 @@ gtk_progress_bar_set_activity_mode (GtkProgressBar *pbar,
* @pbar: a #GtkProgressBar
* @fraction: fraction of the task that's been completed
*
* Causes the progress bar to "fill in" the given fraction
* Causes the progress bar to fill in the given fraction
* of the bar. The fraction should be between 0.0 and 1.0,
* inclusive.
*/
@ -1090,7 +1090,7 @@ gtk_progress_bar_update_pulse (GtkProgressBar *pbar)
* @pbar: a #GtkProgressBar
*
* Indicates that some progress has been made, but you don't know how much.
* Causes the progress bar to enter "activity mode," where a block
* Causes the progress bar to enter activity mode, where a block
* bounces back and forth. Each call to gtk_progress_bar_pulse()
* causes the block to move by a little bit (the amount of movement
* per pulse is determined by gtk_progress_bar_set_pulse_step()).

View File

@ -54,8 +54,8 @@
*
* Apart from signals for monitoring the parameters of the adjustment,
* #GtkRange provides properties and methods for influencing the sensitivity
* of the "steppers". It also provides properties and methods for setting a
* "fill level" on range widgets. See gtk_range_set_fill_level().
* of the steppers. It also provides properties and methods for setting a
* fill level on range widgets. See gtk_range_set_fill_level().
*/
@ -758,7 +758,7 @@ gtk_range_init (GtkRange *range)
* gtk_range_get_adjustment:
* @range: a #GtkRange
*
* Get the #GtkAdjustment which is the "model" object for #GtkRange.
* Get the #GtkAdjustment which is the model object for #GtkRange.
* See gtk_range_set_adjustment() for details.
* The return value does not have a reference added, so should not
* be unreferenced.
@ -785,7 +785,7 @@ gtk_range_get_adjustment (GtkRange *range)
* @range: a #GtkRange
* @adjustment: a #GtkAdjustment
*
* Sets the adjustment to be used as the "model" object for this range
* Sets the adjustment to be used as the model object for this range
* widget. The adjustment indicates the current range value, the
* minimum and maximum range values, the step/page increments used
* for keybindings and scrolling, and the page size. The page size
@ -1426,7 +1426,7 @@ gtk_range_get_restrict_to_fill_level (GtkRange *range)
*
* Set the new position of the fill level indicator.
*
* The "fill level" is probably best described by its most prominent
* The fill level is probably best described by its most prominent
* use case, which is an indicator for the amount of pre-buffering in
* a streaming media player. In that use case, the value of the range
* would indicate the current play position, and the fill level would

View File

@ -824,8 +824,8 @@ gtk_recent_chooser_unselect_all (GtkRecentChooser *chooser)
*
* Gets the list of recently used resources in form of #GtkRecentInfo objects.
*
* The return value of this function is affected by the "sort-type" and
* "limit" properties of @chooser.
* The return value of this function is affected by the sort-type and
* limit properties of @chooser.
*
* Return value: (element-type GtkRecentInfo) (transfer full): A newly allocated
* list of #GtkRecentInfo objects. You should
@ -850,7 +850,7 @@ gtk_recent_chooser_get_items (GtkRecentChooser *chooser)
*
* Gets the URI of the recently used resources.
*
* The return value of this function is affected by the "sort-type" and "limit"
* The return value of this function is affected by the sort-type and limit
* properties of @chooser.
*
* Since the returned array is %NULL terminated, @length may be %NULL.

Some files were not shown because too many files have changed in this diff Show More