From 2a45418b673d10f60e9334ebcfa493f125d26e02 Mon Sep 17 00:00:00 2001 From: William Jon McCann Date: Wed, 5 Feb 2014 13:07:34 -0500 Subject: [PATCH] docs: use proper quotes --- gtk/a11y/gtkmenuitemaccessible.c | 2 +- gtk/a11y/gtkwidgetaccessible.c | 2 +- gtk/deprecated/gtkaction.c | 6 +- gtk/deprecated/gtkactiongroup.c | 6 +- gtk/deprecated/gtkactivatable.c | 2 +- gtk/deprecated/gtkcolorseldialog.c | 4 +- gtk/deprecated/gtkfontsel.c | 16 +-- gtk/deprecated/gtkhandlebox.c | 4 +- gtk/deprecated/gtkiconfactory.c | 10 +- gtk/deprecated/gtkrc.c | 10 +- gtk/deprecated/gtkrc.h | 4 +- gtk/deprecated/gtkstock.c | 2 +- gtk/deprecated/gtkstock.h | 210 ++++++++++++++--------------- gtk/deprecated/gtkstyle.c | 14 +- gtk/deprecated/gtktoggleaction.c | 4 +- gtk/deprecated/gtkuimanager.c | 16 +-- gtk/gtkaboutdialog.c | 4 +- gtk/gtkaccelgroup.c | 14 +- gtk/gtkaccellabel.c | 8 +- gtk/gtkaccelmap.c | 14 +- gtk/gtkactionable.c | 6 +- gtk/gtkactionmuxer.c | 16 +-- gtk/gtkactionobserver.c | 2 +- gtk/gtkapplication.c | 12 +- gtk/gtkapplicationwindow.c | 4 +- gtk/gtkaspectframe.c | 2 +- gtk/gtkassistant.c | 2 +- gtk/gtkassistant.h | 6 +- gtk/gtkbindings.c | 18 +-- gtk/gtkbuildable.c | 2 +- gtk/gtkbuildable.h | 4 +- gtk/gtkbuilder.c | 40 +++--- gtk/gtkbutton.c | 2 +- gtk/gtkcellarea.c | 6 +- gtk/gtkcellarea.h | 2 +- gtk/gtkcelllayout.c | 2 +- gtk/gtkcellrenderer.c | 4 +- gtk/gtkcellrenderercombo.c | 2 +- gtk/gtkcellrendererpixbuf.c | 2 +- gtk/gtkcellrenderertext.c | 6 +- gtk/gtkcellrenderertoggle.c | 2 +- gtk/gtkcellview.c | 2 +- gtk/gtkcheckmenuitem.c | 6 +- gtk/gtkclipboard.c | 14 +- gtk/gtkcomboboxtext.c | 6 +- gtk/gtkcontainer.c | 12 +- gtk/gtkcsslookup.c | 12 +- gtk/gtkcssprovider.c | 2 +- gtk/gtkdialog.c | 8 +- gtk/gtkdnd-quartz.c | 2 +- gtk/gtkdnd.c | 8 +- gtk/gtkdrawingarea.c | 4 +- gtk/gtkentry.c | 14 +- gtk/gtkentrycompletion.c | 4 +- gtk/gtkenums.h | 4 +- gtk/gtkexpander.c | 4 +- gtk/gtkfilechooser.c | 20 +-- gtk/gtkfilechooserbutton.c | 2 +- gtk/gtkfilechooserdialog.c | 10 +- gtk/gtkfilechooserwidget.c | 8 +- gtk/gtkfilesystem.c | 2 +- gtk/gtkfilesystemmodel.c | 18 +-- gtk/gtkfontchooser.c | 10 +- gtk/gtkfontchooserdialog.c | 4 +- gtk/gtkframe.c | 2 +- gtk/gtkheaderbar.c | 4 +- gtk/gtkicontheme.c | 12 +- gtk/gtkimage.c | 12 +- gtk/gtkimcontext.c | 2 +- gtk/gtkimmodule.c | 2 +- gtk/gtkinfobar.c | 10 +- gtk/gtkinvisible.c | 2 +- gtk/gtklabel.c | 6 +- gtk/gtklayout.c | 2 +- gtk/gtkliststore.c | 4 +- gtk/gtkmain.c | 2 +- gtk/gtkmenu.c | 4 +- gtk/gtkmenu.h | 2 +- gtk/gtkmenubutton.c | 2 +- gtk/gtkmenuitem.c | 6 +- gtk/gtkmenushell.c | 16 +-- gtk/gtkmenutoolbutton.c | 2 +- gtk/gtkmenutracker.c | 6 +- gtk/gtkmessagedialog.c | 10 +- gtk/gtknotebook.c | 22 +-- gtk/gtkoverlay.c | 4 +- gtk/gtkpagesetup.c | 8 +- gtk/gtkpathbar.c | 4 +- gtk/gtkplacessidebar.c | 16 +-- gtk/gtkplug.c | 2 +- gtk/gtkprinteroptionwidget.c | 2 +- gtk/gtkprintjob.c | 2 +- gtk/gtkprintoperation.c | 18 +-- gtk/gtkprintoperation.h | 6 +- gtk/gtkprintsettings.c | 12 +- gtk/gtkprintsettings.h | 12 +- gtk/gtkprintunixdialog.c | 8 +- gtk/gtkprogressbar.c | 4 +- gtk/gtkrange.c | 10 +- gtk/gtkrecentchooser.c | 6 +- gtk/gtkrecentchooser.h | 2 +- gtk/gtkrecentmanager.c | 6 +- gtk/gtkrecentmanager.h | 2 +- gtk/gtkscale.c | 4 +- gtk/gtkscrolledwindow.c | 6 +- gtk/gtksearchbar.c | 2 +- gtk/gtksearchentry.c | 6 +- gtk/gtkselection.c | 18 +-- gtk/gtkseparatortoolitem.c | 4 +- gtk/gtksettings.h | 4 +- gtk/gtkstatusicon.c | 6 +- gtk/gtkstylecontext.c | 6 +- gtk/gtkswitch.c | 4 +- gtk/gtktestutils.c | 10 +- gtk/gtktextbuffer.c | 44 +++--- gtk/gtktextbuffer.h | 2 +- gtk/gtktextbufferrichtext.c | 4 +- gtk/gtktextchild.h | 2 +- gtk/gtktextiter.c | 20 +-- gtk/gtktextiter.h | 4 +- gtk/gtktextmark.c | 2 +- gtk/gtktexttag.c | 8 +- gtk/gtktexttagtable.c | 2 +- gtk/gtktextview.c | 14 +- gtk/gtktogglebutton.c | 4 +- gtk/gtktoolbar.c | 2 +- gtk/gtktoolbutton.c | 32 ++--- gtk/gtktoolitem.c | 4 +- gtk/gtktrayicon-x11.c | 2 +- gtk/gtktreemodel.c | 8 +- gtk/gtktreemodelfilter.c | 26 ++-- gtk/gtktreemodelsort.c | 10 +- gtk/gtktreesortable.h | 2 +- gtk/gtktreestore.c | 6 +- gtk/gtktreeview.c | 16 +-- gtk/gtktreeviewcolumn.c | 10 +- gtk/gtktreeviewcolumn.h | 4 +- gtk/gtkwidget.c | 54 ++++---- gtk/gtkwidget.h | 4 +- gtk/gtkwin32embed.h | 4 +- gtk/gtkwindow.c | 52 +++---- 141 files changed, 668 insertions(+), 668 deletions(-) diff --git a/gtk/a11y/gtkmenuitemaccessible.c b/gtk/a11y/gtkmenuitemaccessible.c index b29e5cc1ed..46190fd48b 100644 --- a/gtk/a11y/gtkmenuitemaccessible.c +++ b/gtk/a11y/gtkmenuitemaccessible.c @@ -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, diff --git a/gtk/a11y/gtkwidgetaccessible.c b/gtk/a11y/gtkwidgetaccessible.c index 3572e42a17..8c4d0c58dd 100644 --- a/gtk/a11y/gtkwidgetaccessible.c +++ b/gtk/a11y/gtkwidgetaccessible.c @@ -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. */ diff --git a/gtk/deprecated/gtkaction.c b/gtk/deprecated/gtkaction.c index 5fe0946675..d87b8acc41 100644 --- a/gtk/deprecated/gtkaction.c +++ b/gtk/deprecated/gtkaction.c @@ -68,7 +68,7 @@ * Apart from regular actions, there are toggle * actions, which can be toggled between two states and radio actions, 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. * diff --git a/gtk/deprecated/gtkactiongroup.c b/gtk/deprecated/gtkactiongroup.c index 0664ea66ec..a2bde7bfb6 100644 --- a/gtk/deprecated/gtkactiongroup.c +++ b/gtk/deprecated/gtkactiongroup.c @@ -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 * `<Actions>/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 * `<Actions>/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 * `<Actions>/group-name/action-name`. * diff --git a/gtk/deprecated/gtkactivatable.c b/gtk/deprecated/gtkactivatable.c index 3a0b8cbd39..f9916019e5 100644 --- a/gtk/deprecated/gtkactivatable.c +++ b/gtk/deprecated/gtkactivatable.c @@ -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, diff --git a/gtk/deprecated/gtkcolorseldialog.c b/gtk/deprecated/gtkcolorseldialog.c index b5cd48d6cb..18c651a125 100644 --- a/gtk/deprecated/gtkcolorseldialog.c +++ b/gtk/deprecated/gtkcolorseldialog.c @@ -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”. */ diff --git a/gtk/deprecated/gtkfontsel.c b/gtk/deprecated/gtkfontsel.c index 0ac6561836..1553bd73ce 100644 --- a/gtk/deprecated/gtkfontsel.c +++ b/gtk/deprecated/gtkfontsel.c @@ -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. * diff --git a/gtk/deprecated/gtkhandlebox.c b/gtk/deprecated/gtkhandlebox.c index cb7d3c2674..30b20486ed 100644 --- a/gtk/deprecated/gtkhandlebox.c +++ b/gtk/deprecated/gtkhandlebox.c @@ -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 diff --git a/gtk/deprecated/gtkiconfactory.c b/gtk/deprecated/gtkiconfactory.c index dc0f4a674d..b77c649ecd 100644 --- a/gtk/deprecated/gtkiconfactory.c +++ b/gtk/deprecated/gtkiconfactory.c @@ -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 diff --git a/gtk/deprecated/gtkrc.c b/gtk/deprecated/gtkrc.c index 5cf123f654..60214f0cb4 100644 --- a/gtk/deprecated/gtkrc.c +++ b/gtk/deprecated/gtkrc.c @@ -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(). * diff --git a/gtk/deprecated/gtkrc.h b/gtk/deprecated/gtkrc.h index 5c171285a5..011cbc8ca3 100644 --- a/gtk/deprecated/gtkrc.h +++ b/gtk/deprecated/gtkrc.h @@ -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; diff --git a/gtk/deprecated/gtkstock.c b/gtk/deprecated/gtkstock.c index 65c609c59d..78befcb1b0 100644 --- a/gtk/deprecated/gtkstock.c +++ b/gtk/deprecated/gtkstock.c @@ -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 diff --git a/gtk/deprecated/gtkstock.h b/gtk/deprecated/gtkstock.h index 3f75f574b1..1ef97e7380 100644 --- a/gtk/deprecated/gtkstock.h +++ b/gtk/deprecated/gtkstock.h @@ -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 "list-add" or the label "_Add". @@ -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 "_Apply". @@ -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 "format-text-bold". @@ -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 "_Cancel". @@ -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 "media-optical". @@ -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 "edit-clear". @@ -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 "window-close" or the label "_Close". @@ -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 "_Copy". @@ -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 "Cu_t". @@ -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 "_Delete". @@ -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 "dialog-information". @@ -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 "dialog-warning". @@ -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 "dialog-error". @@ -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 "dialog-question". @@ -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 "system-run". @@ -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 "edit-find". @@ -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 "edit-find-replace". @@ -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 "go-bottom". @@ -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 "go-top". @@ -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 "go-down". @@ -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 "go-up". @@ -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 "help-browser". @@ -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 "go-home". @@ -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 "format-text-italic". @@ -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 "format-justify-center". @@ -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 "format-justify-fill". @@ -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 "format-justify-left". @@ -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 "format-justify-right". @@ -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 "image-missing". @@ -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 "document-new" or the label "_New". @@ -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 "_OK". @@ -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 "document-open" or the label "_Open". @@ -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 "_Paste". @@ -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 "preferences-system" or the label "_Preferences". @@ -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 "document-print" or the label "_Print". @@ -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 "Pre_view". @@ -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 "document-properties" or the label "_Properties". @@ -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 "application-exit" or the label "_Quit". @@ -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 "view-refresh" or the label "_Refresh". @@ -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 "list-remove" or the label "_Remove". @@ -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 "document-save" or the label "_Save". @@ -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 "document-save-as" or the label "Save _As". @@ -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 "view-sort-ascending". @@ -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 "view-sort-descending". @@ -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 "tools-check-spelling". @@ -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 "process-stop" or the label "_Stop". @@ -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 "format-text-strikethrough" or the label "_Strikethrough". @@ -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 "format-text-underline" or the label "_Underline". @@ -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 "zoom-original" or the label "_Normal Size". @@ -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 "zoom-fit-best" or the label "Best _Fit". @@ -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 "zoom-in" or the label "Zoom _In". @@ -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 "zoom-out" or the label "Zoom _Out". diff --git a/gtk/deprecated/gtkstyle.c b/gtk/deprecated/gtkstyle.c index 802d4cef11..0bfd9f49e3 100644 --- a/gtk/deprecated/gtkstyle.c +++ b/gtk/deprecated/gtkstyle.c @@ -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 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 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 diff --git a/gtk/deprecated/gtktoggleaction.c b/gtk/deprecated/gtktoggleaction.c index a39e4d57c0..82ebc91ba1 100644 --- a/gtk/deprecated/gtktoggleaction.c +++ b/gtk/deprecated/gtktoggleaction.c @@ -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 * diff --git a/gtk/deprecated/gtkuimanager.c b/gtk/deprecated/gtkuimanager.c index 7400213880..109aab5745 100644 --- a/gtk/deprecated/gtkuimanager.c +++ b/gtk/deprecated/gtkuimanager.c @@ -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 diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c index 423ffbe871..3e17c339f8 100644 --- a/gtk/gtkaboutdialog.c +++ b/gtk/gtkaboutdialog.c @@ -1656,9 +1656,9 @@ gtk_about_dialog_get_translator_credits (GtkAboutDialog *about) * |[ * 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 diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c index 0745349a92..8b2c696a03 100644 --- a/gtk/gtkaccelgroup.c +++ b/gtk/gtkaccelgroup.c @@ -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 "<Control>a" or "<Shift><Alt>F1" - * or "<Release>z" (the last one is for key release). + * format looks like “<Control>a” or “<Shift><Alt>F1” + * or “<Release>z” (the last one is for key release). * * The parser is fairly liberal and allows lower or upper case, - * and also abbreviations such as "<Ctl>" and "<Ctrl>". + * and also abbreviations such as “<Ctl>” and “<Ctrl>”. * 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 "<Ctrl>minus" instead of "<Ctrl>-". + * would use “<Ctrl>minus” instead of “<Ctrl>-”. * * 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 "<Control>q". + * this function returns “<Control>q”. * * If you need to display accelerators in the user interface, * see gtk_accelerator_get_label(). diff --git a/gtk/gtkaccellabel.c b/gtk/gtkaccellabel.c index 1b4cb77c87..71a53a2638 100644 --- a/gtk/gtkaccellabel.c +++ b/gtk/gtkaccellabel.c @@ -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. diff --git a/gtk/gtkaccelmap.c b/gtk/gtkaccelmap.c index d7b77b8783..2cc38cb5c1 100644 --- a/gtk/gtkaccelmap.c +++ b/gtk/gtkaccelmap.c @@ -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 - * "<WINDOWTYPE>/Category1/Category2/.../Action", where WINDOWTYPE + * “<WINDOWTYPE>/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: "<Gimp-Toolbox>/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: “<Gimp-Toolbox>/File/Dialogs/Tool Options...”. * * All accelerators are stored inside one global #GtkAccelMap that can * be obtained using gtk_accel_map_get(). See Installing a key binding - * 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 - * "<Control>Right" and "<Control>Left" key presses to + * “<Control>Right” and “<Control>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 - * "<Control>Right" or "<Control>Left" are pressed, no - * binding for these keys is found in binding set "MoveCursor3". + * from the bindings set “MoveCursor3” to be deleted, so when + * “<Control>Right” or “<Control>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 "<Control>Right" - * and "<Control>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 “<Control>Right” + * and “<Control>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. diff --git a/gtk/gtkbuildable.c b/gtk/gtkbuildable.c index 937a99b8bc..38ee81addd 100644 --- a/gtk/gtkbuildable.c +++ b/gtk/gtkbuildable.c @@ -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 diff --git a/gtk/gtkbuildable.h b/gtk/gtkbuildable.h index 3e15e05a06..46ec63f0cc 100644 --- a/gtk/gtkbuildable.h +++ b/gtk/gtkbuildable.h @@ -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 <ui> 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. diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c index 6eaa2102e6..e2c183b1fa 100644 --- a/gtk/gtkbuilder.c +++ b/gtk/gtkbuilder.c @@ -72,7 +72,7 @@ * [RELAX NG Compact Syntax](https://git.gnome.org/browse/gtk+/tree/gtk/gtkbuilder.rnc) * * The toplevel element is <interface>. 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 <object> elements, which can contain @@ -82,33 +82,33 @@ * also e.g. actions in an action group, or columns in a tree model). * A <child> element contains an <object> element which * describes the child object. The target toolkit version(s) are - * described by <requires> elements, the "lib" attribute specifies + * described by <requires> 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 "<major>.<minor>". The builder will error + * s “gtk+”) and the “version” attribute specifies the target version + * in the form “<major>.<minor>”. The builder will error * out if the version requirements are not met. * * Typically, the specific kind of object represented by an <object> - * 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 - * <property> element: the "name" attribute specifies the name + * <property> 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 <signal> 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 <child> element to a true value. Note that * GtkBuilder still requires an <object> 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 <child>. - * The possible values for the "type" attribute are described in the + * a UI definition by specifying the “type” attribute on a <child>. + * The possible values for the “type” attribute are described in the * sections describing the widget-specific portions of UI definitions. * * # A GtkBuilder UI Definition diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c index 7486a73935..a9999852f2 100644 --- a/gtk/gtkbutton.c +++ b/gtk/gtkbutton.c @@ -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. * diff --git a/gtk/gtkcellarea.c b/gtk/gtkcellarea.c index 2cdca2c250..e7f0f7ff9e 100644 --- a/gtk/gtkcellarea.c +++ b/gtk/gtkcellarea.c @@ -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 @@ * child properties * 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 diff --git a/gtk/gtkcellarea.h b/gtk/gtkcellarea.h index 9be8f51be7..ebb20a9c05 100644 --- a/gtk/gtkcellarea.h +++ b/gtk/gtkcellarea.h @@ -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 diff --git a/gtk/gtkcelllayout.c b/gtk/gtkcelllayout.c index 9a43649ef3..6b10b37d1e 100644 --- a/gtk/gtkcelllayout.c +++ b/gtk/gtkcelllayout.c @@ -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 */ diff --git a/gtk/gtkcellrenderer.c b/gtk/gtkcellrenderer.c index f7d623377f..e72672228a 100644 --- a/gtk/gtkcellrenderer.c +++ b/gtk/gtkcellrenderer.c @@ -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. */ diff --git a/gtk/gtkcellrenderercombo.c b/gtk/gtkcellrenderercombo.c index e0bc5a6638..89ed2cf488 100644 --- a/gtk/gtkcellrenderercombo.c +++ b/gtk/gtkcellrenderercombo.c @@ -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. * diff --git a/gtk/gtkcellrendererpixbuf.c b/gtk/gtkcellrendererpixbuf.c index 1af8c423ea..d4c1b025b8 100644 --- a/gtk/gtkcellrendererpixbuf.c +++ b/gtk/gtkcellrendererpixbuf.c @@ -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. * diff --git a/gtk/gtkcellrenderertext.c b/gtk/gtkcellrenderertext.c index f218d66782..34c594340c 100644 --- a/gtk/gtkcellrenderertext.c +++ b/gtk/gtkcellrenderertext.c @@ -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 diff --git a/gtk/gtkcellrenderertoggle.c b/gtk/gtkcellrenderertoggle.c index b1d4d7b65c..57761bc254 100644 --- a/gtk/gtkcellrenderertoggle.c +++ b/gtk/gtkcellrenderertoggle.c @@ -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. * diff --git a/gtk/gtkcellview.c b/gtk/gtkcellview.c index ce36676c7d..705b9ed9f5 100644 --- a/gtk/gtkcellview.c +++ b/gtk/gtkcellview.c @@ -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. diff --git a/gtk/gtkcheckmenuitem.c b/gtk/gtkcheckmenuitem.c index a0837f3587..059b464d71 100644 --- a/gtk/gtkcheckmenuitem.c +++ b/gtk/gtkcheckmenuitem.c @@ -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. diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c index b3b5958d22..99a071386a 100644 --- a/gtk/gtkclipboard.c +++ b/gtk/gtkclipboard.c @@ -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 diff --git a/gtk/gtkcomboboxtext.c b/gtk/gtkcomboboxtext.c index bff81952d6..1e0c141094 100644 --- a/gtk/gtkcomboboxtext.c +++ b/gtk/gtkcomboboxtext.c @@ -57,9 +57,9 @@ * The GtkComboBoxText implementation of the GtkBuildable interface * supports adding items directly using the <items> element * and specifying <item> elements for each item. Each <item> - * 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: * |[ diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c index f719544b5c..d5e7382025 100644 --- a/gtk/gtkcontainer.c +++ b/gtk/gtkcontainer.c @@ -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 diff --git a/gtk/gtkcsslookup.c b/gtk/gtkcsslookup.c index a32b959ebe..8166ee9de9 100644 --- a/gtk/gtkcsslookup.c +++ b/gtk/gtkcsslookup.c @@ -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 diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c index e4db4d3381..eeb3e07ed7 100644 --- a/gtk/gtkcssprovider.c +++ b/gtk/gtkcssprovider.c @@ -540,7 +540,7 @@ * border-image-slice: @top @right @bottom @left * 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. * * border-image-width: @top @right @bottom @left diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c index adee554b7d..0093c6f4d4 100644 --- a/gtk/gtkdialog.c +++ b/gtk/gtkdialog.c @@ -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 <action-widgets> element, which - * can contain multiple <action-widget> elements. The "response" + * can contain multiple <action-widget> 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 diff --git a/gtk/gtkdnd-quartz.c b/gtk/gtkdnd-quartz.c index 11a4855f1a..8420612e30 100644 --- a/gtk/gtkdnd-quartz.c +++ b/gtk/gtkdnd-quartz.c @@ -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 diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c index 008ce0aa77..7fdb664964 100644 --- a/gtk/gtkdnd.c +++ b/gtk/gtkdnd.c @@ -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: diff --git a/gtk/gtkdrawingarea.c b/gtk/gtkdrawingarea.c index 5d341516db..62c6c74612 100644 --- a/gtk/gtkdrawingarea.c +++ b/gtk/gtkdrawingarea.c @@ -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 diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c index 8c050aa1f7..4ca17c9a79 100644 --- a/gtk/gtkentry.c +++ b/gtk/gtkentry.c @@ -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 diff --git a/gtk/gtkentrycompletion.c b/gtk/gtkentrycompletion.c index 3ac13ff396..9e5e762dfa 100644 --- a/gtk/gtkentrycompletion.c +++ b/gtk/gtkentrycompletion.c @@ -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. * diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h index 3727145bb4..0b88f71e32 100644 --- a/gtk/gtkenums.h +++ b/gtk/gtkenums.h @@ -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 diff --git a/gtk/gtkexpander.c b/gtk/gtkexpander.c index 7df1dda8a1..6fa157f84c 100644 --- a/gtk/gtkexpander.c +++ b/gtk/gtkexpander.c @@ -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 <child> element. + * “label” as the “type” attribute of a <child> element. * A normal content child can be specified without specifying * a <child> 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 */ diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c index 40787fbe78..a0d4e1d9bb 100644 --- a/gtk/gtkfilechooser.c +++ b/gtk/gtkfilechooser.c @@ -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. diff --git a/gtk/gtkfilechooserbutton.c b/gtk/gtkfilechooserbutton.c index dc448968b7..b61937379b 100644 --- a/gtk/gtkfilechooserbutton.c +++ b/gtk/gtkfilechooserbutton.c @@ -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. diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c index a3efe171c5..790a423b9c 100644 --- a/gtk/gtkfilechooserdialog.c +++ b/gtk/gtkfilechooserdialog.c @@ -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 diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c index 2bb25aa07d..fdef11552a 100644 --- a/gtk/gtkfilechooserwidget.c +++ b/gtk/gtkfilechooserwidget.c @@ -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) diff --git a/gtk/gtkfilesystem.c b/gtk/gtkfilesystem.c index b3509fefb5..f6b4e025dd 100644 --- a/gtk/gtkfilesystem.c +++ b/gtk/gtkfilesystem.c @@ -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"); diff --git a/gtk/gtkfilesystemmodel.c b/gtk/gtkfilesystemmodel.c index 3c415981fe..c103619464 100644 --- a/gtk/gtkfilesystemmodel.c +++ b/gtk/gtkfilesystemmodel.c @@ -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. **/ diff --git a/gtk/gtkfontchooser.c b/gtk/gtkfontchooser.c index 21a5deb234..a2efb33929 100644 --- a/gtk/gtkfontchooser.c +++ b/gtk/gtkfontchooser.c @@ -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. diff --git a/gtk/gtkfontchooserdialog.c b/gtk/gtkfontchooserdialog.c index 86cd219db9..6de69e3db4 100644 --- a/gtk/gtkfontchooserdialog.c +++ b/gtk/gtkfontchooserdialog.c @@ -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 */ diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c index 3d8b3ad39b..ec0f9267bc 100644 --- a/gtk/gtkframe.c +++ b/gtk/gtkframe.c @@ -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 <child> element. + * “label” as the “type” attribute of a <child> element. * A normal content child can be specified without specifying * a <child> type attribute. * diff --git a/gtk/gtkheaderbar.c b/gtk/gtkheaderbar.c index a1769f4732..681dd215d5 100644 --- a/gtk/gtkheaderbar.c +++ b/gtk/gtkheaderbar.c @@ -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 diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c index fe3088c81d..a89683cdf8 100644 --- a/gtk/gtkicontheme.c +++ b/gtk/gtkicontheme.c @@ -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 * diff --git a/gtk/gtkimage.c b/gtk/gtkimage.c index 6ff90deae2..686677bd21 100644 --- a/gtk/gtkimage.c +++ b/gtk/gtkimage.c @@ -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. * diff --git a/gtk/gtkimcontext.c b/gtk/gtkimcontext.c index aab5efa502..ba60a81387 100644 --- a/gtk/gtkimcontext.c +++ b/gtk/gtkimcontext.c @@ -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. diff --git a/gtk/gtkimmodule.c b/gtk/gtkimmodule.c index ab3442d8f6..a8af400827 100644 --- a/gtk/gtkimmodule.c +++ b/gtk/gtkimmodule.c @@ -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. */ diff --git a/gtk/gtkinfobar.c b/gtk/gtkinfobar.c index 42b01613f2..e48048a1c3 100644 --- a/gtk/gtkinfobar.c +++ b/gtk/gtkinfobar.c @@ -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 <action-widgets> element, which - * can contain multiple <action-widget> elements. The "response" + * can contain multiple <action-widget> 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. diff --git a/gtk/gtkinvisible.c b/gtk/gtkinvisible.c index 48e7cf32de..788f545795 100644 --- a/gtk/gtkinvisible.c +++ b/gtk/gtkinvisible.c @@ -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, diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c index 4d0256f744..16a04f153e 100644 --- a/gtk/gtklabel.c +++ b/gtk/gtklabel.c @@ -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, diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c index 969865d3d5..1c410d2a18 100644 --- a/gtk/gtklayout.c +++ b/gtk/gtklayout.c @@ -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 diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c index a52c5b85d3..23f346492d 100644 --- a/gtk/gtkliststore.c +++ b/gtk/gtkliststore.c @@ -137,7 +137,7 @@ * The GtkListStore implementation of the GtkBuildable interface allows * to specify the model columns with a <columns> element that may * contain multiple <column> 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 <data> 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 diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c index 91766c8aea..d4d1bd84c2 100644 --- a/gtk/gtkmain.c +++ b/gtk/gtkmain.c @@ -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 diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c index 3b7f57be5e..bb7cd27fec 100644 --- a/gtk/gtkmenu.c +++ b/gtk/gtkmenu.c @@ -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, "<Gnumeric-Sheet>/File");` * has been called, assign its items the accel paths: * `"<Gnumeric-Sheet>/File/New"` and `"<Gnumeric-Sheet>/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) diff --git a/gtk/gtkmenu.h b/gtk/gtkmenu.h index bf57cf7f2d..25dd8bd0bc 100644 --- a/gtk/gtkmenu.h +++ b/gtk/gtkmenu.h @@ -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, diff --git a/gtk/gtkmenubutton.c b/gtk/gtkmenubutton.c index 49301c884b..c0a1ff5110 100644 --- a/gtk/gtkmenubutton.c +++ b/gtk/gtkmenubutton.c @@ -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 diff --git a/gtk/gtkmenuitem.c b/gtk/gtkmenuitem.c index 0bdd589312..09e30653d7 100644 --- a/gtk/gtkmenuitem.c +++ b/gtk/gtkmenuitem.c @@ -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 <child> 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.) diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c index 168ce56577..d711e89fe2 100644 --- a/gtk/gtkmenushell.c +++ b/gtk/gtkmenushell.c @@ -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 diff --git a/gtk/gtkmenutoolbutton.c b/gtk/gtkmenutoolbutton.c index 3d6e833274..1b98e5d0dd 100644 --- a/gtk/gtkmenutoolbutton.c +++ b/gtk/gtkmenutoolbutton.c @@ -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 <child> element. * * An example for a UI definition fragment with menus: diff --git a/gtk/gtkmenutracker.c b/gtk/gtkmenutracker.c index d74466715b..d9e57f3fd4 100644 --- a/gtk/gtkmenutracker.c +++ b/gtk/gtkmenutracker.c @@ -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. * diff --git a/gtk/gtkmessagedialog.c b/gtk/gtkmessagedialog.c index 53491e203e..68ba03bb4a 100644 --- a/gtk/gtkmessagedialog.c +++ b/gtk/gtkmessagedialog.c @@ -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 Pango text markup language. - * 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. * |[ * 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 **/ diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c index 70b9dfc725..a63ea90b2e 100644 --- a/gtk/gtknotebook.c +++ b/gtk/gtknotebook.c @@ -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 <child> element. Note that the content + * supports placing children into tabs by specifying “tab” as the + * “type” attribute of a <child> 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 <child> * type attribute. * * To add a child widget in the notebooks action area, specify - * "action-start" or "action-end" as the "type" attribute of the <child> + * "action-start" or “action-end” as the “type” attribute of the <child> * 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. * |[ @@ -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 diff --git a/gtk/gtkoverlay.c b/gtk/gtkoverlay.c index 9e3f40d5c3..3b1ac1988d 100644 --- a/gtk/gtkoverlay.c +++ b/gtk/gtkoverlay.c @@ -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 `<child>` element. + * supports placing a child as an overlay by specifying “overlay” as + * the “type” attribute of a `<child>` element. */ struct _GtkOverlayPrivate diff --git a/gtk/gtkpagesetup.c b/gtk/gtkpagesetup.c index 100d3fc6f6..83ec00f17d 100644 --- a/gtk/gtkpagesetup.c +++ b/gtk/gtkpagesetup.c @@ -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. * diff --git a/gtk/gtkpathbar.c b/gtk/gtkpathbar.c index d8a1badcff..13af23a5ec 100644 --- a/gtk/gtkpathbar.c +++ b/gtk/gtkpathbar.c @@ -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 diff --git a/gtk/gtkplacessidebar.c b/gtk/gtkplacessidebar.c index e5bb221a34..8df22555ba 100644 --- a/gtk/gtkplacessidebar.c +++ b/gtk/gtkplacessidebar.c @@ -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 */ diff --git a/gtk/gtkplug.c b/gtk/gtkplug.c index f855fb4fdb..ae24dd6c01 100644 --- a/gtk/gtkplug.c +++ b/gtk/gtkplug.c @@ -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. diff --git a/gtk/gtkprinteroptionwidget.c b/gtk/gtkprinteroptionwidget.c index c128bba2b7..8278e18953 100644 --- a/gtk/gtkprinteroptionwidget.c +++ b/gtk/gtkprinteroptionwidget.c @@ -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 diff --git a/gtk/gtkprintjob.c b/gtk/gtkprintjob.c index 918ece56a8..6b78df989a 100644 --- a/gtk/gtkprintjob.c +++ b/gtk/gtkprintjob.c @@ -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 diff --git a/gtk/gtkprintoperation.c b/gtk/gtkprintoperation.c index f464e86551..6a53b92d20 100644 --- a/gtk/gtkprintoperation.c +++ b/gtk/gtkprintoperation.c @@ -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 **/ diff --git a/gtk/gtkprintoperation.h b/gtk/gtkprintoperation.h index fdafdac886..1a906e0cce 100644 --- a/gtk/gtkprintoperation.h +++ b/gtk/gtkprintoperation.h @@ -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. diff --git a/gtk/gtkprintsettings.c b/gtk/gtkprintsettings.c index b1e8476f03..5098ec668e 100644 --- a/gtk/gtkprintsettings.c +++ b/gtk/gtkprintsettings.c @@ -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. * diff --git a/gtk/gtkprintsettings.h b/gtk/gtkprintsettings.h index c6ff171877..fe47dd2644 100644 --- a/gtk/gtkprintsettings.h +++ b/gtk/gtkprintsettings.h @@ -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" diff --git a/gtk/gtkprintunixdialog.c b/gtk/gtkprintunixdialog.c index 77e5bf8969..735d1f16b8 100644 --- a/gtk/gtkprintunixdialog.c +++ b/gtk/gtkprintunixdialog.c @@ -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: * |[ diff --git a/gtk/gtkprogressbar.c b/gtk/gtkprogressbar.c index 5e3a47d306..097d9b524b 100644 --- a/gtk/gtkprogressbar.c +++ b/gtk/gtkprogressbar.c @@ -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()). diff --git a/gtk/gtkrange.c b/gtk/gtkrange.c index 3dea5b9a4e..dee451294e 100644 --- a/gtk/gtkrange.c +++ b/gtk/gtkrange.c @@ -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 diff --git a/gtk/gtkrecentchooser.c b/gtk/gtkrecentchooser.c index 50ff1cdccc..950e58792e 100644 --- a/gtk/gtkrecentchooser.c +++ b/gtk/gtkrecentchooser.c @@ -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. diff --git a/gtk/gtkrecentchooser.h b/gtk/gtkrecentchooser.h index b09417b31d..51f904cb71 100644 --- a/gtk/gtkrecentchooser.h +++ b/gtk/gtkrecentchooser.h @@ -115,7 +115,7 @@ GQuark gtk_recent_chooser_error_quark (void); * @list_filters: Gets the #GtkRecentFilter objects held by chooser. * @set_sort_func: Sets the comparison function used when sorting to * be sort_func. - * @item_activated: Signal emitted when the user "activates" a recent + * @item_activated: Signal emitted when the user “activates” a recent * item in the recent chooser. * @selection_changed: Signal emitted when there is a change in the * set of selected recently used resources. diff --git a/gtk/gtkrecentmanager.c b/gtk/gtkrecentmanager.c index d32bc00e4b..3b10ef97aa 100644 --- a/gtk/gtkrecentmanager.c +++ b/gtk/gtkrecentmanager.c @@ -707,7 +707,7 @@ build_recent_items_list (GtkRecentManager *manager) * * Creates a new recent manager object. Recent manager objects are used to * handle the list of recently used resources. A #GtkRecentManager object - * monitors the recently used resources list, and emits the "changed" signal + * monitors the recently used resources list, and emits the “changed” signal * each time something inside the list changes. * * #GtkRecentManager objects are expensive: be sure to create them only when @@ -1701,7 +1701,7 @@ gtk_recent_info_get_visited (GtkRecentInfo *info) * gtk_recent_info_get_private_hint: * @info: a #GtkRecentInfo * - * Gets the value of the "private" flag. Resources in the recently used + * Gets the value of the “private” flag. Resources in the recently used * list that have this flag set to %TRUE should only be displayed by the * applications that have registered them. * @@ -2237,7 +2237,7 @@ get_uri_shortname_for_display (const gchar *uri) * * Computes a valid UTF-8 string that can be used as the name of the item in a * menu or list. For example, calling this function on an item that refers to - * "file:///foo/bar.txt" will yield "bar.txt". + * “file:///foo/bar.txt” will yield “bar.txt”. * * Return value: A newly-allocated string in UTF-8 encoding; free it with * g_free(). diff --git a/gtk/gtkrecentmanager.h b/gtk/gtkrecentmanager.h index 246cd4094c..94042ca894 100644 --- a/gtk/gtkrecentmanager.h +++ b/gtk/gtkrecentmanager.h @@ -55,7 +55,7 @@ typedef struct _GtkRecentManagerPrivate GtkRecentManagerPrivate; * @app_name: the name of the application that is registering this recently * used resource; * @app_exec: command line used to launch this resource; may contain the - * "%f" and "%u" escape characters which will be expanded + * “%f” and “%u” escape characters which will be expanded * to the resource file path and URI respectively when the command line * is retrieved; * @groups: a vector of strings containing groups names; diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c index ef703bc819..079f712eb6 100644 --- a/gtk/gtkscale.c +++ b/gtk/gtkscale.c @@ -64,11 +64,11 @@ * # GtkScale as GtkBuildable * * GtkScale supports a custom <marks> element, which - * can contain multiple <mark> elements. The "value" and "position" + * can contain multiple <mark> elements. The “value” and “position” * attributes have the same meaning as gtk_scale_add_mark() parameters of the * same name. If the element is not empty, its content is taken as the markup * to show at the mark. It can be translated with the usual "translatable and - * "context" attributes. + * “context” attributes. */ diff --git a/gtk/gtkscrolledwindow.c b/gtk/gtkscrolledwindow.c index 5bea3e1de9..6566eb9c66 100644 --- a/gtk/gtkscrolledwindow.c +++ b/gtk/gtkscrolledwindow.c @@ -73,11 +73,11 @@ * * The position of the scrollbars is controlled by the scroll * adjustments. See #GtkAdjustment for the fields in an adjustment - for - * #GtkScrollbar, used by #GtkScrolledWindow, the "value" field + * #GtkScrollbar, used by #GtkScrolledWindow, the “value” field * represents the position of the scrollbar, which must be between the - * "lower" field and "upper - page_size." The "page_size" field + * “lower” field and “upper - page_size.” The “page_size” field * represents the size of the visible scrollable area. The - * "step_increment" and "page_increment" fields are used when the user + * “step_increment” and “page_increment” fields are used when the user * asks to step down (using the small stepper arrows) or page down (using * for example the PageDown key). * diff --git a/gtk/gtksearchbar.c b/gtk/gtksearchbar.c index 24e5b70577..7bffdf7097 100644 --- a/gtk/gtksearchbar.c +++ b/gtk/gtksearchbar.c @@ -565,7 +565,7 @@ gtk_search_bar_get_show_close_button (GtkSearchBar *bar) * @visible: whether the close button will be shown or not * * Shows or hides the close button. Applications that - * already have a "search" toggle button should not show a close + * already have a “search” toggle button should not show a close * button in their search bar, as it duplicates the role of the * toggle button. * diff --git a/gtk/gtksearchentry.c b/gtk/gtksearchentry.c index cf3af20e50..57e88b3baf 100644 --- a/gtk/gtksearchentry.c +++ b/gtk/gtksearchentry.c @@ -40,9 +40,9 @@ * #GtkSearchEntry is a subclass of #GtkEntry that has * been tailored for use as a search entry. * - * It will show an inactive symbolic "find" icon when the - * search entry is empty, and a symbolic "clear" icon when - * there is text. Clicking on the "clear" icon will empty + * It will show an inactive symbolic “find” icon when the + * search entry is empty, and a symbolic “clear” icon when + * there is text. Clicking on the “clear” icon will empty * the search entry. * * Note that the search/clear icon is shown using a secondary diff --git a/gtk/gtkselection.c b/gtk/gtkselection.c index 89f099f7aa..783f1e7341 100644 --- a/gtk/gtkselection.c +++ b/gtk/gtkselection.c @@ -31,10 +31,10 @@ /* Terminology note: when not otherwise specified, the term "incr" below * refers to the _sending_ part of the INCR protocol. The receiving - * portion is referred to just as "retrieval". (Terminology borrowed - * from Tk, because there is no good opposite to "retrieval" in English. - * "send" can't be made into a noun gracefully and we're already using - * "emission" for something else ....) + * portion is referred to just as “retrieval”. (Terminology borrowed + * from Tk, because there is no good opposite to “retrieval” in English. + * “send” can't be made into a noun gracefully and we're already using + * “emission” for something else ....) */ /* The MOTIF entry widget seems to ask for the TARGETS target, then @@ -1035,7 +1035,7 @@ gtk_selection_remove_all (GtkWidget *widget) In emergency, you could use #GDK_CURRENT_TIME * * Requests the contents of a selection. When received, - * a "selection-received" signal will be generated. + * a “selection-received” signal will be generated. * * Return value: %TRUE if requested succeeded. %FALSE if we could not process * request. (e.g., there was already a request in process for @@ -2277,7 +2277,7 @@ _gtk_selection_clear (GtkWidget *widget, /************************************************************* * _gtk_selection_request: - * Handler for "selection_request_event" + * Handler for “selection_request_event” * arguments: * widget: * event: @@ -2713,7 +2713,7 @@ gtk_selection_incr_timeout (GtkIncrInfo *info) /************************************************************* * _gtk_selection_notify: - * Handler for "selection-notify-event" signals on windows + * Handler for “selection-notify-event” signals on windows * where a retrieval is currently in process. The selection * owner has responded to our conversion request. * arguments: @@ -2805,7 +2805,7 @@ _gtk_selection_notify (GtkWidget *widget, /************************************************************* * _gtk_selection_property_notify: - * Handler for "property-notify-event" signals on windows + * Handler for “property-notify-event” signals on windows * where a retrieval is currently in process. The selection * owner has added more data. * arguments: @@ -2962,7 +2962,7 @@ gtk_selection_retrieval_timeout (GtkRetrievalInfo *info) /************************************************************* * gtk_selection_retrieval_report: - * Emits a "selection-received" signal. + * Emits a “selection-received” signal. * arguments: * info: information about the retrieval that completed * buffer: buffer containing data (NULL => errror) diff --git a/gtk/gtkseparatortoolitem.c b/gtk/gtkseparatortoolitem.c index 6199cdd063..8921fb9749 100644 --- a/gtk/gtkseparatortoolitem.c +++ b/gtk/gtkseparatortoolitem.c @@ -35,9 +35,9 @@ * #GtkToolItems. Depending on the theme, a #GtkSeparatorToolItem will * often look like a vertical line on horizontally docked toolbars. * - * If the #GtkToolbar child property "expand" is %TRUE and the property + * If the #GtkToolbar child property “expand” is %TRUE and the property * #GtkSeparatorToolItem:draw is %FALSE, a #GtkSeparatorToolItem will act as - * a "spring" that forces other items to the ends of the toolbar. + * a “spring” that forces other items to the ends of the toolbar. * * Use gtk_separator_tool_item_new() to create a new #GtkSeparatorToolItem. */ diff --git a/gtk/gtksettings.h b/gtk/gtksettings.h index c58396fc4d..f76e8f256a 100644 --- a/gtk/gtksettings.h +++ b/gtk/gtksettings.h @@ -65,8 +65,8 @@ struct _GtkSettingsClass /** * GtkSettingsValue: - * @origin: Origin should be something like "filename:linenumber" for - * rc files, or e.g. "XProperty" for other sources. + * @origin: Origin should be something like “filename:linenumber” for + * rc files, or e.g. “XProperty” for other sources. * @value: Valid types are LONG, DOUBLE and STRING corresponding to * the token parsed, or a GSTRING holding an unparsed statement */ diff --git a/gtk/gtkstatusicon.c b/gtk/gtkstatusicon.c index b006e7e0d5..2cc342b559 100644 --- a/gtk/gtkstatusicon.c +++ b/gtk/gtkstatusicon.c @@ -60,13 +60,13 @@ * @Short_description: Display an icon in the system tray * @Title: GtkStatusIcon * - * The "system tray" or notification area is normally used for transient icons + * The “system tray” or notification area is normally used for transient icons * that indicate some special state. For example, a system tray icon might * appear to tell the user that they have new mail, or have an incoming instant * message, or something along those lines. The basic idea is that creating an * icon in the notification area is less annoying than popping up a dialog. * - * A #GtkStatusIcon object can be used to display an icon in a "system tray". + * A #GtkStatusIcon object can be used to display an icon in a “system tray”. * The icon can have a tooltip, and the user can interact with it by * activating it or popping up a context menu. Critical information should * not solely be displayed in a #GtkStatusIcon, since it may not be @@ -75,7 +75,7 @@ * * On X11, the implementation follows the * [FreeDesktop System Tray Specification](http://www.freedesktop.org/wiki/Specifications/systemtray-spec). - * Implementations of the "tray" side of this specification can + * Implementations of the “tray” side of this specification can * be found e.g. in the GNOME 2 and KDE panel applications. * * Note that a GtkStatusIcon is not a widget, but just diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c index eda92b3945..5cabff2b7f 100644 --- a/gtk/gtkstylecontext.c +++ b/gtk/gtkstylecontext.c @@ -1818,14 +1818,14 @@ region_find (GArray *array, * gtk_style_context_get() or any of the gtk_render_*() * functions will make use of this new class for styling. * - * In the CSS file format, a #GtkEntry defining an "entry" + * In the CSS file format, a #GtkEntry defining an “entry” * class, would be matched by: * * |[ * GtkEntry.entry { ... } * ]| * - * While any widget defining an "entry" class would be + * While any widget defining an “entry” class would be * matched by: * |[ * .entry { ... } @@ -2043,7 +2043,7 @@ _gtk_style_context_check_region_name (const gchar *str) * gtk_style_context_get() or any of the gtk_render_*() * functions will make use of this new region for styling. * - * In the CSS file format, a #GtkTreeView defining a "row" + * In the CSS file format, a #GtkTreeView defining a “row” * region, would be matched by: * * |[ diff --git a/gtk/gtkswitch.c b/gtk/gtkswitch.c index 732d016408..ad24dcad63 100644 --- a/gtk/gtkswitch.c +++ b/gtk/gtkswitch.c @@ -25,7 +25,7 @@ /** * SECTION:gtkswitch - * @Short_Description: A "light switch" style toggle + * @Short_Description: A “light switch” style toggle * @Title: GtkSwitch * @See_Also: #GtkToggleButton * @@ -974,7 +974,7 @@ gtk_switch_set_active (GtkSwitch *sw, * gtk_switch_get_active: * @sw: a #GtkSwitch * - * Gets whether the #GtkSwitch is in its "on" or "off" state. + * Gets whether the #GtkSwitch is in its “on” or “off” state. * * Return value: %TRUE if the #GtkSwitch is active, and %FALSE otherwise * diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c index dc976e6bf8..5fe60b74ad 100644 --- a/gtk/gtktestutils.c +++ b/gtk/gtktestutils.c @@ -53,7 +53,7 @@ * * It will in turn call g_test_init() and gtk_init() to properly * initialize the testing framework and graphical toolkit. It'll - * also set the program's locale to "C" and prevent loading of rc + * also set the program's locale to “C” and prevent loading of rc * files and Gtk+ modules. This is done to make tets program * environments as deterministic as possible. * @@ -130,7 +130,7 @@ quit_main_loop_callback (GtkWidget *widget, * gtk_test_widget_wait_for_draw: * @widget: the widget to wait for * - * Enters the main loop and waits for @widget to be "drawn". In this + * Enters the main loop and waits for @widget to be “drawn”. In this * context that means it waits for the frame clock of @widget to have * run a full styling, layout and drawing cycle. * @@ -272,7 +272,7 @@ gtk_test_spin_button_click (GtkSpinButton *spinner, * widget with a text string matching @label_pattern. * The @label_pattern may contain asterisks '*' and question marks '?' as * placeholders, g_pattern_match() is used for the matching. - * Note that locales other than "C" tend to alter (translate" label strings, + * Note that locales other than "C“ tend to alter (translate” label strings, * so this function is genrally only useful in test programs with * predetermined locales, see gtk_test_init() for more details. * @@ -375,7 +375,7 @@ widget_geo_cmp (gconstpointer a, * ancestors for all widgets matching @widget_type. * Of the matching widgets, the one that is geometrically closest to * @base_widget will be returned. - * The general purpose of this function is to find the most likely "action" + * The general purpose of this function is to find the most likely “action” * widget, relative to another labeling widget. Such as finding a * button or text entry widget, given its corresponding label widget. * @@ -416,7 +416,7 @@ gtk_test_find_sibling (GtkWidget *base_widget, * This function will search the descendants of @widget for a widget * of type @widget_type that has a label matching @label_pattern next * to it. This is most useful for automated GUI testing, e.g. to find - * the "OK" button in a dialog and synthesize clicks on it. + * the “OK” button in a dialog and synthesize clicks on it. * However see gtk_test_find_label(), gtk_test_find_sibling() and * gtk_test_widget_click() for possible caveats involving the search of * such widgets and synthesizing widget events. diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c index 8ae90cc498..558dd7f61b 100644 --- a/gtk/gtktextbuffer.c +++ b/gtk/gtktextbuffer.c @@ -933,7 +933,7 @@ gtk_text_buffer_emit_insert (GtkTextBuffer *buffer, * * Inserts @len bytes of @text at position @iter. If @len is -1, * @text must be nul-terminated and will be inserted in its - * entirety. Emits the "insert-text" signal; insertion actually occurs + * entirety. Emits the “insert-text” signal; insertion actually occurs * in the default handler for the signal. @iter is invalidated when * insertion occurs (because the buffer contents change), but the * default signal handler revalidates it to point to the end of the @@ -1655,7 +1655,7 @@ gtk_text_buffer_emit_delete (GtkTextBuffer *buffer, * * Deletes text between @start and @end. The order of @start and @end * is not actually relevant; gtk_text_buffer_delete() will reorder - * them. This function actually emits the "delete-range" signal, and + * them. This function actually emits the “delete-range” signal, and * the default handler of that signal deletes the text. Because the * buffer is modified, all outstanding iterators become invalid after * calling this function; however, the @start and @end will be @@ -1915,9 +1915,9 @@ gtk_text_buffer_real_insert_pixbuf (GtkTextBuffer *buffer, * Inserts an image into the text buffer at @iter. The image will be * counted as one character in character counts, and when obtaining * the buffer contents as a string, will be represented by the Unicode - * "object replacement character" 0xFFFC. Note that the "slice" + * “object replacement character” 0xFFFC. Note that the “slice” * variants for obtaining portions of the buffer as a string include - * this character for pixbufs, but the "text" variants do + * this character for pixbufs, but the “text” variants do * not. e.g. see gtk_text_buffer_get_slice() and * gtk_text_buffer_get_text(). **/ @@ -1959,9 +1959,9 @@ gtk_text_buffer_real_insert_anchor (GtkTextBuffer *buffer, * Inserts a child widget anchor into the text buffer at @iter. The * anchor will be counted as one character in character counts, and * when obtaining the buffer contents as a string, will be represented - * by the Unicode "object replacement character" 0xFFFC. Note that the - * "slice" variants for obtaining portions of the buffer as a string - * include this character for child anchors, but the "text" variants do + * by the Unicode “object replacement character” 0xFFFC. Note that the + * “slice” variants for obtaining portions of the buffer as a string + * include this character for child anchors, but the “text” variants do * not. E.g. see gtk_text_buffer_get_slice() and * gtk_text_buffer_get_text(). Consider * gtk_text_buffer_create_child_anchor() as a more convenient @@ -2335,7 +2335,7 @@ gtk_text_buffer_delete_mark_by_name (GtkTextBuffer *buffer, * * Returns the mark that represents the cursor (insertion point). * Equivalent to calling gtk_text_buffer_get_mark() to get the mark - * named "insert", but very slightly more efficient, and involves less + * named “insert”, but very slightly more efficient, and involves less * typing. * * Return value: (transfer none): insertion point mark @@ -2354,12 +2354,12 @@ gtk_text_buffer_get_insert (GtkTextBuffer *buffer) * * Returns the mark that represents the selection bound. Equivalent * to calling gtk_text_buffer_get_mark() to get the mark named - * "selection_bound", but very slightly more efficient, and involves + * “selection_bound”, but very slightly more efficient, and involves * less typing. * * The currently-selected text in @buffer is the region between the - * "selection_bound" and "insert" marks. If "selection_bound" and - * "insert" are in the same place, then there is no current selection. + * “selection_bound” and “insert” marks. If “selection_bound” and + * “insert” are in the same place, then there is no current selection. * gtk_text_buffer_get_selection_bounds() is another convenient function * for handling the selection, if you just want to know whether there's a * selection and what its bounds are. @@ -2402,7 +2402,7 @@ gtk_text_buffer_get_iter_at_child_anchor (GtkTextBuffer *buffer, * @buffer: a #GtkTextBuffer * @where: where to put the cursor * - * This function moves the "insert" and "selection_bound" marks + * This function moves the “insert” and “selection_bound” marks * simultaneously. If you move them to the same place in two steps * with gtk_text_buffer_move_mark(), you will temporarily select a * region in between their old and new locations, which can be pretty @@ -2420,10 +2420,10 @@ gtk_text_buffer_place_cursor (GtkTextBuffer *buffer, /** * gtk_text_buffer_select_range: * @buffer: a #GtkTextBuffer - * @ins: where to put the "insert" mark - * @bound: where to put the "selection_bound" mark + * @ins: where to put the “insert” mark + * @bound: where to put the “selection_bound” mark * - * This function moves the "insert" and "selection_bound" marks + * This function moves the “insert” and “selection_bound” marks * simultaneously. If you move them in two steps * with gtk_text_buffer_move_mark(), you will temporarily select a * region in between their old and new locations, which can be pretty @@ -2603,7 +2603,7 @@ gtk_text_buffer_emit_tag (GtkTextBuffer *buffer, * @start: one bound of range to be tagged * @end: other bound of range to be tagged * - * Emits the "apply-tag" signal on @buffer. The default + * Emits the “apply-tag” signal on @buffer. The default * handler for the signal applies @tag to the given range. * @start and @end do not have to be in order. **/ @@ -2631,7 +2631,7 @@ gtk_text_buffer_apply_tag (GtkTextBuffer *buffer, * @start: one bound of range to be untagged * @end: other bound of range to be untagged * - * Emits the "remove-tag" signal. The default handler for the signal + * Emits the “remove-tag” signal. The default handler for the signal * removes all occurrences of @tag from the given range. @start and * @end don't have to be in order. **/ @@ -2972,7 +2972,7 @@ gtk_text_buffer_get_start_iter (GtkTextBuffer *buffer, * @buffer: a #GtkTextBuffer * @iter: (out): iterator to initialize * - * Initializes @iter with the "end iterator," one past the last valid + * Initializes @iter with the “end iterator,” one past the last valid * character in the text buffer. If dereferenced with * gtk_text_iter_get_char(), the end iterator has a character value of 0. * The entire buffer lies in the range from the first position in @@ -3021,7 +3021,7 @@ gtk_text_buffer_get_bounds (GtkTextBuffer *buffer, * * Indicates whether the buffer has been modified since the last call * to gtk_text_buffer_set_modified() set the modification flag to - * %FALSE. Used for example to enable a "save" function in a text + * %FALSE. Used for example to enable a “save” function in a text * editor. * * Return value: %TRUE if the buffer has been modified @@ -3819,7 +3819,7 @@ gtk_text_buffer_paste_clipboard (GtkTextBuffer *buffer, * @interactive: whether the deletion is caused by user interaction * @default_editable: whether the buffer is editable by default * - * Deletes the range between the "insert" and "selection_bound" marks, + * Deletes the range between the “insert” and “selection_bound” marks, * that is, the currently-selected text. If @interactive is %TRUE, * the editability of the selection will be considered (users can't delete * uneditable text). @@ -4090,11 +4090,11 @@ gtk_text_buffer_get_selection_bounds (GtkTextBuffer *buffer, * an undo stack. #GtkTextBuffer maintains a count of calls to * gtk_text_buffer_begin_user_action() that have not been closed with * a call to gtk_text_buffer_end_user_action(), and emits the - * "begin-user-action" and "end-user-action" signals only for the + * “begin-user-action” and “end-user-action” signals only for the * outermost pair of calls. This allows you to build user actions * from other user actions. * - * The "interactive" buffer mutation functions, such as + * The “interactive” buffer mutation functions, such as * gtk_text_buffer_insert_interactive(), automatically call begin/end * user action around the buffer operations they perform, so there's * no need to add extra calls if you user action consists solely of a diff --git a/gtk/gtktextbuffer.h b/gtk/gtktextbuffer.h index 614aa9c5d3..5b56f8deec 100644 --- a/gtk/gtktextbuffer.h +++ b/gtk/gtktextbuffer.h @@ -49,7 +49,7 @@ G_BEGIN_DECLS * @GTK_TEXT_BUFFER_TARGET_INFO_RICH_TEXT: Rich text * @GTK_TEXT_BUFFER_TARGET_INFO_TEXT: Text * - * These values are used as "info" for the targets contained in the + * These values are used as “info” for the targets contained in the * lists returned by gtk_text_buffer_get_copy_target_list() and * gtk_text_buffer_get_paste_target_list(). * diff --git a/gtk/gtktextbufferrichtext.c b/gtk/gtktextbufferrichtext.c index 8da9605405..996d6247f9 100644 --- a/gtk/gtktextbufferrichtext.c +++ b/gtk/gtktextbufferrichtext.c @@ -111,8 +111,8 @@ gtk_text_buffer_register_serialize_format (GtkTextBuffer *buffer, * * This function is just a wrapper around * gtk_text_buffer_register_serialize_format(). The mime type used - * for registering is "application/x-gtk-text-buffer-rich-text", or - * "application/x-gtk-text-buffer-rich-text;format=@tagset_name" if a + * for registering is “application/x-gtk-text-buffer-rich-text”, or + * “application/x-gtk-text-buffer-rich-text;format=@tagset_name” if a * @tagset_name was passed. * * The @tagset_name can be used to restrict the transfer of rich text diff --git a/gtk/gtktextchild.h b/gtk/gtktextchild.h index 46ae1a04f8..7437577897 100644 --- a/gtk/gtktextchild.h +++ b/gtk/gtktextchild.h @@ -39,7 +39,7 @@ G_BEGIN_DECLS * GtkTextChildAnchor: * * A #GtkTextChildAnchor is a spot in the buffer where child widgets can - * be "anchored" (inserted inline, as if they were characters). The anchor + * be “anchored” (inserted inline, as if they were characters). The anchor * can have multiple widgets anchored, to allow for multiple views. */ typedef struct _GtkTextChildAnchor GtkTextChildAnchor; diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c index 0110236279..cfdf53ccb1 100644 --- a/gtk/gtktextiter.c +++ b/gtk/gtktextiter.c @@ -713,7 +713,7 @@ gtk_text_iter_get_line_index (const GtkTextIter *iter) * * Returns the offset in characters from the start of the * line to the given @iter, not counting characters that - * are invisible due to tags with the "invisible" flag + * are invisible due to tags with the “invisible” flag * toggled on. * * Return value: offset in visible characters from the start of the line @@ -778,7 +778,7 @@ gtk_text_iter_get_visible_line_offset (const GtkTextIter *iter) * * Returns the number of bytes from the start of the * line to the given @iter, not counting bytes that - * are invisible due to tags with the "invisible" flag + * are invisible due to tags with the “invisible” flag * toggled on. * * Return value: byte index of @iter with respect to the start of the line @@ -847,7 +847,7 @@ gtk_text_iter_get_visible_line_index (const GtkTextIter *iter) * The Unicode character at this iterator is returned. (Equivalent to * operator* on a C++ iterator.) If the element at this iterator is a * non-character element, such as an image embedded in the buffer, the - * Unicode "unknown" character 0xFFFC is returned. If invoked on + * Unicode “unknown” character 0xFFFC is returned. If invoked on * the end iterator, zero is returned; zero is not a valid Unicode character. * So you can write a loop which ends when gtk_text_iter_get_char() * returns 0. @@ -889,8 +889,8 @@ gtk_text_iter_get_char (const GtkTextIter *iter) * @start: iterator at start of a range * @end: iterator at end of a range * - * Returns the text in the given range. A "slice" is an array of - * characters encoded in UTF-8 format, including the Unicode "unknown" + * Returns the text in the given range. A “slice” is an array of + * characters encoded in UTF-8 format, including the Unicode “unknown” * character 0xFFFC for iterable non-character elements in the buffer, * such as images. Because images are encoded in the slice, byte and * character offsets in the returned array will correspond to byte @@ -946,7 +946,7 @@ gtk_text_iter_get_text (const GtkTextIter *start, * * Like gtk_text_iter_get_slice (), but invisible text is not included. * Invisible text is usually invisible because a #GtkTextTag with the - * "invisible" attribute turned on has been applied to it. + * “invisible” attribute turned on has been applied to it. * * Return value: slice of text from the buffer **/ @@ -970,7 +970,7 @@ gtk_text_iter_get_visible_slice (const GtkTextIter *start, * * Like gtk_text_iter_get_text (), but invisible text is not included. * Invisible text is usually invisible because a #GtkTextTag with the - * "invisible" attribute turned on has been applied to it. + * “invisible” attribute turned on has been applied to it. * * Return value: string containing visible text in the range **/ @@ -1379,7 +1379,7 @@ gtk_text_iter_get_tags (const GtkTextIter *iter) * @default_setting: %TRUE if text is editable by default * * Returns whether the character at @iter is within an editable region - * of text. Non-editable text is "locked" and can't be changed by the + * of text. Non-editable text is “locked” and can't be changed by the * user via #GtkTextView. This function is simply a convenience * wrapper around gtk_text_iter_get_attributes (). If no tags applied * to this text affect editability, @default_setting will be returned. @@ -3604,7 +3604,7 @@ is_cursor_pos_func (const PangoLogAttr *attrs, * surprisingly, there may not be a cursor position between all * characters. The most common example for European languages would be * a carriage return/newline sequence. For some Unicode characters, - * the equivalent of say the letter "a" with an accent mark will be + * the equivalent of say the letter “a” with an accent mark will be * represented as two characters, first the letter then a "combining * mark" that causes the accent to be rendered; so the cursor can't go * between those two characters. See also the #PangoLogAttr-struct and @@ -4034,7 +4034,7 @@ gtk_text_iter_set_offset (GtkTextIter *iter, * gtk_text_iter_forward_to_end: * @iter: a #GtkTextIter * - * Moves @iter forward to the "end iterator," which points one past the last + * Moves @iter forward to the “end iterator,” which points one past the last * valid character in the buffer. gtk_text_iter_get_char() called on the * end iterator returns 0, which is convenient for writing loops. **/ diff --git a/gtk/gtktextiter.h b/gtk/gtktextiter.h index 57ce274f8e..58f1274786 100644 --- a/gtk/gtktextiter.h +++ b/gtk/gtktextiter.h @@ -131,7 +131,7 @@ gint gtk_text_iter_get_visible_line_index (const GtkTextIter *iter); /* - * "Dereference" operators + * “Dereference” operators */ GDK_AVAILABLE_IN_ALL gunichar gtk_text_iter_get_char (const GtkTextIter *iter); @@ -348,7 +348,7 @@ void gtk_text_iter_set_visible_line_index (GtkTextIter *iter, gint byte_on_line); /* returns TRUE if a toggle was found; NULL for the tag pointer - * means "any tag toggle", otherwise the next toggle of the + * means “any tag toggle”, otherwise the next toggle of the * specified tag is located. */ GDK_AVAILABLE_IN_ALL diff --git a/gtk/gtktextmark.c b/gtk/gtktextmark.c index 0c58498696..7c72004e2c 100644 --- a/gtk/gtktextmark.c +++ b/gtk/gtktextmark.c @@ -73,7 +73,7 @@ * beginning of the newly-inserted text, and a mark with “right * gravity” will be moved to the end. * - * Note that "left" and "right" here refer to logical direction (left + * Note that “left” and “right” here refer to logical direction (left * is the toward the start of the buffer); in some languages such as * Hebrew the logically-leftmost text is not actually on the left when * displayed. diff --git a/gtk/gtktexttag.c b/gtk/gtktexttag.c index abb54bb4d7..b566c2c579 100644 --- a/gtk/gtktexttag.c +++ b/gtk/gtktexttag.c @@ -62,8 +62,8 @@ * gtk_text_buffer_create_tag() is the best way to create tags. * See “gtk3-demo” for numerous examples. * - * For each property of #GtkTextTag, there is a "set" property, e.g. - * "font-set" corresponds to "font". These "set" properties reflect + * For each property of #GtkTextTag, there is a “set” property, e.g. + * “font-set” corresponds to “font”. These “set” properties reflect * whether a property has been set or not. * They are maintained by GTK+ and you should not set them independently. */ @@ -1913,7 +1913,7 @@ gtk_text_tag_get_priority (GtkTextTag *tag) * Each tag in a table has a unique priority; setting the priority * of one tag shifts the priorities of all the other tags in the * table to maintain a unique priority for each tag. Higher priority - * tags "win" if two tags both set the same text attribute. When adding + * tags “win” if two tags both set the same text attribute. When adding * a tag to a tag table, it will be assigned the highest priority in * the table by default; so normally the precedence of a set of tags * is the order in which they were added to the table, or created with @@ -1965,7 +1965,7 @@ gtk_text_tag_set_priority (GtkTextTag *tag, * @event: the event * @iter: location where the event was received * - * Emits the "event" signal on the #GtkTextTag. + * Emits the “event” signal on the #GtkTextTag. * * Return value: result of signal emission (whether the event was handled) **/ diff --git a/gtk/gtktexttagtable.c b/gtk/gtktexttagtable.c index 15cdee4400..29245c1cbb 100644 --- a/gtk/gtktexttagtable.c +++ b/gtk/gtktexttagtable.c @@ -47,7 +47,7 @@ * # GtkTextTagTables as GtkBuildable * * The GtkTextTagTable implementation of the GtkBuildable interface - * supports adding tags by specifying "tag" as the "type" + * supports adding tags by specifying “tag” as the “type” * attribute of a <child> element. * * An example of a UI definition fragment specifying tags: diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c index 02b4d2c934..1614fe26b1 100644 --- a/gtk/gtktextview.c +++ b/gtk/gtktextview.c @@ -83,7 +83,7 @@ * - validate the lines that were moved onscreen * - gdk_window_process_updates() to handle the exposes immediately * - * The second way is that you get the "invalidated" signal from the layout, + * The second way is that you get the “invalidated” signal from the layout, * indicating that lines have become invalid. This code path begins in * invalidated_handler() and goes like this: * - install high-priority idle which does the rest of the steps @@ -1608,7 +1608,7 @@ gtk_text_view_new_with_buffer (GtkTextBuffer *buffer) * buffer displayed by the text view is unreferenced, and a reference is * added to @buffer. If you owned a reference to @buffer before passing it * to this function, you must remove that reference yourself; #GtkTextView - * will not "adopt" it. + * will not “adopt” it. **/ void gtk_text_view_set_buffer (GtkTextView *text_view, @@ -2589,7 +2589,7 @@ gtk_text_view_get_wrap_mode (GtkTextView *text_view) * @setting: whether it's editable * * Sets the default editability of the #GtkTextView. You can override - * this default setting with tags in the buffer, using the "editable" + * this default setting with tags in the buffer, using the “editable” * attribute of tags. **/ void @@ -3032,10 +3032,10 @@ gtk_text_view_set_tabs (GtkTextView *text_view, * * Gets the default tabs for @text_view. Tags in the buffer may * override the defaults. The returned array will be %NULL if - * "standard" (8-space) tabs are used. Free the return value + * “standard” (8-space) tabs are used. Free the return value * with pango_tab_array_free(). * - * Return value: copy of default tab array, or %NULL if "standard" + * Return value: copy of default tab array, or %NULL if “standard” * tabs are used; must be freed with pango_tab_array_free(). **/ PangoTabArray* @@ -8044,7 +8044,7 @@ gtk_text_view_set_vadjustment_values (GtkTextView *text_view) /* FIXME this adjust_allocation is a big cut-and-paste from - * GtkCList, needs to be some "official" way to do this + * GtkCList, needs to be some “official” way to do this * factored out. */ typedef struct @@ -9904,7 +9904,7 @@ set_window_height (GtkTextView *text_view, * or the height of %GTK_TEXT_WINDOW_TOP or %GTK_TEXT_WINDOW_BOTTOM. * Automatically destroys the corresponding window if the size is set * to 0, and creates the window if the size is set to non-zero. This - * function can only be used for the "border windows," it doesn't work + * function can only be used for the “border windows,” it doesn't work * with #GTK_TEXT_WINDOW_WIDGET, #GTK_TEXT_WINDOW_TEXT, or * #GTK_TEXT_WINDOW_PRIVATE. **/ diff --git a/gtk/gtktogglebutton.c b/gtk/gtktogglebutton.c index 11dc951712..3bbaccd2aa 100644 --- a/gtk/gtktogglebutton.c +++ b/gtk/gtktogglebutton.c @@ -519,8 +519,8 @@ gtk_toggle_button_toggled (GtkToggleButton *toggle_button) * If the user has selected a range of elements (such as some text or * spreadsheet cells) that are affected by a toggle button, and the * current values in that range are inconsistent, you may want to - * display the toggle in an "in between" state. This function turns on - * "in between" display. Normally you would turn off the inconsistent + * display the toggle in an “in between” state. This function turns on + * “in between” display. Normally you would turn off the inconsistent * state again if the user toggles the toggle button. This has to be * done manually, gtk_toggle_button_set_inconsistent() only affects * visual appearance, it doesn't affect the semantics of the button. diff --git a/gtk/gtktoolbar.c b/gtk/gtktoolbar.c index 20ed218336..b6aa77dfc6 100644 --- a/gtk/gtktoolbar.c +++ b/gtk/gtktoolbar.c @@ -74,7 +74,7 @@ * * Toolbar items can be visually grouped by adding instances of * #GtkSeparatorToolItem to the toolbar. If the GtkToolbar child property - * "expand" is #TRUE and the property #GtkSeparatorToolItem:draw is set to + * “expand” is #TRUE and the property #GtkSeparatorToolItem:draw is set to * #FALSE, the effect is to force all following items to the end of the toolbar. * * Creating a context menu for the toolbar can be done by connecting to diff --git a/gtk/gtktoolbutton.c b/gtk/gtktoolbutton.c index 0aeea1b497..dfea80de2f 100644 --- a/gtk/gtktoolbutton.c +++ b/gtk/gtktoolbutton.c @@ -1134,10 +1134,10 @@ gtk_tool_button_new (GtkWidget *icon_widget, * @button: a #GtkToolButton * @label: (allow-none): a string that will be used as label, or %NULL. * - * Sets @label as the label used for the tool button. The "label" property - * only has an effect if not overridden by a non-%NULL "label_widget" property. - * If both the "label_widget" and "label" properties are %NULL, the label - * is determined by the "stock_id" property. If the "stock_id" property is also + * Sets @label as the label used for the tool button. The “label” property + * only has an effect if not overridden by a non-%NULL “label_widget” property. + * If both the “label_widget” and “label” properties are %NULL, the label + * is determined by the “stock_id” property. If the “stock_id” property is also * %NULL, @button will not have a label. * * Since: 2.4 @@ -1193,12 +1193,12 @@ gtk_tool_button_get_label (GtkToolButton *button) /** * gtk_tool_button_set_use_underline: * @button: a #GtkToolButton - * @use_underline: whether the button label has the form "_Open" + * @use_underline: whether the button label has the form “_Open” * * If set, an underline in the label property indicates that the next character * should be used for the mnemonic accelerator key in the overflow menu. For - * example, if the label property is "_Open" and @use_underline is %TRUE, - * the label on the tool button will be "Open" and the item on the overflow + * example, if the label property is “_Open” and @use_underline is %TRUE, + * the label on the tool button will be “Open” and the item on the overflow * menu will have an underlined 'O'. * * Labels shown on tool buttons never have mnemonics on them; this property @@ -1250,7 +1250,7 @@ gtk_tool_button_get_use_underline (GtkToolButton *button) * * Sets the name of the stock item. See gtk_tool_button_new_from_stock(). * The stock_id property only has an effect if not - * overridden by non-%NULL "label" and "icon_widget" properties. + * overridden by non-%NULL “label” and “icon_widget” properties. * * Since: 2.4 * @@ -1302,8 +1302,8 @@ gtk_tool_button_get_stock_id (GtkToolButton *button) * * Sets the icon for the tool button from a named themed icon. * See the docs for #GtkIconTheme for more details. - * The "icon_name" property only has an effect if not - * overridden by non-%NULL "label", "icon_widget" and "stock_id" + * The “icon_name” property only has an effect if not + * overridden by non-%NULL “label”, “icon_widget” and “stock_id” * properties. * * Since: 2.8 @@ -1352,8 +1352,8 @@ gtk_tool_button_get_icon_name (GtkToolButton *button) * @icon_widget: (allow-none): the widget used as icon, or %NULL * * Sets @icon as the widget used as icon on @button. If @icon_widget is - * %NULL the icon is determined by the "stock_id" property. If the - * "stock_id" property is also %NULL, @button will not have an icon. + * %NULL the icon is determined by the “stock_id” property. If the + * “stock_id” property is also %NULL, @button will not have an icon. * * Since: 2.4 **/ @@ -1394,10 +1394,10 @@ gtk_tool_button_set_icon_widget (GtkToolButton *button, * @label_widget: (allow-none): the widget used as label, or %NULL * * Sets @label_widget as the widget that will be used as the label - * for @button. If @label_widget is %NULL the "label" property is used - * as label. If "label" is also %NULL, the label in the stock item - * determined by the "stock_id" property is used as label. If - * "stock_id" is also %NULL, @button does not have a label. + * for @button. If @label_widget is %NULL the “label” property is used + * as label. If “label” is also %NULL, the label in the stock item + * determined by the “stock_id” property is used as label. If + * “stock_id” is also %NULL, @button does not have a label. * * Since: 2.4 **/ diff --git a/gtk/gtktoolitem.c b/gtk/gtktoolitem.c index ceb3331a26..5b39f828d0 100644 --- a/gtk/gtktoolitem.c +++ b/gtk/gtktoolitem.c @@ -1031,8 +1031,8 @@ gtk_tool_item_get_is_important (GtkToolItem *tool_item) * Sets whether @tool_item should be considered important. The #GtkToolButton * class uses this property to determine whether to show or hide its label * when the toolbar style is %GTK_TOOLBAR_BOTH_HORIZ. The result is that - * only tool buttons with the "is_important" property set have labels, an - * effect known as "priority text" + * only tool buttons with the “is_important” property set have labels, an + * effect known as “priority text” * * Since: 2.4 **/ diff --git a/gtk/gtktrayicon-x11.c b/gtk/gtktrayicon-x11.c index 43204c6f25..371cd0ed62 100644 --- a/gtk/gtktrayicon-x11.c +++ b/gtk/gtktrayicon-x11.c @@ -16,7 +16,7 @@ */ /* - * This is an implementation of the freedesktop.org "system tray" spec, + * This is an implementation of the freedesktop.org “system tray” spec, * http://www.freedesktop.org/wiki/Standards/systemtray-spec */ diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c index 2aca8faddf..d066f82f51 100644 --- a/gtk/gtktreemodel.c +++ b/gtk/gtktreemodel.c @@ -597,7 +597,7 @@ gtk_tree_path_new (void) * Creates a new #GtkTreePath-struct initialized to @path. * * @path is expected to be a colon separated list of numbers. - * For example, the string "10:4:0" would create a path of depth + * For example, the string “10:4:0” would create a path of depth * 3 pointing to the 11th child of the root node, the 5th * child of that 11th child, and the 1st child of that 5th child. * If an invalid path string is passed in, %NULL is returned. @@ -713,7 +713,7 @@ gtk_tree_path_new_from_indicesv (gint *indices, * Generates a string representation of the path. * * This string is a ':' separated list of numbers. - * For example, "4:10:0:3" would be an acceptable + * For example, “4:10:0:3” would be an acceptable * return value for this string. * * Return value: A newly-allocated string. @@ -752,7 +752,7 @@ gtk_tree_path_to_string (GtkTreePath *path) * * Creates a new #GtkTreePath-struct. * - * The string representation of this path is "0". + * The string representation of this path is “0”. * * Return value: A new #GtkTreePath-struct */ @@ -1302,7 +1302,7 @@ gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model, * Generates a string representation of the iter. * * This string is a ':' separated list of numbers. - * For example, "4:10:0:3" would be an acceptable + * For example, “4:10:0:3” would be an acceptable * return value for this string. * * Return value: a newly-allocated string. diff --git a/gtk/gtktreemodelfilter.c b/gtk/gtktreemodelfilter.c index 17029a0a72..04012356e8 100644 --- a/gtk/gtktreemodelfilter.c +++ b/gtk/gtktreemodelfilter.c @@ -33,18 +33,18 @@ * A #GtkTreeModelFilter is a tree model which wraps another tree model, * and can do the following things: * - * - Filter specific rows, based on data from a "visible column", a column + * - Filter specific rows, based on data from a “visible column”, a column * storing booleans indicating whether the row should be filtered or not, - * or based on the return value of a "visible function", which gets a + * or based on the return value of a “visible function”, which gets a * model, iter and user_data and returns a boolean indicating whether the * row should be filtered or not. * - * - Modify the "appearance" of the model, using a modify function. + * - Modify the “appearance” of the model, using a modify function. * This is extremely powerful and allows for just changing some * values and also for creating a completely different model based * on the given child model. * - * - Set a different root node, also known as a "virtual root". You can pass + * - Set a different root node, also known as a “virtual root”. You can pass * in a #GtkTreePath indicating the root node for the filter at construction * time. * @@ -134,7 +134,7 @@ * Internal data structure * ----------------------- * - * Using FilterLevel and FilterElt, GtkTreeModelFilter maintains a "cache" + * Using FilterLevel and FilterElt, GtkTreeModelFilter maintains a “cache” * of the mapping from GtkTreeModelFilter nodes to nodes in the child model. * This is to avoid re-creating a level each time (which involves computing * visibility for each node in that level) an operation is requested on @@ -142,10 +142,10 @@ * * A FilterElt corresponds to a single node. The FilterElt can either be * visible or invisible in the model that is exposed to the clients of this - * GtkTreeModelFilter. The visibility state is stored in the "visible_siter" + * GtkTreeModelFilter. The visibility state is stored in the “visible_siter” * field, which is NULL when the node is not visible. The FilterLevel keeps * a reference to the parent FilterElt and its FilterLevel (if any). The - * FilterElt can have a "children" pointer set, which points at a child + * FilterElt can have a “children” pointer set, which points at a child * level (a sub level). * * In a FilterLevel, two separate GSequences are maintained. One contains @@ -160,7 +160,7 @@ * nodes are stored in the *visible* GSequence is the order in * which the nodes are exposed to clients of the GtkTreeModelFilter. * II. The mapping from this model to its child model. Each FilterElt - * contains an "offset" field which is the offset of the + * contains an “offset” field which is the offset of the * corresponding node in the child model. * * Throughout the code, two kinds of paths relative to the GtkTreeModelFilter @@ -177,10 +177,10 @@ * to the corresponding node in the child model. In addition, * GtkTreeModelFilter will also add references of its own. The full reference * count of each node (i.e. all forwarded references and these by the - * filter model) is maintained internally in the "ref_count" fields in + * filter model) is maintained internally in the “ref_count” fields in * FilterElt and FilterLevel. Because there is a need to determine whether * a node should be visible for the client, the reference count of only - * the forwarded references is maintained as well, in the "ext_ref_count" + * the forwarded references is maintained as well, in the “ext_ref_count” * fields. * * In a few cases, GtkTreeModelFilter takes additional references on @@ -208,7 +208,7 @@ * * When a level has an *external* reference count of zero (which means that * none of the nodes in the level is referenced by the clients), the level - * has a "zero ref count" on all its parents. As soon as the level reaches + * has a “zero ref count” on all its parents. As soon as the level reaches * an *external* reference count of zero, the zero ref count value is * incremented by one for all parents of this level. Due to the additional * references taken by the filter model, it is important to base the @@ -1028,7 +1028,7 @@ gtk_tree_model_filter_free_level (GtkTreeModelFilter *filter, * freed, the level is pruned to a level with only the first node used * for monitoring. For now it is only being called from * gtk_tree_model_filter_remove_elt_from_level(), which is the reason - * this function is lacking a "gboolean unref" argument. + * this function is lacking a “gboolean unref” argument. */ static void gtk_tree_model_filter_prune_level (GtkTreeModelFilter *filter, @@ -3830,7 +3830,7 @@ gtk_tree_model_filter_get_model (GtkTreeModelFilter *filter) * GtkTreeIter *iter, * gpointer data) * { - * /* Visible if row is non-empty and first column is "HI" */ + * /* Visible if row is non-empty and first column is “HI” */ * gchar *str; * gboolean visible = FALSE; * diff --git a/gtk/gtktreemodelsort.c b/gtk/gtktreemodelsort.c index 9d294e82b6..97577fe390 100644 --- a/gtk/gtktreemodelsort.c +++ b/gtk/gtktreemodelsort.c @@ -159,7 +159,7 @@ * Internal data structure * ----------------------- * - * Using SortLevel and SortElt, GtkTreeModelSort maintains a "cache" of + * Using SortLevel and SortElt, GtkTreeModelSort maintains a “cache” of * the mapping from GtkTreeModelSort nodes to nodes in the child model. * This is to avoid sorting a level each time an operation is requested * on GtkTreeModelSort, such as get iter, get path, get value. @@ -179,7 +179,7 @@ * nodes are stored in the GSequence is the order in which the * nodes are exposed to clients of the GtkTreeModelSort. * II. The mapping from this model to its child model. Each SortElt - * contains an "offset" field which is the offset of the + * contains an “offset” field which is the offset of the * corresponding node in the child model. * * Reference counting @@ -187,9 +187,9 @@ * * GtkTreeModelSort forwards all reference and unreference operations * to the corresponding node in the child model. The reference count - * of each node is also maintained internally, in the "ref_count" + * of each node is also maintained internally, in the “ref_count” * fields in SortElt and SortLevel. For each ref and unref operation on - * a SortElt, the "ref_count" of the SortLevel is updated accordingly. + * a SortElt, the “ref_count” of the SortLevel is updated accordingly. * In addition, if a SortLevel has a parent, a reference is taken on * this parent. This happens in gtk_tree_model_sort_build_level() and * the reference is released again in gtk_tree_model_sort_free_level(). @@ -200,7 +200,7 @@ * * When a level has a reference count of zero, which means that * none of the nodes in the level is referenced, the level has - * a "zero ref count" on all its parents. As soon as the level + * a “zero ref count” on all its parents. As soon as the level * reaches a reference count of zero, the zero ref count value is * incremented by one on all parents of this level. Similarly, as * soon as the reference count of a level changes from zero, the diff --git a/gtk/gtktreesortable.h b/gtk/gtktreesortable.h index 790ea083e4..c08e6a2534 100644 --- a/gtk/gtktreesortable.h +++ b/gtk/gtktreesortable.h @@ -74,7 +74,7 @@ typedef struct _GtkTreeSortableIface GtkTreeSortableIface; * the model, i.e. it must be reflexive, antisymmetric and transitive. * * For example, if @model is a product catalogue, then a compare function - * for the "price" column could be one which returns + * for the “price” column could be one which returns * `price_of(@a) - price_of(@b)`. * * Returns: a negative integer, zero or a positive integer depending on whether diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c index a1aa611809..6b346ca80b 100644 --- a/gtk/gtktreestore.c +++ b/gtk/gtktreestore.c @@ -46,7 +46,7 @@ * The GtkTreeStore implementation of the #GtkBuildable interface allows * to specify the model columns with a <columns> element that may * contain multiple <column> 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. * * An example of a UI Definition fragment for a tree store: * |[ @@ -495,7 +495,7 @@ gtk_tree_store_finalize (GObject *object) /* fulfill the GtkTreeModel requirements */ /* NOTE: GtkTreeStore::root is a GNode, that acts as the parent node. However, - * it is not visible to the tree or to the user., and the path "0" refers to the + * it is not visible to the tree or to the user., and the path “0” refers to the * first child of GtkTreeStore::root. */ @@ -1169,7 +1169,7 @@ gtk_tree_store_set_valist (GtkTreeStore *tree_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 + * %G_TYPE_STRING to “Foo”, you would write * `gtk_tree_store_set (store, iter, 0, "Foo", -1)`. * * The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c index bba913bf19..ad65749cd8 100644 --- a/gtk/gtktreeview.c +++ b/gtk/gtktreeview.c @@ -11827,8 +11827,8 @@ gtk_tree_view_get_activate_on_single_click (GtkTreeView *tree_view) * @tree_view: A #GtkTreeView. * @column: The #GtkTreeViewColumn to add. * - * Appends @column to the list of columns. If @tree_view has "fixed_height" - * mode enabled, then @column must have its "sizing" property set to be + * Appends @column to the list of columns. If @tree_view has “fixed_height” + * mode enabled, then @column must have its “sizing” property set to be * GTK_TREE_VIEW_COLUMN_FIXED. * * Return value: The number of columns in @tree_view after appending. @@ -11948,7 +11948,7 @@ gtk_tree_view_remove_column (GtkTreeView *tree_view, * * This inserts the @column into the @tree_view at @position. If @position is * -1, then the column is inserted at the end. If @tree_view has - * "fixed_height" mode enabled, then @column must have its "sizing" property + * “fixed_height” mode enabled, then @column must have its “sizing” property * set to be GTK_TREE_VIEW_COLUMN_FIXED. * * Return value: The number of columns in @tree_view after insertion. @@ -12022,7 +12022,7 @@ gtk_tree_view_insert_column (GtkTreeView *tree_view, * Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at * @position. If @position is -1, then the newly created column is inserted at * the end. The column is initialized with the attributes given. If @tree_view - * has "fixed_height" mode enabled, then the new column will have its sizing + * has “fixed_height” mode enabled, then the new column will have its sizing * property set to be GTK_TREE_VIEW_COLUMN_FIXED. * * Return value: The number of columns in @tree_view after insertion. @@ -12078,8 +12078,8 @@ gtk_tree_view_insert_column_with_attributes (GtkTreeView *tree_view, * with the given cell renderer and a #GtkTreeCellDataFunc to set cell renderer * attributes (normally using data from the model). See also * gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start(). - * If @tree_view has "fixed_height" mode enabled, then the new column will have its - * "sizing" property set to be GTK_TREE_VIEW_COLUMN_FIXED. + * If @tree_view has “fixed_height” mode enabled, then the new column will have its + * “sizing” property set to be GTK_TREE_VIEW_COLUMN_FIXED. * * Return value: number of columns in the tree view post-insert **/ @@ -14665,7 +14665,7 @@ gtk_tree_view_set_destroy_count_func (GtkTreeView *tree_view, * the tree interactively (this is sometimes called "typeahead find"). * * Note that even if this is %FALSE, the user can still initiate a search - * using the "start-interactive-search" key binding. + * using the “start-interactive-search” key binding. */ void gtk_tree_view_set_enable_search (GtkTreeView *tree_view, @@ -14724,7 +14724,7 @@ gtk_tree_view_get_search_column (GtkTreeView *tree_view) * Sets @column as the column where the interactive search code should * search in for the current model. * - * If the search column is set, users can use the "start-interactive-search" + * If the search column is set, users can use the “start-interactive-search” * key binding to bring up search popup. The enable-search property controls * whether simply typing text will also start an interactive search. * diff --git a/gtk/gtktreeviewcolumn.c b/gtk/gtktreeviewcolumn.c index d08cca687a..29deef006a 100644 --- a/gtk/gtktreeviewcolumn.c +++ b/gtk/gtktreeviewcolumn.c @@ -1749,7 +1749,7 @@ gtk_tree_view_column_clear (GtkTreeViewColumn *tree_column) * column of the model to get a value from, and the @attribute is the * parameter on @cell_renderer 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 + * “text” attribute of a #GtkCellRendererText get its values from * column 2. **/ void @@ -2184,13 +2184,13 @@ _gtk_tree_view_column_allocate (GtkTreeViewColumn *tree_column, * If @fixed_width is not -1, sets the fixed width of @tree_column; otherwise * unsets it. The effective value of @fixed_width is clamped between the * minumum and maximum width of the column; however, the value stored in the - * "fixed-width" property is not clamped. If the column sizing is + * “fixed-width” property is not clamped. If the column sizing is * #GTK_TREE_VIEW_COLUMN_GROW_ONLY or #GTK_TREE_VIEW_COLUMN_AUTOSIZE, setting a * fixed width overrides the automatically calculated width. Note that * @fixed_width is only a hint to GTK+; the width actually allocated to the * column may be greater or less than requested. * - * Along with "expand", the "fixed-width" property changes when the column is + * Along with “expand”, the “fixed-width” property changes when the column is * resized by the user. **/ void @@ -2363,7 +2363,7 @@ gtk_tree_view_column_get_max_width (GtkTreeViewColumn *tree_column) * gtk_tree_view_column_clicked: * @tree_column: a #GtkTreeViewColumn * - * Emits the "clicked" signal on the column. This function will only work if + * Emits the “clicked” signal on the column. This function will only work if * @tree_column is clickable. **/ void @@ -2435,7 +2435,7 @@ gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column) * option set, then the last column gets all extra space. By default, every * column is created with this %FALSE. * - * Along with "fixed-width", the "expand" property changes when the column is + * Along with “fixed-width”, the “expand” property changes when the column is * resized by the user. * * Since: 2.4 diff --git a/gtk/gtktreeviewcolumn.h b/gtk/gtktreeviewcolumn.h index 9579fc092b..a991218e2b 100644 --- a/gtk/gtktreeviewcolumn.h +++ b/gtk/gtktreeviewcolumn.h @@ -70,8 +70,8 @@ typedef enum * A function to set the properties of a cell instead of just using the * straight mapping between the cell and the model. This is useful for * customizing the cell renderer. For example, a function might get an - * integer from the @tree_model, and render it to the "text" attribute of - * "cell" by converting it to its written equivilent. This is set by + * integer from the @tree_model, and render it to the “text” attribute of + * “cell” by converting it to its written equivilent. This is set by * calling gtk_tree_view_column_set_cell_data_func() */ typedef void (* GtkTreeCellDataFunc) (GtkTreeViewColumn *tree_column, diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index f1776fb6e9..a84ac3e241 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -224,7 +224,7 @@ * means that widgets are positioned such that the typographical baseline of * widgets in the same row are aligned. This happens if a widget supports baselines, * has a vertical alignment of %GTK_ALIGN_BASELINE, and is inside a container - * that supports baselines and has a natural "row" that it aligns to the baseline, + * that supports baselines and has a natural “row” that it aligns to the baseline, * or a baseline assigned to it by the grandparent. * * Baseline alignment support for a widget is done by the #GtkWidgetClass.get_preferred_height_and_baseline_for_width() @@ -271,7 +271,7 @@ * In addition to accelerators, #GtkWidget also support a * custom <accessible> element, which supports actions and relations. * Properties on the accessible implementation of an object can be set by accessing the - * internal child "accessible" of a #GtkWidget. + * internal child “accessible” of a #GtkWidget. * * An example of a UI definition fragment specifying an accessible: * |[ @@ -317,8 +317,8 @@ * * Unlike regular interface descriptions, gtk_widget_class_set_template() will expect a * <template> tag as a direct child of the toplevel <interface> - * tag. The <template> tag must specify the "class" attribute which - * must be the type name of the widget. Optionally, the "parent" attribute + * tag. The <template> tag must specify the “class” attribute which + * must be the type name of the widget. Optionally, the “parent” attribute * may be specified to specify the direct parent type of the widget type, this * is ignored by the GtkBuilder but required for Glade to introspect what kind * of properties and internal children exist for a given type when the actual @@ -4307,7 +4307,7 @@ gtk_widget_destroy (GtkWidget *widget) * * This function sets *@widget_pointer to %NULL if @widget_pointer != * %NULL. It's intended to be used as a callback connected to the - * "destroy" signal of a widget. You connect gtk_widget_destroyed() + * “destroy” signal of a widget. You connect gtk_widget_destroyed() * as a signal handler, and pass the address of your widget variable * as user data. Then when the widget is destroyed, the variable will * be set to %NULL. Useful for example to avoid multiple copies @@ -5260,7 +5260,7 @@ gtk_widget_queue_resize_no_redraw (GtkWidget *widget) * @widget: a #GtkWidget * * Obtains the frame clock for a widget. The frame clock is a global - * "ticker" that can be used to drive animations and repaints. The + * “ticker” that can be used to drive animations and repaints. The * most common reason to get the frame clock is to call * gdk_frame_clock_get_frame_time(), in order to get a time to use for * animating. For example you might record the start of the animation @@ -5356,7 +5356,7 @@ gtk_widget_size_request (GtkWidget *widget, * on @widget to compute the size request and fill in @widget->requisition, * and only then returns @widget->requisition. * - * Because this function does not call the "size_request" method, it + * Because this function does not call the “size_request” method, it * can only be used when you know that @widget->requisition is * up-to-date, that is, gtk_widget_size_request() has been called * since the last time a resize was queued. In general, only container @@ -6406,7 +6406,7 @@ gtk_cairo_set_event (cairo_t *cr, * that when the drawing was not initiated by the windowing * system this function will return %TRUE for all windows, so * you need to draw the bottommost window first. Also, do not - * use "else if" statements to check which window should be drawn. + * use “else if” statements to check which window should be drawn. * * Returns: %TRUE if @window should be drawn * @@ -7212,7 +7212,7 @@ gtk_widget_event_internal (GtkWidget *widget, * gtk_widget_activate: * @widget: a #GtkWidget that's activatable * - * For widgets that can be "activated" (buttons, menu items, etc.) + * For widgets that can be “activated” (buttons, menu items, etc.) * this function activates them. Activation is what happens when you * press Enter on a widget during key navigation. If @widget isn't * activatable, the function returns %FALSE. @@ -7852,7 +7852,7 @@ gtk_widget_is_focus (GtkWidget *widget) * * Specifies whether @widget can be a default widget. See * gtk_widget_grab_default() for details about the meaning of - * "default". + * “default”. * * Since: 2.18 **/ @@ -7936,7 +7936,7 @@ _gtk_widget_set_has_default (GtkWidget *widget, * The default widget is activated when * the user presses Enter in a window. Default widgets must be * activatable, that is, gtk_widget_activate() should affect them. Note - * that #GtkEntry widgets require the "activates-default" property + * that #GtkEntry widgets require the “activates-default” property * set to %TRUE before they activate the default widget when Enter * is pressed and the #GtkEntry is focused. **/ @@ -7966,7 +7966,7 @@ gtk_widget_grab_default (GtkWidget *widget) * is the default. * * See gtk_widget_grab_default() for details about the meaning of - * "default". + * “default”. * * Since: 2.18 **/ @@ -8461,7 +8461,7 @@ gtk_widget_is_visible (GtkWidget *widget) * @has_window: whether or not @widget has a window. * * Specifies whether @widget has a #GdkWindow of its own. Note that - * all realized widgets have a non-%NULL "window" pointer + * all realized widgets have a non-%NULL “window” pointer * (gtk_widget_get_window() never returns a %NULL window when a widget * is realized), but for many of them it's actually the #GdkWindow of * one of its parent widgets. Widgets that do not create a %window for @@ -8576,7 +8576,7 @@ gtk_widget_get_realized (GtkWidget *widget) * Marks the widget as being realized. * * This function should only ever be called in a derived widget's - * "realize" or "unrealize" implementation. + * “realize” or “unrealize” implementation. * * Since: 2.20 */ @@ -8615,7 +8615,7 @@ gtk_widget_get_mapped (GtkWidget *widget) * Marks the widget as being realized. * * This function should only ever be called in a derived widget's - * "map" or "unmap" implementation. + * “map” or “unmap” implementation. * * Since: 2.20 */ @@ -8691,7 +8691,7 @@ gtk_widget_get_app_paintable (GtkWidget *widget) * @double_buffered: %TRUE to double-buffer a widget * * Widgets are double buffered by default; you can use this function - * to turn off the buffering. "Double buffered" simply means that + * to turn off the buffering. “Double buffered” simply means that * gdk_window_begin_paint_region() and gdk_window_end_paint() are called * automatically around expose events sent to the * widget. gdk_window_begin_paint_region() diverts all drawing to a widget's @@ -8786,9 +8786,9 @@ gtk_widget_set_redraw_on_allocate (GtkWidget *widget, * @sensitive: %TRUE to make the widget sensitive * * Sets the sensitivity of a widget. A widget is sensitive if the user - * can interact with it. Insensitive widgets are "grayed out" and the + * can interact with it. Insensitive widgets are “grayed out” and the * user can't interact with them. Insensitive widgets are known as - * "inactive", "disabled", or "ghosted" in some other toolkits. + * “inactive”, “disabled”, or “ghosted” in some other toolkits. **/ void gtk_widget_set_sensitive (GtkWidget *widget, @@ -10373,7 +10373,7 @@ gtk_widget_set_usize_internal (GtkWidget *widget, * space than it requested. * * If the size request in a given direction is -1 (unset), then - * the "natural" size request of the widget will be used instead. + * the “natural” size request of the widget will be used instead. * * The size request set here does not include any margin from the * #GtkWidget properties margin-left, margin-right, margin-top, and @@ -14504,7 +14504,7 @@ gtk_widget_remove_mnemonic_label (GtkWidget *widget, * which determines whether calls to gtk_widget_show_all() * will affect this widget. * - * Return value: the current value of the "no-show-all" property. + * Return value: the current value of the “no-show-all” property. * * Since: 2.4 **/ @@ -14519,7 +14519,7 @@ gtk_widget_get_no_show_all (GtkWidget *widget) /** * gtk_widget_set_no_show_all: * @widget: a #GtkWidget - * @no_show_all: the new value for the "no-show-all" property + * @no_show_all: the new value for the “no-show-all” property * * Sets the #GtkWidget:no-show-all property, which determines whether * calls to gtk_widget_show_all() will affect this widget. @@ -14594,7 +14594,7 @@ gtk_widget_real_set_has_tooltip (GtkWidget *widget, * tooltip window will be used. * * If the custom window should have the default theming it needs to - * have the name "gtk-tooltip", see gtk_widget_set_name(). + * have the name “gtk-tooltip”, see gtk_widget_set_name(). * * Since: 2.12 */ @@ -14832,7 +14832,7 @@ gtk_widget_get_has_tooltip (GtkWidget *widget) * Retrieves the widget's allocation. * * Note, when implementing a #GtkContainer: a widget's allocation will - * be its "adjusted" allocation, that is, the widget's parent + * be its “adjusted” allocation, that is, the widget's parent * container typically calls gtk_widget_size_allocate() with an * allocation, and that allocation is then adjusted (to handle margin * and alignment for example) before assignment to the widget. @@ -14870,7 +14870,7 @@ gtk_widget_get_allocation (GtkWidget *widget, * Sets the widget's allocation. This should not be used * directly, but from within a widget's size_allocate method. * - * The allocation set should be the "adjusted" or actual + * The allocation set should be the “adjusted” or actual * allocation. If you're implementing a #GtkContainer, you want to use * gtk_widget_size_allocate() instead of gtk_widget_set_allocation(). * The GtkWidgetClass::adjust_size_allocation virtual method adjusts the @@ -16115,8 +16115,8 @@ gtk_widget_class_set_connect_func (GtkWidgetClass *widget_class, /** * gtk_widget_class_bind_template_child_full: * @widget_class: A #GtkWidgetClass - * @name: The "id" of the child defined in the template XML - * @internal_child: Whether the child should be accessible as an "internal-child" + * @name: The “id” of the child defined in the template XML + * @internal_child: Whether the child should be accessible as an “internal-child” * when this class is used in GtkBuilder XML * @struct_offset: The structure offset into the composite widget's instance public or private structure * where the automated child pointer should be set, or 0 to not assign the pointer. @@ -16169,7 +16169,7 @@ gtk_widget_class_bind_template_child_full (GtkWidgetClass *widget_class, * gtk_widget_get_template_child: * @widget: A #GtkWidget * @widget_type: The #GType to get a template child for - * @name: The "id" of the child defined in the template XML + * @name: The “id” of the child defined in the template XML * * Fetch an object build from the template XML for @widget_type in this @widget instance. * diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index b03e098a75..97bcb7363a 100644 --- a/gtk/gtkwidget.h +++ b/gtk/gtkwidget.h @@ -311,8 +311,8 @@ struct _GtkWidget * an accelerator can be activated. * @composited_changed: Signal emitted when the composited status of * widgets screen changes. See gdk_screen_is_composited(). - * @query_tooltip: Signal emitted when "has-tooltip" is %TRUE and the - * hover timeout has expired with the cursor hovering "above" + * @query_tooltip: Signal emitted when “has-tooltip” is %TRUE and the + * hover timeout has expired with the cursor hovering “above” * widget; or emitted when widget got focus in keyboard mode. * @compute_expand: Computes whether a container should give this * widget extra space when possible. diff --git a/gtk/gtkwin32embed.h b/gtk/gtkwin32embed.h index b6da80e52f..6694a6044b 100644 --- a/gtk/gtkwin32embed.h +++ b/gtk/gtkwin32embed.h @@ -31,8 +31,8 @@ G_BEGIN_DECLS * registered window messages. The name passed to * RegisterWindowMessage() is gtk-win32-embed:%d, with %d being the * numeric value of an GtkWin32EmbedMessageType enum. Each message - * carries the message type enum value and two integers, the "wparam" - * and "lparam", like all window messages. + * carries the message type enum value and two integers, the “wparam” + * and “lparam”, like all window messages. * * So far all the window messages are posted to the other * process. Maybe some later enhancement will add also messages that diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index b11c61d796..d75183704b 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -111,8 +111,8 @@ * ]| * * The GtkWindow implementation of the GtkBuildable interface - * supports setting a child as the titlebar by specifying "titlebar" as - * the "type" attribute of a `<child>` element. + * supports setting a child as the titlebar by specifying “titlebar” as + * the “type” attribute of a `<child>` element. */ #define MNEMONICS_DELAY 300 /* ms */ @@ -1825,7 +1825,7 @@ gtk_window_buildable_custom_finished (GtkBuildable *buildable, * be #GTK_WINDOW_TOPLEVEL. If you're implementing something like a * popup menu from scratch (which is a bad idea, just use #GtkMenu), * you might use #GTK_WINDOW_POPUP. #GTK_WINDOW_POPUP is not for - * dialogs, though in some other toolkits dialogs are called "popups". + * dialogs, though in some other toolkits dialogs are called “popups”. * In GTK+, #GTK_WINDOW_POPUP means a pop-up menu or pop-up tooltip. * On X11, popup windows are not controlled by the window manager. @@ -1937,8 +1937,8 @@ gtk_window_get_title (GtkWindow *window) * @wmclass_name: window name hint * @wmclass_class: window class hint * - * Don't use this function. It sets the X Window System "class" and - * "name" hints for a window. According to the ICCCM, you should + * Don't use this function. It sets the X Window System “class” and + * “name” hints for a window. According to the ICCCM, you should * always set these to the same value for all windows in an * application, and GTK+ sets them to that value by default, so calling * this function is sort of pointless. However, you may want to call @@ -1978,7 +1978,7 @@ gtk_window_set_wmclass (GtkWindow *window, * In combination with the window title, the window role allows a * window manager to identify "the * same" window when an application is restarted. So for example you - * might set the "toolbox" role on your app's toolbox window, so that + * might set the “toolbox” role on your app's toolbox window, so that * when the user restarts their session, the window manager can put * the toolbox back in the same place. * @@ -4665,7 +4665,7 @@ gtk_window_set_default_size_internal (GtkWindow *window, * @width: width in pixels, or -1 to unset the default width * @height: height in pixels, or -1 to unset the default height * - * Sets the default size of a window. If the window's "natural" size + * Sets the default size of a window. If the window's “natural” size * (its size request) is larger than the default, the default will be * ignored. More generally, if the default size does not obey the * geometry hints for the window (gtk_window_set_geometry_hints() can @@ -4677,7 +4677,7 @@ gtk_window_set_default_size_internal (GtkWindow *window, * function only sets the initial size, just as if the user had * resized the window themselves. Users can still shrink the window * again as they normally would. Setting a default size of -1 means to - * use the "natural" default size (the size request of the window). + * use the “natural” default size (the size request of the window). * * For more control over a window's initial size and how resizing works, * investigate gtk_window_set_geometry_hints(). @@ -4738,7 +4738,7 @@ gtk_window_set_default_geometry (GtkWindow *window, * * Gets the default size of the window. A value of -1 for the width or * height indicates that a default size has not been explicitly set - * for that dimension, so the "natural" size of the window will be + * for that dimension, so the “natural” size of the window will be * used. * **/ @@ -4855,7 +4855,7 @@ gtk_window_resize_to_geometry (GtkWindow *window, * because the size of the window may change between the time that you * get the size and the time that you perform some action assuming * that size is the current size. To avoid race conditions, connect to - * "configure-event" on the window and adjust your size-dependent + * “configure-event” on the window and adjust your size-dependent * state to match the size delivered in the #GdkEventConfigure. * * Note 2: The returned size does not include the @@ -4954,7 +4954,7 @@ gtk_window_get_size (GtkWindow *window, * example does not take multi-head scenarios into account). * * The [Extended Window Manager Hints Specification](http://www.freedesktop.org/Standards/wm-spec) - * has a nice table of gravities in the "implementation notes" section. + * has a nice table of gravities in the “implementation notes” section. * * The gtk_window_get_position() documentation may also be relevant. */ @@ -5038,7 +5038,7 @@ gtk_window_move (GtkWindow *window, * gtk_window_get_position() is not 100% reliable because the X Window System * does not specify a way to obtain the geometry of the * decorations placed on a window by the window manager. - * Thus GTK+ is using a "best guess" that works with most + * Thus GTK+ is using a “best guess” that works with most * window managers. * * Moreover, nearly all window managers are historically broken with @@ -5058,7 +5058,7 @@ gtk_window_move (GtkWindow *window, * do this without getting it somewhat wrong because applications do * not have sufficient knowledge of window manager state. The Correct * Mechanism is to support the session management protocol (see the - * "GnomeClient" object in the GNOME libraries for example) and allow + * “GnomeClient” object in the GNOME libraries for example) and allow * the window manager to save your window sizes and positions. * **/ @@ -10018,7 +10018,7 @@ gtk_window_present_with_time (GtkWindow *window, * in which case the window will be iconified before it ever appears * onscreen. * - * You can track iconification via the "window-state-event" signal + * You can track iconification via the “window-state-event” signal * on #GtkWidget. * **/ @@ -10052,7 +10052,7 @@ gtk_window_iconify (GtkWindow *window) * linkend="gtk-X11-arch">window manager) could iconify it * again before your code which assumes deiconification gets to run. * - * You can track iconification via the "window-state-event" signal + * You can track iconification via the “window-state-event” signal * on #GtkWidget. **/ void @@ -10089,7 +10089,7 @@ gtk_window_deiconify (GtkWindow *window) * * It's permitted to call this function before showing a window. * - * You can track stickiness via the "window-state-event" signal + * You can track stickiness via the “window-state-event” signal * on #GtkWidget. * **/ @@ -10124,7 +10124,7 @@ gtk_window_stick (GtkWindow *window) * manager) could stick it again. But normally the window will * end up stuck. Just don't write code that crashes if not. * - * You can track stickiness via the "window-state-event" signal + * You can track stickiness via the “window-state-event” signal * on #GtkWidget. * **/ @@ -10164,7 +10164,7 @@ gtk_window_unstick (GtkWindow *window) * in which case the window will be maximized when it appears onscreen * initially. * - * You can track maximization via the "window-state-event" signal + * You can track maximization via the “window-state-event” signal * on #GtkWidget, or by listening to notifications on the * #GtkWindow:is-maximized property. * @@ -10200,7 +10200,7 @@ gtk_window_maximize (GtkWindow *window) * managers honor requests to unmaximize. But normally the window will * end up unmaximized. Just don't write code that crashes if not. * - * You can track maximization via the "window-state-event" signal + * You can track maximization via the “window-state-event” signal * on #GtkWidget. * **/ @@ -10236,7 +10236,7 @@ gtk_window_unmaximize (GtkWindow *window) * windows. But normally the window will end up fullscreen. Just * don't write code that crashes if not. * - * You can track the fullscreen state via the "window-state-event" signal + * You can track the fullscreen state via the “window-state-event” signal * on #GtkWidget. * * Since: 2.2 @@ -10273,7 +10273,7 @@ gtk_window_fullscreen (GtkWindow *window) * windows. But normally the window will end up restored to its normal * state. Just don't write code that crashes if not. * - * You can track the fullscreen state via the "window-state-event" signal + * You can track the fullscreen state via the “window-state-event” signal * on #GtkWidget. * * Since: 2.2 @@ -10315,7 +10315,7 @@ gtk_window_unfullscreen (GtkWindow *window) * in which case the window will be kept above when it appears onscreen * initially. * - * You can track the above state via the "window-state-event" signal + * You can track the above state via the “window-state-event” signal * on #GtkWidget. * * Note that, according to the @@ -10366,7 +10366,7 @@ gtk_window_set_keep_above (GtkWindow *window, * in which case the window will be kept below when it appears onscreen * initially. * - * You can track the below state via the "window-state-event" signal + * You can track the below state via the “window-state-event” signal * on #GtkWidget. * * Note that, according to the @@ -10459,7 +10459,7 @@ gtk_window_get_resizable (GtkWindow *window) * more details. * * The default window gravity is #GDK_GRAVITY_NORTH_WEST which will - * typically "do what you mean." + * typically “do what you mean.” * **/ void @@ -11198,7 +11198,7 @@ _gtk_window_group_widget_is_blocked_for_device (GtkWindowGroup *window_group, * XParseGeometry parses strings of the form * "=x{+-}{+-}", where * width, height, xoffset, and yoffset are unsigned integers. - * Example: "=80x24+300-49" + * Example: “=80x24+300-49” * The equal sign is optional. * It returns a bitmask that indicates which of the four values * were actually found in the string. For each value found, @@ -11373,7 +11373,7 @@ gtk_XParseGeometry (const char *string, * managers to honor the geometry. * * Note that for gtk_window_parse_geometry() to work as expected, it has - * to be called when the window has its "final" size, i.e. after calling + * to be called when the window has its “final” size, i.e. after calling * gtk_widget_show_all() on the contents and gtk_window_set_geometry_hints() * on the window. * |[