docs: use proper quotations instead of '*'

52 files changed, 101 insertions, 101 deletions

diff --git a/gtk/deprecated/gtkcolorsel.c b/gtk/deprecated/gtkcolorsel.c
index df4e3f2844..7a0206807a 100644
--- a/gtk/deprecated/gtkcolorsel.c
+++ b/gtk/deprecated/gtkcolorsel.c
@@ -2630,7 +2630,7 @@ gtk_color_selection_get_current_alpha (GtkColorSelection *colorsel)
  * @colorsel: a #GtkColorSelection
  * @color: a #GdkColor to set the previous color with
  *
- * Sets the 'previous' color to be @color.
+ * Sets the “previous” color to be @color.
  *
  * This function should be called with some hesitations,
  * as it might seem confusing to have that color change.
@@ -2669,7 +2669,7 @@ gtk_color_selection_set_previous_color (GtkColorSelection *colorsel,
  * @colorsel: a #GtkColorSelection
  * @alpha: an integer between 0 and 65535
  *
- * Sets the 'previous' alpha to be @alpha.
+ * Sets the “previous” alpha to be @alpha.
  *
  * This function should be called with some hesitations,
  * as it might seem confusing to have that alpha change.
@@ -2811,7 +2811,7 @@ gtk_color_selection_get_current_rgba (GtkColorSelection *colorsel,
  * @colorsel: a #GtkColorSelection
  * @rgba: a #GdkRGBA to set the previous color with
  *
- * Sets the 'previous' color to be @rgba.
+ * Sets the “previous” color to be @rgba.
  *
  * This function should be called with some hesitations,
  * as it might seem confusing to have that color change.
diff --git a/gtk/deprecated/gtkfontsel.c b/gtk/deprecated/gtkfontsel.c
index 82a95d2f41..83e520ca34 100644
--- a/gtk/deprecated/gtkfontsel.c
+++ b/gtk/deprecated/gtkfontsel.c
@@ -1206,7 +1206,7 @@ gtk_font_selection_update_preview (GtkFontSelection *fontsel)
  * @fontsel: a #GtkFontSelection
  *
  * This returns the #GtkTreeView that lists font families, for
- * example, 'Sans', 'Serif', etc.
+ * example, “Sans”, “Serif”, etc.
  *
  * Return value: (transfer none): A #GtkWidget that is part of @fontsel
  *
@@ -1227,7 +1227,7 @@ gtk_font_selection_get_family_list (GtkFontSelection *fontsel)
  * @fontsel: a #GtkFontSelection
  *
  * This returns the #GtkTreeView which lists all styles available for
- * the selected font. For example, 'Regular', 'Bold', etc.
+ * the selected font. For example, “Regular”, “Bold”, etc.
  * 
  * Return value: (transfer none): A #GtkWidget that is part of @fontsel
  *
@@ -1759,10 +1759,10 @@ gtk_font_selection_dialog_get_font_selection (GtkFontSelectionDialog *fsd)
  * gtk_font_selection_dialog_get_ok_button:
  * @fsd: a #GtkFontSelectionDialog
  *
- * Gets the 'OK' button.
+ * Gets the “OK” button.
  *
  * Return value: (transfer none): the #GtkWidget used in the dialog
- *     for the 'OK' button.
+ *     for the “OK” button.
  *
  * Since: 2.14
  *
@@ -1780,10 +1780,10 @@ gtk_font_selection_dialog_get_ok_button (GtkFontSelectionDialog *fsd)
  * gtk_font_selection_dialog_get_cancel_button:
  * @fsd: a #GtkFontSelectionDialog
  *
- * Gets the 'Cancel' button.
+ * Gets the “Cancel” button.
  *
  * Return value: (transfer none): the #GtkWidget used in the dialog
- *     for the 'Cancel' button.
+ *     for the “Cancel” button.
  *
  * Since: 2.14
  *
diff --git a/gtk/deprecated/gtkhbbox.c b/gtk/deprecated/gtkhbbox.c
index 054e7b49a5..9d119fedb3 100644
--- a/gtk/deprecated/gtkhbbox.c
+++ b/gtk/deprecated/gtkhbbox.c
@@ -38,7 +38,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  *
  * A button box should be used to provide a consistent layout of buttons
  * throughout your application. The layout/spacing can be altered by the
- * programmer, or if desired, by the user to alter the 'feel' of a
+ * programmer, or if desired, by the user to alter the “feel” of a
  * program to a small degree.
  *
  * A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are
diff --git a/gtk/deprecated/gtkhsv.c b/gtk/deprecated/gtkhsv.c
index 7f164d4e63..fa5a9b7b59 100644
--- a/gtk/deprecated/gtkhsv.c
+++ b/gtk/deprecated/gtkhsv.c
@@ -44,11 +44,11 @@
 
 /**
  * SECTION:gtkhsv
- * @Short_description: A 'color wheel' widget
+ * @Short_description: A “color wheel” widget
  * @Title: GtkHSV
  * @See_also: #GtkColorSelection, #GtkColorSelectionDialog
  *
- * #GtkHSV is the 'color wheel' part of a complete color selector widget.
+ * #GtkHSV is the “color wheel” part of a complete color selector widget.
  * It allows to select a color by determining its HSV components in an
  * intuitive way. Moving the selection around the outer ring changes the hue,
  * and moving the selection point inside the inner triangle changes value and
diff --git a/gtk/deprecated/gtkrc.c b/gtk/deprecated/gtkrc.c
index 169b59943c..a920d2ee9b 100644
--- a/gtk/deprecated/gtkrc.c
+++ b/gtk/deprecated/gtkrc.c
@@ -249,8 +249,8 @@
  * # Toplevel declarations #
  *
  * An RC file is a text file which is composed of a sequence
- * of declarations. `'#'` characters delimit comments and
- * the portion of a line after a `'#'` is ignored when parsing
+ * of declarations. `“#”` characters delimit comments and
+ * the portion of a line after a `“#”` is ignored when parsing
  * an RC file.
  *
  * The possible toplevel declarations are:
diff --git a/gtk/deprecated/gtktable.c b/gtk/deprecated/gtktable.c
index 4af47c49ed..23b98bdaa2 100644
--- a/gtk/deprecated/gtktable.c
+++ b/gtk/deprecated/gtktable.c
@@ -721,7 +721,7 @@ gtk_table_resize (GtkTable *table,
  * @xpadding: An integer value specifying the padding on the left and right of the widget being added to the table.
  * @ypadding: The amount of padding above and below the child widget.
  *
- * Adds a widget to a table. The number of 'cells' that a widget will occupy is
+ * Adds a widget to a table. The number of “cells” that a widget will occupy is
  * specified by @left_attach, @right_attach, @top_attach and @bottom_attach.
  * These each represent the leftmost, rightmost, uppermost and lowest column
  * and row numbers of the table. (Columns and rows are indexed from zero).
diff --git a/gtk/deprecated/gtkuimanager.c b/gtk/deprecated/gtkuimanager.c
index 1df9bb9922..69f89e3270 100644
--- a/gtk/deprecated/gtkuimanager.c
+++ b/gtk/deprecated/gtkuimanager.c
@@ -113,9 +113,9 @@
  *
  * If a name is not specified, it defaults to the action. If an action is
  * not specified either, the element name is used. The name and action
- * attributes must not contain '/' characters after parsing (since that
+ * attributes must not contain “/” characters after parsing (since that
  * would mess up path lookup) and must be usable as XML attributes when
- * enclosed in doublequotes, thus they must not '"' characters or references
+ * enclosed in doublequotes, thus they must not “"” characters or references
  * to the " entity.
  *
  * # A UI definition #
@@ -1092,7 +1092,7 @@ gtk_ui_manager_get_accel_group (GtkUIManager *manager)
  * 
  * Looks up a widget by following a path. 
  * The path consists of the names specified in the XML description of the UI. 
- * separated by '/'. Elements which don’t have a name or action attribute in 
+ * separated by “/”. Elements which don’t have a name or action attribute in 
  * the XML (e.g. <popup>) can be addressed by their XML element name 
  * (e.g. "popup"). The root element ("/ui") can be omitted in the path.
  *
diff --git a/gtk/deprecated/gtkvbbox.c b/gtk/deprecated/gtkvbbox.c
index 9253746c65..320f84778e 100644
--- a/gtk/deprecated/gtkvbbox.c
+++ b/gtk/deprecated/gtkvbbox.c
@@ -38,7 +38,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  *
  * A button box should be used to provide a consistent layout of buttons
  * throughout your application. The layout/spacing can be altered by the
- * programmer, or if desired, by the user to alter the 'feel' of a
+ * programmer, or if desired, by the user to alter the “feel” of a
  * program to a small degree.
  *
  * A #GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons are
diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c
index 736b7b7e59..19b72777ee 100644
--- a/gtk/gtkaboutdialog.c
+++ b/gtk/gtkaboutdialog.c
@@ -94,7 +94,7 @@
  *
  * It is also possible to show a #GtkAboutDialog like any other #GtkDialog,
  * e.g. using gtk_dialog_run(). In this case, you might need to know that
- * the 'Close' button returns the #GTK_RESPONSE_CANCEL response id.
+ * the “Close” button returns the #GTK_RESPONSE_CANCEL response id.
  */
 
 /* Translators: this is the license preamble; the string at the end
diff --git a/gtk/gtkactionmuxer.c b/gtk/gtkactionmuxer.c
index de675ed1cf..2e48d6c28b 100644
--- a/gtk/gtkactionmuxer.c
+++ b/gtk/gtkactionmuxer.c
@@ -37,9 +37,9 @@
  * particular context into a single action group, with namespacing.
  *
  * Consider the case of two action groups -- one containing actions
- * applicable to an entire application (such as 'quit') and one
+ * applicable to an entire application (such as “quit”) and one
  * containing actions applicable to a particular window in the
- * application (such as 'fullscreen').
+ * application (such as “fullscreen”).
  *
  * In this case, each of these action groups could be added to a
  * #GtkActionMuxer with the prefixes “app” and “win”, respectively.  This
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index a0451e9adb..8fb80307ff 100644
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -67,7 +67,7 @@
  * actions invoked in a predictable context it is therefore recommended
  * that the GDK lock be held while invoking actions locally with
  * g_action_group_activate_action().  The same applies to actions
- * associated with #GtkApplicationWindow and to the 'activate' and
+ * associated with #GtkApplicationWindow and to the “activate” and
  * 'open' #GApplication methods.
  *
  * To set an application menu for a GtkApplication, use
@@ -1082,7 +1082,7 @@ gtk_application_update_accels (GtkApplication *application)
  * are referred to with an “app.” prefix, and window-specific actions
  * with a “win.” prefix.
  *
- * GtkApplication also extracts accelerators out of 'accel' attributes
+ * GtkApplication also extracts accelerators out of “accel” attributes
  * in the #GMenuModels passed to gtk_application_set_app_menu() and
  * gtk_application_set_menubar(), which is usually more convenient
  * than calling this function for each accelerator.
diff --git a/gtk/gtkbbox.c b/gtk/gtkbbox.c
index 1d60ab5423..fafcea74ca 100644
--- a/gtk/gtkbbox.c
+++ b/gtk/gtkbbox.c
@@ -29,7 +29,7 @@
  *
  * A button box should be used to provide a consistent layout of buttons
  * throughout your application. The layout/spacing can be altered by the
- * programmer, or if desired, by the user to alter the 'feel' of a
+ * programmer, or if desired, by the user to alter the “feel” of a
  * program to a small degree.
  *
  * gtk_button_box_get_layout() and gtk_button_box_set_layout() retrieve and
diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c
index 6b0da96c53..18a17f52e0 100644
--- a/gtk/gtkbindings.c
+++ b/gtk/gtkbindings.c
@@ -49,7 +49,7 @@
  *
  * # Installing a key binding
  *
- * A CSS file binding consists of a 'binding-set' definition and a match
+ * A CSS file binding consists of a “binding-set” definition and a match
  * statement to apply the binding set to specific widget types. Details
  * on the matching mechanism are described under
  * [Selectors][gtkcssprovider-selectors]
diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index c05a98532d..8cfdf39ad3 100644
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -1375,7 +1375,7 @@ gtk_button_new_from_stock (const gchar *stock_id)
  *
  * Creates a new #GtkButton containing a label.
  * If characters in @label are preceded by an underscore, they are underlined.
- * If you need a literal underscore character in a label, use '__' (two
+ * If you need a literal underscore character in a label, use “__” (two
  * underscores). The first underlined character represents a keyboard
  * accelerator called a mnemonic.
  * Pressing Alt and that key activates the button.
diff --git a/gtk/gtkcairoblur.c b/gtk/gtkcairoblur.c
index df989898b2..b38a3e8980 100644
--- a/gtk/gtkcairoblur.c
+++ b/gtk/gtkcairoblur.c
@@ -165,8 +165,8 @@ _blurcol (guchar* pixels,
  * @aprec: precision of alpha parameter in fixed-point format 0.aprec
  * @zprec: precision of state parameters zR,zG,zB and zA in fp format 8.zprec
  *
- * Performs an in-place blur of image data 'pixels'
- * with kernel of approximate radius 'radius'.
+ * Performs an in-place blur of image data “pixels”
+ * with kernel of approximate radius “radius”.
  *
  * Blurs with two sided exponential impulse response.
  *
diff --git a/gtk/gtkcellrenderer.c b/gtk/gtkcellrenderer.c
index 1b542bb8ba..5c21cb6a11 100644
--- a/gtk/gtkcellrenderer.c
+++ b/gtk/gtkcellrenderer.c
@@ -1394,7 +1394,7 @@ gtk_cell_renderer_real_get_aligned_area (GtkCellRenderer         *cell,
  * cell alignment in a target allocation (used to draw focus and align
  * cells in the icon view).
  *
- * Note this is only a trivial 'align * (allocation - request)' operation.
+ * Note this is only a trivial “align * (allocation - request)” operation.
  */
 void
 _gtk_cell_renderer_calc_offset    (GtkCellRenderer      *cell,
diff --git a/gtk/gtkcombobox.c b/gtk/gtkcombobox.c
index 9f4198b195..c0c7718809 100644
--- a/gtk/gtkcombobox.c
+++ b/gtk/gtkcombobox.c
@@ -80,7 +80,7 @@
  * not restricted to a flat list, it can be a real tree, and the popup will
  * reflect the tree structure.
  *
- * To allow the user to enter values not in the model, the 'has-entry'
+ * To allow the user to enter values not in the model, the “has-entry”
  * property allows the GtkComboBox to contain a #GtkEntry. This entry
  * can be accessed by calling gtk_bin_get_child() on the combo box.
  *
diff --git a/gtk/gtkcomboboxtext.c b/gtk/gtkcomboboxtext.c
index 1e0c141094..f3d120b7d6 100644
--- a/gtk/gtkcomboboxtext.c
+++ b/gtk/gtkcomboboxtext.c
@@ -44,7 +44,7 @@
  * or gtk_combo_box_text_prepend_text() and remove options with
  * gtk_combo_box_text_remove().
  *
- * If the GtkComboBoxText contains an entry (via the 'has-entry' property),
+ * If the GtkComboBoxText contains an entry (via the “has-entry” property),
  * its contents can be retrieved using gtk_combo_box_text_get_active_text().
  * The entry itself can be accessed by calling gtk_bin_get_child() on the
  * combo box.
diff --git a/gtk/gtkcsscustomproperty.c b/gtk/gtkcsscustomproperty.c
index 92802e17d5..457e1f8f25 100644
--- a/gtk/gtkcsscustomproperty.c
+++ b/gtk/gtkcsscustomproperty.c
@@ -185,7 +185,7 @@ gtk_css_custom_property_create_initial_value (GParamSpec *pspec)
  * be the theme engine name.
  *
  * For any type a @parse_func may be provided, being this function
- * used for turning any property value (between ':' and ';') in
+ * used for turning any property value (between “:” and “;”) in
  * CSS to the #GValue needed. For basic types there is already
  * builtin parsing support, so %NULL may be provided for these
  * cases.
diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c
index abf6e6a9ae..a26ae73893 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -74,7 +74,7 @@
  * # Style sheets
  *
  * The basic structure of the style sheets understood by this provider is
- * a series of statements, which are either rule sets or '@-rules', separated
+ * a series of statements, which are either rule sets or “@-rules”, separated
  * by whitespace.
  *
  * A rule set consists of a selector and a declaration block, which is
@@ -96,7 +96,7 @@
  * Selectors work very similar to the way they do in CSS, with widget class
  * names taking the role of element names, and widget names taking the role
  * of IDs. When used in a selector, widget names must be prefixed with a
- * '#' character. The '*' character represents the so-called universal
+ * '#' character. The “*” character represents the so-called universal
  * selector, which matches any widget.
  *
  * To express more complicated situations, selectors can be combined in
@@ -111,7 +111,7 @@
  *   that occur inside a GtkToolBar.
  * - In the previous example, the GtkButton is matched even
  *   if it occurs deeply nested inside the toolbar. To restrict the match
- *   to direct children of the parent widget, insert a '>' character between
+ *   to direct children of the parent widget, insert a “>” character between
  *   the two selectors. E.g. `GtkNotebook > GtkLabel` matches
  *   GtkLabel widgets that are direct children of a GtkNotebook.
  *
@@ -153,7 +153,7 @@
  * ]|
  *
  * Widgets may also define style classes, which can be used for matching.
- * When used in a selector, style classes must be prefixed with a '.'
+ * When used in a selector, style classes must be prefixed with a “.”
  * character.
  *
  * Refer to the documentation of individual widgets to learn which
@@ -425,12 +425,12 @@
  *               color-stop (@position, @color),
  *               ...)</literallayout>
  * where @start_x and @end_x can be either a floating point number between
- * 0 and 1 or one of the special values 'left', 'right' or 'center', @start_y
+ * 0 and 1 or one of the special values “left”, “right” or “center”, @start_y
  * and @end_y can be either a floating point number between 0 and 1 or one
- * of the special values 'top', 'bottom' or 'center', @position is a floating
+ * of the special values “top”, “bottom” or “center”, @position is a floating
  * point number between 0 and 1 and @color is a color expression (see above).
  * The color-stop can be repeated multiple times to add more than one color
- * stop. 'from (@color)' and 'to (@color)' can be used as abbreviations for
+ * stop. “from (@color)” and “to (@color)” can be used as abbreviations for
  * color stops with position 0 and 1, respectively.
  *
  * An example for a linear gradient:
@@ -558,12 +558,12 @@
  * outlined by border-width.
  * The default (stretch) is to resize the slice to fill in the whole 
  * allocated area.
- * If the value of this property is 'repeat', the image slice
+ * If the value of this property is “repeat”, the image slice
  * will be tiled to fill the area.
- * If the value of this property is 'round', the image slice will
+ * If the value of this property is “round”, the image slice will
  * be tiled to fill the area, and scaled to fit it exactly
  * a whole number of times.
- * If the value of this property is 'space', the image slice will
+ * If the value of this property is “space”, the image slice will
  * be tiled to fill the area, and if it doesn’t fit it exactly a whole
  * number of times, the extra space is distributed as padding around 
  * the slices.
@@ -803,7 +803,7 @@
  *                center center, 0.8,
  *                color-stop (0.0, &num;fff),
  *                color-stop (1.0, &num;000));
- * url ('background.png');</literallayout>
+ * url ("background.png");</literallayout>
  *         </entry>
  *       </row>
  *       <row>
diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c
index 5756cd1619..e1df310903 100644
--- a/gtk/gtkdialog.c
+++ b/gtk/gtkdialog.c
@@ -66,11 +66,11 @@
  * recommended; it allows you to set the dialog title, some convenient
  * flags, and add simple buttons.
  *
- * If 'dialog' is a newly created dialog, the two primary areas of the
+ * If “dialog” is a newly created dialog, the two primary areas of the
  * window can be accessed through gtk_dialog_get_content_area() and
  * gtk_dialog_get_action_area(), as can be seen from the example below.
  *
- * A 'modal' dialog (that is, one which freezes the rest of the application
+ * A “modal” dialog (that is, one which freezes the rest of the application
  * from user input), can be created by calling gtk_window_set_modal() on the
  * dialog. Use the GTK_WINDOW() macro to cast the widget returned from
  * gtk_dialog_new() into a #GtkWindow. When using gtk_dialog_new_with_buttons()
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 6c364a611e..1e2e7a347e 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -83,7 +83,7 @@
  *
  * When using an entry for passwords and other sensitive information,
  * it can be put into “password mode” using gtk_entry_set_visibility().
- * In this mode, entered text is displayed using a 'invisible' character.
+ * In this mode, entered text is displayed using a “invisible” character.
  * By default, GTK+ picks the best invisible character that is available
  * in the current font, but it can be changed with
  * gtk_entry_set_invisible_char(). Since 2.16, GTK+ displays a warning
diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index cc1ad3df86..6cba7d345e 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -1207,10 +1207,10 @@ G_END_DECLS
  * The difference between @GTK_INPUT_PURPOSE_DIGITS and
  * @GTK_INPUT_PURPOSE_NUMBER is that the former accepts only digits
  * while the latter also some punctuation (like commas or points, plus,
- * minus) and 'e' or 'E' as in 3.14E+000.
+ * minus) and “e” or “E” as in 3.14E+000.
  *
  * This enumeration may be extended in the future; input methods should
- * interpret unknown values as 'free form'.
+ * interpret unknown values as “free form”.
  *
  * Since: 3.6
  */
diff --git a/gtk/gtkexpander.c b/gtk/gtkexpander.c
index a9bc69ab9a..3240559e79 100644
--- a/gtk/gtkexpander.c
+++ b/gtk/gtkexpander.c
@@ -1648,7 +1648,7 @@ gtk_expander_new (const gchar *label)
  *
  * Creates a new expander using @label as the text of the label.
  * If characters in @label are preceded by an underscore, they are underlined.
- * If you need a literal underscore character in a label, use '__' (two
+ * If you need a literal underscore character in a label, use “__” (two
  * underscores). The first underlined character represents a keyboard
  * accelerator called a mnemonic.
  * Pressing Alt and that key activates the button.
diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c
index d8f3ad195f..947c3d9c0d 100644
--- a/gtk/gtkfilechooserwidget.c
+++ b/gtk/gtkfilechooserwidget.c
@@ -1152,7 +1152,7 @@ key_is_left_or_right (GdkEventKey *event)
 }
 
 /* Handles key press events on the file list, so that we can trap Enter to
- * activate the default button on our own.  Also, checks to see if '/' has been
+ * activate the default button on our own.  Also, checks to see if “/” has been
  * pressed.
  */
 static gboolean
diff --git a/gtk/gtkgrid.c b/gtk/gtkgrid.c
index 14e7dd6de6..7cac6f870f 100644
--- a/gtk/gtkgrid.c
+++ b/gtk/gtkgrid.c
@@ -1823,7 +1823,7 @@ gtk_grid_new (void)
  * Adds a widget to the grid.
  *
  * The position of @child is determined by @left and @top. The
- * number of 'cells' that @child will occupy is determined by
+ * number of “cells” that @child will occupy is determined by
  * @width and @height.
  */
 void
diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 05a1ef09d8..4b0ee84a9c 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -4317,7 +4317,7 @@ _gtk_icon_info_load_symbolic_internal (GtkIconInfo  *icon_info,
  *
  * As implementation details, the icon loaded needs to be of SVG type,
  * contain the “symbolic” term as the last component of the icon name,
- * and use the 'fg', 'success', 'warning' and 'error' CSS styles in the
+ * and use the “fg”, “success”, “warning” and “error” CSS styles in the
  * SVG file itself.
  *
  * See the [Symbolic Icons Specification](http://www.freedesktop.org/wiki/SymbolicIcons)
@@ -4853,7 +4853,7 @@ gtk_icon_info_load_symbolic_for_style (GtkIconInfo   *icon_info,
  * icons, they are in a 1000x1000 coordinate space that is scaled
  * to the final size of the icon.  You can determine if the icon is an SVG
  * icon by using gtk_icon_info_get_filename(), and seeing if it is non-%NULL
- * and ends in '.svg'.
+ * and ends in “.svg”.
  *
  * This function is provided primarily to allow compatibility wrappers
  * for older API's, and is not expected to be useful for applications.
diff --git a/gtk/gtkimmodule.c b/gtk/gtkimmodule.c
index a8af400827..329546e13c 100644
--- a/gtk/gtkimmodule.c
+++ b/gtk/gtkimmodule.c
@@ -639,10 +639,10 @@ _gtk_im_module_create (const gchar *context_id)
 
 /* Match @locale against @against.
  * 
- * 'en_US' against 'en_US'       => 4
- * 'en_US' against 'en'          => 3
- * 'en', 'en_UK' against 'en_US' => 2
- *  all locales, against '*' 	 => 1
+ * 'en_US' against “en_US”       => 4
+ * 'en_US' against “en”          => 3
+ * 'en', “en_UK” against “en_US” => 2
+ *  all locales, against “*” 	 => 1
  */
 static gint
 match_locale (const gchar *locale,
diff --git a/gtk/gtkinfobar.c b/gtk/gtkinfobar.c
index 3beffdc9c7..fe3bb3f237 100644
--- a/gtk/gtkinfobar.c
+++ b/gtk/gtkinfobar.c
@@ -955,7 +955,7 @@ gtk_info_bar_set_default_response (GtkInfoBar *info_bar,
  * @info_bar: a #GtkInfoBar
  * @response_id: a response ID
  *
- * Emits the 'response' signal with the given @response_id.
+ * Emits the “response” signal with the given @response_id.
  *
  * Since: 2.18
  */
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index 4e896bd1e7..4b2a72d443 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -254,7 +254,7 @@ struct _GtkLabelPrivate
  * There are some new fields for links. The links field contains the list
  * of GtkLabelLink structs that describe the links which are embedded in
  * the label. The active_link field points to the link under the mouse
- * pointer. For keyboard navigation, the 'focus' link is determined by
+ * pointer. For keyboard navigation, the “focus” link is determined by
  * finding the link which contains the selection_anchor position.
  * The link_clicked field is used with button press and release events
  * to ensure that pressing inside a link and releasing outside of it
diff --git a/gtk/gtklinkbutton.c b/gtk/gtklinkbutton.c
index 4abcb255ab..44d7ce2a70 100644
--- a/gtk/gtklinkbutton.c
+++ b/gtk/gtklinkbutton.c
@@ -679,7 +679,7 @@ gtk_link_button_query_tooltip_cb (GtkWidget    *widget,
  * @uri: a valid URI
  *
  * Sets @uri as the URI where the #GtkLinkButton points. As a side-effect
- * this unsets the 'visited' state of the button.
+ * this unsets the “visited” state of the button.
  *
  * Since: 2.10
  */
@@ -724,9 +724,9 @@ gtk_link_button_get_uri (GtkLinkButton *link_button)
 /**
  * gtk_link_button_set_visited:
  * @link_button: a #GtkLinkButton
- * @visited: the new 'visited' state
+ * @visited: the new “visited” state
  *
- * Sets the 'visited' state of the URI where the #GtkLinkButton
+ * Sets the “visited” state of the URI where the #GtkLinkButton
  * points.  See gtk_link_button_get_visited() for more details.
  *
  * Since: 2.14
@@ -762,9 +762,9 @@ gtk_link_button_set_visited (GtkLinkButton *link_button,
  * gtk_link_button_get_visited:
  * @link_button: a #GtkLinkButton
  *
- * Retrieves the 'visited' state of the URI where the #GtkLinkButton
+ * Retrieves the “visited” state of the URI where the #GtkLinkButton
  * points. The button becomes visited when it is clicked. If the URI
- * is changed on the button, the 'visited' state is unset again.
+ * is changed on the button, the “visited” state is unset again.
  *
  * The state may also be changed using gtk_link_button_set_visited().
  *
diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c
index 82cde83638..72e736b613 100644
--- a/gtk/gtkmenu.c
+++ b/gtk/gtkmenu.c
@@ -5075,7 +5075,7 @@ gtk_menu_set_screen (GtkMenu   *menu,
  * @top_attach: The row number to attach the top of the item to
  * @bottom_attach: The row number to attach the bottom of the item to
  *
- * Adds a new #GtkMenuItem to a (table) menu. The number of 'cells' that
+ * Adds a new #GtkMenuItem to a (table) menu. The number of “cells” that
  * an item will occupy is specified by @left_attach, @right_attach,
  * @top_attach and @bottom_attach. These each represent the leftmost,
  * rightmost, uppermost and lower column and row numbers of the table.
diff --git a/gtk/gtkmenubutton.c b/gtk/gtkmenubutton.c
index 21a429988f..dbce31b631 100644
--- a/gtk/gtkmenubutton.c
+++ b/gtk/gtkmenubutton.c
@@ -38,7 +38,7 @@
  * text direction) of the menu aligned with the starting edge of the button.
  * If there is not enough space below the button, the menu is popped up above
  * the button instead. If the alignment would move part of the menu offscreen,
- * it is 'pushed in'.
+ * it is “pushed in”.
  *
  * ## Direction = Down
  *
diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c
index 7b2e155974..48a00ea42f 100644
--- a/gtk/gtkmenushell.c
+++ b/gtk/gtkmenushell.c
@@ -1549,7 +1549,7 @@ gtk_menu_shell_select_submenu_first (GtkMenuShell *menu_shell)
  * menubars working, if submenu_placement is different for
  * the menu and its MenuShell then the following apply:
  *
- * - For 'parent' the current menu is not just moved to
+ * - For “parent” the current menu is not just moved to
  *   the parent, but moved to the previous entry in the parent
  * - For 'child', if there is no child, then current is
  *   moved to the next item in the parent.
diff --git a/gtk/gtkmenutracker.c b/gtk/gtkmenutracker.c
index 2e650fba32..86ee9fca5d 100644
--- a/gtk/gtkmenutracker.c
+++ b/gtk/gtkmenutracker.c
@@ -146,7 +146,7 @@ gtk_menu_tracker_section_find_model (GtkMenuTrackerSection *section,
  *    before us (ie: we should add a separator if we have content in
  *    order to divide us from the items above)
  *
- *  - if we had a 'label' attribute set for this section
+ *  - if we had a “label” attribute set for this section
  *
  * parent_model and parent_index are passed in so that we can give them
  * to the insertion callback so that it can see the label (and anything
diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c
index a63ea90b2e..bf3c20e972 100644
--- a/gtk/gtknotebook.c
+++ b/gtk/gtknotebook.c
@@ -6953,7 +6953,7 @@ gtk_notebook_menu_detacher (GtkWidget *widget,
  * @notebook: a #GtkNotebook
  * @child: the #GtkWidget to use as the contents of the page
  * @tab_label: (allow-none): the #GtkWidget to be used as the label
- *     for the page, or %NULL to use the default label, 'page N'
+ *     for the page, or %NULL to use the default label, “page N”
  *
  * Appends a page to @notebook.
  *
@@ -6977,7 +6977,7 @@ gtk_notebook_append_page (GtkNotebook *notebook,
  * @notebook: a #GtkNotebook
  * @child: the #GtkWidget to use as the contents of the page
  * @tab_label: (allow-none): the #GtkWidget to be used as the label
- *     for the page, or %NULL to use the default label, 'page N'
+ *     for the page, or %NULL to use the default label, “page N”
  * @menu_label: (allow-none): the widget to use as a label for the
  *     page-switch menu, if that is enabled. If %NULL, and @tab_label
  *     is a #GtkLabel or %NULL, then the menu label will be a newly
@@ -7010,7 +7010,7 @@ gtk_notebook_append_page_menu (GtkNotebook *notebook,
  * @notebook: a #GtkNotebook
  * @child: the #GtkWidget to use as the contents of the page
  * @tab_label: (allow-none): the #GtkWidget to be used as the label
- *     for the page, or %NULL to use the default label, 'page N'
+ *     for the page, or %NULL to use the default label, “page N”
  *
  * Prepends a page to @notebook.
  *
@@ -7034,7 +7034,7 @@ gtk_notebook_prepend_page (GtkNotebook *notebook,
  * @notebook: a #GtkNotebook
  * @child: the #GtkWidget to use as the contents of the page
  * @tab_label: (allow-none): the #GtkWidget to be used as the label
- *     for the page, or %NULL to use the default label, 'page N'
+ *     for the page, or %NULL to use the default label, “page N”
  * @menu_label: (allow-none): the widget to use as a label for the
  *     page-switch menu, if that is enabled. If %NULL, and @tab_label
  *     is a #GtkLabel or %NULL, then the menu label will be a newly
@@ -7067,7 +7067,7 @@ gtk_notebook_prepend_page_menu (GtkNotebook *notebook,
  * @notebook: a #GtkNotebook
  * @child: the #GtkWidget to use as the contents of the page
  * @tab_label: (allow-none): the #GtkWidget to be used as the label
- *     for the page, or %NULL to use the default label, 'page N'
+ *     for the page, or %NULL to use the default label, “page N”
  * @position: the index (starting at 0) at which to insert the page,
  *     or -1 to append the page after all other pages
  *
@@ -7125,7 +7125,7 @@ gtk_notebook_mnemonic_activate_switch_page (GtkWidget *child,
  * @notebook: a #GtkNotebook
  * @child: the #GtkWidget to use as the contents of the page
  * @tab_label: (allow-none): the #GtkWidget to be used as the label
- *     for the page, or %NULL to use the default label, 'page N'
+ *     for the page, or %NULL to use the default label, “page N”
  * @menu_label: (allow-none): the widget to use as a label for the
  *     page-switch menu, if that is enabled. If %NULL, and @tab_label
  *     is a #GtkLabel or %NULL, then the menu label will be a newly
@@ -7812,7 +7812,7 @@ gtk_notebook_get_tab_label (GtkNotebook *notebook,
  *
  * Changes the tab label for @child.
  * If %NULL is specified for @tab_label, then the page will
- * have the label 'page N'.
+ * have the label “page N”.
  */
 void
 gtk_notebook_set_tab_label (GtkNotebook *notebook,
diff --git a/gtk/gtkorientable.c b/gtk/gtkorientable.c
index cb9994df96..5c313c4fae 100644
--- a/gtk/gtkorientable.c
+++ b/gtk/gtkorientable.c
@@ -37,7 +37,7 @@
  * realized as subclasses of a common base class (e.g #GtkBox/#GtkHBox/#GtkVBox
  * or #GtkScale/#GtkHScale/#GtkVScale). #GtkOrientable is more flexible in that
  * it allows the orientation to be changed at runtime, allowing the widgets
- * to 'flip'.
+ * to “flip”.
  *
  * #GtkOrientable was introduced in GTK+ 2.16.
  */
diff --git a/gtk/gtkpango.c b/gtk/gtkpango.c
index 40c94f3c13..416bf6e250 100644
--- a/gtk/gtkpango.c
+++ b/gtk/gtkpango.c
@@ -358,7 +358,7 @@ _gtk_pango_get_default_attributes (AtkAttributeSet *attributes,
  * @end_offset: return location for the ending offset of the
  *    current run
  *
- * Finds the 'run' around index (i.e. the maximal range of characters
+ * Finds the “run” around index (i.e. the maximal range of characters
  * where the set of applicable attributes remains constant) and
  * returns the starting and ending offsets for it.
  *
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index cb63c9ee57..0ad153aea8 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -2061,7 +2061,7 @@ _gtk_style_context_check_region_name (const gchar *str)
  * would apply to even and odd rows, respectively.
  *
  * Region names must only contain lowercase letters
- * and '-', starting always with a lowercase letter.
+ * and “-”, starting always with a lowercase letter.
  *
  * Since: 3.0
  **/
@@ -2552,7 +2552,7 @@ gtk_style_context_lookup_icon_set (GtkStyleContext *context,
  *
  * Attaches @context to the given screen.
  *
- * The screen is used to add style information from 'global' style
+ * The screen is used to add style information from “global” style
  * providers, such as the screens #GtkSettings instance.
  *
  * If you are using a #GtkStyleContext returned from
diff --git a/gtk/gtkstylecontext.h b/gtk/gtkstylecontext.h
index 78f043bc4d..c188604fa5 100644
--- a/gtk/gtkstylecontext.h
+++ b/gtk/gtkstylecontext.h
@@ -307,7 +307,7 @@ struct _GtkStyleContextClass
  *
  * A CSS class to match primary toolbars.
  *
- * This should be used for the 'main' toolbar of an application,
+ * This should be used for the “main” toolbar of an application,
  * right below its menubar.
  */
 #define GTK_STYLE_CLASS_PRIMARY_TOOLBAR "primary-toolbar"
@@ -473,7 +473,7 @@ struct _GtkStyleContextClass
 /**
  * GTK_STYLE_CLASS_SPINNER:
  *
- * A CSS class to use when rendering activity as a 'spinner'.
+ * A CSS class to use when rendering activity as a “spinner”.
  *
  * This is used by #GtkSpinner and #GtkCellRendererSpinner.
  */
diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c
index 05bd21dc1b..fa0067802d 100644
--- a/gtk/gtktestutils.c
+++ b/gtk/gtktestutils.c
@@ -270,7 +270,7 @@ gtk_test_spin_button_click (GtkSpinButton  *spinner,
  *
  * This function will search @widget and all its descendants for a GtkLabel
  * widget with a text string matching @label_pattern.
- * The @label_pattern may contain asterisks '*' and question marks '?' as
+ * The @label_pattern may contain asterisks “*” and question marks “?” as
  * placeholders, g_pattern_match() is used for the matching.
  * Note that locales other than "C“ tend to alter (translate” label strings,
  * so this function is genrally only useful in test programs with
diff --git a/gtk/gtktogglebutton.c b/gtk/gtktogglebutton.c
index 52968658e9..785cf22f76 100644
--- a/gtk/gtktogglebutton.c
+++ b/gtk/gtktogglebutton.c
@@ -43,7 +43,7 @@
  * @Title: GtkToggleButton
  * @See_also: #GtkButton, #GtkCheckButton, #GtkCheckMenuItem
  *
- * A #GtkToggleButton is a #GtkButton which will remain 'pressed-in' when
+ * A #GtkToggleButton is a #GtkButton which will remain “pressed-in” when
  * clicked. Clicking again will cause the toggle button to return to its
  * normal state.
  *
@@ -451,7 +451,7 @@ gtk_toggle_button_get_mode (GtkToggleButton *toggle_button)
  * @is_active: %TRUE or %FALSE.
  *
  * Sets the status of the toggle button. Set to %TRUE if you want the
- * GtkToggleButton to be 'pressed in', and %FALSE to raise it.
+ * GtkToggleButton to be “pressed in”, and %FALSE to raise it.
  * This action causes the #GtkToggleButton::toggled signal and the
  * #GtkButton::clicked signal to be emitted.
  */
diff --git a/gtk/gtktoggletoolbutton.c b/gtk/gtktoggletoolbutton.c
index eb82ef9b50..bca04889e7 100644
--- a/gtk/gtktoggletoolbutton.c
+++ b/gtk/gtktoggletoolbutton.c
@@ -438,7 +438,7 @@ gtk_toggle_tool_button_new_from_stock (const gchar *stock_id)
  * @is_active: whether @button should be active
  * 
  * Sets the status of the toggle tool button. Set to %TRUE if you
- * want the GtkToggleButton to be 'pressed in', and %FALSE to raise it.
+ * want the GtkToggleButton to be “pressed in”, and %FALSE to raise it.
  * This action causes the toggled signal to be emitted.
  * 
  * Since: 2.4
diff --git a/gtk/gtktoolbutton.c b/gtk/gtktoolbutton.c
index 148cd81a46..ed7fb46e3a 100644
--- a/gtk/gtktoolbutton.c
+++ b/gtk/gtktoolbutton.c
@@ -1199,7 +1199,7 @@ gtk_tool_button_get_label (GtkToolButton *button)
  * 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
- * menu will have an underlined 'O'.
+ * menu will have an underlined “O”.
  * 
  * Labels shown on tool buttons never have mnemonics on them; this property
  * only affects the menu item on the overflow menu.
diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index 6ebbccfc3d..f228982de8 100644
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -176,7 +176,7 @@
  *    gint   int_data;
  *
  *    /&ast; Make sure you terminate calls to gtk_tree_model_get()
- *     &ast; with a '-1' value
+ *     &ast; with a “-1” value
  *     &ast;/
  *    gtk_tree_model_get (list_store, &iter,
  *                        STRING_COLUMN, &str_data,
@@ -712,7 +712,7 @@ gtk_tree_path_new_from_indicesv (gint *indices,
  *
  * Generates a string representation of the path.
  *
- * This string is a ':' separated list of numbers.
+ * This string is a “:” separated list of numbers.
  * For example, “4:10:0:3” would be an acceptable
  * return value for this string.
  *
@@ -1301,7 +1301,7 @@ gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model,
  *
  * Generates a string representation of the iter.
  *
- * This string is a ':' separated list of numbers.
+ * This string is a “:” separated list of numbers.
  * For example, “4:10:0:3” would be an acceptable
  * return value for this string.
  *
diff --git a/gtk/gtktreemodelsort.c b/gtk/gtktreemodelsort.c
index 85f5c6a1fa..2324df8c8c 100644
--- a/gtk/gtktreemodelsort.c
+++ b/gtk/gtktreemodelsort.c
@@ -2691,10 +2691,10 @@ gtk_tree_model_sort_clear_cache_helper (GtkTreeModelSort *tree_model_sort,
  * gtk_tree_model_sort_reset_default_sort_func:
  * @tree_model_sort: A #GtkTreeModelSort
  * 
- * This resets the default sort function to be in the 'unsorted' state.  That
+ * This resets the default sort function to be in the “unsorted” state.  That
  * is, it is in the same order as the child model. It will re-sort the model
  * to be in the same order as the child model only if the #GtkTreeModelSort
- * is in 'unsorted' state.
+ * is in “unsorted” state.
  **/
 void
 gtk_tree_model_sort_reset_default_sort_func (GtkTreeModelSort *tree_model_sort)
diff --git a/gtk/gtktreeselection.c b/gtk/gtktreeselection.c
index f9cd68afba..3a5bb987a5 100644
--- a/gtk/gtktreeselection.c
+++ b/gtk/gtktreeselection.c
@@ -1468,7 +1468,7 @@ _gtk_tree_selection_row_is_selectable (GtkTreeSelection *selection,
  */
 
 /*
- * docs about the 'override_browse_mode', we set this flag when we want to
+ * docs about the “override_browse_mode”, we set this flag when we want to
  * unset select the node and override the select browse mode behaviour (that is
  * 'one node should *always* be selected').
  */
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 6a2acb364f..70b49ceaee 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -7792,7 +7792,7 @@ gtk_widget_has_focus (GtkWidget *widget)
  * To find out if the widget has the global input focus, use
  * gtk_widget_has_focus().
  *
- * Return value: %TRUE if the widget should display a 'focus rectangle'
+ * Return value: %TRUE if the widget should display a “focus rectangle”
  *
  * Since: 3.2
  */
@@ -15714,7 +15714,7 @@ _gtk_widget_get_action_muxer (GtkWidget *widget)
  *
  * Inserts @group into @widget. Children of @widget that implement
  * #GtkActionable can then be associated with actions in @group by
- * setting their 'action-name' to
+ * setting their “action-name” to
  * @prefix.`action-name`.
  *
  * If @group is %NULL, a previously inserted group for @name is removed
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 7649054454..2291b44808 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -52,7 +52,7 @@ typedef enum
 } GtkWidgetHelpType;
 
 /* Macro for casting a pointer to a GtkWidget or GtkWidgetClass pointer.
- * Macros for testing whether `widget' or `klass' are of type GTK_TYPE_WIDGET.
+ * Macros for testing whether widget or klass are of type GTK_TYPE_WIDGET.
  */
 #define GTK_TYPE_WIDGET			  (gtk_widget_get_type ())
 #define GTK_WIDGET(widget)		  (G_TYPE_CHECK_INSTANCE_CAST ((widget), GTK_TYPE_WIDGET, GtkWidget))
diff --git a/gtk/gtkwidgetpath.c b/gtk/gtkwidgetpath.c
index fa431da197..b5c74b7b0d 100644
--- a/gtk/gtkwidgetpath.c
+++ b/gtk/gtkwidgetpath.c
@@ -978,7 +978,7 @@ gtk_widget_path_iter_has_class (const GtkWidgetPath *path,
  * gtk_style_context_add_region().
  *
  * Region names must only contain lowercase letters
- * and '-', starting always with a lowercase letter.
+ * and “-”, starting always with a lowercase letter.
  *
  * Since: 3.0
  **/
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index cb4bde661d..36ee0d16aa 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -11370,7 +11370,7 @@ gtk_XParseGeometry (const char   *string,
  * @geometry: geometry string
  * 
  * Parses a standard X Window System geometry string - see the
- * manual page for X (type 'man X') for details on this.
+ * manual page for X (type “man X”) for details on this.
  * gtk_window_parse_geometry() does work on all GTK+ ports
  * including Win32 but is primarily intended for an X environment.
  *
@@ -11425,7 +11425,7 @@ gtk_XParseGeometry (const char   *string,
  *   if (argc > 1)
  *     {
  *       if (!gtk_window_parse_geometry (GTK_WINDOW (window), argv[1]))
- *         fprintf (stderr, "Failed to parse '%s'\n", argv[1]);
+ *         fprintf (stderr, "Failed to parse “%s”\n", argv[1]);
  *     }
  *    
  *   gtk_widget_show_all (window);
@@ -12040,7 +12040,7 @@ _gtk_window_schedule_mnemonics_visible (GtkWindow *window)
  *
  * Gets the value of the #GtkWindow:focus-visible property.
  *
- * Returns: %TRUE if 'focus rectangles' are supposed to be visible
+ * Returns: %TRUE if “focus rectangles” are supposed to be visible
  *     in this window.
  *
  * Since: 3.2
diff --git a/gtk/updateiconcache.c b/gtk/updateiconcache.c
index c5be0f56d5..b186e9ad70 100644
--- a/gtk/updateiconcache.c
+++ b/gtk/updateiconcache.c
@@ -575,7 +575,7 @@ maybe_cache_icon_data (Image       *image,
 }
 
 /*
- * Finds all dir separators and replaces them with '/'.
+ * Finds all dir separators and replaces them with “/”.
  * This makes sure that only /-separated paths are written in cache files,
  * maintaining compatibility with theme index files that use slashes as
  * directory separators on all platforms.