docs: use proper apostrophe

https://wiki.gnome.org/Design/OS/Typography

145 files changed, 650 insertions, 650 deletions

diff --git a/gtk/deprecated/gtkaction.c b/gtk/deprecated/gtkaction.c
index b9630ae2b3..0a6d672421 100644
--- a/gtk/deprecated/gtkaction.c
+++ b/gtk/deprecated/gtkaction.c
@@ -71,7 +71,7 @@
  *
  * Each action can have one or more proxy widgets. To act as an action proxy,
  * widget needs to implement #GtkActivatable interface. Proxies mirror the state
- * of the action and should change when the action's state changes. Properties
+ * of the action and should change when the action’s state changes. Properties
  * that are always mirrored by proxies are #GtkAction:sensitive and
  * #GtkAction:visible. #GtkAction:gicon, #GtkAction:icon-name, #GtkAction:label,
  * #GtkAction:short-label and #GtkAction:stock-id properties are only mirorred
@@ -1356,7 +1356,7 @@ gtk_action_get_is_important (GtkAction *action)
  * @action: a #GtkAction
  * @always_show: %TRUE if menuitem proxies should always show their image
  *
- * Sets whether @action<!-- -->'s menu item proxies will ignore the
+ * Sets whether @action<!-- -->’s menu item proxies will ignore the
  * #GtkSettings:gtk-menu-images setting and always show their image, if available.
  *
  * Use this if the menu item would be useless or hard to use
@@ -1391,7 +1391,7 @@ gtk_action_set_always_show_image (GtkAction *action,
  * gtk_action_get_always_show_image:
  * @action: a #GtkAction
  *
- * Returns whether @action<!-- -->'s menu item proxies will always
+ * Returns whether @action<!-- -->’s menu item proxies will always
  * show their image, if available.
  *
  * Returns: %TRUE if the menu item proxies will always show their image
@@ -1835,7 +1835,7 @@ gtk_action_set_gicon (GtkAction *action,
  *
  * Gets the gicon of @action.
  *
- * Returns: (transfer none): The action's #GIcon if one is set.
+ * Returns: (transfer none): The action’s #GIcon if one is set.
  *
  * Since: 2.16
  *
diff --git a/gtk/deprecated/gtkactiongroup.c b/gtk/deprecated/gtkactiongroup.c
index 16dde2a70e..6b9b9adeb2 100644
--- a/gtk/deprecated/gtkactiongroup.c
+++ b/gtk/deprecated/gtkactiongroup.c
@@ -41,7 +41,7 @@
  * application that can edit multiple documents, one group holding global
  * actions (e.g. quit, about, new), and one group per document holding
  * actions that act on that document (eg. save, cut/copy/paste, etc). Each
- * window's menus would be constructed from a combination of two action
+ * window’s menus would be constructed from a combination of two action
  * groups.
  *
  * ## Accelerators ## {#Action-Accel}
diff --git a/gtk/deprecated/gtkactivatable.c b/gtk/deprecated/gtkactivatable.c
index 3d36e391fd..f214b4a27e 100644
--- a/gtk/deprecated/gtkactivatable.c
+++ b/gtk/deprecated/gtkactivatable.c
@@ -414,7 +414,7 @@ gtk_activatable_action_notify (GtkAction      *action,
  * This function adds a reference to the currently set related
  * action for you, it also makes sure the #GtkActivatable->update()
  * method is called when the related #GtkAction properties change
- * and registers to the action's proxy list.
+ * and registers to the action’s proxy list.
  *
  * > Be careful to call this before setting the local
  * > copy of the #GtkAction property, since this function uses 
diff --git a/gtk/deprecated/gtkactivatable.h b/gtk/deprecated/gtkactivatable.h
index dd89d85b72..612dbba19a 100644
--- a/gtk/deprecated/gtkactivatable.h
+++ b/gtk/deprecated/gtkactivatable.h
@@ -39,7 +39,7 @@ typedef struct _GtkActivatableIface GtkActivatableIface;
 
 /**
  * GtkActivatableIface:
- * @update: Called to update the activatable when its related action's properties change.
+ * @update: Called to update the activatable when its related action’s properties change.
  * You must check the #GtkActivatable:use-action-appearance property only apply action
  * properties that are meant to effect the appearance accordingly.
  * @sync_action_properties: Called to update the activatable completely, this is called internally when
diff --git a/gtk/deprecated/gtkcolorseldialog.c b/gtk/deprecated/gtkcolorseldialog.c
index 18c651a125..7ff28ec866 100644
--- a/gtk/deprecated/gtkcolorseldialog.c
+++ b/gtk/deprecated/gtkcolorseldialog.c
@@ -48,7 +48,7 @@
  * #GtkColorSelection widget contained within the dialog. Use this widget
  * and its gtk_color_selection_get_current_color()
  * function to gain access to the selected color.  Connect a handler
- * for this widget's #GtkColorSelection::color-changed signal to be notified
+ * for this widget’s #GtkColorSelection::color-changed signal to be notified
  * when the color changes.
  *
  * # GtkColorSelectionDialog as GtkBuildable # {#GtkColorSelectionDialog-BUILDER-UI}
diff --git a/gtk/deprecated/gtkgradient.c b/gtk/deprecated/gtkgradient.c
index e8759e05e7..7021d14fd3 100644
--- a/gtk/deprecated/gtkgradient.c
+++ b/gtk/deprecated/gtkgradient.c
@@ -43,7 +43,7 @@
  * since they are mostly used behind the scenes by #GtkStyleContext and
  * #GtkCssProvider.
  *
- * #GtkGradient is deprecated. It was used internally by GTK's CSS engine
+ * #GtkGradient is deprecated. It was used internally by GTK’s CSS engine
  * to represent gradients. As its handling is not conforming to modern
  * web standards, it is not used anymore. If you want to use gradients in
  * your own code, please use Cairo directly.
diff --git a/gtk/deprecated/gtkhandlebox.c b/gtk/deprecated/gtkhandlebox.c
index 36a788301c..3987c19106 100644
--- a/gtk/deprecated/gtkhandlebox.c
+++ b/gtk/deprecated/gtkhandlebox.c
@@ -1057,7 +1057,7 @@ gtk_handle_box_get_snap_edge (GtkHandleBox *handle_box)
  * gtk_handle_box_get_child_detached:
  * @handle_box: a #GtkHandleBox
  *
- * Whether the handlebox's child is currently detached.
+ * Whether the handlebox’s child is currently detached.
  *
  * Return value: %TRUE if the child is currently detached, otherwise %FALSE
  *
diff --git a/gtk/deprecated/gtkhscale.c b/gtk/deprecated/gtkhscale.c
index 57d36ad559..58aa6e8b10 100644
--- a/gtk/deprecated/gtkhscale.c
+++ b/gtk/deprecated/gtkhscale.c
@@ -43,7 +43,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  * a horizontal slider. To create one, use gtk_hscale_new_with_range().
  *
  * The position to show the current value, and the number of decimal places
- * shown can be set using the parent #GtkScale class's functions.
+ * shown can be set using the parent #GtkScale class’s functions.
  *
  * GtkHScale has been deprecated, use #GtkScale instead.
  */
@@ -95,7 +95,7 @@ gtk_hscale_new (GtkAdjustment *adjustment)
  *
  * Creates a new horizontal scale widget that lets the user input a
  * number between @min and @max (including @min and @max) with the
- * increment @step.  @step must be nonzero; it's the distance the
+ * increment @step.  @step must be nonzero; it’s the distance the
  * slider moves when using the arrow keys to adjust the scale value.
  *
  * Note that the way in which the precision is derived works best if @step
diff --git a/gtk/deprecated/gtkiconfactory.c b/gtk/deprecated/gtkiconfactory.c
index b77c649ecd..efa7eb0036 100644
--- a/gtk/deprecated/gtkiconfactory.c
+++ b/gtk/deprecated/gtkiconfactory.c
@@ -289,7 +289,7 @@ gtk_icon_factory_new (void)
  * gtk_icon_factory_add_default(). Then they pass the @stock_id to
  * widgets such as #GtkImage to display the icon. Themes can provide
  * an icon with the same name (such as "myapp-whatever-icon") to
- * override your application's default icons. If an icon already
+ * override your application’s default icons. If an icon already
  * existed in @factory for @stock_id, it is unreferenced and replaced
  * with the new @icon_set.
  *
@@ -1736,7 +1736,7 @@ icon_source_compare (gconstpointer ap, gconstpointer bp)
  * This function copies @source, so you can reuse the same source immediately
  * without affecting the icon set.
  *
- * An example of when you'd use this function: a web browser's "Back
+ * An example of when you'd use this function: 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
@@ -1864,7 +1864,7 @@ gtk_icon_set_get_sizes (GtkIconSet   *icon_set,
  * 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 8c27040b3e..6a30f9ea6f 100644
--- a/gtk/deprecated/gtkrc.c
+++ b/gtk/deprecated/gtkrc.c
@@ -542,7 +542,7 @@
  * `"gtk-button"`, `"gtk-dialog"`. Applications
  * can define other sizes.
  *
- * It's also possible to use custom icons for a given state, for example:
+ * It’s also possible to use custom icons for a given state, for example:
  *
  * |[<!-- language="C" -->
  * stock["my-stock-item"] =
diff --git a/gtk/deprecated/gtkstock.c b/gtk/deprecated/gtkstock.c
index 245d213c4c..e0bdccd5f0 100644
--- a/gtk/deprecated/gtkstock.c
+++ b/gtk/deprecated/gtkstock.c
@@ -51,7 +51,7 @@ Prebuilt common menu/toolbar items and corresponding icons
  * of the menu or toolbar item; and/or with an icon stored in a
  * #GtkIconFactory. The connection between a
  * #GtkStockItem and stock icons is purely conventional (by virtue of
- * using the same stock ID); it's possible to register a stock item but
+ * using the same stock ID); it’s possible to register a stock item but
  * no icon, and vice versa. Stock icons may have a RTL variant which gets
  * used for right-to-left locales.
  */
diff --git a/gtk/deprecated/gtkstyle.c b/gtk/deprecated/gtkstyle.c
index bf2a5ebbfa..3fb461c81e 100644
--- a/gtk/deprecated/gtkstyle.c
+++ b/gtk/deprecated/gtkstyle.c
@@ -910,7 +910,7 @@ gtk_style_has_context (GtkStyle *style)
  * @window: a #GdkWindow.
  *
  * Attaches a style to a window; this process allocates the
- * colors and creates the GC's for the style - it specializes
+ * colors and creates the GC’s for the style - it specializes
  * it to a particular visual. The process may involve the creation
  * of a new style if the style has already been attached to a
  * window with a different style and visual.
@@ -987,7 +987,7 @@ gtk_style_lookup_icon_set (GtkStyle   *style,
  * @color_name: the name of the logical color to look up
  * @color: (out): the #GdkColor to fill in
  *
- * Looks up @color_name in the style's logical color mappings,
+ * Looks up @color_name in the style’s logical color mappings,
  * filling in @color and returning %TRUE if found, otherwise
  * returning %FALSE. Do not cache the found mapping, because
  * it depends on the #GtkStyle and might change when a theme
@@ -4063,14 +4063,14 @@ gtk_widget_get_default_style (void)
  * gtk_widget_style_attach:
  * @widget: a #GtkWidget
  *
- * This function attaches the widget's #GtkStyle to the widget's
+ * This function attaches the widget’s #GtkStyle to the widget's
  * #GdkWindow. It is a replacement for
  *
  * |[
  * 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
  * (finally #GtkWidget) would attach the style itself.
@@ -4160,7 +4160,7 @@ gtk_widget_ensure_style (GtkWidget *widget)
  *
  * Simply an accessor function that returns @widget->style.
  *
- * Return value: (transfer none): the widget's #GtkStyle
+ * Return value: (transfer none): the widget’s #GtkStyle
  *
  * Deprecated:3.0: Use #GtkStyleContext instead
  */
@@ -4375,7 +4375,7 @@ gtk_widget_modify_fg (GtkWidget      *widget,
  * See also gtk_widget_modify_style().
  *
  * > Note that “no window” widgets (which have the %GTK_NO_WINDOW
- * > flag set) draw on their parent container's window and thus may
+ * > 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.
  * >
@@ -4473,7 +4473,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
- * > flag set) draw on their parent container's window and thus may
+ * > 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,8 +4600,8 @@ gtk_widget_reset_rc_styles (GtkWidget *widget)
  * the name of a widget, you allow users or theme authors to apply
  * styles to that specific widget in their gtkrc
  * file. @path_reversed_p fills in the path in reverse order,
- * i.e. starting with @widget's name instead of starting with the name
- * of @widget's outermost ancestor.
+ * i.e. starting with @widget’s name instead of starting with the name
+ * of @widget’s outermost ancestor.
  *
  * Deprecated:3.0: Use gtk_widget_get_path() instead
  **/
@@ -4670,7 +4670,7 @@ gtk_widget_path (GtkWidget *widget,
  * @path_reversed: (out) (allow-none): location to store the reverse
  *     class path as an allocated string, or %NULL
  *
- * Same as gtk_widget_path(), but always uses the name of a widget's type,
+ * Same as gtk_widget_path(), but always uses the name of a widget’s type,
  * never uses a custom name set with gtk_widget_set_name().
  *
  * Deprecated:3.0: Use gtk_widget_get_path() instead
diff --git a/gtk/deprecated/gtktable.c b/gtk/deprecated/gtktable.c
index c006e87ff2..4af47c49ed 100644
--- a/gtk/deprecated/gtktable.c
+++ b/gtk/deprecated/gtktable.c
@@ -626,7 +626,7 @@ gtk_table_new (guint	rows,
  * @rows: The new number of rows.
  * @columns: The new number of columns.
  *
- * If you need to change a table's size after
+ * If you need to change a table’s size after
  * it has been created, this function allows you to do so.
  *
  * Deprecated: 3.4: #GtkGrid resizes automatically.
diff --git a/gtk/deprecated/gtkvscale.c b/gtk/deprecated/gtkvscale.c
index a8cd171fd9..3944383b84 100644
--- a/gtk/deprecated/gtkvscale.c
+++ b/gtk/deprecated/gtkvscale.c
@@ -43,7 +43,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  * a vertical slider. To create one, use gtk_hscale_new_with_range().
  *
  * The position to show the current value, and the number of decimal places
- * shown can be set using the parent #GtkScale class's functions.
+ * shown can be set using the parent #GtkScale class’s functions.
  *
  * GtkVScale has been deprecated, use #GtkScale instead.
  */
@@ -93,7 +93,7 @@ gtk_vscale_new (GtkAdjustment *adjustment)
  *
  * Creates a new vertical scale widget that lets the user input a
  * number between @min and @max (including @min and @max) with the
- * increment @step.  @step must be nonzero; it's the distance the
+ * increment @step.  @step must be nonzero; it’s the distance the
  * slider moves when using the arrow keys to adjust the scale value.
  *
  * Note that the way in which the precision is derived works best if @step
diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c
index 3e17c339f8..736b7b7e59 100644
--- a/gtk/gtkaboutdialog.c
+++ b/gtk/gtkaboutdialog.c
@@ -2378,7 +2378,7 @@ close_cb (GtkAboutDialog *about)
  * @first_property_name: the name of the first property
  * @...: value of first property, followed by more properties, %NULL-terminated
  *
- * This is a convenience function for showing an application's about box.
+ * This is a convenience function for showing an application’s about box.
  * The constructed dialog is associated with the parent window and
  * reused for future invocations of this function.
  *
diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c
index 8b2c696a03..15fa061376 100644
--- a/gtk/gtkaccelgroup.c
+++ b/gtk/gtkaccelgroup.c
@@ -47,7 +47,7 @@
  * gtk_window_add_accel_group()). Usually you won't need to create a
  * #GtkAccelGroup directly; instead, when using #GtkUIManager, GTK+
  * automatically sets up the accelerators for your menus in the ui
- * manager's #GtkAccelGroup.
+ * manager’s #GtkAccelGroup.
  *
  * Note that “accelerators” are different from
  * “mnemonics”. Accelerators are shortcuts for
diff --git a/gtk/gtkaccelmap.c b/gtk/gtkaccelmap.c
index c5819d564e..ff6e417b2b 100644
--- a/gtk/gtkaccelmap.c
+++ b/gtk/gtkaccelmap.c
@@ -60,7 +60,7 @@
  * “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”,
+ * items, choose the item’s menu path, e.g. “File/Save As”,
  * “Image/View/Zoom” or “Edit/Select All”. So a full valid accelerator
  * path may look like: “&lt;Gimp-Toolbox&gt;/File/Dialogs/Tool Options...”.
  *
diff --git a/gtk/gtkaccessible.c b/gtk/gtkaccessible.c
index 5845a00e46..e8fe6ca9f6 100644
--- a/gtk/gtkaccessible.c
+++ b/gtk/gtkaccessible.c
@@ -167,7 +167,7 @@ gtk_accessible_class_init (GtkAccessibleClass *klass)
  * Sets the #GtkWidget corresponding to the #GtkAccessible.
  *
  * @accessible will not hold a reference to @widget.
- * It is the caller's responsibility to ensure that when @widget
+ * It is the caller’s responsibility to ensure that when @widget
  * is destroyed, the widget is unset by calling this function
  * again with @widget set to %NULL.
  *
diff --git a/gtk/gtkactionable.c b/gtk/gtkactionable.c
index 2be4783e25..12f8758284 100644
--- a/gtk/gtkactionable.c
+++ b/gtk/gtkactionable.c
@@ -168,7 +168,7 @@ gtk_actionable_get_action_target_value (GtkActionable *actionable)
  * will be associated with the same action, but with a different target
  * value for that action.  Clicking on a particular button will activate
  * the action with the target of that button, which will typically cause
- * the action's state to change to that value.  Since the action's state
+ * the action’s state to change to that value.  Since the action’s state
  * is now equal to the target value of the button, the button will now
  * be rendered as active (and the other buttons, with different targets,
  * rendered inactive).
diff --git a/gtk/gtkadjustment.c b/gtk/gtkadjustment.c
index 3173d2e37f..f550500a8f 100644
--- a/gtk/gtkadjustment.c
+++ b/gtk/gtkadjustment.c
@@ -468,7 +468,7 @@ gtk_adjustment_get_lower (GtkAdjustment *adjustment)
  * When setting multiple adjustment properties via their individual
  * setters, multiple #GtkAdjustment::changed signals will be emitted. However, since
  * the emission of the #GtkAdjustment::changed signal is tied to the emission of the
- * #GObject::notify signals of the changed properties, it's possible
+ * #GObject::notify signals of the changed properties, it’s possible
  * to compress the #GtkAdjustment::changed signals into one by calling
  * g_object_freeze_notify() and g_object_thaw_notify() around the
  * calls to the individual setters.
diff --git a/gtk/gtkappchooserwidget.h b/gtk/gtkappchooserwidget.h
index 19aba13701..9b0625ab71 100644
--- a/gtk/gtkappchooserwidget.h
+++ b/gtk/gtkappchooserwidget.h
@@ -57,9 +57,9 @@ struct _GtkAppChooserWidget {
  * GtkAppChooserWidgetClass:
  * @parent_class: The parent class.
  * @application_selected: Signal emitted when an application item is
- *    selected from the widget's list.
+ *    selected from the widget’s list.
  * @application_activated: Signal emitted when an application item is
- *    activated from the widget's list.
+ *    activated from the widget’s list.
  * @populate_popup: Signal emitted when a context menu is about to
  *    popup over an application item.
  */
diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c
index c83790db02..25d6e18ee4 100644
--- a/gtk/gtkassistant.c
+++ b/gtk/gtkassistant.c
@@ -1805,7 +1805,7 @@ gtk_assistant_insert_page (GtkAssistant *assistant,
  * @page_num: the index of a page in the @assistant,
  *     or -1 to remove the last page
  *
- * Removes the @page_num's page from @assistant.
+ * Removes the @page_num’s page from @assistant.
  *
  * Since: 3.2
  */
@@ -2164,7 +2164,7 @@ gtk_assistant_do_set_page_header_image (GtkAssistant *assistant,
  * Gets the header image for @page.
  *
  * Return value: (transfer none): the header image for @page,
- *     or %NULL if there's no header image for the page
+ *     or %NULL if there’s no header image for the page
  *
  * Since: 2.10
  *
@@ -2255,7 +2255,7 @@ gtk_assistant_do_set_page_side_image (GtkAssistant *assistant,
  * Gets the side image for @page.
  *
  * Return value: (transfer none): the side image for @page,
- *     or %NULL if there's no side image for the page
+ *     or %NULL if there’s no side image for the page
  *
  * Since: 2.10
  *
diff --git a/gtk/gtkassistant.h b/gtk/gtkassistant.h
index 1a70e703bf..0f9de28af4 100644
--- a/gtk/gtkassistant.h
+++ b/gtk/gtkassistant.h
@@ -92,7 +92,7 @@ struct _GtkAssistant
 /**
  * GtkAssistantClass:
  * @parent_class: The parent class.
- * @prepare: Signal emitted when a new page is set as the assistant's current page, before making the new page visible.
+ * @prepare: Signal emitted when a new page is set as the assistant’s current page, before making the new page visible.
  * @apply: Signal emitted when the apply button is clicked.
  * @close: Signal emitted either when the close button or last page apply button is clicked.
  * @cancel: Signal emitted when the cancel button is clicked.
@@ -124,7 +124,7 @@ struct _GtkAssistantClass
  * @data: (closure): user data.
  *
  * A function used by gtk_assistant_set_forward_page_func() to know which
- * is the next page given a current one. It's called both for computing the
+ * is the next page given a current one. It’s called both for computing the
  * next page when the user presses the “forward” button and for handling
  * the behavior of the “last” button.
  *
diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c
index 772038448c..6b0da96c53 100644
--- a/gtk/gtkbindings.c
+++ b/gtk/gtkbindings.c
@@ -130,7 +130,7 @@
  * and “&lt;Control&gt;Left” key presses before it resorts to its default
  * bindings, and the match instructs it to abort (“unbind”) the search,
  * so the key presses are not consumed by this widget. As usual, further
- * processing of the key presses, e.g. by an entry's parent widget, is
+ * processing of the key presses, e.g. by an entry’s parent widget, is
  * now possible.
  */
 
diff --git a/gtk/gtkbox.c b/gtk/gtkbox.c
index 4a0613487a..16ef16cff1 100644
--- a/gtk/gtkbox.c
+++ b/gtk/gtkbox.c
@@ -1571,7 +1571,7 @@ gtk_box_get_preferred_height_for_width (GtkWidget *widget,
 
 /**
  * gtk_box_new:
- * @orientation: the box's orientation.
+ * @orientation: the box’s orientation.
  * @spacing: the number of pixels to place by default between children.
  *
  * Creates a new #GtkBox.
@@ -1835,7 +1835,7 @@ _gtk_box_get_spacing_set (GtkBox *box)
  * as well as widgets packed #GTK_PACK_END, in the order that these
  * widgets were added to @box.
  *
- * A widget's position in the @box children list determines where
+ * A widget’s position in the @box children list determines where
  * the widget is packed into @box.  A child widget at some position
  * in the list will be packed just after all other widgets of the
  * same packing type that appear earlier in the list.
diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index b2893e9a9d..e928bafed2 100644
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -198,7 +198,7 @@
  * respective objects.
  *
  * Additionally, since 3.10 a special &lt;template&gt; tag has been
- * added to the format allowing one to define a widget class's components.
+ * added to the format allowing one to define a widget class’s components.
  */
 
 #include "config.h"
@@ -955,10 +955,10 @@ gtk_builder_new (void)
  * #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR 
  * domain.
  *
- * It's not really reasonable to attempt to handle failures of this
+ * It’s not really reasonable to attempt to handle failures of this
  * call.  You should not use this function with untrusted files (ie:
  * files that are not part of your application).  Broken #GtkBuilder
- * files can easily crash your program, and it's possible that memory
+ * files can easily crash your program, and it’s possible that memory
  * was leaked leading up to the reported failure.  The only reasonable
  * thing to do when an error is detected is to call g_error().
  *
@@ -1132,7 +1132,7 @@ _gtk_builder_extend_with_template (GtkBuilder    *builder,
  * #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_RESOURCE_ERROR
  * domain.
  *
- * It's not really reasonable to attempt to handle failures of this
+ * It’s not really reasonable to attempt to handle failures of this
  * call.  The only reasonable thing to do when an error is detected is
  * to call g_error().
  *
@@ -1287,7 +1287,7 @@ gtk_builder_add_objects_from_resource (GtkBuilder   *builder,
  * Upon errors 0 will be returned and @error will be assigned a
  * #GError from the #GTK_BUILDER_ERROR or #G_MARKUP_ERROR domain.
  *
- * It's not really reasonable to attempt to handle failures of this
+ * It’s not really reasonable to attempt to handle failures of this
  * call.  The only reasonable thing to do when an error is detected is
  * to call g_error().
  *
@@ -1562,8 +1562,8 @@ gtk_builder_connect_signals_default (GtkBuilder    *builder,
  * This method is a simpler variation of gtk_builder_connect_signals_full().
  * It uses symbols explicitly added to @builder with prior calls to
  * gtk_builder_add_callback_symbol(). In the case that symbols are not
- * explicitly added; it uses #GModule's introspective features (by opening the module %NULL) 
- * to look at the application's symbol table. From here it tries to match
+ * explicitly added; it uses #GModule’s introspective features (by opening the module %NULL) 
+ * to look at the application’s symbol table. From here it tries to match
  * the signal handler names given in the interface description with
  * symbols in the application and connects the signals. Note that this
  * function can only be called once, subsequent calls will do nothing.
diff --git a/gtk/gtkbuilder.h b/gtk/gtkbuilder.h
index 38e63a5217..65c6276a03 100644
--- a/gtk/gtkbuilder.h
+++ b/gtk/gtkbuilder.h
@@ -61,7 +61,7 @@ typedef struct _GtkBuilderPrivate GtkBuilderPrivate;
  * @GTK_BUILDER_ERROR_DUPLICATE_ID: An object id occurred twice.
  * @GTK_BUILDER_ERROR_OBJECT_TYPE_REFUSED: A specified object type is of the same type or
  *  derived from the type of the composite class being extended with builder XML.
- * @GTK_BUILDER_ERROR_TEMPLATE_MISMATCH: The wrong type was specified in a composite class's template XML
+ * @GTK_BUILDER_ERROR_TEMPLATE_MISMATCH: The wrong type was specified in a composite class’s template XML
  *
  * Error codes that identify various errors that can occur while using
  * #GtkBuilder.
diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index a9999852f2..0a3d8209b5 100644
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -2895,10 +2895,10 @@ gtk_button_get_always_show_image (GtkButton *button)
  * gtk_button_get_event_window:
  * @button: a #GtkButton
  *
- * Returns the button's event window if it is realized, %NULL otherwise.
+ * Returns the button’s event window if it is realized, %NULL otherwise.
  * This function should be rarely needed.
  *
- * Return value: (transfer none): @button's event window.
+ * Return value: (transfer none): @button’s event window.
  *
  * Since: 2.22
  */
diff --git a/gtk/gtkcellarea.c b/gtk/gtkcellarea.c
index 1c41e21bee..7b283d6fc0 100644
--- a/gtk/gtkcellarea.c
+++ b/gtk/gtkcellarea.c
@@ -38,7 +38,7 @@
  * # Requesting area sizes
  *
  * As outlined in
- * [GtkWidget's geometry management section][geometry-management],
+ * [GtkWidget’s geometry management section][geometry-management],
  * GTK+ uses a height-for-width
  * geometry management system to compute the sizes of widgets and user
  * interfaces. #GtkCellArea uses the same semantics to calculate the
@@ -52,7 +52,7 @@
  * width and wrap the areas around, requesting height for more cell
  * areas when allocated less width.
  *
- * It's also important for areas to maintain some cell
+ * 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
  * cells are different in each row). For this reason the #GtkCellArea
@@ -66,7 +66,7 @@
  * The owning cell-layouting widget can create as many contexts as
  * it wishes to calculate sizes of rows which should receive the
  * same size in at least one orientation (horizontally or vertically),
- * However, it's important that the same #GtkCellAreaContext which
+ * However, it’s important that the same #GtkCellAreaContext which
  * was used to request the sizes for a given #GtkTreeModel row be
  * used when rendering or processing events for that row.
  *
@@ -89,7 +89,7 @@
  * gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width);
  * ]|
  *
- * Note that in this example it's not important to observe the
+ * Note that in this example it’s not important to observe the
  * returned minimum and natural width of the area for each row
  * unless the cell-layouting object is actually interested in the
  * widths of individual rows. The overall width is however stored
@@ -132,7 +132,7 @@
  * Requesting the height for width (or width for height) of an area is
  * a similar task except in this case the #GtkCellAreaContext does not
  * store the data (actually, it does not know how much space the layouting
- * widget plans to allocate it for every row. It's up to the layouting
+ * widget plans to allocate it for every row. It’s up to the layouting
  * widget to render each row of data with the appropriate height and
  * width which was requested by the #GtkCellArea).
  *
@@ -172,7 +172,7 @@
  * In some cases the layouting widget is requested the height for an
  * arbitrary for_width, this is a special case for layouting widgets
  * who need to request size for tens of thousands  of rows. For this
- * case it's only important that the layouting widget calculate
+ * case it’s only important that the layouting widget calculate
  * one reasonably sized chunk of rows and return that height
  * synchronously. The reasoning here is that any layouting widget is
  * at least capable of synchronously calculating enough height to fill
@@ -240,7 +240,7 @@
  *
  * The #GtkCellArea drives keyboard focus from cell to cell in a way
  * similar to #GtkWidget. For layouting widgets that support giving
- * focus to cells it's important to remember to pass %GTK_CELL_RENDERER_FOCUSED
+ * focus to cells it’s important to remember to pass %GTK_CELL_RENDERER_FOCUSED
  * to the area functions for the row that has focus and to tell the
  * area to paint the focus at render time.
  *
@@ -1822,12 +1822,12 @@ gtk_cell_area_event (GtkCellArea          *area,
  * @context: the #GtkCellAreaContext for this row of data.
  * @widget: the #GtkWidget that @area is rendering to
  * @cr: the #cairo_t to render with
- * @background_area: the @widget relative coordinates for @area's background
+ * @background_area: the @widget relative coordinates for @area’s background
  * @cell_area: the @widget relative coordinates for @area
  * @flags: the #GtkCellRendererState for @area in this row.
  * @paint_focus: whether @area should paint focus on focused cells for focused rows or not.
  *
- * Renders @area's cells according to @area's layout onto @widget at
+ * Renders @area’s cells according to @area’s layout onto @widget at
  * the given coordinates.
  *
  * Since: 3.0
@@ -2057,10 +2057,10 @@ gtk_cell_area_get_request_mode (GtkCellArea *area)
  * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL
  * @natural_width: (out) (allow-none): location to store the natural width, or %NULL
  *
- * Retrieves a cell area's initial minimum and natural width.
+ * Retrieves a cell area’s initial minimum and natural width.
  *
  * @area will store some geometrical information in @context along the way;
- * when requesting sizes over an arbitrary number of rows, it's not important
+ * when requesting sizes over an arbitrary number of rows, it’s not important
  * to check the @minimum_width and @natural_width of this call but rather to
  * consult gtk_cell_area_context_get_preferred_width() after a series of
  * requests.
@@ -2090,11 +2090,11 @@ gtk_cell_area_get_preferred_width (GtkCellArea        *area,
  * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL
  * @natural_height: (out) (allow-none): location to store the natural height, or %NULL
  *
- * Retrieves a cell area's minimum and natural height if it would be given
+ * Retrieves a cell area’s minimum and natural height if it would be given
  * the specified @width.
  *
  * @area stores some geometrical information in @context along the way
- * while calling gtk_cell_area_get_preferred_width(). It's important to
+ * while calling gtk_cell_area_get_preferred_width(). It’s important to
  * perform a series of gtk_cell_area_get_preferred_width() requests with
  * @context first and then call gtk_cell_area_get_preferred_height_for_width()
  * on each cell area individually to get the height for width of each
@@ -2133,10 +2133,10 @@ gtk_cell_area_get_preferred_height_for_width (GtkCellArea        *area,
  * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL
  * @natural_height: (out) (allow-none): location to store the natural height, or %NULL
  *
- * Retrieves a cell area's initial minimum and natural height.
+ * Retrieves a cell area’s initial minimum and natural height.
  *
  * @area will store some geometrical information in @context along the way;
- * when requesting sizes over an arbitrary number of rows, it's not important
+ * when requesting sizes over an arbitrary number of rows, it’s not important
  * to check the @minimum_height and @natural_height of this call but rather to
  * consult gtk_cell_area_context_get_preferred_height() after a series of
  * requests.
@@ -2166,11 +2166,11 @@ gtk_cell_area_get_preferred_height (GtkCellArea        *area,
  * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL
  * @natural_width: (out) (allow-none): location to store the natural width, or %NULL
  *
- * Retrieves a cell area's minimum and natural width if it would be given
+ * Retrieves a cell area’s minimum and natural width if it would be given
  * the specified @height.
  *
  * @area stores some geometrical information in @context along the way
- * while calling gtk_cell_area_get_preferred_height(). It's important to
+ * while calling gtk_cell_area_get_preferred_height(). It’s important to
  * perform a series of gtk_cell_area_get_preferred_height() requests with
  * @context first and then call gtk_cell_area_get_preferred_width_for_height()
  * on each cell area individually to get the height for width of each
@@ -2869,7 +2869,7 @@ gtk_cell_area_is_activatable (GtkCellArea *area)
  * @area: a #GtkCellArea
  * @direction: the #GtkDirectionType
  *
- * This should be called by the @area's owning layout widget
+ * This should be called by the @area’s owning layout widget
  * when focus is to be passed to @area, or moved within @area
  * for a given @direction and row data.
  *
@@ -2895,7 +2895,7 @@ gtk_cell_area_focus (GtkCellArea      *area,
  * @area: a #GtkCellArea
  * @context: the #GtkCellAreaContext in context with the current row data
  * @widget: the #GtkWidget that @area is rendering on
- * @cell_area: the size and location of @area relative to @widget's allocation
+ * @cell_area: the size and location of @area relative to @widget’s allocation
  * @flags: the #GtkCellRendererState flags for @area for this row of data.
  * @edit_only: if %TRUE then only cell renderers that are %GTK_CELL_RENDERER_MODE_EDITABLE
  *             will be activated.
@@ -2999,9 +2999,9 @@ gtk_cell_area_get_focus_cell (GtkCellArea *area)
  * gtk_cell_area_add_focus_sibling:
  * @area: a #GtkCellArea
  * @renderer: the #GtkCellRenderer expected to have focus
- * @sibling: the #GtkCellRenderer to add to @renderer's focus area
+ * @sibling: the #GtkCellRenderer to add to @renderer’s focus area
  *
- * Adds @sibling to @renderer's focusable area, focus will be drawn
+ * Adds @sibling to @renderer’s focusable area, focus will be drawn
  * around @renderer and all of its siblings if @renderer can
  * focus for a given row.
  *
@@ -3048,9 +3048,9 @@ gtk_cell_area_add_focus_sibling (GtkCellArea     *area,
  * gtk_cell_area_remove_focus_sibling:
  * @area: a #GtkCellArea
  * @renderer: the #GtkCellRenderer expected to have focus
- * @sibling: the #GtkCellRenderer to remove from @renderer's focus area
+ * @sibling: the #GtkCellRenderer to remove from @renderer’s focus area
  *
- * Removes @sibling from @renderer's focus sibling list
+ * Removes @sibling from @renderer’s focus sibling list
  * (see gtk_cell_area_add_focus_sibling()).
  *
  * Since: 3.0
@@ -3085,9 +3085,9 @@ gtk_cell_area_remove_focus_sibling (GtkCellArea     *area,
  * gtk_cell_area_is_focus_sibling:
  * @area: a #GtkCellArea
  * @renderer: the #GtkCellRenderer expected to have focus
- * @sibling: the #GtkCellRenderer to check against @renderer's sibling list
+ * @sibling: the #GtkCellRenderer to check against @renderer’s sibling list
  *
- * Returns whether @sibling is one of @renderer's focus siblings
+ * Returns whether @sibling is one of @renderer’s focus siblings
  * (see gtk_cell_area_add_focus_sibling()).
  *
  * Return value: %TRUE if @sibling is a focus sibling of @renderer
@@ -3505,7 +3505,7 @@ gtk_cell_area_stop_editing (GtkCellArea *area,
  * gtk_cell_area_inner_cell_area:
  * @area: a #GtkCellArea
  * @widget: the #GtkWidget that @area is rendering onto
- * @cell_area: the @widget relative coordinates where one of @area's cells
+ * @cell_area: the @widget relative coordinates where one of @area’s cells
  *             is to be placed
  * @inner_area: (out): the return location for the inner cell area
  *
@@ -3550,7 +3550,7 @@ gtk_cell_area_inner_cell_area (GtkCellArea        *area,
  * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
  *
  * This is a convenience function for #GtkCellArea implementations
- * to request size for cell renderers. It's important to use this
+ * to request size for cell renderers. It’s important to use this
  * function to request size and then use gtk_cell_area_inner_cell_area()
  * at render and event time since this function will add padding
  * around the cell for focus painting.
diff --git a/gtk/gtkcellarea.h b/gtk/gtkcellarea.h
index ebb20a9c05..d82b2cf842 100644
--- a/gtk/gtkcellarea.h
+++ b/gtk/gtkcellarea.h
@@ -112,7 +112,7 @@ struct _GtkCellArea
  * @event: Handle an event in the area, this is generally used to activate
  *     a cell at the event location for button events but can also be used
  *     to generically pass events to #GtkWidgets drawn onto the area.
- * @render: Actually render the area's cells to the specified rectangle,
+ * @render: Actually render the area’s cells to the specified rectangle,
  *     @background_area should be correctly distributed to the cells
  *     corresponding background areas.
  * @apply_attributes: Apply the cell attributes to the cells. This is
diff --git a/gtk/gtkcellareacontext.c b/gtk/gtkcellareacontext.c
index e90abc737e..f704e953a2 100644
--- a/gtk/gtkcellareacontext.c
+++ b/gtk/gtkcellareacontext.c
@@ -30,7 +30,7 @@
  * #GtkTreeModel rows that are requested and rendered in the same context.
  *
  * #GtkCellLayout widgets can create any number of contexts in which to
- * request and render groups of data rows. However, it's important that the
+ * request and render groups of data rows. However, it’s important that the
  * same context which was used to request sizes for a given #GtkTreeModel
  * row also be used for the same row when calling other #GtkCellArea APIs
  * such as gtk_cell_area_render() and gtk_cell_area_event().
@@ -330,7 +330,7 @@ gtk_cell_area_context_real_allocate (GtkCellAreaContext *context,
  * fetch information about the area it is being used for.
  *
  * For instance at #GtkCellAreaContextClass.allocate() time
- * it's important to know details about any cell spacing
+ * it’s important to know details about any cell spacing
  * that the #GtkCellArea is configured with in order to
  * compute a proper allocation.
  *
diff --git a/gtk/gtkcellareacontext.h b/gtk/gtkcellareacontext.h
index cf35a626b7..c9f19c198c 100644
--- a/gtk/gtkcellareacontext.h
+++ b/gtk/gtkcellareacontext.h
@@ -57,9 +57,9 @@ struct _GtkCellAreaContext
  * @reset: Clear any previously stored information about requested and
  *     allocated sizes for the context.
  * @get_preferred_height_for_width: Returns the aligned height for the given
- *     width that context must store while collecting sizes for it's rows.
+ *     width that context must store while collecting sizes for it’s rows.
  * @get_preferred_width_for_height: Returns the aligned width for the given
- *     height that context must store while collecting sizes for it's rows.
+ *     height that context must store while collecting sizes for it’s rows.
  */
 struct _GtkCellAreaContextClass
 {
diff --git a/gtk/gtkcelllayout.h b/gtk/gtkcelllayout.h
index a0e17d509f..13cd9b23f9 100644
--- a/gtk/gtkcelllayout.h
+++ b/gtk/gtkcelllayout.h
@@ -46,7 +46,7 @@ typedef struct _GtkCellLayoutIface      GtkCellLayoutIface;
  * @iter: a #GtkTreeIter indicating the row to set the value for
  * @data: user data passed to gtk_cell_layout_set_cell_data_func()
  *
- * A function which should set the value of @cell_layout's cell renderer(s)
+ * A function which should set the value of @cell_layout’s cell renderer(s)
  * as appropriate. 
  */
 typedef void (* GtkCellLayoutDataFunc) (GtkCellLayout   *cell_layout,
diff --git a/gtk/gtkcellrenderer.c b/gtk/gtkcellrenderer.c
index e72672228a..b58f66c1bb 100644
--- a/gtk/gtkcellrenderer.c
+++ b/gtk/gtkcellrenderer.c
@@ -46,7 +46,7 @@
  * is rendered in the correct location using gtk_cell_renderer_render().
  *
  * There are a number of rules that must be followed when writing a new
- * #GtkCellRenderer.  First and foremost, it's important that a certain set
+ * #GtkCellRenderer.  First and foremost, it’s important that a certain set
  * of properties will always yield a cell renderer of the same size,
  * barring a #GtkStyle change.  The #GtkCellRenderer also has a number of
  * generic properties that are expected to be honored by all children.
@@ -962,7 +962,7 @@ gtk_cell_renderer_get_fixed_size (GtkCellRenderer *cell,
  * @xalign: the x alignment of the cell renderer
  * @yalign: the y alignment of the cell renderer
  *
- * Sets the renderer's alignment within its available space.
+ * Sets the renderer’s alignment within its available space.
  *
  * Since: 2.18
  **/
@@ -1032,7 +1032,7 @@ gtk_cell_renderer_get_alignment (GtkCellRenderer *cell,
  * @xpad: the x padding of the cell renderer
  * @ypad: the y padding of the cell renderer
  *
- * Sets the renderer's padding.
+ * Sets the renderer’s padding.
  *
  * Since: 2.18
  **/
@@ -1100,7 +1100,7 @@ gtk_cell_renderer_get_padding (GtkCellRenderer *cell,
  * @cell: A #GtkCellRenderer
  * @visible: the visibility of the cell
  *
- * Sets the cell renderer's visibility.
+ * Sets the cell renderer’s visibility.
  *
  * Since: 2.18
  **/
@@ -1125,7 +1125,7 @@ gtk_cell_renderer_set_visible (GtkCellRenderer *cell,
  * gtk_cell_renderer_get_visible:
  * @cell: A #GtkCellRenderer
  *
- * Returns the cell renderer's visibility.
+ * Returns the cell renderer’s visibility.
  *
  * Returns: %TRUE if the cell renderer is visible
  *
@@ -1144,7 +1144,7 @@ gtk_cell_renderer_get_visible (GtkCellRenderer *cell)
  * @cell: A #GtkCellRenderer
  * @sensitive: the sensitivity of the cell
  *
- * Sets the cell renderer's sensitivity.
+ * Sets the cell renderer’s sensitivity.
  *
  * Since: 2.18
  **/
@@ -1169,7 +1169,7 @@ gtk_cell_renderer_set_sensitive (GtkCellRenderer *cell,
  * gtk_cell_renderer_get_sensitive:
  * @cell: A #GtkCellRenderer
  *
- * Returns the cell renderer's sensitivity.
+ * Returns the cell renderer’s sensitivity.
  *
  * Returns: %TRUE if the cell renderer is sensitive
  *
@@ -1454,7 +1454,7 @@ gtk_cell_renderer_get_request_mode (GtkCellRenderer *cell)
  * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL
  * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
  *
- * Retreives a renderer's natural size when rendered to @widget.
+ * Retreives a renderer’s natural size when rendered to @widget.
  *
  * Since: 3.0
  */
@@ -1502,7 +1502,7 @@ gtk_cell_renderer_get_preferred_width (GtkCellRenderer *cell,
  * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL
  * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
  *
- * Retreives a renderer's natural size when rendered to @widget.
+ * Retreives a renderer’s natural size when rendered to @widget.
  *
  * Since: 3.0
  */
@@ -1551,7 +1551,7 @@ gtk_cell_renderer_get_preferred_height (GtkCellRenderer *cell,
  * @minimum_width: (out) (allow-none): location for storing the minimum size, or %NULL
  * @natural_width: (out) (allow-none): location for storing the preferred size, or %NULL
  *
- * Retreives a cell renderers's minimum and natural width if it were rendered to 
+ * Retreives a cell renderers’s minimum and natural width if it were rendered to 
  * @widget with the specified @height.
  *
  * Since: 3.0
@@ -1601,7 +1601,7 @@ gtk_cell_renderer_get_preferred_width_for_height (GtkCellRenderer *cell,
  * @minimum_height: (out) (allow-none): location for storing the minimum size, or %NULL
  * @natural_height: (out) (allow-none): location for storing the preferred size, or %NULL
  *
- * Retreives a cell renderers's minimum and natural height if it were rendered to 
+ * Retreives a cell renderers’s minimum and natural height if it were rendered to 
  * @widget with the specified @width.
  *
  * Since: 3.0
@@ -1651,7 +1651,7 @@ gtk_cell_renderer_get_preferred_height_for_width (GtkCellRenderer *cell,
  * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL
  *
  * Retrieves the minimum and natural size of a cell taking
- * into account the widget's preference for height-for-width management.
+ * into account the widget’s preference for height-for-width management.
  *
  * Since: 3.0
  */
diff --git a/gtk/gtkcellrenderer.h b/gtk/gtkcellrenderer.h
index afa45ecf51..679b21b8ee 100644
--- a/gtk/gtkcellrenderer.h
+++ b/gtk/gtkcellrenderer.h
@@ -94,10 +94,10 @@ struct _GtkCellRenderer
  * GtkCellRendererClass:
  * @get_request_mode: Called to gets whether the cell renderer prefers
  *    a height-for-width layout or a width-for-height layout.
- * @get_preferred_width: Called to get a renderer's natural width.
- * @get_preferred_height_for_width: Called to get a renderer's natural height for width.
- * @get_preferred_height: Called to get a renderer's natural height.
- * @get_preferred_width_for_height: Called to get a renderer's natural width for height.
+ * @get_preferred_width: Called to get a renderer’s natural width.
+ * @get_preferred_height_for_width: Called to get a renderer’s natural height for width.
+ * @get_preferred_height: Called to get a renderer’s natural height.
+ * @get_preferred_width_for_height: Called to get a renderer’s natural width for height.
  * @get_aligned_area: Called to get the aligned area used by @cell inside @cell_area.
  * @get_size: Called to get the width and height needed to render the cell. Deprecated: 3.0.
  * @render: Called to render the content of the #GtkCellRenderer.
diff --git a/gtk/gtkcellview.c b/gtk/gtkcellview.c
index d30f6d2f6a..f577dcd14b 100644
--- a/gtk/gtkcellview.c
+++ b/gtk/gtkcellview.c
@@ -1435,7 +1435,7 @@ gtk_cell_view_get_fit_model (GtkCellView     *cell_view)
  * Sets whether @cell_view should request space to fit the entire #GtkTreeModel.
  *
  * This is used by #GtkComboBox to ensure that the cell view displayed on
- * the combo box's button always gets enough space and does not resize
+ * the combo box’s button always gets enough space and does not resize
  * when selection changes.
  *
  * Since: 3.0
diff --git a/gtk/gtkcheckmenuitem.c b/gtk/gtkcheckmenuitem.c
index 059b464d71..54c23bf21f 100644
--- a/gtk/gtkcheckmenuitem.c
+++ b/gtk/gtkcheckmenuitem.c
@@ -314,7 +314,7 @@ gtk_check_menu_item_new_with_mnemonic (const gchar *label)
  * @check_menu_item: a #GtkCheckMenuItem.
  * @is_active: boolean value indicating whether the check box is active.
  *
- * Sets the active state of the menu item's check box.
+ * Sets the active state of the menu item’s check box.
  */
 void
 gtk_check_menu_item_set_active (GtkCheckMenuItem *check_menu_item,
diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c
index 99a071386a..9c361f4767 100644
--- a/gtk/gtkclipboard.c
+++ b/gtk/gtkclipboard.c
@@ -79,7 +79,7 @@
  * simply free the data blob. The latter is more useful when the
  * contents of clipboard reflect the internal state of a #GObject
  * (As an example, for the PRIMARY clipboard, when an entry widget
- * provides the clipboard's contents the contents are simply the
+ * provides the clipboard’s contents the contents are simply the
  * text within the selected region.) If the contents change, the
  * entry widget can call gtk_clipboard_set_with_owner() to update
  * the timestamp for clipboard ownership, without having to worry
@@ -337,7 +337,7 @@ clipboard_display_closed (GdkDisplay   *display,
  * selections under the X window system. On Win32 the
  * #GDK_SELECTION_PRIMARY clipboard is essentially ignored.)
  *
- * It's possible to have arbitrary named clipboards; if you do invent
+ * It’s possible to have arbitrary named clipboards; if you do invent
  * 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,
@@ -1123,7 +1123,7 @@ request_rich_text_received_func (GtkClipboard     *clipboard,
  *
  * The @text parameter to @callback will contain the resulting rich
  * text if the request succeeded, or %NULL if it failed. The @length
- * parameter will contain @text's length. This function can fail for
+ * parameter will contain @text’s length. This function can fail for
  * various reasons, in particular if the clipboard was empty or if the
  * contents of the clipboard could not be converted into rich text form.
  *
@@ -1960,7 +1960,7 @@ gtk_clipboard_owner_change (GtkClipboard        *clipboard,
  * 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
+ * If you want to see if there’s text available on the clipboard, use
  * gtk_clipboard_wait_is_text_available () instead.
  *
  * Return value: %TRUE if the target is available, %FALSE otherwise.
diff --git a/gtk/gtkcombobox.c b/gtk/gtkcombobox.c
index 5a33a01cd3..cf7bbb48e4 100644
--- a/gtk/gtkcombobox.c
+++ b/gtk/gtkcombobox.c
@@ -4255,14 +4255,14 @@ gtk_combo_box_set_column_span_column (GtkComboBox *combo_box,
  * gtk_combo_box_get_active:
  * @combo_box: A #GtkComboBox
  *
- * Returns the index of the currently active item, or -1 if there's no
+ * Returns the index of the currently active item, or -1 if there’s no
  * active item. If the model is a non-flat treemodel, and the active item
  * is not an immediate child of the root of the tree, this function returns
  * `gtk_tree_path_get_indices (path)[0]`, where
  * `path` is the #GtkTreePath of the active item.
  *
  * Return value: An integer which is the index of the currently active item,
- *     or -1 if there's no active item.
+ *     or -1 if there’s no active item.
  *
  * Since: 2.4
  */
@@ -5067,7 +5067,7 @@ gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box,
  * Gets the current title of the menu in tearoff mode. See
  * gtk_combo_box_set_add_tearoffs().
  *
- * Returns: the menu's title in tearoff mode. This is an internal copy of the
+ * Returns: the menu’s title in tearoff mode. This is an internal copy of the
  * string which must not be freed.
  *
  * Since: 2.10
@@ -5100,7 +5100,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS;
  * @combo_box: a #GtkComboBox
  * @title: a title for the menu in tearoff mode
  *
- * Sets the menu's title in tearoff mode.
+ * Sets the menu’s title in tearoff mode.
  *
  * Since: 2.10
  *
@@ -5134,7 +5134,7 @@ gtk_combo_box_set_title (GtkComboBox *combo_box,
  * @combo_box: a #GtkComboBox
  * @fixed: whether to use a fixed popup width
  *
- * Specifies whether the popup's width should be a fixed width
+ * Specifies whether the popup’s width should be a fixed width
  * matching the allocated width of the combo box.
  *
  * Since: 3.0
@@ -5177,13 +5177,13 @@ gtk_combo_box_get_popup_fixed_width (GtkComboBox *combo_box)
  * gtk_combo_box_get_popup_accessible:
  * @combo_box: a #GtkComboBox
  *
- * Gets the accessible object corresponding to the combo box's popup.
+ * Gets the accessible object corresponding to the combo box’s popup.
  *
  * This function is mostly intended for use by accessibility technologies;
  * applications should have little use for it.
  *
  * Returns: (transfer none): the accessible object corresponding
- *     to the combo box's popup.
+ *     to the combo box’s popup.
  *
  * Since: 2.6
  */
diff --git a/gtk/gtkcombobox.h b/gtk/gtkcombobox.h
index a4277121a2..0cded838b7 100644
--- a/gtk/gtkcombobox.h
+++ b/gtk/gtkcombobox.h
@@ -52,7 +52,7 @@ struct _GtkComboBox
  * @parent_class: The parent class.
  * @changed: Signal is emitted when the active item is changed.
  * @format_entry_text: Signal which allows you to change how the text
- *    displayed in a combo box's entry is displayed.
+ *    displayed in a combo box’s entry is displayed.
  */
 struct _GtkComboBoxClass
 {
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index 202668c9d2..db6e26f76e 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -86,8 +86,8 @@
  * width-for-height).
  *
  * There are some things to keep in mind when implementing container widgets
- * that make use of GTK+'s height for width geometry management system. First,
- * it's important to note that a container must prioritize one of its
+ * that make use of GTK+’s height for width geometry management system. First,
+ * it’s important to note that a container must prioritize one of its
  * dimensions, that is to say that a widget or container can only have a
  * #GtkSizeRequestMode that is %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH or
  * %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT. However, every widget and container
@@ -161,7 +161,7 @@
  * The container will then move on to request the preferred height for each child by using
  * gtk_widget_get_preferred_height_for_width() and using the sizes stored in the #GtkRequestedSize array.
  *
- * To allocate a height-for-width container, it's again important
+ * To allocate a height-for-width container, it’s again important
  * to consider that a container must prioritize one dimension over the other. So if
  * a container is a height-for-width container it must first allocate all widgets horizontally
  * using a #GtkRequestedSize array and gtk_distribute_natural_allocation() and then add any
@@ -177,7 +177,7 @@
  * that the container adds. Then vertical expand space should be added where appropriate and available
  * and the container should go on to actually allocating the child widgets.
  *
- * See [GtkWidget's geometry management section][geometry-management]
+ * See [GtkWidget’s geometry management section][geometry-management]
  * to learn more about implementing height-for-width geometry management for widgets.
  *
  * # Child properties
@@ -1554,9 +1554,9 @@ gtk_container_add (GtkContainer *container,
  * Note that @container will own a reference to @widget, and that this
  * may be the last reference held; so removing a widget from its
  * container can destroy that widget. If you want to use @widget
- * again, you need to add a reference to it while it's not inside
+ * again, you need to add a reference to it while it’s not inside
  * a container, using g_object_ref(). If you don't want to use @widget
- * again it's usually more efficient to simply destroy it directly
+ * again it’s usually more efficient to simply destroy it directly
  * using gtk_widget_destroy() since this will remove it from the
  * container and help break any circular reference count cycles.
  **/
@@ -1588,7 +1588,7 @@ _gtk_container_dequeue_resize_handler (GtkContainer *container)
  * Sets the resize mode for the container.
  *
  * The resize mode of a container determines whether a resize request
- * will be passed to the container's parent, queued for later execution
+ * will be passed to the container’s parent, queued for later execution
  * or executed immediately.
  *
  * Deprecated: 3.12: Resize modes are deprecated. They aren't necessary
@@ -1645,7 +1645,7 @@ gtk_container_get_resize_mode (GtkContainer *container)
 /**
  * gtk_container_set_reallocate_redraws:
  * @container: a #GtkContainer
- * @needs_redraws: the new value for the container's @reallocate_redraws flag
+ * @needs_redraws: the new value for the container’s @reallocate_redraws flag
  *
  * Sets the @reallocate_redraws flag of the container to the given value.
  *
@@ -2212,10 +2212,10 @@ gtk_container_get_focus_child (GtkContainer *container)
  * gtk_container_get_children:
  * @container: a #GtkContainer
  *
- * Returns the container's non-internal children. See
+ * Returns the container’s non-internal children. See
  * gtk_container_forall() for details on what constitutes an "internal" child.
  *
- * Return value: (element-type GtkWidget) (transfer container): a newly-allocated list of the container's non-internal children.
+ * Return value: (element-type GtkWidget) (transfer container): a newly-allocated list of the container’s non-internal children.
  **/
 GList*
 gtk_container_get_children (GtkContainer *container)
@@ -3041,7 +3041,7 @@ chain_widget_destroyed (GtkWidget *widget,
  * Sets a focus chain, overriding the one computed automatically by GTK+.
  *
  * In principle each widget in the chain should be a descendant of the
- * container, but this is not enforced by this method, since it's allowed
+ * container, but this is not enforced by this method, since it’s allowed
  * to set the focus chain before you pack the widgets, or have a widget
  * in the chain that isn't always packed. The necessary checks are done
  * when the focus chain is actually traversed.
@@ -3455,7 +3455,7 @@ gtk_container_should_propagate_draw (GtkContainer   *container,
  * @container: a #GtkContainer
  * @child: a child of @container
  * @cr: Cairo context as passed to the container. If you want to use @cr
- *   in container's draw function, consider using cairo_save() and
+ *   in container’s draw function, consider using cairo_save() and
  *   cairo_restore() before calling this function.
  *
  * When a container receives a call to the draw function, it must send
diff --git a/gtk/gtkcontainer.h b/gtk/gtkcontainer.h
index 29d510fe63..00c3936b4d 100644
--- a/gtk/gtkcontainer.h
+++ b/gtk/gtkcontainer.h
@@ -64,7 +64,7 @@ struct _GtkContainer
  * @forall: Invokes callback on each child of container.
  * @set_focus_child: Sets the focused child of container.
  * @child_type: Returns the type of the children supported by the container.
- * @composite_name: Gets a widget's composite name. Deprecated: 3.10.
+ * @composite_name: Gets a widget’s composite name. Deprecated: 3.10.
  * @set_child_property: Set a property on a child of container.
  * @get_child_property: Get a property from a child of container.
  * @get_path_for_child: Get path representing entire widget hierarchy
diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c
index 04cfab3457..2792acf79a 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -123,7 +123,7 @@
  *     background-color: #898989
  * }
  *
- * /&ast; Theme notebooks, and anything that's within these &ast;/
+ * /&ast; Theme notebooks, and anything that’s within these &ast;/
  * GtkNotebook {
  *     background-color: #a939f0
  * }
@@ -269,7 +269,7 @@
  *
  * # &commat; Rules
  *
- * GTK+'s CSS supports the &commat;import rule, in order to load another
+ * GTK+’s CSS supports the &commat;import rule, in order to load another
  * CSS style sheet in addition to the currently parsed one.
  *
  * An example for using the &commat;import rule:
@@ -404,7 +404,7 @@
  *       </row>
  *       <row>
  *         <entry>alpha(@color, @f)</entry>
- *         <entry>Modifies passed color's alpha by a factor @f. @f is a
+ *         <entry>Modifies passed color’s alpha by a factor @f. @f is a
  *                floating point number. @f < 1.0 results in a more transparent
  *                color while @f > 1.0 results in a more opaque color.
  *         </entry>
diff --git a/gtk/gtkcsssection.h b/gtk/gtkcsssection.h
index 7966982f12..4f88eee0ee 100644
--- a/gtk/gtkcsssection.h
+++ b/gtk/gtkcsssection.h
@@ -44,7 +44,7 @@ G_BEGIN_DECLS
  *   Animations](http://dev.w3.org/csswg/css3-animations/#keyframes) for details. Since 3.6
  *
  * The different types of sections indicate parts of a CSS document as
- * parsed by GTK's CSS parser. They are oriented towards the
+ * parsed by GTK’s CSS parser. They are oriented towards the
  * [CSS Grammar](http://www.w3.org/TR/CSS21/grammar.html),
  * but may contain extensions.
  *
diff --git a/gtk/gtkcssstyleproperty.c b/gtk/gtkcssstyleproperty.c
index 33d6bda256..5468d20fbc 100644
--- a/gtk/gtkcssstyleproperty.c
+++ b/gtk/gtkcssstyleproperty.c
@@ -363,7 +363,7 @@ _gtk_css_style_property_get_n_properties (void)
  * @id: the id of the property
  *
  * Gets the style property with the given id. All style properties (but not
- * shorthand properties) are indexable by id so that it's easy to use arrays
+ * shorthand properties) are indexable by id so that it’s easy to use arrays
  * when doing style lookups.
  *
  * Returns: (transfer none): The style property with the given id
diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c
index cf09b250f3..e5b2c03c2f 100644
--- a/gtk/gtkdialog.c
+++ b/gtk/gtkdialog.c
@@ -52,7 +52,7 @@
  *
  * Dialog boxes are a convenient way to prompt the user for a small amount
  * of input, e.g. to display a message, ask a question, or anything else
- * that does not require extensive effort on the user's part.
+ * that does not require extensive effort on the user’s part.
  *
  * GTK+ treats a dialog as a window split vertically. The top section is a
  * #GtkVBox, and is where widgets such as a #GtkLabel or a #GtkEntry should
@@ -842,7 +842,7 @@ gtk_dialog_new_empty (const gchar     *title,
  * #GTK_DIALOG_DESTROY_WITH_PARENT flag. Buttons are from left to right,
  * so the first button in the list will be the leftmost button in the dialog.
  *
- * Here's a simple example:
+ * Here’s a simple example:
  * |[<!-- language="C" -->
  *  GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog",
  *                                                   main_app_window,
@@ -914,7 +914,7 @@ get_response_data (GtkWidget *widget,
  * Adds an activatable widget to the action area of a #GtkDialog,
  * connecting a signal handler that will emit the #GtkDialog::response
  * signal on the dialog when the widget is activated. The widget is
- * appended to the end of the dialog's action area. If you want to add a
+ * appended to the end of the dialog’s action area. If you want to add a
  * non-activatable widget, simply pack it into the @action_area field
  * of the #GtkDialog struct.
  **/
@@ -945,7 +945,7 @@ gtk_dialog_add_action_widget (GtkDialog *dialog,
  * Adds a button with the given text and sets things up so that
  * clicking the button will emit the #GtkDialog::response signal with
  * the given @response_id. The button is appended to the end of the
- * dialog's action area. The button widget is returned, but usually
+ * dialog’s action area. The button widget is returned, but usually
  * you don't need it.
  *
  * Return value: (transfer none): the #GtkButton widget that was added
@@ -1045,7 +1045,7 @@ gtk_dialog_add_buttons (GtkDialog   *dialog,
  * @setting: %TRUE for sensitive
  *
  * Calls `gtk_widget_set_sensitive (widget, @setting)`
- * for each widget in the dialog's action area with the given @response_id.
+ * for each widget in the dialog’s action area with the given @response_id.
  * A convenient way to sensitize/desensitize dialog buttons.
  **/
 void
@@ -1080,7 +1080,7 @@ gtk_dialog_set_response_sensitive (GtkDialog *dialog,
  * @dialog: a #GtkDialog
  * @response_id: a response ID
  *
- * Sets the last widget in the dialog's action area with the given @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
  * the default widget.
  **/
@@ -1449,8 +1449,8 @@ gtk_dialog_set_alternative_button_order_valist (GtkDialog *dialog,
 /**
  * gtk_dialog_set_alternative_button_order:
  * @dialog: a #GtkDialog
- * @first_response_id: a response id used by one @dialog's buttons
- * @...: a list of more response ids of @dialog's buttons, terminated by -1
+ * @first_response_id: a response id used by one @dialog’s buttons
+ * @...: a list of more response ids of @dialog’s buttons, terminated by -1
  *
  * Sets an alternative button order. If the
  * #GtkSettings:gtk-alternative-button-order setting is set to %TRUE,
@@ -1520,7 +1520,7 @@ gtk_dialog_set_alternative_button_order (GtkDialog *dialog,
  * @dialog: a #GtkDialog
  * @n_params: the number of response ids in @new_order
  * @new_order: (array length=n_params): an array of response ids of
- *     @dialog's buttons
+ *     @dialog’s buttons
  *
  * Sets an alternative button order. If the
  * #GtkSettings:gtk-alternative-button-order setting is set to %TRUE,
diff --git a/gtk/gtkdnd-quartz.c b/gtk/gtkdnd-quartz.c
index 8420612e30..e1680f4957 100644
--- a/gtk/gtkdnd-quartz.c
+++ b/gtk/gtkdnd-quartz.c
@@ -597,7 +597,7 @@ gtk_drag_dest_get_target_list (GtkWidget *widget)
 
 /**
  * gtk_drag_dest_set_target_list: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  * @target_list: (allow-none): list of droppable targets, or %NULL for none
  */
 void
@@ -630,7 +630,7 @@ gtk_drag_dest_set_target_list (GtkWidget      *widget,
 
 /**
  * gtk_drag_dest_add_text_targets: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  */
 void
 gtk_drag_dest_add_text_targets (GtkWidget *widget)
@@ -650,7 +650,7 @@ gtk_drag_dest_add_text_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_dest_add_image_targets: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  */
 void
 gtk_drag_dest_add_image_targets (GtkWidget *widget)
@@ -669,7 +669,7 @@ gtk_drag_dest_add_image_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_dest_add_uri_targets: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  */
 void
 gtk_drag_dest_add_uri_targets (GtkWidget *widget)
@@ -940,7 +940,7 @@ gtk_drag_dest_drop (GtkWidget	     *widget,
 
 /**
  * gtk_drag_dest_set_track_motion: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  * @track_motion: whether to accept all targets
  */
 void
@@ -960,7 +960,7 @@ gtk_drag_dest_set_track_motion (GtkWidget *widget,
 
 /**
  * gtk_drag_dest_get_track_motion: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  */
 gboolean
 gtk_drag_dest_get_track_motion (GtkWidget *widget)
@@ -1524,7 +1524,7 @@ gtk_drag_source_get_target_list (GtkWidget *widget)
 
 /**
  * gtk_drag_source_set_target_list: (method)
- * @widget: a #GtkWidget that's a drag source
+ * @widget: a #GtkWidget that’s a drag source
  * @target_list: (allow-none): list of draggable targets, or %NULL for none
  */
 void
@@ -1554,7 +1554,7 @@ gtk_drag_source_set_target_list (GtkWidget     *widget,
 
 /**
  * gtk_drag_source_add_text_targets:
- * @widget: a #GtkWidget that's is a drag source
+ * @widget: a #GtkWidget that’s is a drag source
  *
  * Add the text targets supported by #GtkSelection to
  * the target list of the drag source.  The targets
@@ -1581,7 +1581,7 @@ gtk_drag_source_add_text_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_source_add_image_targets: (method)
- * @widget: a #GtkWidget that's is a drag source
+ * @widget: a #GtkWidget that’s is a drag source
  */
 void
 gtk_drag_source_add_image_targets (GtkWidget *widget)
@@ -1600,7 +1600,7 @@ gtk_drag_source_add_image_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_source_add_uri_targets: (method)
- * @widget: a #GtkWidget that's is a drag source
+ * @widget: a #GtkWidget that’s is a drag source
  */
 void
 gtk_drag_source_add_uri_targets (GtkWidget *widget)
diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c
index 1c864ffa4a..f290aa6782 100644
--- a/gtk/gtkdnd.c
+++ b/gtk/gtkdnd.c
@@ -1357,10 +1357,10 @@ gtk_drag_dest_set_internal (GtkWidget       *widget,
  * Sets a widget as a potential drop destination, and adds default behaviors.
  *
  * The default behaviors listed in @flags have an effect similar
- * to installing default handlers for the widget's drag-and-drop signals
+ * to installing default handlers for the widget’s drag-and-drop signals
  * (#GtkWidget::drag-motion, #GtkWidget::drag-drop, ...). They all exist
  * for convenience. When passing #GTK_DEST_DEFAULT_ALL for instance it is
- * sufficient to connect to the widget's #GtkWidget::drag-data-received
+ * sufficient to connect to the widget’s #GtkWidget::drag-data-received
  * signal to get primitive, but consistent drag-and-drop support.
  *
  * Things become more complicated when you try to preview the dragged data,
@@ -1372,8 +1372,8 @@ gtk_drag_dest_set_internal (GtkWidget       *widget,
  * Especially the later is dramatic, when your own #GtkWidget::drag-motion
  * handler calls gtk_drag_get_data() to inspect the dragged data.
  *
- * There's no way to set a default action here, you can use the
- * #GtkWidget::drag-motion callback for that. Here's an example which selects
+ * There’s no way to set a default action here, you can use the
+ * #GtkWidget::drag-motion callback for that. Here’s an example which selects
  * the action to use depending on whether the control key is pressed or not:
  * |[<!-- language="C" -->
  * static void
@@ -1514,7 +1514,7 @@ gtk_drag_dest_get_target_list (GtkWidget *widget)
 
 /**
  * gtk_drag_dest_set_target_list: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  * @target_list: (allow-none): list of droppable targets, or %NULL for none
  * 
  * Sets the target types that this widget can accept from drag-and-drop.
@@ -1549,7 +1549,7 @@ gtk_drag_dest_set_target_list (GtkWidget      *widget,
 
 /**
  * gtk_drag_dest_add_text_targets: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  *
  * Add the text targets supported by #GtkSelectionData to
  * the target list of the drag destination. The targets
@@ -1576,7 +1576,7 @@ gtk_drag_dest_add_text_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_dest_add_image_targets: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  *
  * Add the image targets supported by #GtkSelectionData to
  * the target list of the drag destination. The targets
@@ -1603,7 +1603,7 @@ gtk_drag_dest_add_image_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_dest_add_uri_targets: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  *
  * Add the URI targets supported by #GtkSelectionData to
  * the target list of the drag destination. The targets
@@ -1630,7 +1630,7 @@ gtk_drag_dest_add_uri_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_dest_set_track_motion: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  * @track_motion: whether to accept all targets
  *
  * Tells the widget to emit #GtkWidget::drag-motion and
@@ -1659,7 +1659,7 @@ gtk_drag_dest_set_track_motion (GtkWidget *widget,
 
 /**
  * gtk_drag_dest_get_track_motion: (method)
- * @widget: a #GtkWidget that's a drag destination
+ * @widget: a #GtkWidget that’s a drag destination
  *
  * Returns whether the widget has been configured to always
  * emit #GtkWidget::drag-motion signals.
@@ -2857,7 +2857,7 @@ gtk_drag_source_get_target_list (GtkWidget *widget)
 
 /**
  * gtk_drag_source_set_target_list: (method)
- * @widget: a #GtkWidget that's a drag source
+ * @widget: a #GtkWidget that’s a drag source
  * @target_list: (allow-none): list of draggable targets, or %NULL for none
  *
  * Changes the target types that this widget offers for drag-and-drop.
@@ -2893,7 +2893,7 @@ gtk_drag_source_set_target_list (GtkWidget     *widget,
 
 /**
  * gtk_drag_source_add_text_targets: (method)
- * @widget: a #GtkWidget that's is a drag source
+ * @widget: a #GtkWidget that’s is a drag source
  *
  * Add the text targets supported by #GtkSelectionData to
  * the target list of the drag source.  The targets
@@ -2920,7 +2920,7 @@ gtk_drag_source_add_text_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_source_add_image_targets: (method)
- * @widget: a #GtkWidget that's is a drag source
+ * @widget: a #GtkWidget that’s is a drag source
  *
  * Add the writable image targets supported by #GtkSelectionData to
  * the target list of the drag source. The targets
@@ -2947,7 +2947,7 @@ gtk_drag_source_add_image_targets (GtkWidget *widget)
 
 /**
  * gtk_drag_source_add_uri_targets: (method)
- * @widget: a #GtkWidget that's is a drag source
+ * @widget: a #GtkWidget that’s is a drag source
  *
  * Add the URI targets supported by #GtkSelectionData to
  * the target list of the drag source.  The targets
diff --git a/gtk/gtkdnd.h b/gtk/gtkdnd.h
index 83fda61cee..c7060da857 100644
--- a/gtk/gtkdnd.h
+++ b/gtk/gtkdnd.h
@@ -40,14 +40,14 @@ G_BEGIN_DECLS
 /**
  * GtkDestDefaults:
  * @GTK_DEST_DEFAULT_MOTION: If set for a widget, GTK+, during a drag over this
- *   widget will check if the drag matches this widget's list of possible targets
+ *   widget will check if the drag matches this widget’s list of possible targets
  *   and actions.
  *   GTK+ will then call gdk_drag_status() as appropriate.
  * @GTK_DEST_DEFAULT_HIGHLIGHT: If set for a widget, GTK+ will draw a highlight on
  *   this widget as long as a drag is over this widget and the widget drag format
  *   and action are acceptable.
  * @GTK_DEST_DEFAULT_DROP: If set for a widget, when a drop occurs, GTK+ will
- *   will check if the drag matches this widget's list of possible targets and
+ *   will check if the drag matches this widget’s list of possible targets and
  *   actions. If so, GTK+ will call gtk_drag_get_data() on behalf of the widget.
  *   Whether or not the drop is successful, GTK+ will call gtk_drag_finish(). If
  *   the action was a move, then if the drag was successful, then %TRUE will be
diff --git a/gtk/gtkdrawingarea.c b/gtk/gtkdrawingarea.c
index ca5f34e246..f2775ea803 100644
--- a/gtk/gtkdrawingarea.c
+++ b/gtk/gtkdrawingarea.c
@@ -35,7 +35,7 @@
  * @See_also: #GtkImage
  *
  * The #GtkDrawingArea widget is used for creating custom user interface
- * elements. It's essentially a blank widget; you can draw on it. After
+ * elements. It’s essentially a blank widget; you can draw on it. After
  * creating a drawing area, the application may want to connect to:
  *
  * - Mouse and button press signals to respond to input from
@@ -93,9 +93,9 @@
  * ]|
  *
  * Draw signals are normally delivered when a drawing area first comes
- * onscreen, or when it's covered by another window and then uncovered.
+ * 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”
- * of the drawing area's window; gtk_widget_queue_draw_area() and
+ * 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.
  *
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index b10db21b94..7715e05ae7 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -7422,7 +7422,7 @@ gtk_entry_set_buffer (GtkEntry       *entry,
  * @entry: a #GtkEntry
  * @text_area: (out): Return location for the text area.
  *
- * Gets the area where the entry's text is drawn. This function is
+ * Gets the area where the entry’s text is drawn. This function is
  * useful when drawing something to the entry in a draw callback.
  *
  * If the entry is not realized, @text_area is filled with zeros.
@@ -7800,7 +7800,7 @@ gtk_entry_get_text_length (GtkEntry *entry)
 /**
  * gtk_entry_set_activates_default:
  * @entry: a #GtkEntry
- * @setting: %TRUE to activate window's default widget on Enter keypress
+ * @setting: %TRUE to activate window’s default widget on Enter keypress
  *
  * If @setting is %TRUE, pressing Enter in the @entry will activate the default
  * widget for the window containing the entry. This usually means that
@@ -7939,8 +7939,8 @@ gtk_entry_get_has_frame (GtkEntry *entry)
  * @entry: a #GtkEntry
  * @border: (allow-none): a #GtkBorder, or %NULL
  *
- * Sets %entry's inner-border property to @border, or clears it if %NULL
- * is passed. The inner-border is the area around the entry's text, but
+ * Sets %entry’s inner-border property to @border, or clears it if %NULL
+ * is passed. The inner-border is the area around the entry’s text, but
  * inside its frame.
  *
  * If set, this property overrides the inner-border style property.
@@ -7967,10 +7967,10 @@ gtk_entry_set_inner_border (GtkEntry        *entry,
  * gtk_entry_get_inner_border:
  * @entry: a #GtkEntry
  *
- * This function returns the entry's #GtkEntry:inner-border property. See
+ * This function returns the entry’s #GtkEntry:inner-border property. See
  * gtk_entry_set_inner_border() for more information.
  *
- * Return value: (transfer none): the entry's #GtkBorder, or %NULL if none was set.
+ * Return value: (transfer none): the entry’s #GtkBorder, or %NULL if none was set.
  *
  * Since: 2.10
  *
@@ -8023,7 +8023,7 @@ gtk_entry_get_layout (GtkEntry *entry)
  * 
  * Converts from a position in the entry contents (returned
  * by gtk_entry_get_text()) to a position in the
- * entry's #PangoLayout (returned by gtk_entry_get_layout(),
+ * entry’s #PangoLayout (returned by gtk_entry_get_layout(),
  * with text retrieved via pango_layout_get_text()).
  * 
  * Return value: byte index into the entry contents
@@ -8061,7 +8061,7 @@ gtk_entry_layout_index_to_text_index (GtkEntry *entry,
  * @entry: a #GtkEntry
  * @text_index: byte index into the entry contents
  * 
- * Converts from a position in the entry's #PangoLayout (returned by
+ * Converts from a position in the entry’s #PangoLayout (returned by
  * gtk_entry_get_layout()) to a position in the entry contents
  * (returned by gtk_entry_get_text()).
  * 
@@ -8782,7 +8782,7 @@ gtk_entry_get_icon_storage_type (GtkEntry             *entry,
  * @y: the y coordinate of the position to find
  *
  * Finds the icon at the given position and return its index. The
- * position's coordinates are relative to the @entry's top left corner.
+ * position’s coordinates are relative to the @entry’s top left corner.
  * If @x, @y doesn't lie inside an icon, -1 is returned.
  * This function is intended for use in a #GtkWidget::query-tooltip
  * signal handler.
@@ -8910,9 +8910,9 @@ gtk_entry_get_current_icon_drag_source (GtkEntry *entry)
  * gtk_entry_get_icon_area:
  * @entry: A #GtkEntry
  * @icon_pos: Icon position
- * @icon_area: (out): Return location for the icon's area
+ * @icon_area: (out): Return location for the icon’s area
  *
- * Gets the area where entry's icon at @icon_pos is drawn.
+ * Gets the area where entry’s icon at @icon_pos is drawn.
  * This function is useful when drawing something to the
  * entry in a draw callback.
  *
@@ -10189,9 +10189,9 @@ gtk_entry_get_cursor_hadjustment (GtkEntry *entry)
 /**
  * gtk_entry_set_progress_fraction:
  * @entry: a #GtkEntry
- * @fraction: fraction of the task that's been completed
+ * @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.
  *
@@ -10242,7 +10242,7 @@ gtk_entry_set_progress_fraction (GtkEntry *entry,
  * gtk_entry_get_progress_fraction:
  * @entry: a #GtkEntry
  *
- * Returns the current fraction of the task that's been completed.
+ * Returns the current fraction of the task that’s been completed.
  * See gtk_entry_set_progress_fraction().
  *
  * Return value: a fraction from 0.0 to 1.0
@@ -10312,7 +10312,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/gtkentrybuffer.c b/gtk/gtkentrybuffer.c
index 067048ff97..cf72518078 100644
--- a/gtk/gtkentrybuffer.c
+++ b/gtk/gtkentrybuffer.c
@@ -42,7 +42,7 @@
  * #GtkEntryBuffer may be derived from. Such a derived class might allow
  * text to be stored in an alternate location, such as non-pageable memory,
  * useful in the case of important passwords. Or a derived class could 
- * integrate with an application's concept of undo/redo.
+ * integrate with an application’s concept of undo/redo.
  *
  * Since: 2.18
  */
diff --git a/gtk/gtkentrycompletion.c b/gtk/gtkentrycompletion.c
index 869b64ebe0..a386adad9b 100644
--- a/gtk/gtkentrycompletion.c
+++ b/gtk/gtkentrycompletion.c
@@ -1403,7 +1403,7 @@ gtk_entry_completion_insert_action (GtkEntryCompletion *completion,
  * @index_: the index of the item to insert
  * @text: text of the item to insert
  *
- * Inserts an action in @completion's action item list at position @index_
+ * Inserts an action in @completion’s action item list at position @index_
  * with text @text. If you want the action item to have markup, use
  * gtk_entry_completion_insert_action_markup().
  *
@@ -1426,7 +1426,7 @@ gtk_entry_completion_insert_action_text (GtkEntryCompletion *completion,
  * @index_: the index of the item to insert
  * @markup: markup of the item to insert
  *
- * Inserts an action in @completion's action item list at position @index_
+ * Inserts an action in @completion’s action item list at position @index_
  * with markup @markup.
  *
  * Since: 2.4
@@ -1447,7 +1447,7 @@ gtk_entry_completion_insert_action_markup (GtkEntryCompletion *completion,
  * @completion: a #GtkEntryCompletion
  * @index_: the index of the item to delete
  *
- * Deletes the action at @index_ from @completion's action list.
+ * Deletes the action at @index_ from @completion’s action list.
  *
  * Since: 2.4
  */
@@ -1921,7 +1921,7 @@ gtk_entry_completion_real_insert_prefix (GtkEntryCompletion *completion,
  * @completion: a #GtkEntryCompletion
  *
  * Get the original text entered by the user that triggered
- * the completion or %NULL if there's no completion ongoing.
+ * the completion or %NULL if there’s no completion ongoing.
  *
  * Returns: the prefix for the current completion
  *
diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index 0b88f71e32..34efa1fc0f 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -610,7 +610,7 @@ typedef enum
  * @GTK_SELECTION_SINGLE: Zero or one element may be selected.
  * @GTK_SELECTION_BROWSE: Exactly one element is selected.
  *     In some circumstances, such as initially or during a search
- *     operation, it's possible for no element to be selected with
+ *     operation, it’s possible for no element to be selected with
  *     %GTK_SELECTION_BROWSE. What is really enforced is that the user
  *     can't deselect a currently selected element except by selecting
  *     another element.
@@ -689,7 +689,7 @@ typedef enum
  *  other, rather than vertically stacked
  *
  * Used to customize the appearance of a #GtkToolbar. Note that
- * setting the toolbar style overrides the user's preferences
+ * setting the toolbar style overrides the user’s preferences
  * for the default toolbar style.  Note that if the button has only
  * a label set and GTK_TOOLBAR_ICONS is used, the label will be
  * visible, and vice versa.
diff --git a/gtk/gtkexpander.c b/gtk/gtkexpander.c
index 270068fea3..a9bc69ab9a 100644
--- a/gtk/gtkexpander.c
+++ b/gtk/gtkexpander.c
@@ -1903,10 +1903,10 @@ gtk_expander_get_use_underline (GtkExpander *expander)
 /**
  * gtk_expander_set_use_markup:
  * @expander: a #GtkExpander
- * @use_markup: %TRUE if the label's text should be parsed for markup
+ * @use_markup: %TRUE if the label’s text should be parsed for markup
  *
  * Sets whether the text of the label contains markup in
- * [Pango's text markup language][PangoMarkupFormat].
+ * [Pango’s text markup language][PangoMarkupFormat].
  * See gtk_label_set_markup().
  *
  * Since: 2.4
@@ -1938,11 +1938,11 @@ gtk_expander_set_use_markup (GtkExpander *expander,
  * gtk_expander_get_use_markup:
  * @expander: a #GtkExpander
  *
- * Returns whether the label's text is interpreted as marked up with
+ * Returns whether the label’s text is interpreted as marked up with
  * the [Pango text markup language][PangoMarkupFormat].
  * See gtk_expander_set_use_markup().
  *
- * Return value: %TRUE if the label's text will be parsed for markup
+ * Return value: %TRUE if the label’s text will be parsed for markup
  *
  * Since: 2.4
  */
diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index 90bc88a3a2..091ef50339 100644
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -704,10 +704,10 @@ gtk_file_chooser_get_filename (GtkFileChooser *chooser)
  * @filename: (type filename): the filename to set as current
  * 
  * Sets @filename as the current filename for the file chooser, by changing to
- * the file's parent folder and actually selecting the file in list; all other
+ * the file’s parent folder and actually selecting the file in list; all other
  * files will be unselected.  If the @chooser is in
- * %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name will also appear in
- * the dialog's file name entry.
+ * %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file’s base name will also appear in
+ * the dialog’s file name entry.
  *
  * Note that the file must exist, or nothing will be done except
  * for the directory change.
@@ -733,7 +733,7 @@ gtk_file_chooser_get_filename (GtkFileChooser *chooser)
  * ]|
  *
  * In the first case, the file chooser will present the user with useful suggestions
- * as to where to save his new file.  In the second case, the file's existing location
+ * as to where to save his new file.  In the second case, the file’s existing location
  * is already known, so the file chooser will use it.
  * 
  * Return value: Not useful.
@@ -996,10 +996,10 @@ gtk_file_chooser_set_current_name  (GtkFileChooser *chooser,
  * change the extension of the typed filename based on the chosen format, say,
  * 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.
+ * UTF-8 encoding, which is not necessarily the system’s encoding for filenames.
  *
  * Since: 3.10
  **/
@@ -1057,9 +1057,9 @@ gtk_file_chooser_get_uri (GtkFileChooser *chooser)
  * @uri: the URI to set as current
  * 
  * Sets the file referred to by @uri as the current file for the file chooser,
- * by changing to the URI's parent folder and actually selecting the URI in the
- * list.  If the @chooser is %GTK_FILE_CHOOSER_ACTION_SAVE mode, the URI's base
- * name will also appear in the dialog's file name entry.
+ * by changing to the URI’s parent folder and actually selecting the URI in the
+ * list.  If the @chooser is %GTK_FILE_CHOOSER_ACTION_SAVE mode, the URI’s base
+ * name will also appear in the dialog’s file name entry.
  *
  * Note that the URI must exist, or nothing will be done except for the 
  * directory change.
@@ -1086,7 +1086,7 @@ gtk_file_chooser_get_uri (GtkFileChooser *chooser)
  *
  *
  * In the first case, the file chooser will present the user with useful suggestions
- * as to where to save his new file.  In the second case, the file's existing location
+ * as to where to save his new file.  In the second case, the file’s existing location
  * is already known, so the file chooser will use it.
  * 
  * Return value: Not useful.
@@ -1418,9 +1418,9 @@ gtk_file_chooser_get_files (GtkFileChooser *chooser)
  * @error: (allow-none): location to store the error, or %NULL to ignore errors.
  *
  * Sets @file as the current filename for the file chooser, by changing
- * to the file's parent folder and actually selecting the file in list.  If
- * the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name
- * will also appear in the dialog's file name entry.
+ * to the file’s parent folder and actually selecting the file in list.  If
+ * the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file’s base name
+ * will also appear in the dialog’s file name entry.
  *
  * If the file name isn't in the current folder of @chooser, then the current
  * folder of @chooser will be changed to the folder containing @filename. This
@@ -2012,7 +2012,7 @@ gtk_file_chooser_add_shortcut_folder (GtkFileChooser    *chooser,
  * @folder: (type filename): filename of the folder to remove
  * @error: (allow-none): location to store error, or %NULL
  * 
- * Removes a folder from a file chooser's list of shortcut folders.
+ * Removes a folder from a file chooser’s list of shortcut folders.
  * 
  * Return value: %TRUE if the operation succeeds, %FALSE otherwise.  
  * In the latter case, the @error will be set as appropriate.
@@ -2110,7 +2110,7 @@ gtk_file_chooser_add_shortcut_folder_uri (GtkFileChooser    *chooser,
  * @uri: URI of the folder to remove
  * @error: (allow-none): location to store error, or %NULL
  * 
- * Removes a folder URI from a file chooser's list of shortcut folders.
+ * Removes a folder URI from a file chooser’s list of shortcut folders.
  * 
  * Return value: %TRUE if the operation succeeds, %FALSE otherwise.  
  * In the latter case, the @error will be set as appropriate.
diff --git a/gtk/gtkfilechooser.h b/gtk/gtkfilechooser.h
index 6dff84ec2b..d1f5543e52 100644
--- a/gtk/gtkfilechooser.h
+++ b/gtk/gtkfilechooser.h
@@ -64,14 +64,14 @@ typedef enum
  * @GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM: The file chooser will present
  *  its stock dialog to confirm about overwriting an existing file.
  * @GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME: The file chooser will
- *  terminate and accept the user's choice of a file name.
+ *  terminate and accept the user’s choice of a file name.
  * @GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN: The file chooser will
  *  continue running, so as to let the user select another file name.
  *
  * Used as a return value of handlers for the
  * #GtkFileChooser::confirm-overwrite signal of a #GtkFileChooser. This
  * value determines whether the file chooser will present the stock
- * confirmation dialog, accept the user's choice of a filename, or
+ * confirmation dialog, accept the user’s choice of a filename, or
  * let the user choose another filename.
  *
  * Since: 2.8
diff --git a/gtk/gtkfilechooserbutton.c b/gtk/gtkfilechooserbutton.c
index 43d8c84677..b8c2313e62 100644
--- a/gtk/gtkfilechooserbutton.c
+++ b/gtk/gtkfilechooserbutton.c
@@ -2774,7 +2774,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.
@@ -3007,7 +3007,7 @@ gtk_file_chooser_button_set_title (GtkFileChooserButton *button,
  * Retrieves the title of the browse dialog used by @button. The returned value
  * should not be modified or freed.
  *
- * Returns: a pointer to the browse dialog's title.
+ * Returns: a pointer to the browse dialog’s title.
  *
  * Since: 2.6
  **/
@@ -3023,7 +3023,7 @@ gtk_file_chooser_button_get_title (GtkFileChooserButton *button)
  * gtk_file_chooser_button_get_width_chars:
  * @button: the button widget to examine.
  *
- * Retrieves the width in characters of the @button widget's entry and/or label.
+ * Retrieves the width in characters of the @button widget’s entry and/or label.
  *
  * Returns: an integer width (in characters) that the button will use to size itself.
  *
diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c
index 8731f41769..771f38e007 100644
--- a/gtk/gtkfilechooserdialog.c
+++ b/gtk/gtkfilechooserdialog.c
@@ -123,7 +123,7 @@
  *
  * - To choose a folder instead of a file. Use #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
  *
- * Note that old versions of the file chooser's documentation suggested
+ * Note that old versions of the file chooser’s documentation suggested
  * using gtk_file_chooser_set_current_folder() in various
  * situations, with the intention of letting the application
  * suggest a reasonable default folder.  This is no longer
diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c
index ec5cb3a548..bef5003fb0 100644
--- a/gtk/gtkfilechooserwidget.c
+++ b/gtk/gtkfilechooserwidget.c
@@ -2463,8 +2463,8 @@ put_recent_folder_in_pathbar (GtkFileChooserWidget *impl, GtkTreeIter *iter)
 }
 
 /* Sets the pathbar in the appropriate mode according to the current operation mode and action.  This is the central function for
- * dealing with the pathbar's widgets; as long as impl->action and impl->operation_mode are set correctly, then calling this
- * function will update all the pathbar's widgets.
+ * dealing with the pathbar’s widgets; as long as impl->action and impl->operation_mode are set correctly, then calling this
+ * function will update all the pathbar’s widgets.
  */
 static void
 path_bar_update (GtkFileChooserWidget *impl)
@@ -3265,7 +3265,7 @@ switch_to_cwd (GtkFileChooserWidget *impl)
 }
 
 /* Sets the file chooser to showing Recent Files or $CWD, depending on the
- * user's settings.
+ * user’s settings.
  */
 static void
 set_startup_mode (GtkFileChooserWidget *impl)
diff --git a/gtk/gtkfilesystemmodel.c b/gtk/gtkfilesystemmodel.c
index c103619464..ff60a98bc3 100644
--- a/gtk/gtkfilesystemmodel.c
+++ b/gtk/gtkfilesystemmodel.c
@@ -99,7 +99,7 @@
  * 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
- * node.  If the model happens to need a node's row number and that node is in the model->files array after
+ * node.  If the model happens to need a node’s row number and that node is in the model->files array after
  * model->n_nodes_valid, then the nodes get re-validated up to the sought node.  See node_validate_rows() for
  * this logic.
  *
diff --git a/gtk/gtkflowbox.c b/gtk/gtkflowbox.c
index 22ad2cf1a1..e13df856dd 100644
--- a/gtk/gtkflowbox.c
+++ b/gtk/gtkflowbox.c
@@ -4278,7 +4278,7 @@ gtk_flow_box_get_column_spacing (GtkFlowBox *box)
  * @n_children: the minimum number of children per line
  *
  * Sets the minimum number of children to line up
- * in @box's orientation before flowing.
+ * in @box’s orientation before flowing.
  *
  * Since: 3.12
  */
@@ -4321,7 +4321,7 @@ gtk_flow_box_get_min_children_per_line (GtkFlowBox *box)
  * @n_children: the maximum number of children per line
  *
  * Sets the maximum number of children to request and
- * allocate space for in @box's orientation.
+ * allocate space for in @box’s orientation.
  *
  * Setting the maximum number of children per line
  * limits the overall natural size request to be no more
diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index ec0f9267bc..4a2ac00109 100644
--- a/gtk/gtkframe.c
+++ b/gtk/gtkframe.c
@@ -421,7 +421,7 @@ gtk_frame_set_label (GtkFrame *frame,
  * gtk_frame_get_label:
  * @frame: a #GtkFrame
  * 
- * If the frame's label widget is a #GtkLabel, returns the
+ * If the frame’s label widget is a #GtkLabel, returns the
  * text in the label widget. (The frame will have a #GtkLabel
  * for the label widget if a non-%NULL argument was passed
  * to gtk_frame_new().)
@@ -523,7 +523,7 @@ gtk_frame_get_label_widget (GtkFrame *frame)
  *   0.0 or 1.0 the gap in the frame won't be painted because the label
  *   will be completely above or below the frame.
  * 
- * Sets the alignment of the frame widget's label. The
+ * Sets the alignment of the frame widget’s label. The
  * default values for a newly created frame are 0.0 and 0.5.
  **/
 void
@@ -561,11 +561,11 @@ gtk_frame_set_label_align (GtkFrame *frame,
  * gtk_frame_get_label_align:
  * @frame: a #GtkFrame
  * @xalign: (out) (allow-none): location to store X alignment of
- *     frame's label, or %NULL
+ *     frame’s label, or %NULL
  * @yalign: (out) (allow-none): location to store X alignment of
- *     frame's label, or %NULL
+ *     frame’s label, or %NULL
  * 
- * Retrieves the X and Y alignment of the frame's label. See
+ * Retrieves the X and Y alignment of the frame’s label. See
  * gtk_frame_set_label_align().
  **/
 void
diff --git a/gtk/gtkgladecatalog.c b/gtk/gtkgladecatalog.c
index c179ea271c..f9fb7df064 100644
--- a/gtk/gtkgladecatalog.c
+++ b/gtk/gtkgladecatalog.c
@@ -33,7 +33,7 @@
 
 /* This function is referred to in gtk/glade/gtk-private-widgets.xml
  * and is used to ensure the private types for use in Glade while
- * editing UI files that define GTK+'s various composite widget classes.
+ * editing UI files that define GTK+’s various composite widget classes.
  */
 _GDK_EXTERN void
 gtk_glade_catalog_init (const gchar *catalog_name)
diff --git a/gtk/gtkgrid.c b/gtk/gtkgrid.c
index 15754e7a62..14e7dd6de6 100644
--- a/gtk/gtkgrid.c
+++ b/gtk/gtkgrid.c
@@ -36,7 +36,7 @@
  *
  * GtkGrid is a container which arranges its child widgets in
  * rows and columns. It is a very similar to #GtkTable and #GtkBox,
- * but it consistently uses #GtkWidget's #GtkWidget:margin and #GtkWidget:expand
+ * but it consistently uses #GtkWidget’s #GtkWidget:margin and #GtkWidget:expand
  * properties instead of custom child properties, and it fully supports
  * [height-for-width geometry management][geometry-management].
  *
diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 08d3aba862..2cd943f3ce 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -108,7 +108,7 @@
  * or stock items, rather than directly, but looking up icons
  * directly is also simple. The #GtkIconTheme object acts
  * as a database of all the icons in the current theme. You
- * can create new #GtkIconTheme objects, but it's much more
+ * can create new #GtkIconTheme objects, but it’s much more
  * efficient to use the standard icon theme for the #GdkScreen
  * so that the icon information is shared with other people
  * looking up icons. In the case where the default screen is
@@ -538,7 +538,7 @@ gtk_icon_theme_class_init (GtkIconThemeClass *klass)
 
 
 /* Callback when the display that the icon theme is attached to
- * is closed; unset the screen, and if it's the unique theme
+ * is closed; unset the screen, and if it’s the unique theme
  * for the screen, drop the reference
  */
 static void
@@ -637,7 +637,7 @@ unset_screen (GtkIconTheme *icon_theme)
  * @screen: a #GdkScreen
  * 
  * Sets the screen for an icon theme; the screen is used
- * to track the user's currently configured icon theme,
+ * to track the user’s currently configured icon theme,
  * which might be different for different screens.
  *
  * Since: 2.4
@@ -891,7 +891,7 @@ gtk_icon_theme_finalize (GObject *object)
  * one or more of the directories in @path with the same name
  * as the icon theme. (Themes from multiple of the path elements
  * are combined to allow themes to be extended by adding icons
- * in the user's home directory.)
+ * in the user’s home directory.)
  *
  * In addition if an icon found isn't found either in the current
  * icon theme or the default icon theme, and an image file with
@@ -5043,7 +5043,7 @@ gtk_icon_info_get_display_name (GtkIconInfo *icon_info)
  * of built-in icons is to allow an application or library
  * that uses themed icons to function requiring files to
  * be present in the file system. For instance, the default
- * images for all of GTK+'s stock icons are registered
+ * images for all of GTK+’s stock icons are registered
  * as built-icons.
  *
  * In general, if you use gtk_icon_theme_add_builtin_icon()
diff --git a/gtk/gtkiconview.c b/gtk/gtkiconview.c
index f4184f3d6e..ce40e6894c 100644
--- a/gtk/gtkiconview.c
+++ b/gtk/gtkiconview.c
@@ -61,7 +61,7 @@
  * Note that if the tree model is backed by an actual tree store (as
  * opposed to a flat list where the mapping to icons is obvious),
  * #GtkIconView will only display the first level of the tree and
- * ignore the tree's branches.
+ * ignore the tree’s branches.
  */
 
 #define SCROLL_EDGE_SIZE 15
@@ -1451,7 +1451,7 @@ adjust_wrap_width (GtkIconView *icon_view)
  * * padded size
  *   This is the cell size plus the item padding on each side.
  * * spaced size
- *   This is the padded size plus the spacing. This is what's used for most
+ *   This is the padded size plus the spacing. This is what’s used for most
  *   calculations because it can (ab)use the following formula:
  *   iconview_size = 2 * margin + n_items * spaced_size - spacing
  * So when reading this code and fixing my bugs where I confuse these two, be
@@ -2182,7 +2182,7 @@ gtk_icon_view_remove_editable (GtkCellArea            *area,
  * @start_editing: %TRUE if the specified cell should start being edited.
  *
  * Sets the current keyboard focus to be at @path, and selects it.  This is
- * useful when you want to focus the user's attention on a particular item.
+ * useful when you want to focus the user’s attention on a particular item.
  * If @cell is not %NULL, then focus is given to the cell specified by 
  * it. Additionally, if @start_editing is %TRUE, then editing should be 
  * started in the specified cell.  
@@ -4668,7 +4668,7 @@ gtk_icon_view_set_tooltip_cell (GtkIconView     *icon_view,
  * tooltips the item returned will be the cursor item. When %TRUE, then any of
  * @model, @path and @iter which have been provided will be set to point to
  * that row and the corresponding model. @x and @y will always be converted
- * to be relative to @icon_view's bin_window if @keyboard_tooltip is %FALSE.
+ * to be relative to @icon_view’s bin_window if @keyboard_tooltip is %FALSE.
  *
  * Return value: whether or not the given tooltip context points to a item
  *
@@ -4761,11 +4761,11 @@ gtk_icon_view_set_tooltip_query_cb (GtkWidget  *widget,
 /**
  * gtk_icon_view_set_tooltip_column:
  * @icon_view: a #GtkIconView
- * @column: an integer, which is a valid column number for @icon_view's model
+ * @column: an integer, which is a valid column number for @icon_view’s model
  *
  * If you only plan to have simple (text-only) tooltips on full items, you
  * can use this function to have #GtkIconView handle these automatically
- * for you. @column should be set to the column in @icon_view's model
+ * for you. @column should be set to the column in @icon_view’s model
  * containing the tooltip texts, or -1 to disable this feature.
  *
  * When enabled, #GtkWidget:has-tooltip will be set to %TRUE and
@@ -4810,8 +4810,8 @@ gtk_icon_view_set_tooltip_column (GtkIconView *icon_view,
  * gtk_icon_view_get_tooltip_column:
  * @icon_view: a #GtkIconView
  *
- * Returns the column of @icon_view's model which is being used for
- * displaying tooltips on @icon_view's rows.
+ * Returns the column of @icon_view’s model which is being used for
+ * displaying tooltips on @icon_view’s rows.
  *
  * Return value: the index of the tooltip column that is currently being
  * used, or -1 if this is disabled.
@@ -5254,7 +5254,7 @@ gtk_icon_view_set_text_column (GtkIconView *icon_view,
  *
  * Returns the column with text for @icon_view.
  *
- * Returns: the text column, or -1 if it's unset.
+ * Returns: the text column, or -1 if it’s unset.
  *
  * Since: 2.6
  */
@@ -5317,7 +5317,7 @@ gtk_icon_view_set_markup_column (GtkIconView *icon_view,
  *
  * Returns the column with markup text for @icon_view.
  *
- * Returns: the markup column, or -1 if it's unset.
+ * Returns: the markup column, or -1 if it’s unset.
  *
  * Since: 2.6
  */
@@ -5379,7 +5379,7 @@ gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view,
  *
  * Returns the column with pixbufs for @icon_view.
  *
- * Returns: the pixbuf column, or -1 if it's unset.
+ * Returns: the pixbuf column, or -1 if it’s unset.
  *
  * Since: 2.6
  */
@@ -6013,7 +6013,7 @@ gtk_icon_view_get_margin (GtkIconView *icon_view)
  * @item_padding: the item padding
  *
  * Sets the #GtkIconView:item-padding property which specifies the padding
- * around each of the icon view's items.
+ * around each of the icon view’s items.
  *
  * Since: 2.18
  */
diff --git a/gtk/gtkimage.c b/gtk/gtkimage.c
index 686677bd21..abe536df14 100644
--- a/gtk/gtkimage.c
+++ b/gtk/gtkimage.c
@@ -50,7 +50,7 @@
  * The #GtkImage widget displays an image. Various kinds of object
  * can be displayed as an image; most typically, you would load a
  * #GdkPixbuf ("pixel buffer") from a file, and then display that.
- * There's a convenience function to do this, gtk_image_new_from_file(),
+ * There’s a convenience function to do this, gtk_image_new_from_file(),
  * used as follows:
  * |[<!-- language="C" -->
  *   GtkWidget *image;
@@ -705,7 +705,7 @@ gtk_image_new_from_stock (const gchar    *stock_id,
  *
  * Creates a #GtkImage displaying an icon set. Sample stock sizes are
  * #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_SMALL_TOOLBAR. Instead of using
- * this function, usually it's better to create a #GtkIconFactory, put
+ * this function, usually it’s better to create a #GtkIconFactory, put
  * your icon sets in the icon factory, add the icon factory to the
  * list of default factories with gtk_icon_factory_add_default(), and
  * then use gtk_image_new_from_stock(). This will allow themes to
diff --git a/gtk/gtkimcontext.c b/gtk/gtkimcontext.c
index e2c3257a19..09355c9eb7 100644
--- a/gtk/gtkimcontext.c
+++ b/gtk/gtkimcontext.c
@@ -194,7 +194,7 @@ G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE (GtkIMContext, gtk_im_context, G_TYPE_OBJECT
  *   other means if turned off.
  * @set_surrounding: Called via gtk_im_context_set_surrounding() in response
  *   to signal #GtkIMContext::retrieve-surrounding to update the input
- *   method's idea of the context around the cursor. It is not necessary to
+ *   method’s idea of the context around the cursor. It is not necessary to
  *   override this method even with input methods which implement
  *   context-dependent behavior. The base implementation is sufficient for
  *   gtk_im_context_get_surrounding() to work.
diff --git a/gtk/gtkinfobar.c b/gtk/gtkinfobar.c
index 902b5420ef..3beffdc9c7 100644
--- a/gtk/gtkinfobar.c
+++ b/gtk/gtkinfobar.c
@@ -886,7 +886,7 @@ gtk_info_bar_new_with_buttons (const gchar *first_button_text,
  * @setting: TRUE for sensitive
  *
  * Calls gtk_widget_set_sensitive (widget, setting) for each
- * widget in the info bars's action area with the given response_id.
+ * widget in the info bars’s action area with the given response_id.
  * A convenient way to sensitize/desensitize dialog buttons.
  *
  * Since: 2.18
@@ -919,7 +919,7 @@ gtk_info_bar_set_response_sensitive (GtkInfoBar *info_bar,
  * @info_bar: a #GtkInfoBar
  * @response_id: a response ID
  *
- * Sets the last widget in the info bar's action area with
+ * 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.
  *
diff --git a/gtk/gtkkeyhash.c b/gtk/gtkkeyhash.c
index 64d98aa53f..a46d72fe02 100644
--- a/gtk/gtkkeyhash.c
+++ b/gtk/gtkkeyhash.c
@@ -529,7 +529,7 @@ _gtk_key_hash_lookup (GtkKeyHash      *key_hash,
  * @event: a #GtkEvent
  * 
  * Looks up the best matching entry or entries in the hash table for a
- * given keyval/modifiers pair. It's better to use
+ * given keyval/modifiers pair. It’s better to use
  * _gtk_key_hash_lookup() if you have the original #GdkEventKey
  * available.  The results are sorted so that entries with less
  * modifiers come before entries with more modifiers.
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index 7cb976a2e9..64ff248713 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -101,8 +101,8 @@
  *
  * Mnemonics automatically activate any activatable widget the label is
  * inside, such as a #GtkButton; if the label is not inside the
- * mnemonic's target widget, you have to tell the label about the target
- * using gtk_label_set_mnemonic_widget(). Here's a simple example where
+ * mnemonic’s target widget, you have to tell the label about the target
+ * using gtk_label_set_mnemonic_widget(). Here’s a simple example where
  * the label is inside a button:
  *
  * |[<!-- language="C" -->
@@ -112,7 +112,7 @@
  *   gtk_container_add (GTK_CONTAINER (button), label);
  * ]|
  *
- * There's a convenience function to create buttons with a mnemonic label
+ * There’s a convenience function to create buttons with a mnemonic label
  * already inside:
  *
  * |[<!-- language="C" -->
@@ -137,7 +137,7 @@
  * fonts, etc.), label text can be provided in a simple
  * [markup format][PangoMarkupFormat].
  *
- * Here's how to create a label with a small font:
+ * Here’s how to create a label with a small font:
  * |[<!-- language="C" -->
  *   label = gtk_label_new (NULL);
  *   gtk_label_set_markup (GTK_LABEL (label), "<small>Small text</small>");
@@ -1948,7 +1948,7 @@ gtk_label_set_mnemonic_widget (GtkLabel  *label,
  * Retrieves the target of the mnemonic (keyboard shortcut) of this
  * label. See gtk_label_set_mnemonic_widget().
  *
- * Return value: (transfer none): the target of the label's mnemonic,
+ * Return value: (transfer none): the target of the label’s mnemonic,
  *     or %NULL if none has been set and the default algorithm will be used.
  **/
 GtkWidget *
@@ -2596,7 +2596,7 @@ gtk_label_set_markup_internal (GtkLabel    *label,
  *
  * Parses @str which is marked up with the
  * [Pango text markup language][PangoMarkupFormat], setting the
- * label's text and attribute list based on the parse results. If the @str is
+ * label’s text and attribute list based on the parse results. If the @str is
  * external data, you may need to escape it with g_markup_escape_text() or
  * g_markup_printf_escaped()<!-- -->:
  * |[<!-- language="C" -->
@@ -2632,7 +2632,7 @@ gtk_label_set_markup (GtkLabel    *label,
  *
  * Parses @str which is marked up with the
  * [Pango text markup language][PangoMarkupFormat],
- * setting the label's text and attribute list based on the parse results.
+ * setting the label’s text and attribute list based on the parse results.
  * If characters in @str are preceded by an underscore, they are underlined
  * indicating that they represent a keyboard accelerator called a mnemonic.
  *
@@ -2984,14 +2984,14 @@ gtk_label_get_max_width_chars (GtkLabel *label)
  * @wrap: the setting
  *
  * Toggles line wrapping within the #GtkLabel widget. %TRUE makes it break
- * lines if text exceeds the widget's size. %FALSE lets the text get cut off
+ * lines if text exceeds the widget’s size. %FALSE lets the text get cut off
  * by the edge of the widget if it exceeds the widget size.
  *
  * Note that setting line wrapping to %TRUE does not make the label
- * wrap at its parent container's width, because GTK+ widgets
+ * wrap at its parent container’s width, because GTK+ widgets
  * conceptually can't make their requisition depend on the parent
- * container's size. For a label that wraps at a specific position,
- * set the label's width using gtk_widget_set_size_request().
+ * container’s size. For a label that wraps at a specific position,
+ * set the label’s width using gtk_widget_set_size_request().
  **/
 void
 gtk_label_set_line_wrap (GtkLabel *label,
@@ -3133,8 +3133,8 @@ gtk_label_clear_layout (GtkLabel *label)
  * @width: the width to measure with in pango units, or -1 for infinite
  *
  * Gets a layout that can be used for measuring sizes. The returned
- * layout will be identical to the label's layout except for the
- * layout's width, which will be set to @width. Do not modify the returned
+ * layout will be identical to the label’s layout except for the
+ * layout’s width, which will be set to @width. Do not modify the returned
  * layout.
  *
  * Returns: a new reference to a pango layout
@@ -4300,7 +4300,7 @@ gtk_label_set_uline_text_internal (GtkLabel    *label,
  * @label: a #GtkLabel
  * @str: a string
  * 
- * Sets the label's text from the string @str.
+ * Sets the label’s text from the string @str.
  * If characters in @str are preceded by an underscore, they are underlined
  * indicating that they represent a keyboard accelerator called a mnemonic.
  * The mnemonic key can be used to activate another widget, chosen 
@@ -5449,7 +5449,7 @@ gtk_label_select_region  (GtkLabel *label,
  * @end: (out): return location for end of selection, as a character offset
  * 
  * Gets the selected range of characters in the label, returning %TRUE
- * if there's a selection.
+ * if there’s a selection.
  * 
  * Return value: %TRUE if selection is non-empty
  **/
@@ -5571,10 +5571,10 @@ gtk_label_get_layout_offsets (GtkLabel *label,
 /**
  * gtk_label_set_use_markup:
  * @label: a #GtkLabel
- * @setting: %TRUE if the label's text should be parsed for markup.
+ * @setting: %TRUE if the label’s text should be parsed for markup.
  *
  * Sets whether the text of the label contains markup in
- * [Pango's text markup language][PangoMarkupFormat].
+ * [Pango’s text markup language][PangoMarkupFormat].
  * See gtk_label_set_markup().
  **/
 void
@@ -5595,11 +5595,11 @@ gtk_label_set_use_markup (GtkLabel *label,
  * gtk_label_get_use_markup:
  * @label: a #GtkLabel
  *
- * Returns whether the label's text is interpreted as marked up with
+ * Returns whether the label’s text is interpreted as marked up with
  * the [Pango text markup language][PangoMarkupFormat].
  * See gtk_label_set_use_markup ().
  *
- * Return value: %TRUE if the label's text will be parsed for markup.
+ * Return value: %TRUE if the label’s text will be parsed for markup.
  **/
 gboolean
 gtk_label_get_use_markup (GtkLabel *label)
diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c
index 1c410d2a18..d3c53890b5 100644
--- a/gtk/gtklayout.c
+++ b/gtk/gtklayout.c
@@ -46,10 +46,10 @@
  * @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
+ * #GtkScrolledWindow), and it can contain child widgets, since it’s a
  * #GtkContainer. However if you're just going to draw, a #GtkDrawingArea
  * is a better choice since it has lower overhead.
  *
@@ -601,7 +601,7 @@ gtk_layout_set_size (GtkLayout     *layout,
  *     @layout, or %NULL
  *
  * Gets the size that has been set on the layout, and that determines
- * the total extents of the layout's scrollbar area. See
+ * the total extents of the layout’s scrollbar area. See
  * gtk_layout_set_size ().
  **/
 void
diff --git a/gtk/gtklevelbar.c b/gtk/gtklevelbar.c
index a6f3639bb3..ce9118a526 100644
--- a/gtk/gtklevelbar.c
+++ b/gtk/gtklevelbar.c
@@ -67,7 +67,7 @@
  * }
  * ]|
  *
- * The default interval of values is between zero and one, but it's possible to
+ * The default interval of values is between zero and one, but it’s possible to
  * modify the interval using gtk_level_bar_set_min_value() and
  * gtk_level_bar_set_max_value(). The value will be always drawn in proportion to
  * the admissible interval, i.e. a value of 15 with a specified interval between
@@ -76,7 +76,7 @@
  * as a finite and number of separated blocks instead of a single one. The number
  * of blocks that will be rendered is equal to the number of units specified by
  * the admissible interval.
- * For instance, to build a bar rendered with five blocks, it's sufficient to
+ * For instance, to build a bar rendered with five blocks, it’s sufficient to
  * set the minimum value to 0 and the maximum value to 5 after changing the indicator
  * mode to discrete.
  *
diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c
index 0217a53b17..9a384409cb 100644
--- a/gtk/gtkliststore.c
+++ b/gtk/gtkliststore.c
@@ -1680,7 +1680,7 @@ gtk_list_store_reorder_func (GSequenceIter *a,
  * @new_order: (array zero-terminated=1): an array of integers mapping the new
  *      position of each child to its old position before the re-ordering,
  *      i.e. @new_order`[newpos] = oldpos`. It must have
- *      exactly as many items as the list store's length.
+ *      exactly as many items as the list store’s length.
  *
  * Reorders @store to follow the order indicated by @new_order. Note that
  * this function only works with unsorted stores.
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index d4d1bd84c2..398bb85efb 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -82,7 +82,7 @@
  * }
  * ]|
  *
- * It's OK to use the GLib main loop directly instead of gtk_main(), though it
+ * It’s OK to use the GLib main loop directly instead of gtk_main(), though it
  * involves slightly more typing. See #GMainLoop in the GLib documentation.
  */
 
@@ -383,7 +383,7 @@ static gboolean do_setlocale = TRUE;
  * gtk_parse_args() from automatically
  * calling `setlocale (LC_ALL, "")`. You would
  * want to use this function if you wanted to set the locale for
- * your program to something other than the user's locale, or if
+ * your program to something other than the user’s locale, or if
  * you wanted to set different values for different locale categories.
  *
  * Most programs should not need to call this function.
diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c
index bb7cd27fec..7922698fc8 100644
--- a/gtk/gtkmenu.c
+++ b/gtk/gtkmenu.c
@@ -2385,7 +2385,7 @@ gtk_menu_get_tearoff_state (GtkMenu *menu)
  * The title is displayed when the menu is shown as a tearoff
  * menu. If @title is %NULL, the menu will see if it is attached
  * to a parent menu item, and if so it will try to use the same
- * text as that menu item's label.
+ * text as that menu item’s label.
  *
  * Deprecated: 3.10
  */
diff --git a/gtk/gtkmenubutton.c b/gtk/gtkmenubutton.c
index c0a1ff5110..068a1fc9d5 100644
--- a/gtk/gtkmenubutton.c
+++ b/gtk/gtkmenubutton.c
@@ -821,7 +821,7 @@ gtk_menu_button_get_align_widget (GtkMenuButton *menu_button)
  * @direction: a #GtkArrowType
  *
  * Sets the direction in which the menu will be popped up, as
- * well as changing the arrow's direction. The child will not
+ * well as changing the arrow’s direction. The child will not
  * be changed to an arrow if it was customized.
  *
  * If the menu when popped out would have collided with screen edges,
diff --git a/gtk/gtkmenuitem.c b/gtk/gtkmenuitem.c
index 09e30653d7..69fa4cb1bb 100644
--- a/gtk/gtkmenuitem.c
+++ b/gtk/gtkmenuitem.c
@@ -1319,7 +1319,7 @@ gtk_menu_item_set_use_action_appearance (GtkMenuItem *menu_item,
  * @menu_item: a #GtkMenuItem
  * @submenu: (allow-none): the submenu, or %NULL
  *
- * Sets or replaces the menu item's submenu, or removes it when a %NULL
+ * Sets or replaces the menu item’s submenu, or removes it when a %NULL
  * submenu is passed.
  */
 void
@@ -2397,10 +2397,10 @@ _gtk_menu_item_refresh_accel_path (GtkMenuItem   *menu_item,
  * gtk_menu_item_set_accel_path:
  * @menu_item:  a valid #GtkMenuItem
  * @accel_path: (allow-none): accelerator path, corresponding to this menu
- *     item's functionality, or %NULL to unset the current path.
+ *     item’s functionality, or %NULL to unset the current path.
  *
  * Set the accelerator path on @menu_item, through which runtime
- * changes of the menu item's accelerator caused by the user can be
+ * changes of the menu item’s accelerator caused by the user can be
  * identified and saved to persistent storage (see gtk_accel_map_save()
  * on this). To set up a default accelerator for this menu item, call
  * gtk_accel_map_add_entry() with the same @accel_path. See also
@@ -2462,7 +2462,7 @@ gtk_menu_item_set_accel_path (GtkMenuItem *menu_item,
  * See gtk_menu_item_set_accel_path() for details.
  *
  * Returns: the accelerator path corresponding to this menu
- *     item's functionality, or %NULL if not set
+ *     item’s functionality, or %NULL if not set
  *
  * Since: 2.14
  */
diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c
index d711e89fe2..4cf34a8a5b 100644
--- a/gtk/gtkmenushell.c
+++ b/gtk/gtkmenushell.c
@@ -534,7 +534,7 @@ gtk_menu_shell_prepend (GtkMenuShell *menu_shell,
  * @position: The position in the item list where @child
  *     is added. Positions are numbered from 0 to n-1
  *
- * Adds a new #GtkMenuItem to the menu shell's item list
+ * Adds a new #GtkMenuItem to the menu shell’s item list
  * at the position indicated by @position.
  */
 void
diff --git a/gtk/gtkmenutoolbutton.c b/gtk/gtkmenutoolbutton.c
index 1b98e5d0dd..cb71576533 100644
--- a/gtk/gtkmenutoolbutton.c
+++ b/gtk/gtkmenutoolbutton.c
@@ -448,7 +448,7 @@ gtk_menu_tool_button_get_menu (GtkMenuToolButton *button)
 /**
  * gtk_menu_tool_button_set_arrow_tooltip_text:
  * @button: a #GtkMenuToolButton
- * @text: text to be used as tooltip text for button's arrow button
+ * @text: text to be used as tooltip text for button’s arrow button
  *
  * Sets the tooltip text to be used as tooltip for the arrow button which
  * pops up the menu.  See gtk_tool_item_set_tooltip_text() for setting a tooltip
@@ -468,7 +468,7 @@ gtk_menu_tool_button_set_arrow_tooltip_text (GtkMenuToolButton *button,
 /**
  * gtk_menu_tool_button_set_arrow_tooltip_markup:
  * @button: a #GtkMenuToolButton
- * @markup: markup text to be used as tooltip text for button's arrow button
+ * @markup: markup text to be used as tooltip text for button’s arrow button
  *
  * Sets the tooltip markup text to be used as tooltip for the arrow button
  * which pops up the menu.  See gtk_tool_item_set_tooltip_text() for setting
diff --git a/gtk/gtkmenutracker.c b/gtk/gtkmenutracker.c
index d9e57f3fd4..2e650fba32 100644
--- a/gtk/gtkmenutracker.c
+++ b/gtk/gtkmenutracker.c
@@ -127,7 +127,7 @@ gtk_menu_tracker_section_find_model (GtkMenuTrackerSection *section,
  *
  * we only ever show separators if we have _actual_ children (ie: we do
  * not show a separator if the section contains only empty child
- * sections).  it's difficult to determine this on-the-fly, so we have
+ * sections).  it’s difficult to determine this on-the-fly, so we have
  * this separate function to come back later and figure it out.
  *
  * 'section' is that section.
diff --git a/gtk/gtkmenutrackeritem.c b/gtk/gtkmenutrackeritem.c
index f80ee65e59..8477a6b6f4 100644
--- a/gtk/gtkmenutrackeritem.c
+++ b/gtk/gtkmenutrackeritem.c
@@ -37,7 +37,7 @@
  *
  * If an item is one of the non-normal classes (submenu, separator), only the
  * label of the item needs to be respected. Otherwise, all the properties
- * of the item contribute to the item's appearance and state.
+ * of the item contribute to the item’s appearance and state.
  *
  * Implementing the appearance of the menu item is up to toolkits, and certain
  * toolkits may choose to ignore certain properties, like icon or accel. The
@@ -66,7 +66,7 @@
  * Applications using submenus may want to lazily build their submenus in
  * response to the user clicking on it, as building a submenu may be expensive.
  *
- * Thus, the submenu has two special controls -- the submenu's visibility
+ * Thus, the submenu has two special controls -- the submenu’s visibility
  * should be controlled by the GtkMenuTrackerItem::submenu-shown property,
  * and if a user clicks on the submenu, do not immediately show the menu,
  * but call gtk_menu_tracker_item_request_submenu_shown() and wait for the
diff --git a/gtk/gtkmessagedialog.c b/gtk/gtkmessagedialog.c
index 0362cf7b7e..d02352580c 100644
--- a/gtk/gtkmessagedialog.c
+++ b/gtk/gtkmessagedialog.c
@@ -45,7 +45,7 @@
  * @See_also:#GtkDialog
  *
  * #GtkMessageDialog presents a dialog with an image representing the type of
- * message (Error, Question, etc.) alongside some message text. It's simply a
+ * message (Error, Question, etc.) alongside some message text. It’s simply a
  * convenience widget; you could construct the equivalent of #GtkMessageDialog
  * from #GtkDialog without too much effort, but #GtkMessageDialog saves typing.
  *
@@ -656,7 +656,7 @@ gtk_message_dialog_new_with_markup (GtkWindow     *parent,
  * @dialog: a #GtkMessageDialog
  * @image: the image
  * 
- * Sets the dialog's image to @image.
+ * Sets the dialog’s image to @image.
  *
  * Since: 2.10
  **/
@@ -695,9 +695,9 @@ gtk_message_dialog_set_image (GtkMessageDialog *dialog,
  * gtk_message_dialog_get_image:
  * @dialog: a #GtkMessageDialog
  *
- * Gets the dialog's image.
+ * Gets the dialog’s image.
  *
- * Return value: (transfer none): the dialog's image
+ * Return value: (transfer none): the dialog’s image
  *
  * Since: 2.14
  **/
@@ -845,9 +845,9 @@ gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog,
  * @message_dialog: a #GtkMessageDialog
  *
  * Returns the message area of the dialog. This is the box where the
- * dialog's primary and secondary labels are packed. You can add your
+ * dialog’s primary and secondary labels are packed. You can add your
  * own extra content to that box and it will appear below those labels,
- * on the right side of the dialog's image (or on the left for right-to-left
+ * on the right side of the dialog’s image (or on the left for right-to-left
  * languages).  See gtk_dialog_get_content_area() for the corresponding
  * function in the parent #GtkDialog.
  *
diff --git a/gtk/gtknumerableicon.c b/gtk/gtknumerableicon.c
index 84fba13d85..836e1a7104 100644
--- a/gtk/gtknumerableicon.c
+++ b/gtk/gtknumerableicon.c
@@ -812,7 +812,7 @@ gtk_numerable_icon_set_count (GtkNumerableIcon *self,
  * @self: a #GtkNumerableIcon
  *
  * Returns the #GtkStyleContext used by the icon for theming,
- * or %NULL if there's none.
+ * or %NULL if there’s none.
  *
  * Returns: (transfer none): a #GtkStyleContext, or %NULL.
  *     This object is internal to GTK+ and should not be unreffed.
@@ -903,7 +903,7 @@ gtk_numerable_icon_set_background_gicon (GtkNumerableIcon *self,
  * @self: a #GtkNumerableIcon
  *
  * Returns the #GIcon that was set as the base background image, or
- * %NULL if there's none. The caller of this function does not own
+ * %NULL if there’s none. The caller of this function does not own
  * a reference to the returned #GIcon.
  *
  * Returns: (transfer none): a #GIcon, or %NULL
@@ -973,7 +973,7 @@ gtk_numerable_icon_set_background_icon_name (GtkNumerableIcon *self,
  * @self: a #GtkNumerableIcon
  *
  * Returns the icon name used as the base background image,
- * or %NULL if there's none.
+ * or %NULL if there’s none.
  *
  * Returns: an icon name, or %NULL
  *
diff --git a/gtk/gtkorientable.c b/gtk/gtkorientable.c
index 0f72542473..cb9994df96 100644
--- a/gtk/gtkorientable.c
+++ b/gtk/gtkorientable.c
@@ -68,7 +68,7 @@ gtk_orientable_default_init (GtkOrientableInterface *iface)
 /**
  * gtk_orientable_set_orientation:
  * @orientable: a #GtkOrientable
- * @orientation: the orientable's new orientation.
+ * @orientation: the orientable’s new orientation.
  *
  * Sets the orientation of the @orientable.
  *
diff --git a/gtk/gtkpaned.c b/gtk/gtkpaned.c
index e97de29f2b..9c4b07aa24 100644
--- a/gtk/gtkpaned.c
+++ b/gtk/gtkpaned.c
@@ -1873,7 +1873,7 @@ gtk_paned_motion (GtkWidget      *widget,
 
 /**
  * gtk_paned_new:
- * @orientation: the paned's orientation.
+ * @orientation: the paned’s orientation.
  *
  * Creates a new #GtkPaned widget.
  *
@@ -2832,7 +2832,7 @@ gtk_paned_toggle_handle_focus (GtkPaned *paned)
  * enables the callback to distinguish between the window
  * of the paned, a child and the handle.
  *
- * Return value: (transfer none): the paned's handle window.
+ * Return value: (transfer none): the paned’s handle window.
  *
  * Since: 2.20
  **/
diff --git a/gtk/gtkplacessidebar.c b/gtk/gtkplacessidebar.c
index 8df22555ba..97034ec4e4 100644
--- a/gtk/gtkplacessidebar.c
+++ b/gtk/gtkplacessidebar.c
@@ -1,7 +1,7 @@
 /*
  *  GtkPlacesSidebar - sidebar widget for places in the filesystem
  *
- *  This code comes from Nautilus, GNOME's file manager.
+ *  This code comes from Nautilus, GNOME’s file manager.
  *
  *  This library is free software; you can redistribute it and/or
  *  modify it under the terms of the GNU General Public License as
@@ -74,7 +74,7 @@
  * @See_also: #GtkFileChooser
  *
  * #GtkPlacesSidebar is a widget that displays a list of frequently-used places in the
- * file system:  the user's home directory, the user's bookmarks, and volumes and drives.
+ * file system:  the user’s home directory, the user’s bookmarks, and volumes and drives.
  * This widget is used as a sidebar in #GtkFileChooser and may be used by file managers
  * and similar programs.
  *
@@ -4524,7 +4524,7 @@ gtk_places_sidebar_set_location (GtkPlacesSidebar *sidebar,
  *
  * Gets the currently-selected location in the @sidebar.  This can be #NULL when
  * nothing is selected, for example, when gtk_places_sidebar_set_location() has
- * been called with a location that is not among the sidebar's list of places to
+ * been called with a location that is not among the sidebar’s list of places to
  * show.
  *
  * You can use this function to get the selection in the @sidebar.  Also, if you
@@ -4569,7 +4569,7 @@ gtk_places_sidebar_get_location (GtkPlacesSidebar *sidebar)
  *
  * Sets whether the @sidebar should show an item for the Desktop folder.
  * The default value for this option is determined by the desktop
- * environment and the user's configuration, but this function can be
+ * environment and the user’s configuration, but this function can be
  * used to override it on a per-application basis.
  *
  * Since: 3.10
@@ -4731,7 +4731,7 @@ find_shortcut_link (GtkPlacesSidebar *sidebar,
  * shortcuts.  The shortcuts are application-specific; they are not shared
  * across applications, and they are not persistent.  If this function
  * is called multiple times with different locations, then they are added
- * to the sidebar's list in the same order as the function is called.
+ * to the sidebar’s list in the same order as the function is called.
  *
  * Since: 3.10
  */
diff --git a/gtk/gtkplacessidebar.h b/gtk/gtkplacessidebar.h
index 47af0f11d6..a358f5ba67 100644
--- a/gtk/gtkplacessidebar.h
+++ b/gtk/gtkplacessidebar.h
@@ -3,7 +3,7 @@
 /*
  *  GtkPlacesSidebar - sidebar widget for places in the filesystem
  *
- *  This code comes from Nautilus, GNOME's file manager.
+ *  This code comes from Nautilus, GNOME’s file manager.
  *
  *  This library is free software; you can redistribute it and/or
  *  modify it under the terms of the GNU General Public License as
diff --git a/gtk/gtkplug.c b/gtk/gtkplug.c
index ae24dd6c01..8482dce7b1 100644
--- a/gtk/gtkplug.c
+++ b/gtk/gtkplug.c
@@ -49,10 +49,10 @@
  * Together with #GtkSocket, #GtkPlug provides the ability to embed
  * widgets from one process into another process in a fashion that is
  * transparent to the user. One process creates a #GtkSocket widget
- * and passes the ID of that widget's window to the other process,
+ * and passes the ID of that widget’s window to the other process,
  * which then creates a #GtkPlug with that window ID. Any widgets
  * contained in the #GtkPlug then will appear inside the first
- * application's window.
+ * application’s window.
  *
  * The communication between a #GtkSocket and a #GtkPlug follows the
  * [XEmbed Protocol](http://www.freedesktop.org/Standards/xembed-spec).
@@ -541,7 +541,7 @@ _gtk_plug_remove_from_socket (GtkPlug   *plug,
 /**
  * gtk_plug_construct:
  * @plug: a #GtkPlug.
- * @socket_id: the XID of the socket's window.
+ * @socket_id: the XID of the socket’s window.
  *
  * Finish the initialization of @plug for a given #GtkSocket identified by
  * @socket_id. This function will generally only be used by classes deriving from #GtkPlug.
@@ -556,9 +556,9 @@ gtk_plug_construct (GtkPlug *plug,
 /**
  * gtk_plug_construct_for_display:
  * @plug: a #GtkPlug.
- * @display: the #GdkDisplay associated with @socket_id's 
+ * @display: the #GdkDisplay associated with @socket_id’s 
  *	     #GtkSocket.
- * @socket_id: the XID of the socket's window.
+ * @socket_id: the XID of the socket’s window.
  *
  * Finish the initialization of @plug for a given #GtkSocket identified by
  * @socket_id which is currently displayed on @display.
@@ -634,7 +634,7 @@ gtk_plug_new (Window socket_id)
 /**
  * gtk_plug_new_for_display:
  * @display: the #GdkDisplay on which @socket_id is displayed
- * @socket_id: the XID of the socket's window.
+ * @socket_id: the XID of the socket’s window.
  * 
  * Create a new plug widget inside the #GtkSocket identified by socket_id.
  *
diff --git a/gtk/gtkprinter.c b/gtk/gtkprinter.c
index d8097363aa..a3959208fe 100644
--- a/gtk/gtkprinter.c
+++ b/gtk/gtkprinter.c
@@ -946,7 +946,7 @@ _gtk_printer_create_cairo_surface (GtkPrinter       *printer,
  * @printer: a #GtkPrinter
  * 
  * Lists all the paper sizes @printer supports.
- * This will return and empty list unless the printer's details are 
+ * This will return and empty list unless the printer’s details are 
  * available, see gtk_printer_has_details() and gtk_printer_request_details().
  *
  * Return value: (element-type GtkPageSetup) (transfer full): a newly allocated list of newly allocated #GtkPageSetup s.
@@ -996,7 +996,7 @@ gtk_printer_get_default_page_size (GtkPrinter *printer)
  * Retrieve the hard margins of @printer, i.e. the margins that define
  * the area at the borders of the paper that the printer cannot print to.
  *
- * Note: This will not succeed unless the printer's details are available,
+ * Note: This will not succeed unless the printer’s details are available,
  * see gtk_printer_has_details() and gtk_printer_request_details().
  *
  * Return value: %TRUE iff the hard margins were retrieved
@@ -1019,16 +1019,16 @@ gtk_printer_get_hard_margins (GtkPrinter *printer,
  * gtk_printer_get_capabilities:
  * @printer: a #GtkPrinter
  * 
- * Returns the printer's capabilities.
+ * Returns the printer’s capabilities.
  *
- * This is useful when you're using #GtkPrintUnixDialog's manual-capabilities 
+ * This is useful when you're using #GtkPrintUnixDialog’s manual-capabilities 
  * setting and need to know which settings the printer can handle and which 
  * you must handle yourself.
  *
- * This will return 0 unless the printer's details are available, see
+ * This will return 0 unless the printer’s details are available, see
  * gtk_printer_has_details() and gtk_printer_request_details().
  *
- * Return value: the printer's capabilities
+ * Return value: the printer’s capabilities
  *
  * Since: 2.12
  */
diff --git a/gtk/gtkprivate.c b/gtk/gtkprivate.c
index fb1c6b57ee..c6d166f081 100644
--- a/gtk/gtkprivate.c
+++ b/gtk/gtkprivate.c
@@ -87,7 +87,7 @@ _gtk_get_data_prefix (void)
  * names spelled out in English.
  * However, this function does check the above environment
  * variables, and does return a Unix-style locale string based on
- * either said environment variables or the thread's current locale.
+ * either said environment variables or the thread’s current locale.
  *
  * Return value: a dynamically allocated string, free with g_free().
  */
diff --git a/gtk/gtkprogressbar.c b/gtk/gtkprogressbar.c
index 097d9b524b..103bf15b0f 100644
--- a/gtk/gtkprogressbar.c
+++ b/gtk/gtkprogressbar.c
@@ -1053,7 +1053,7 @@ gtk_progress_bar_set_activity_mode (GtkProgressBar *pbar,
 /**
  * gtk_progress_bar_set_fraction:
  * @pbar: a #GtkProgressBar
- * @fraction: fraction of the task that's been completed
+ * @fraction: fraction of the task that’s been completed
  *
  * Causes the progress bar to “fill in” the given fraction
  * of the bar. The fraction should be between 0.0 and 1.0,
@@ -1288,7 +1288,7 @@ gtk_progress_bar_get_text (GtkProgressBar *pbar)
  * gtk_progress_bar_get_fraction:
  * @pbar: a #GtkProgressBar
  *
- * Returns the current fraction of the task that's been completed.
+ * Returns the current fraction of the task that’s been completed.
  *
  * Return value: a fraction from 0.0 to 1.0
  */
diff --git a/gtk/gtkquartz.c b/gtk/gtkquartz.c
index 722a00bac8..ba204f3c93 100644
--- a/gtk/gtkquartz.c
+++ b/gtk/gtkquartz.c
@@ -288,7 +288,7 @@ _gtk_quartz_set_selection_data_for_pasteboard (NSPasteboard     *pasteboard,
 
 /* Bundle-based functions for various directories. These almost work
  * even when the application isn't in a bundle, becuase mainBundle
- * paths point to the bin directory in that case. It's a simple matter
+ * paths point to the bin directory in that case. It’s a simple matter
  * to test for that and remove the last element.
  */
 
diff --git a/gtk/gtkradiobutton.c b/gtk/gtkradiobutton.c
index fc7744403c..0d93796ce9 100644
--- a/gtk/gtkradiobutton.c
+++ b/gtk/gtkradiobutton.c
@@ -266,7 +266,7 @@ gtk_radio_button_get_property (GObject    *object,
  * @group: (element-type GtkRadioButton) (allow-none): an existing radio
  *     button group, such as one returned from gtk_radio_button_get_group(), or %NULL.
  *
- * Sets a #GtkRadioButton's group. It should be noted that this does not change
+ * Sets a #GtkRadioButton’s group. It should be noted that this does not change
  * the layout of your interface in any way, so if you are changing the group,
  * it is likely you will need to re-arrange the user interface to reflect these
  * changes.
diff --git a/gtk/gtkrange.c b/gtk/gtkrange.c
index dee451294e..fc16d4b98d 100644
--- a/gtk/gtkrange.c
+++ b/gtk/gtkrange.c
@@ -937,8 +937,8 @@ gtk_range_get_flippable (GtkRange *range)
  * @range: a #GtkRange
  * @size_fixed: %TRUE to make the slider size constant
  *
- * Sets whether the range's slider has a fixed size, or a size that
- * depends on its adjustment's page size.
+ * Sets whether the range’s slider has a fixed size, or a size that
+ * depends on its adjustment’s page size.
  *
  * This function is useful mainly for #GtkRange subclasses.
  *
@@ -975,7 +975,7 @@ gtk_range_set_slider_size_fixed (GtkRange *range,
  *
  * See gtk_range_set_slider_size_fixed().
  *
- * Return value: whether the range's slider has a fixed size.
+ * Return value: whether the range’s slider has a fixed size.
  *
  * Since: 2.20
  **/
@@ -990,9 +990,9 @@ gtk_range_get_slider_size_fixed (GtkRange *range)
 /**
  * gtk_range_set_min_slider_size:
  * @range: a #GtkRange
- * @min_size: The slider's minimum size
+ * @min_size: The slider’s minimum size
  *
- * Sets the minimum size of the range's slider.
+ * Sets the minimum size of the range’s slider.
  *
  * This function is useful mainly for #GtkRange subclasses.
  *
@@ -1030,7 +1030,7 @@ gtk_range_set_min_slider_size (GtkRange *range,
  *
  * See gtk_range_set_min_slider_size().
  *
- * Return value: The minimum size of the range's slider.
+ * Return value: The minimum size of the range’s slider.
  *
  * Since: 2.20
  **/
@@ -1047,7 +1047,7 @@ gtk_range_get_min_slider_size (GtkRange *range)
  * @range: a #GtkRange
  * @range_rect: (out): return location for the range rectangle
  *
- * This function returns the area that contains the range's trough
+ * This function returns the area that contains the range’s trough
  * and its steppers, in widget->window coordinates.
  *
  * This function is useful mainly for #GtkRange subclasses.
@@ -1108,10 +1108,10 @@ gtk_range_get_slider_range (GtkRange *range,
 /**
  * gtk_range_set_lower_stepper_sensitivity:
  * @range:       a #GtkRange
- * @sensitivity: the lower stepper's sensitivity policy.
+ * @sensitivity: the lower stepper’s sensitivity policy.
  *
  * Sets the sensitivity policy for the stepper that points to the
- * 'lower' end of the GtkRange's adjustment.
+ * 'lower' end of the GtkRange’s adjustment.
  *
  * Since: 2.10
  **/
@@ -1142,9 +1142,9 @@ gtk_range_set_lower_stepper_sensitivity (GtkRange           *range,
  * @range: a #GtkRange
  *
  * Gets the sensitivity policy for the stepper that points to the
- * 'lower' end of the GtkRange's adjustment.
+ * 'lower' end of the GtkRange’s adjustment.
  *
- * Return value: The lower stepper's sensitivity policy.
+ * Return value: The lower stepper’s sensitivity policy.
  *
  * Since: 2.10
  **/
@@ -1159,10 +1159,10 @@ gtk_range_get_lower_stepper_sensitivity (GtkRange *range)
 /**
  * gtk_range_set_upper_stepper_sensitivity:
  * @range:       a #GtkRange
- * @sensitivity: the upper stepper's sensitivity policy.
+ * @sensitivity: the upper stepper’s sensitivity policy.
  *
  * Sets the sensitivity policy for the stepper that points to the
- * 'upper' end of the GtkRange's adjustment.
+ * 'upper' end of the GtkRange’s adjustment.
  *
  * Since: 2.10
  **/
@@ -1193,9 +1193,9 @@ gtk_range_set_upper_stepper_sensitivity (GtkRange           *range,
  * @range: a #GtkRange
  *
  * Gets the sensitivity policy for the stepper that points to the
- * 'upper' end of the GtkRange's adjustment.
+ * 'upper' end of the GtkRange’s adjustment.
  *
- * Return value: The upper stepper's sensitivity policy.
+ * Return value: The upper stepper’s sensitivity policy.
  *
  * Since: 2.10
  **/
@@ -1432,12 +1432,12 @@ gtk_range_get_restrict_to_fill_level (GtkRange *range)
  * would indicate the current play position, and the fill level would
  * be the position up to which the file/stream has been downloaded.
  *
- * This amount of prebuffering can be displayed on the range's trough
+ * This amount of prebuffering can be displayed on the range’s trough
  * and is themeable separately from the trough. To enable fill level
  * display, use gtk_range_set_show_fill_level(). The range defaults
  * to not showing the fill level.
  *
- * Additionally, it's possible to restrict the range's slider position
+ * Additionally, it’s possible to restrict the range’s slider position
  * to values which are smaller than the fill level. This is controller
  * by gtk_range_set_restrict_to_fill_level() and is by default
  * enabled.
diff --git a/gtk/gtkrecentchoosermenu.c b/gtk/gtkrecentchoosermenu.c
index f6afd2b9c6..ba512a4047 100644
--- a/gtk/gtkrecentchoosermenu.c
+++ b/gtk/gtkrecentchoosermenu.c
@@ -1305,7 +1305,7 @@ gtk_recent_chooser_menu_get_show_numbers (GtkRecentChooserMenu *menu)
  *
  * Sets whether a number should be added to the items of @menu.  The
  * numbers are shown to provide a unique character for a mnemonic to
- * be used inside ten menu item's label.  Only the first the items
+ * be used inside ten menu item’s label.  Only the first the items
  * get a number to avoid clashes.
  *
  * Since: 2.10
diff --git a/gtk/gtkrecentmanager.c b/gtk/gtkrecentmanager.c
index 3b10ef97aa..2268c57e66 100644
--- a/gtk/gtkrecentmanager.c
+++ b/gtk/gtkrecentmanager.c
@@ -640,7 +640,7 @@ gtk_recent_manager_set_filename (GtkRecentManager *manager,
 
 /* reads the recently used resources file and builds the items list.
  * we keep the items list inside the parser object, and build the
- * RecentInfo object only on user's demand to avoid useless replication.
+ * RecentInfo object only on user’s demand to avoid useless replication.
  * this function resets the dirty bit of the manager.
  */
 static void
@@ -1641,10 +1641,10 @@ gtk_recent_info_get_mime_type (GtkRecentInfo *info)
  * gtk_recent_info_get_added:
  * @info: a #GtkRecentInfo
  *
- * Gets the timestamp (seconds from system's Epoch) when the resource
+ * Gets the timestamp (seconds from system’s Epoch) when the resource
  * was added to the recently used resources list.
  *
- * Return value: the number of seconds elapsed from system's Epoch when
+ * Return value: the number of seconds elapsed from system’s Epoch when
  *   the resource was added to the list, or -1 on failure.
  *
  * Since: 2.10
@@ -1661,10 +1661,10 @@ gtk_recent_info_get_added (GtkRecentInfo *info)
  * gtk_recent_info_get_modified:
  * @info: a #GtkRecentInfo
  *
- * Gets the timestamp (seconds from system's Epoch) when the meta-data
+ * Gets the timestamp (seconds from system’s Epoch) when the meta-data
  * for the resource was last modified.
  *
- * Return value: the number of seconds elapsed from system's Epoch when
+ * Return value: the number of seconds elapsed from system’s Epoch when
  *   the resource was last modified, or -1 on failure.
  *
  * Since: 2.10
@@ -1681,10 +1681,10 @@ gtk_recent_info_get_modified (GtkRecentInfo *info)
  * gtk_recent_info_get_visited:
  * @info: a #GtkRecentInfo
  *
- * Gets the timestamp (seconds from system's Epoch) when the meta-data
+ * Gets the timestamp (seconds from system’s Epoch) when the meta-data
  * for the resource was last visited.
  *
- * Return value: the number of seconds elapsed from system's Epoch when
+ * Return value: the number of seconds elapsed from system’s Epoch when
  *   the resource was last visited, or -1 on failure.
  *
  * Since: 2.10
@@ -2263,12 +2263,12 @@ gtk_recent_info_get_short_name (GtkRecentInfo *info)
  * gtk_recent_info_get_uri_display:
  * @info: a #GtkRecentInfo
  *
- * Gets a displayable version of the resource's URI.  If the resource
+ * Gets a displayable version of the resource’s URI.  If the resource
  * is local, it returns a local path; if the resource is not local,
  * it returns the UTF-8 encoded content of gtk_recent_info_get_uri().
  *
  * Return value: a newly allocated UTF-8 string containing the
- *   resource's URI or %NULL. Use g_free() when done using it.
+ *   resource’s URI or %NULL. Use g_free() when done using it.
  *
  * Since: 2.10
  */
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index cf1a39bd6f..5a10401fa1 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -567,7 +567,7 @@ gtk_scale_get_property (GObject      *object,
 
 /**
  * gtk_scale_new:
- * @orientation: the scale's orientation.
+ * @orientation: the scale’s orientation.
  * @adjustment: (allow-none): the #GtkAdjustment which sets the range
  *              of the scale, or %NULL to create a new adjustment.
  *
@@ -592,14 +592,14 @@ gtk_scale_new (GtkOrientation  orientation,
 
 /**
  * gtk_scale_new_with_range:
- * @orientation: the scale's orientation.
+ * @orientation: the scale’s orientation.
  * @min: minimum value
  * @max: maximum value
  * @step: step increment (tick size) used with keyboard shortcuts
  *
  * Creates a new scale widget with the given orientation that lets the
  * user input a number between @min and @max (including @min and @max)
- * with the increment @step.  @step must be nonzero; it's the distance
+ * with the increment @step.  @step must be nonzero; it’s the distance
  * the slider moves when using the arrow keys to adjust the scale
  * value.
  *
diff --git a/gtk/gtkscalebutton.c b/gtk/gtkscalebutton.c
index fd76382a64..187fd14f48 100644
--- a/gtk/gtkscalebutton.c
+++ b/gtk/gtkscalebutton.c
@@ -621,7 +621,7 @@ gtk_scale_button_set_icons (GtkScaleButton  *button,
  * gtk_scale_button_get_adjustment:
  * @button: a #GtkScaleButton
  *
- * Gets the #GtkAdjustment associated with the #GtkScaleButton's scale.
+ * Gets the #GtkAdjustment associated with the #GtkScaleButton’s scale.
  * See gtk_range_get_adjustment() for details.
  *
  * Returns: (transfer none): the adjustment associated with the scale
@@ -642,7 +642,7 @@ gtk_scale_button_get_adjustment	(GtkScaleButton *button)
  * @adjustment: a #GtkAdjustment
  *
  * Sets the #GtkAdjustment to be used as a model
- * for the #GtkScaleButton's scale.
+ * for the #GtkScaleButton’s scale.
  * See gtk_range_set_adjustment() for details.
  *
  * Since: 2.12
diff --git a/gtk/gtkscrollable.c b/gtk/gtkscrollable.c
index 0ed52e785f..0c4f67abb2 100644
--- a/gtk/gtkscrollable.c
+++ b/gtk/gtkscrollable.c
@@ -30,7 +30,7 @@
  *
  * All scrollable widgets should do the following.
  *
- * - When a parent widget sets the scrollable child widget's adjustments,
+ * - When a parent widget sets the scrollable child widget’s adjustments,
  *   the widget should populate the adjustments'
  *   #GtkAdjustment:lower, #GtkAdjustment:upper,
  *   #GtkAdjustment:step-increment, #GtkAdjustment:page-increment and
diff --git a/gtk/gtkscrollbar.c b/gtk/gtkscrollbar.c
index ecd4c7ea17..4fe7c87aea 100644
--- a/gtk/gtkscrollbar.c
+++ b/gtk/gtkscrollbar.c
@@ -155,7 +155,7 @@ gtk_scrollbar_style_updated (GtkWidget *widget)
 
 /**
  * gtk_scrollbar_new:
- * @orientation: the scrollbar's orientation.
+ * @orientation: the scrollbar’s orientation.
  * @adjustment: (allow-none): the #GtkAdjustment to use, or %NULL to create a new adjustment.
  *
  * Creates a new scrollbar with the given orientation.
diff --git a/gtk/gtkscrolledwindow.c b/gtk/gtkscrolledwindow.c
index 9ebb1d9211..5d2393015f 100644
--- a/gtk/gtkscrolledwindow.c
+++ b/gtk/gtkscrolledwindow.c
@@ -49,7 +49,7 @@
  * @Title: GtkScrolledWindow
  * @See_also: #GtkScrollable, #GtkViewport, #GtkAdjustment
  *
- * #GtkScrolledWindow is a #GtkBin subclass: it's a container
+ * #GtkScrolledWindow is a #GtkBin subclass: it’s a container
  * the accepts a single child widget. #GtkScrolledWindow adds scrollbars
  * to the child widget and optionally draws a beveled frame around the
  * child widget.
@@ -82,7 +82,7 @@
  * for example the PageDown key).
  *
  * If a #GtkScrolledWindow doesn't behave quite as you would like, or
- * doesn't have exactly the right layout, it's very possible to set up
+ * doesn't have exactly the right layout, it’s very possible to set up
  * your own scrolling with #GtkScrollbar and for example a #GtkGrid.
  */
 
@@ -117,8 +117,8 @@
  * B) from 1.1) follows: the requisition may be overidden by usize of the scrolled
  *    window (done automatically) or by usize of the child (needs to be checked).
  * C) from 2) follows: for POLICY_NEVER, the scrolled window simply reports the
- *    child's dimension.
- * D) from 3) follows: the scrolled window child's minimum width and minimum height
+ *    child’s dimension.
+ * D) from 3) follows: the scrolled window child’s minimum width and minimum height
  *    under A) at least correspond to the space taken up by its scrollbars.
  */
 
@@ -594,7 +594,7 @@ gtk_scrolled_window_init (GtkScrolledWindow *scrolled_window)
  *
  * Creates a new scrolled window.
  *
- * The two arguments are the scrolled window's adjustments; these will be
+ * The two arguments are the scrolled window’s adjustments; these will be
  * shared with the scrollbars and the child widget to keep the bars in sync 
  * with the child. Usually you want to pass %NULL for the adjustments, which 
  * will cause the scrolled window to create them for you.
@@ -755,8 +755,8 @@ gtk_scrolled_window_set_vadjustment (GtkScrolledWindow *scrolled_window,
  * gtk_scrolled_window_get_hadjustment:
  * @scrolled_window: a #GtkScrolledWindow
  *
- * Returns the horizontal scrollbar's adjustment, used to connect the
- * horizontal scrollbar to the child widget's horizontal scroll
+ * Returns the horizontal scrollbar’s adjustment, used to connect the
+ * horizontal scrollbar to the child widget’s horizontal scroll
  * functionality.
  *
  * Returns: (transfer none): the horizontal #GtkAdjustment
@@ -779,8 +779,8 @@ gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window)
  * gtk_scrolled_window_get_vadjustment:
  * @scrolled_window: a #GtkScrolledWindow
  * 
- * Returns the vertical scrollbar's adjustment, used to connect the
- * vertical scrollbar to the child widget's vertical scroll functionality.
+ * Returns the vertical scrollbar’s adjustment, used to connect the
+ * vertical scrollbar to the child widget’s vertical scroll functionality.
  * 
  * Returns: (transfer none): the vertical #GtkAdjustment
  */
@@ -3040,7 +3040,7 @@ gtk_scrolled_window_add_with_viewport (GtkScrolledWindow *scrolled_window,
  * _gtk_scrolled_window_get_spacing:
  * @scrolled_window: a scrolled window
  * 
- * Gets the spacing between the scrolled window's scrollbars and
+ * Gets the spacing between the scrolled window’s scrollbars and
  * the scrolled widget. Used by GtkCombo
  * 
  * Return value: the spacing, in pixels.
diff --git a/gtk/gtksearchbar.c b/gtk/gtksearchbar.c
index 7bffdf7097..38d26118b5 100644
--- a/gtk/gtksearchbar.c
+++ b/gtk/gtksearchbar.c
@@ -41,7 +41,7 @@
  * #GtkSearchBar is a container made to have a search entry (possibly
  * with additional connex widgets, such as drop-down menus, or buttons)
  * built-in. The search bar would appear when a search is started through
- * typing on the keyboard, or the application's search mode is toggled on.
+ * typing on the keyboard, or the application’s search mode is toggled on.
  *
  * For keyboard presses to start a search, events will need to be
  * forwarded from the top-level window that contains the search bar.
diff --git a/gtk/gtkselection.c b/gtk/gtkselection.c
index 783f1e7341..d3878a78ab 100644
--- a/gtk/gtkselection.c
+++ b/gtk/gtkselection.c
@@ -17,7 +17,7 @@
 
 /* This file implements most of the work of the ICCCM selection protocol.
  * The code was written after an intensive study of the equivalent part
- * of John Ousterhout's Tk toolkit, and does many things in much the 
+ * of John Ousterhout’s Tk toolkit, and does many things in much the 
  * same way.
  *
  * The one thing in the ICCCM that isn't fully supported here (or in Tk)
@@ -67,7 +67,7 @@
  * #GtkClipboard provides a nicer interface to the same functionality.
  *
  * Some of the datatypes defined this section are used in
- * the #GtkClipboard and drag-and-drop API's as well. The
+ * the #GtkClipboard and drag-and-drop API’s as well. The
  * #GtkTargetEntry and #GtkTargetList objects represent
  * lists of data types that are supported when sending or
  * receiving data. The #GtkSelectionData object is used to
diff --git a/gtk/gtkseparator.c b/gtk/gtkseparator.c
index 663c418b81..de887fb26d 100644
--- a/gtk/gtkseparator.c
+++ b/gtk/gtkseparator.c
@@ -250,7 +250,7 @@ gtk_separator_draw (GtkWidget *widget,
 
 /**
  * gtk_separator_new:
- * @orientation: the separator's orientation.
+ * @orientation: the separator’s orientation.
  *
  * Creates a new #GtkSeparator with the given orientation.
  *
diff --git a/gtk/gtksizerequest.c b/gtk/gtksizerequest.c
index cd234407a7..7ac4fa0b82 100644
--- a/gtk/gtksizerequest.c
+++ b/gtk/gtksizerequest.c
@@ -466,7 +466,7 @@ gtk_widget_get_request_mode (GtkWidget *widget)
  * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL
  * @natural_width: (out) (allow-none): location to store the natural width, or %NULL
  *
- * Retrieves a widget's initial minimum and natural width.
+ * Retrieves a widget’s initial minimum and natural width.
  *
  * This call is specific to height-for-width requests.
  *
@@ -501,7 +501,7 @@ gtk_widget_get_preferred_width (GtkWidget *widget,
  * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL
  * @natural_height: (out) (allow-none): location to store the natural height, or %NULL
  *
- * Retrieves a widget's initial minimum and natural height.
+ * Retrieves a widget’s initial minimum and natural height.
  *
  * This call is specific to width-for-height requests.
  *
@@ -538,7 +538,7 @@ gtk_widget_get_preferred_height (GtkWidget *widget,
  * @minimum_width: (out) (allow-none): location for storing the minimum width, or %NULL
  * @natural_width: (out) (allow-none): location for storing the natural width, or %NULL
  *
- * Retrieves a widget's minimum and natural width if it would be given
+ * Retrieves a widget’s minimum and natural width if it would be given
  * the specified @height.
  *
  * The returned request will be modified by the
@@ -574,7 +574,7 @@ gtk_widget_get_preferred_width_for_height (GtkWidget *widget,
  * @minimum_height: (out) (allow-none): location for storing the minimum height, or %NULL
  * @natural_height: (out) (allow-none): location for storing the natural height, or %NULL
  *
- * Retrieves a widget's minimum and natural height if it would be given
+ * Retrieves a widget’s minimum and natural height if it would be given
  * the specified @width.
  *
  * The returned request will be modified by the
@@ -612,7 +612,7 @@ gtk_widget_get_preferred_height_for_width (GtkWidget *widget,
  * @minimum_baseline: (out) (allow-none): location for storing the baseline for the minimum height, or %NULL
  * @natural_baseline: (out) (allow-none): location for storing the baseline for the natural height, or %NULL
  *
- * Retrieves a widget's minimum and natural height and the corresponding baselines if it would be given
+ * Retrieves a widget’s minimum and natural height and the corresponding baselines if it would be given
  * the specified @width, or the default height if @width is -1. The baselines may be -1 which means
  * that no baseline is requested for this widget.
  *
@@ -652,7 +652,7 @@ gtk_widget_get_preferred_height_and_baseline_for_width (GtkWidget *widget,
  * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL
  *
  * Retrieves the minimum and natural size  and the corresponding baselines of a widget, taking
- * into account the widget's preference for height-for-width management. The baselines may
+ * into account the widget’s preference for height-for-width management. The baselines may
  * be -1 which means that no baseline is requested for this widget.
  *
  * This is used to retrieve a suitable size by container widgets which do
@@ -722,7 +722,7 @@ _gtk_widget_get_preferred_size_and_baseline (GtkWidget      *widget,
  * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL
  *
  * Retrieves the minimum and natural size of a widget, taking
- * into account the widget's preference for height-for-width management.
+ * into account the widget’s preference for height-for-width management.
  *
  * This is used to retrieve a suitable size by container widgets which do
  * not impose any restrictions on the child placement. It can be used
diff --git a/gtk/gtksocket.c b/gtk/gtksocket.c
index a8293e43d0..0bd7bc6f1b 100644
--- a/gtk/gtksocket.c
+++ b/gtk/gtksocket.c
@@ -60,11 +60,11 @@
  * Together with #GtkPlug, #GtkSocket provides the ability to embed
  * widgets from one process into another process in a fashion that
  * is transparent to the user. One process creates a #GtkSocket widget
- * and passes that widget's window ID to the other process, which then
+ * and passes that widget’s window ID to the other process, which then
  * creates a #GtkPlug with that window ID. Any widgets contained in the
- * #GtkPlug then will appear inside the first application's window.
+ * #GtkPlug then will appear inside the first application’s window.
  *
- * The socket's window ID is obtained by using gtk_socket_get_id().
+ * The socket’s window ID is obtained by using gtk_socket_get_id().
  * Before using this function, the socket must have been realized,
  * and for hence, have been added to its parent.
  *
@@ -1002,7 +1002,7 @@ gtk_socket_forall (GtkContainer *container,
  * gtk_socket_add_window:
  * @socket: a #GtkSocket
  * @xid: the native identifier for a window
- * @need_reparent: whether the socket's plug's window needs to be
+ * @need_reparent: whether the socket’s plug’s window needs to be
  *                 reparented to the socket
  *
  * Adds a window to a GtkSocket.
diff --git a/gtk/gtkspinbutton.c b/gtk/gtkspinbutton.c
index 0a2c2b1c68..999ce595d1 100644
--- a/gtk/gtkspinbutton.c
+++ b/gtk/gtkspinbutton.c
@@ -2155,7 +2155,7 @@ gtk_spin_button_new_with_range (gdouble min,
 }
 
 /* Callback used when the spin button's adjustment changes.
- * We need to redraw the arrows when the adjustment's range
+ * We need to redraw the arrows when the adjustment’s range
  * changes, and reevaluate our size request.
  */
 static void
@@ -2235,7 +2235,7 @@ gtk_spin_button_get_adjustment (GtkSpinButton *spin_button)
 /**
  * gtk_spin_button_set_digits:
  * @spin_button: a #GtkSpinButton
- * @digits: the number of digits after the decimal point to be displayed for the spin button's value
+ * @digits: the number of digits after the decimal point to be displayed for the spin button’s value
  *
  * Set the precision to be displayed by @spin_button. Up to 20 digit precision
  * is allowed.
@@ -2284,7 +2284,7 @@ gtk_spin_button_get_digits (GtkSpinButton *spin_button)
  * @page: increment applied for a button 2 press.
  *
  * Sets the step and page increments for spin_button.  This affects how
- * quickly the value changes when the spin button's arrows are activated.
+ * quickly the value changes when the spin button’s arrows are activated.
  **/
 void
 gtk_spin_button_set_increments (GtkSpinButton *spin_button,
@@ -2578,7 +2578,7 @@ gtk_spin_button_set_wrap (GtkSpinButton  *spin_button,
  * gtk_spin_button_get_wrap:
  * @spin_button: a #GtkSpinButton
  *
- * Returns whether the spin button's value wraps around to the
+ * Returns whether the spin button’s value wraps around to the
  * opposite limit when the upper or lower limit of the range is
  * exceeded. See gtk_spin_button_set_wrap().
  *
@@ -2647,7 +2647,7 @@ gtk_spin_button_get_snap_to_ticks (GtkSpinButton *spin_button)
  * @direction: a #GtkSpinType indicating the direction to spin
  * @increment: step increment to apply in the specified direction
  *
- * Increment or decrement a spin button's value in a specified
+ * Increment or decrement a spin button’s value in a specified
  * direction by a specified amount.
  */
 void
diff --git a/gtk/gtkstatusbar.c b/gtk/gtkstatusbar.c
index b7aba0fdb9..eeabaae018 100644
--- a/gtk/gtkstatusbar.c
+++ b/gtk/gtkstatusbar.c
@@ -50,9 +50,9 @@
  * is complete in an FTP client, for example).
  *
  * Status bars in GTK+ maintain a stack of messages. The message at
- * the top of the each bar's stack is the one that will currently be displayed.
+ * the top of the each bar’s stack is the one that will currently be displayed.
  *
- * Any messages added to a statusbar's stack must specify a
+ * Any messages added to a statusbar’s stack must specify a
  * context id that is used to uniquely identify
  * the source of a message. This context id can be generated by
  * gtk_statusbar_get_context_id(), given a message and the statusbar that
@@ -66,7 +66,7 @@
  *
  * Status bars are created using gtk_statusbar_new().
  *
- * Messages are added to the bar's stack with gtk_statusbar_push().
+ * Messages are added to the bar’s stack with gtk_statusbar_push().
  *
  * The message at the top of the stack can be removed using
  * gtk_statusbar_pop(). A message can be removed from anywhere in the
@@ -304,11 +304,11 @@ gtk_statusbar_msg_free (GtkStatusbarMsg *msg)
 /**
  * gtk_statusbar_push:
  * @statusbar: a #GtkStatusbar
- * @context_id: the message's context id, as returned by
+ * @context_id: the message’s context id, as returned by
  *              gtk_statusbar_get_context_id()
  * @text: the message to add to the statusbar
  * 
- * Pushes a new message onto a statusbar's stack.
+ * Pushes a new message onto a statusbar’s stack.
  *
  * Returns: a message id that can be used with 
  *          gtk_statusbar_remove().
@@ -343,7 +343,7 @@ gtk_statusbar_push (GtkStatusbar *statusbar,
  * @statusbar: a #GtkStatusbar
  * @context_id: a context identifier
  * 
- * Removes the first message in the #GtkStatusbar's stack
+ * Removes the first message in the #GtkStatusbar’s stack
  * with the given context id. 
  *
  * Note that this may not change the displayed message, if 
@@ -394,7 +394,7 @@ gtk_statusbar_pop (GtkStatusbar *statusbar,
  * @context_id: a context identifier
  * @message_id: a message identifier, as returned by gtk_statusbar_push()
  *
- * Forces the removal of a message from a statusbar's stack. 
+ * Forces the removal of a message from a statusbar’s stack. 
  * The exact @context_id and @message_id must be specified.
  */
 void
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index 4a63c9e928..c1b51cfc24 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -1511,9 +1511,9 @@ gtk_style_context_get_scale (GtkStyleContext *context)
  *
  * If @progress is not %NULL, the animation progress will be returned
  * there, 0.0 means the state is closest to being unset, while 1.0 means
- * it's closest to being set. This means transition animation will
+ * it’s closest to being set. This means transition animation will
  * run from 0 to 1 when @state is being set and from 1 to 0 when
- * it's being unset.
+ * it’s being unset.
  *
  * Returns: %TRUE if there is a running transition animation for @state.
  *
@@ -4285,7 +4285,7 @@ gtk_render_extension (GtkStyleContext *context,
  * @height: rectangle height
  *
  * Renders a handle (as in #GtkHandleBox, #GtkPaned and
- * #GtkWindow<!-- -->'s resize grip), in the rectangle
+ * #GtkWindow<!-- -->’s resize grip), in the rectangle
  * determined by @x, @y, @width, @height.
  *
  * Handles rendered for the paned and grip classes:
diff --git a/gtk/gtkstylecontext.h b/gtk/gtkstylecontext.h
index 870d9c1ce1..55540b0992 100644
--- a/gtk/gtkstylecontext.h
+++ b/gtk/gtkstylecontext.h
@@ -86,9 +86,9 @@ struct _GtkStyleContextClass
 /**
  * GTK_STYLE_PROPERTY_PADDING:
  *
- * A property holding the rendered element's padding as a #GtkBorder. The
+ * A property holding the rendered element’s padding as a #GtkBorder. The
  * padding is defined as the spacing between the inner part of the element border
- * and its child. It's the innermost spacing property of the padding/border/margin
+ * and its child. It’s the innermost spacing property of the padding/border/margin
  * series.
  */
 #define GTK_STYLE_PROPERTY_PADDING "padding"
@@ -96,7 +96,7 @@ struct _GtkStyleContextClass
 /**
  * GTK_STYLE_PROPERTY_BORDER_WIDTH:
  *
- * A property holding the rendered element's border width in pixels as
+ * A property holding the rendered element’s border width in pixels as
  * a #GtkBorder. The border is the intermediary spacing property of the
  * padding/border/margin series.
  *
@@ -109,7 +109,7 @@ struct _GtkStyleContextClass
 /**
  * GTK_STYLE_PROPERTY_MARGIN:
  *
- * A property holding the rendered element's margin as a #GtkBorder. The
+ * A property holding the rendered element’s margin as a #GtkBorder. The
  * margin is defined as the spacing between the border of the element
  * and its surrounding elements. It is external to #GtkWidget<!-- -->s's
  * size allocations, and the most external spacing property of the
@@ -120,28 +120,28 @@ struct _GtkStyleContextClass
 /**
  * GTK_STYLE_PROPERTY_BORDER_RADIUS:
  *
- * A property holding the rendered element's border radius in pixels as a #gint.
+ * A property holding the rendered element’s border radius in pixels as a #gint.
  */
 #define GTK_STYLE_PROPERTY_BORDER_RADIUS "border-radius"
 
 /**
  * GTK_STYLE_PROPERTY_BORDER_STYLE:
  *
- * A property holding the element's border style as a #GtkBorderStyle.
+ * A property holding the element’s border style as a #GtkBorderStyle.
  */
 #define GTK_STYLE_PROPERTY_BORDER_STYLE "border-style"
 
 /**
  * GTK_STYLE_PROPERTY_BORDER_COLOR:
  *
- * A property holding the element's border color as a #GdkRGBA.
+ * A property holding the element’s border color as a #GdkRGBA.
  */
 #define GTK_STYLE_PROPERTY_BORDER_COLOR "border-color"
 
 /**
  * GTK_STYLE_PROPERTY_BACKGROUND_IMAGE:
  *
- * A property holding the element's background as a #cairo_pattern_t.
+ * A property holding the element’s background as a #cairo_pattern_t.
  */
 #define GTK_STYLE_PROPERTY_BACKGROUND_IMAGE "background-image"
 
diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c
index 5fe60b74ad..e07a14d896 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.
  *
@@ -236,7 +236,7 @@ gtk_test_widget_click (GtkWidget      *widget,
  *
  * This function will generate a @button click in the upwards or downwards
  * spin button arrow areas, usually leading to an increase or decrease of
- * spin button's value.
+ * spin button’s value.
  *
  * Returns: whether all actions neccessary for the button click simulation were carried out successfully.
  *
diff --git a/gtk/gtktextattributes.h b/gtk/gtktextattributes.h
index b64e0e7b31..0e2f85b0b8 100644
--- a/gtk/gtktextattributes.h
+++ b/gtk/gtktextattributes.h
@@ -76,7 +76,7 @@ typedef struct _GtkTextAppearance GtkTextAppearance;
  * @strikethrough: Strikethrough style
  * @draw_bg: Whether to use background-related values; this is
  *   irrelevant for the values struct when in a tag, but is used for
- *   the composite values struct; it's true if any of the tags being
+ *   the composite values struct; it’s true if any of the tags being
  *   composited had background stuff set.
  * @inside_selection: This are only used when we are actually laying
  *   out and rendering a paragraph; not when a #GtkTextAppearance is
@@ -157,7 +157,7 @@ struct _GtkTextAppearance
  * @editable: Can edit this text.
  *
  * Using #GtkTextAttributes directly should rarely be necessary.
- * It's primarily useful with gtk_text_iter_get_attributes().
+ * It’s primarily useful with gtk_text_iter_get_attributes().
  * As with most GTK+ structs, the fields in this struct should only
  * be read, never modified directly.
  */
diff --git a/gtk/gtktextbtree.c b/gtk/gtktextbtree.c
index 2757c8ca40..bce15e369c 100644
--- a/gtk/gtktextbtree.c
+++ b/gtk/gtktextbtree.c
@@ -6159,7 +6159,7 @@ recompute_level_nonzero_counts (GtkTextBTreeNode *node)
  *      This procedure is called to recompute all the counts in a GtkTextBTreeNode
  *      (tags, child information, etc.) by scanning the information in
  *      its descendants.  This procedure is called during rebalancing
- *      when a GtkTextBTreeNode's child structure has changed.
+ *      when a GtkTextBTreeNode’s child structure has changed.
  *
  * Results:
  *      None.
diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index 8919e11e61..af7b6830c3 100644
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -837,7 +837,7 @@ _gtk_text_buffer_get_btree (GtkTextBuffer *buffer)
  *
  * Get the #GtkTextTagTable associated with this buffer.
  *
- * Return value: (transfer none): the buffer's tag table
+ * Return value: (transfer none): the buffer’s tag table
  **/
 GtkTextTagTable*
 gtk_text_buffer_get_tag_table (GtkTextBuffer *buffer)
@@ -2100,7 +2100,7 @@ gtk_text_buffer_set_mark (GtkTextBuffer     *buffer,
  * Creates a mark at position @where. If @mark_name is %NULL, the mark
  * is anonymous; otherwise, the mark can be retrieved by name using
  * gtk_text_buffer_get_mark(). If a mark has left gravity, and text is
- * inserted at the mark's current location, the mark will be moved to
+ * inserted at the mark’s current location, the mark will be moved to
  * the left of the newly-inserted text. If the mark has right gravity
  * (@left_gravity = %FALSE), the mark will end up on the right of
  * newly-inserted text. The standard left-to-right cursor is a mark
@@ -2215,7 +2215,7 @@ gtk_text_buffer_get_iter_at_mark (GtkTextBuffer *buffer,
  * @buffer: a #GtkTextBuffer
  * @mark: a #GtkTextMark in @buffer
  *
- * Deletes @mark, so that it's no longer located anywhere in the
+ * Deletes @mark, so that it’s no longer located anywhere in the
  * buffer. Removes the reference the buffer holds to the mark, so if
  * you haven't called g_object_ref() on the mark, it will be freed. Even
  * if the mark isn't freed, most operations on @mark become
@@ -2362,7 +2362,7 @@ gtk_text_buffer_get_insert (GtkTextBuffer *buffer)
  * “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
+ * for handling the selection, if you just want to know whether there’s a
  * selection and what its bounds are.
  *
  * Return value: (transfer none): selection bound mark
@@ -2467,8 +2467,8 @@ gtk_text_buffer_select_range (GtkTextBuffer     *buffer,
  *
  * Creates a tag and adds it to the tag table for @buffer.
  * Equivalent to calling gtk_text_tag_new() and then adding the
- * tag to the buffer's tag table. The returned tag is owned by
- * the buffer's tag table, so the ref count will be equal to one.
+ * tag to the buffer’s tag table. The returned tag is owned by
+ * the buffer’s tag table, so the ref count will be equal to one.
  *
  * If @tag_name is %NULL, the tag is anonymous.
  *
@@ -2661,7 +2661,7 @@ gtk_text_buffer_remove_tag (GtkTextBuffer     *buffer,
  * @start: one bound of range to be tagged
  * @end: other bound of range to be tagged
  *
- * Calls gtk_text_tag_table_lookup() on the buffer's tag table to
+ * Calls gtk_text_tag_table_lookup() on the buffer’s tag table to
  * get a #GtkTextTag, then calls gtk_text_buffer_apply_tag().
  **/
 void
@@ -2698,7 +2698,7 @@ gtk_text_buffer_apply_tag_by_name (GtkTextBuffer     *buffer,
  * @start: one bound of range to be untagged
  * @end: other bound of range to be untagged
  *
- * Calls gtk_text_tag_table_lookup() on the buffer's tag table to
+ * Calls gtk_text_tag_table_lookup() on the buffer’s tag table to
  * get a #GtkTextTag, then calls gtk_text_buffer_remove_tag().
  **/
 void
@@ -4028,7 +4028,7 @@ cut_or_copy (GtkTextBuffer *buffer,
  * @default_editable: default editability of the buffer
  *
  * Copies the currently-selected text to a clipboard, then deletes
- * said text if it's editable.
+ * said text if it’s editable.
  **/
 void
 gtk_text_buffer_cut_clipboard (GtkTextBuffer *buffer,
diff --git a/gtk/gtktextbufferrichtext.c b/gtk/gtktextbufferrichtext.c
index 996d6247f9..cd4e87ac05 100644
--- a/gtk/gtktextbufferrichtext.c
+++ b/gtk/gtktextbufferrichtext.c
@@ -56,16 +56,16 @@ static GQuark    deserialize_quark (void);
 /**
  * gtk_text_buffer_register_serialize_format:
  * @buffer: a #GtkTextBuffer
- * @mime_type: the format's mime-type
+ * @mime_type: the format’s mime-type
  * @function: the serialize function to register
- * @user_data: @function's user_data
+ * @user_data: @function’s user_data
  * @user_data_destroy: a function to call when @user_data is no longer needed
  *
  * This function registers a rich text serialization @function along with
  * its @mime_type with the passed @buffer.
  *
  * Return value: (transfer none): the #GdkAtom that corresponds to the
- *               newly registered format's mime-type.
+ *               newly registered format’s mime-type.
  *
  * Since: 2.10
  **/
@@ -103,10 +103,10 @@ gtk_text_buffer_register_serialize_format (GtkTextBuffer              *buffer,
  * @buffer: a #GtkTextBuffer
  * @tagset_name: (allow-none): an optional tagset name, on %NULL
  *
- * This function registers GTK+'s internal rich text serialization
+ * This function registers GTK+’s internal rich text serialization
  * format with the passed @buffer. The internal format does not comply
  * to any standard rich text format and only works between #GtkTextBuffer
- * instances. It is capable of serializing all of a text buffer's tags
+ * instances. It is capable of serializing all of a text buffer’s tags
  * and embedded pixbufs.
  *
  * This function is just a wrapper around
@@ -122,7 +122,7 @@ gtk_text_buffer_register_serialize_format (GtkTextBuffer              *buffer,
  * receiving buffer to deal with with pasting of arbitrary tags.
  *
  * Return value: (transfer none): the #GdkAtom that corresponds to the
- *               newly registered format's mime-type.
+ *               newly registered format’s mime-type.
  *
  * Since: 2.10
  **/
@@ -154,16 +154,16 @@ gtk_text_buffer_register_serialize_tagset (GtkTextBuffer *buffer,
 /**
  * gtk_text_buffer_register_deserialize_format:
  * @buffer: a #GtkTextBuffer
- * @mime_type: the format's mime-type
+ * @mime_type: the format’s mime-type
  * @function: the deserialize function to register
- * @user_data: @function's user_data
+ * @user_data: @function’s user_data
  * @user_data_destroy: a function to call when @user_data is no longer needed
  *
  * This function registers a rich text deserialization @function along with
  * its @mime_type with the passed @buffer.
  *
  * Return value: (transfer none): the #GdkAtom that corresponds to the
- *               newly registered format's mime-type.
+ *               newly registered format’s mime-type.
  *
  * Since: 2.10
  **/
@@ -201,12 +201,12 @@ gtk_text_buffer_register_deserialize_format (GtkTextBuffer                *buffe
  * @buffer: a #GtkTextBuffer
  * @tagset_name: (allow-none): an optional tagset name, on %NULL
  *
- * This function registers GTK+'s internal rich text serialization
+ * This function registers GTK+’s internal rich text serialization
  * format with the passed @buffer. See
  * gtk_text_buffer_register_serialize_tagset() for details.
  *
  * Return value: (transfer none): the #GdkAtom that corresponds to the
- *               newly registered format's mime-type.
+ *               newly registered format’s mime-type.
  *
  * Since: 2.10
  **/
@@ -315,7 +315,7 @@ gtk_text_buffer_unregister_deserialize_format (GtkTextBuffer *buffer,
  *
  * You should allow creation of tags only if you know what you are
  * doing, e.g. if you defined a tagset name for your application
- * suite's text buffers and you know that it's fine to receive new
+ * suite’s text buffers and you know that it’s fine to receive new
  * tags from these buffers, because you know that your application can
  * handle the newly created tags.
  *
diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c
index b3a7f2a0d8..e03337976e 100644
--- a/gtk/gtktextiter.c
+++ b/gtk/gtktextiter.c
@@ -1492,7 +1492,7 @@ gtk_text_iter_get_language (const GtkTextIter *iter)
  * i.e. if gtk_text_iter_get_line_offset () would return 0.
  * However this function is potentially more efficient than
  * gtk_text_iter_get_line_offset () because it doesn't have to compute
- * the offset, it just has to see whether it's 0.
+ * the offset, it just has to see whether it’s 0.
  *
  * Return value: whether @iter begins a line
  **/
@@ -1792,7 +1792,7 @@ gtk_text_iter_get_attributes (const GtkTextIter  *iter,
  * (MOVEMENT OCCURRED && NEW ITER IS DEREFERENCEABLE)
  *
  * This function will not change the iterator if
- * it's already on the last (end iter) line, i.e. it
+ * it’s already on the last (end iter) line, i.e. it
  * won't move to the end of the last line.
  */
 static gboolean
@@ -1840,7 +1840,7 @@ forward_line_leaving_caches_unmodified (GtkTextRealIter *real)
  * (MOVEMENT OCCURRED && NEW ITER IS DEREFERENCEABLE)
  *
  * This function is currently unused, thus it is #if-0-ed. It is
- * left here, since it's non-trivial code that might be useful in
+ * left here, since it’s non-trivial code that might be useful in
  * the future.
  */
 static gboolean
@@ -2452,7 +2452,7 @@ gtk_text_iter_backward_chars (GtkTextIter *iter, gint count)
 #if 0
 
 /* These two can't be implemented efficiently (always have to use
- * a linear scan, since that's the only way to find all the non-text
+ * a linear scan, since that’s the only way to find all the non-text
  * segments)
  */
 
@@ -3765,7 +3765,7 @@ gtk_text_iter_is_cursor_position (const GtkTextIter *iter)
 /**
  * gtk_text_iter_set_line_offset:
  * @iter: a #GtkTextIter 
- * @char_on_line: a character offset relative to the start of @iter's current line
+ * @char_on_line: a character offset relative to the start of @iter’s current line
  * 
  * Moves @iter within a line, to a new character
  * (not byte) offset. The given character offset must be less than or
@@ -3806,7 +3806,7 @@ gtk_text_iter_set_line_offset (GtkTextIter *iter,
 /**
  * gtk_text_iter_set_line_index:
  * @iter: a #GtkTextIter
- * @byte_on_line: a byte index relative to the start of @iter's current line
+ * @byte_on_line: a byte index relative to the start of @iter’s current line
  *
  * Same as gtk_text_iter_set_line_offset(), but works with a
  * byte index. The given byte index must be at
@@ -5338,7 +5338,7 @@ gtk_text_iter_backward_search (const GtkTextIter *iter,
  * Tests whether two iterators are equal, using the fastest possible
  * mechanism. This function is very fast; you can expect it to perform
  * better than e.g. getting the character offset for each iterator and
- * comparing the offsets yourself. Also, it's a bit faster than
+ * comparing the offsets yourself. Also, it’s a bit faster than
  * gtk_text_iter_compare().
  * 
  * Return value: %TRUE if the iterators point to the same place in the buffer
@@ -5475,7 +5475,7 @@ gtk_text_iter_in_range (const GtkTextIter *iter,
  * Swaps the value of @first and @second if @second comes before
  * @first in the buffer. That is, ensures that @first and @second are
  * in sequence. Most text buffer functions that take a range call this
- * automatically on your behalf, so there's no real reason to call it yourself
+ * automatically on your behalf, so there’s no real reason to call it yourself
  * in those cases. There are some exceptions, such as gtk_text_iter_in_range(),
  * that expect a pre-sorted range.
  * 
diff --git a/gtk/gtktextlayout.c b/gtk/gtktextlayout.c
index 0e18e82875..0426b0fb3e 100644
--- a/gtk/gtktextlayout.c
+++ b/gtk/gtktextlayout.c
@@ -971,7 +971,7 @@ gtk_text_layout_real_free_line_data (GtkTextLayout     *layout,
  * gtk_text_layout_is_valid:
  * @layout: a #GtkTextLayout
  *
- * Check if there are any invalid regions in a #GtkTextLayout's buffer
+ * Check if there are any invalid regions in a #GtkTextLayout’s buffer
  *
  * Return value: %TRUE if any invalid regions were found
  */
@@ -1681,8 +1681,8 @@ add_child_attrs (GtkTextLayout      *layout,
  * @layout: a #GtkTextLayout
  * @display: a #GtkTextLineDisplay
  * @insert_iter: iter pointing to the cursor location
- * @insert_index: cursor offset in the @display's layout, it may
- * be different from @insert_iter's offset in case when preedit
+ * @insert_index: cursor offset in the @display’s layout, it may
+ * be different from @insert_iter’s offset in case when preedit
  * string is present.
  * @pos: location to store cursor position
  * @cursor_at_line_end: whether cursor is at the end of line
@@ -1963,7 +1963,7 @@ add_preedit_attrs (GtkTextLayout     *layout,
 }
 
 /* Iterate over the line and fill in display->cursors.
- * It's a stripped copy of gtk_text_layout_get_line_display() */
+ * It’s a stripped copy of gtk_text_layout_get_line_display() */
 static void
 update_text_display_cursors (GtkTextLayout      *layout,
 			     GtkTextLine        *line,
diff --git a/gtk/gtktextlayout.h b/gtk/gtktextlayout.h
index b6379bc2fb..d113f88bca 100644
--- a/gtk/gtktextlayout.h
+++ b/gtk/gtktextlayout.h
@@ -80,7 +80,7 @@
 
 /* This is a "semi-private" header; it is intended for
  * use by the text widget, and the text canvas item,
- * but that's all. We may have to install it so the
+ * but that’s all. We may have to install it so the
  * canvas item can use it, but users are not supposed
  * to use it.
  */
diff --git a/gtk/gtktextmark.c b/gtk/gtktextmark.c
index 919b5c9c5b..0f502fd556 100644
--- a/gtk/gtktextmark.c
+++ b/gtk/gtktextmark.c
@@ -231,7 +231,7 @@ gtk_text_mark_get_property (GObject    *object,
  * Creates a text mark. Add it to a buffer using gtk_text_buffer_add_mark().
  * If @name is %NULL, the mark is anonymous; otherwise, the mark can be 
  * retrieved by name using gtk_text_buffer_get_mark(). If a mark has left 
- * gravity, and text is inserted at the mark's current location, the mark 
+ * gravity, and text is inserted at the mark’s current location, the mark 
  * will be moved to the left of the newly-inserted text. If the mark has 
  * right gravity (@left_gravity = %FALSE), the mark will end up on the 
  * right of newly-inserted text. The standard left-to-right cursor is a 
@@ -321,7 +321,7 @@ gtk_text_mark_get_deleted (GtkTextMark *mark)
  * Gets the buffer this mark is located inside,
  * or %NULL if the mark is deleted.
  *
- * Return value: (transfer none): the mark's #GtkTextBuffer
+ * Return value: (transfer none): the mark’s #GtkTextBuffer
  **/
 GtkTextBuffer*
 gtk_text_mark_get_buffer (GtkTextMark *mark)
diff --git a/gtk/gtktextsegment.c b/gtk/gtktextsegment.c
index d1493d69a4..aef42dbcc3 100644
--- a/gtk/gtktextsegment.c
+++ b/gtk/gtktextsegment.c
@@ -450,7 +450,7 @@ _gtk_toggle_segment_new (GtkTextTagInfo *info, gboolean on)
  *      unless the entire B-tree is going away.
  *
  * Side effects:
- *      If the tree is going away then the toggle's memory is
+ *      If the tree is going away then the toggle’s memory is
  *      freed;  otherwise the toggle counts in GtkTextBTreeNodes above the
  *      segment get updated.
  *
@@ -489,7 +489,7 @@ toggle_segment_delete_func (GtkTextLineSegment *segPtr, GtkTextLine *line, int t
  * toggle_segment_cleanup_func --
  *
  *      This procedure is called when a toggle is part of a line that's
- *      been modified in some way.  It's invoked after the
+ *      been modified in some way.  It’s invoked after the
  *      modifications are complete.
  *
  * Arguments:
diff --git a/gtk/gtktextsegment.h b/gtk/gtktextsegment.h
index 82ea6b2704..ea5f90423c 100644
--- a/gtk/gtktextsegment.h
+++ b/gtk/gtktextsegment.h
@@ -84,7 +84,7 @@ typedef GtkTextLineSegment* (*GtkTextSegCleanupFunc)    (GtkTextLineSegment *seg
 
 /* Called when a segment moves from one line to another. CleanupFunc is also
  * called in that case, so many segments just use CleanupFunc, I'm not sure
- * what's up with that (this function may not be needed...)
+ * what’s up with that (this function may not be needed...)
  */
 typedef void                (*GtkTextSegLineChangeFunc) (GtkTextLineSegment *seg,
                                                          GtkTextLine        *line);
diff --git a/gtk/gtktexttag.c b/gtk/gtktexttag.c
index 9718a9c762..e9ee74a856 100644
--- a/gtk/gtktexttag.c
+++ b/gtk/gtktexttag.c
@@ -1894,7 +1894,7 @@ delta_priority_foreach (GtkTextTag *tag, gpointer user_data)
  * 
  * Get the tag priority.
  * 
- * Return value: The tag's priority.
+ * Return value: The tag’s priority.
  **/
 gint
 gtk_text_tag_get_priority (GtkTextTag *tag)
@@ -1918,7 +1918,7 @@ gtk_text_tag_get_priority (GtkTextTag *tag)
  * 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
- * gtk_text_buffer_create_tag(), which adds the tag to the buffer's table
+ * gtk_text_buffer_create_tag(), which adds the tag to the buffer’s table
  * automatically.
  **/
 void
diff --git a/gtk/gtktexttagtable.c b/gtk/gtktexttagtable.c
index fdf9cfebb3..062a71f213 100644
--- a/gtk/gtktexttagtable.c
+++ b/gtk/gtktexttagtable.c
@@ -308,7 +308,7 @@ gtk_text_tag_table_lookup (GtkTextTagTable *table,
  * @tag: a #GtkTextTag
  *
  * Remove a tag from the table. If a #GtkTextBuffer has @table as its tag table,
- * the tag is removed from the buffer. The table's reference to the tag is
+ * the tag is removed from the buffer. The table’s reference to the tag is
  * removed, so the tag will end up destroyed if you don't have a reference to
  * it.
  **/
diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c
index daa7a3b31a..a4efa7e215 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -1801,7 +1801,7 @@ gtk_text_view_get_buffer (GtkTextView *text_view)
  * Note that if @iter happens to be the actual cursor position, and
  * there is currently an IM preedit sequence being entered, the
  * returned locations will be adjusted to account for the preedit
- * cursor's offset within the preedit sequence.
+ * cursor’s offset within the preedit sequence.
  *
  * The rectangle position is in buffer coordinates; use
  * gtk_text_view_buffer_to_window_coords() to convert these
@@ -2002,7 +2002,7 @@ gtk_text_view_get_line_at_y (GtkTextView *text_view,
  *
  * Note that this function uses the currently-computed height of the
  * lines in the text buffer. Line heights are computed in an idle 
- * handler; so this function may not have the desired effect if it's 
+ * handler; so this function may not have the desired effect if it’s 
  * called before the height computations. To avoid oddness, consider 
  * using gtk_text_view_scroll_to_mark() which saves a point to be 
  * scrolled to after line validation.
@@ -2587,7 +2587,7 @@ gtk_text_view_get_wrap_mode (GtkTextView *text_view)
 /**
  * gtk_text_view_set_editable:
  * @text_view: a #GtkTextView
- * @setting: whether it's editable
+ * @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”
@@ -2702,7 +2702,7 @@ gtk_text_view_get_pixels_above_lines (GtkTextView *text_view)
  *
  * Sets the default number of pixels of blank space
  * to put below paragraphs in @text_view. May be overridden
- * by tags applied to @text_view's buffer. 
+ * by tags applied to @text_view’s buffer. 
  **/
 void
 gtk_text_view_set_pixels_below_lines (GtkTextView *text_view,
@@ -2751,7 +2751,7 @@ gtk_text_view_get_pixels_below_lines (GtkTextView *text_view)
  *
  * Sets the default number of pixels of blank space to leave between
  * display/wrapped lines within a paragraph. May be overridden by
- * tags in @text_view's buffer.
+ * tags in @text_view’s buffer.
  **/
 void
 gtk_text_view_set_pixels_inside_wrap (GtkTextView *text_view,
@@ -2799,7 +2799,7 @@ gtk_text_view_get_pixels_inside_wrap (GtkTextView *text_view)
  * @justification: justification
  *
  * Sets the default justification of text in @text_view.
- * Tags in the view's buffer may override the default.
+ * Tags in the view’s buffer may override the default.
  * 
  **/
 void
@@ -2976,7 +2976,7 @@ gtk_text_view_set_indent (GtkTextView *text_view,
  * @text_view: a #GtkTextView
  * 
  * Gets the default indentation of paragraphs in @text_view.
- * Tags in the view's buffer may override the default.
+ * Tags in the view’s buffer may override the default.
  * The indentation may be negative.
  * 
  * Return value: number of pixels of indentation
@@ -10227,7 +10227,7 @@ gtk_text_view_move_child (GtkTextView *text_view,
  * Display lines are created by line-wrapping a paragraph. If
  * wrapping is turned off, display lines and paragraphs will be the
  * same. Display lines are divided differently for each view, since
- * they depend on the view's width; paragraphs are the same in all
+ * they depend on the view’s width; paragraphs are the same in all
  * views, since they depend on the contents of the #GtkTextBuffer.
  * 
  * Return value: %TRUE if @iter was moved and is not on the end iterator
@@ -10255,7 +10255,7 @@ gtk_text_view_forward_display_line (GtkTextView *text_view,
  * Display lines are created by line-wrapping a paragraph. If
  * wrapping is turned off, display lines and paragraphs will be the
  * same. Display lines are divided differently for each view, since
- * they depend on the view's width; paragraphs are the same in all
+ * they depend on the view’s width; paragraphs are the same in all
  * views, since they depend on the contents of the #GtkTextBuffer.
  * 
  * Return value: %TRUE if @iter was moved and is not on the end iterator
@@ -10283,7 +10283,7 @@ gtk_text_view_backward_display_line (GtkTextView *text_view,
  * Display lines are created by line-wrapping a paragraph. If
  * wrapping is turned off, display lines and paragraphs will be the
  * same. Display lines are divided differently for each view, since
- * they depend on the view's width; paragraphs are the same in all
+ * they depend on the view’s width; paragraphs are the same in all
  * views, since they depend on the contents of the #GtkTextBuffer.
  * 
  * Return value: %TRUE if @iter was moved and is not on the end iterator
@@ -10311,7 +10311,7 @@ gtk_text_view_forward_display_line_end (GtkTextView *text_view,
  * Display lines are created by line-wrapping a paragraph. If
  * wrapping is turned off, display lines and paragraphs will be the
  * same. Display lines are divided differently for each view, since
- * they depend on the view's width; paragraphs are the same in all
+ * they depend on the view’s width; paragraphs are the same in all
  * views, since they depend on the contents of the #GtkTextBuffer.
  * 
  * Return value: %TRUE if @iter was moved and is not on the end iterator
diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c
index d6e40dc086..2ecd22c72c 100644
--- a/gtk/gtkthemingengine.c
+++ b/gtk/gtkthemingengine.c
@@ -60,7 +60,7 @@
  *
  * #GtkThemingEngine<!-- -->s have limited access to the object they are
  * rendering, the #GtkThemingEngine API has read-only accessors to the
- * style information contained in the rendered object's #GtkStyleContext.
+ * style information contained in the rendered object’s #GtkStyleContext.
  */
 
 enum {
@@ -470,7 +470,7 @@ gtk_theming_engine_get_style_property (GtkThemingEngine *engine,
  * @args: va_list of property name/return location pairs, followed by %NULL
  *
  * Retrieves several widget style properties from @engine according to the
- * currently rendered content's style.
+ * currently rendered content’s style.
  *
  * Since: 3.0
  **/
@@ -492,7 +492,7 @@ gtk_theming_engine_get_style_valist (GtkThemingEngine *engine,
  * @...: property name /return value pairs, followed by %NULL
  *
  * Retrieves several widget style properties from @engine according
- * to the currently rendered content's style.
+ * to the currently rendered content’s style.
  *
  * Since: 3.0
  **/
@@ -518,7 +518,7 @@ gtk_theming_engine_get_style (GtkThemingEngine *engine,
  * @color_name: color name to lookup
  * @color: (out): Return location for the looked up color
  *
- * Looks up and resolves a color name in the current style's color map.
+ * Looks up and resolves a color name in the current style’s color map.
  *
  * Returns: %TRUE if @color_name was found and resolved, %FALSE otherwise
  **/
@@ -568,9 +568,9 @@ gtk_theming_engine_get_state (GtkThemingEngine *engine)
  *
  * If @progress is not %NULL, the animation progress will be returned
  * there, 0.0 means the state is closest to being %FALSE, while 1.0 means
- * it's closest to being %TRUE. This means transition animations will
+ * it’s closest to being %TRUE. This means transition animations will
  * run from 0 to 1 when @state is being set to %TRUE and from 1 to 0 when
- * it's being set to %FALSE.
+ * it’s being set to %FALSE.
  *
  * Returns: %TRUE if there is a running transition animation for @state.
  *
diff --git a/gtk/gtktogglebutton.c b/gtk/gtktogglebutton.c
index 3bbaccd2aa..4e54a8a5ff 100644
--- a/gtk/gtktogglebutton.c
+++ b/gtk/gtktogglebutton.c
@@ -50,7 +50,7 @@
  * A toggle button is created by calling either gtk_toggle_button_new() or
  * gtk_toggle_button_new_with_label(). If using the former, it is advisable to
  * pack a widget, (such as a #GtkLabel and/or a #GtkImage), into the toggle
- * button's container. (See #GtkButton for more information).
+ * button’s container. (See #GtkButton for more information).
  *
  * The state of a #GtkToggleButton can be set specifically using
  * gtk_toggle_button_set_active(), and retrieved using
diff --git a/gtk/gtktoggletoolbutton.c b/gtk/gtktoggletoolbutton.c
index eb74549fca..eb82ef9b50 100644
--- a/gtk/gtktoggletoolbutton.c
+++ b/gtk/gtktoggletoolbutton.c
@@ -274,7 +274,7 @@ gtk_toggle_tool_button_create_menu_proxy (GtkToolItem *item)
  *
  * If a widget is activated and the state of the tool button is the same as
  * the new state of the activated widget, then the other widget was the one
- * that was activated by the user and updated the tool button's state.
+ * that was activated by the user and updated the tool button’s state.
  *
  * If the state of the tool button is not the same as the new state of the
  * activated widget, then the activation was activated by the user, and the
diff --git a/gtk/gtktooltip.c b/gtk/gtktooltip.c
index 47ae1cb3d2..e2bb4cc241 100644
--- a/gtk/gtktooltip.c
+++ b/gtk/gtktooltip.c
@@ -62,7 +62,7 @@
  *   to the signal handler is a GtkTooltip object. This is the object that we
  *   are about to display as a tooltip, and can be manipulated in your callback
  *   using functions like gtk_tooltip_set_icon(). There are functions for setting
- *   the tooltip's markup, setting an image from a named icon, or even putting in
+ *   the tooltip’s markup, setting an image from a named icon, or even putting in
  *   a custom widget.
  *
  *   Return %TRUE from your query-tooltip handler. This causes the tooltip to be
diff --git a/gtk/gtktreednd.c b/gtk/gtktreednd.c
index d65cdc0973..0c6bf7a7e6 100644
--- a/gtk/gtktreednd.c
+++ b/gtk/gtktreednd.c
@@ -311,7 +311,7 @@ gtk_tree_set_row_drag_data (GtkSelectionData *selection_data,
  * Obtains a @tree_model and @path from selection data of target type
  * %GTK_TREE_MODEL_ROW. Normally called from a drag_data_received handler.
  * This function can only be used if @selection_data originates from the same
- * process that's calling this function, because a pointer to the tree model
+ * process that’s calling this function, because a pointer to the tree model
  * is being passed around. If you aren't in the same process, then you'll
  * get memory corruption. In the #GtkTreeDragDest drag_data_received handler,
  * you can assume that selection data of type %GTK_TREE_MODEL_ROW is
diff --git a/gtk/gtktreemenu.c b/gtk/gtktreemenu.c
index cc025070a5..67d2c5ccf0 100644
--- a/gtk/gtktreemenu.c
+++ b/gtk/gtktreemenu.c
@@ -1644,7 +1644,7 @@ _gtk_tree_menu_set_model (GtkTreeMenu  *menu,
  * Gets the @model currently used for the menu heirarhcy.
  *
  * Return value: (transfer none): the #GtkTreeModel which is used
- * for @menu's hierarchy.
+ * for @menu’s hierarchy.
  *
  * Since: 3.0
  */
@@ -1665,7 +1665,7 @@ _gtk_tree_menu_get_model (GtkTreeMenu *menu)
  * @menu: a #GtkTreeMenu
  * @path: (allow-none): the #GtkTreePath which is the root of @menu, or %NULL.
  *
- * Sets the root of a @menu's hierarchy to be @path. @menu must already
+ * Sets the root of a @menu’s hierarchy to be @path. @menu must already
  * have a model set and @path must point to a valid path inside the model.
  *
  * Since: 3.0
@@ -1696,7 +1696,7 @@ _gtk_tree_menu_set_root (GtkTreeMenu *menu,
  * _gtk_tree_menu_get_root:
  * @menu: a #GtkTreeMenu
  *
- * Gets the @root path for @menu's hierarchy, or returns %NULL if @menu
+ * Gets the @root path for @menu’s hierarchy, or returns %NULL if @menu
  * has no model or is building a heirarchy for the entire model. *
  *
  * Return value: (transfer full) (allow-none): A newly created #GtkTreePath
@@ -1832,7 +1832,7 @@ _gtk_tree_menu_set_wrap_width (GtkTreeMenu *menu,
  * The row span column contains integers which indicate how many rows
  * a menu item should span.
  *
- * Return value: the column in @menu's model containing row span information, or -1.
+ * Return value: the column in @menu’s model containing row span information, or -1.
  *
  * Since: 3.0
  */
@@ -1888,7 +1888,7 @@ _gtk_tree_menu_set_row_span_column (GtkTreeMenu *menu,
  * The column span column contains integers which indicate how many columns
  * a menu item should span.
  *
- * Return value: the column in @menu's model containing column span information, or -1.
+ * Return value: the column in @menu’s model containing column span information, or -1.
  *
  * Since: 3.0
  */
diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index 1312d645e9..635ecddff6 100644
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -98,7 +98,7 @@
  * Iterators are expected to always be valid for as long as the model
  * is unchanged (and doesn't emit a signal). The model is considered
  * to own all outstanding iterators and nothing needs to be done to
- * free them from the user's point of view. Additionally, some models
+ * free them from the user’s point of view. Additionally, some models
  * guarantee that an iterator is valid for as long as the node it refers
  * to is valid (most notably the #GtkTreeStore and #GtkListStore).
  * Although generally uninteresting, as one always has to allow for
@@ -2456,7 +2456,7 @@ gtk_tree_row_reference_copy (GtkTreeRowReference *reference)
  * gtk_tree_row_reference_free:
  * @reference: (allow-none): a #GtkTreeRowReference, or %NULL
  *
- * Free's @reference. @reference may be %NULL
+ * Free’s @reference. @reference may be %NULL
  */
 void
 gtk_tree_row_reference_free (GtkTreeRowReference *reference)
diff --git a/gtk/gtktreemodelfilter.c b/gtk/gtktreemodelfilter.c
index 04012356e8..ec966f81dc 100644
--- a/gtk/gtktreemodelfilter.c
+++ b/gtk/gtktreemodelfilter.c
@@ -75,8 +75,8 @@
  * of its child nodes is a frequently occurring use case. Therefore,
  * #GtkTreeModelFilter explicitly supports this. For example, when a node
  * does not have any children, you might not want the node to be visible.
- * As soon as the first row is added to the node's child level (or the
- * last row removed), the node's visibility should be updated.
+ * As soon as the first row is added to the node’s child level (or the
+ * last row removed), the node’s visibility should be updated.
  *
  * This introduces a dependency from the node on its child nodes. In order
  * to accommodate this, #GtkTreeModelFilter must make sure the necessary
@@ -90,7 +90,7 @@
  *
  * Beware, however, that this explicit support is limited to these two
  * cases. For example, if you want a node to be visible only if two nodes
- * in a child's child level (2 levels deeper) are visible, you are on your
+ * in a child’s child level (2 levels deeper) are visible, you are on your
  * own. In this case, either rely on #GtkTreeStore to emit all signals
  * because it does not implement reference counting, or for models that
  * do implement reference counting, obtain references on these child levels
@@ -116,7 +116,7 @@
  * similar data structures, many assumptions made in the GtkTreeModelSort
  * code do *not* apply in the GtkTreeModelFilter case. Reference counting
  * in particular is more complicated in GtkTreeModelFilter, because
- * we explicitly support reliance on the state of a node's children as
+ * we explicitly support reliance on the state of a node’s children as
  * outlined in the public API documentation. Because of these differences,
  * you are strongly recommended to first read through these notes before
  * making any modification to the code.
@@ -192,7 +192,7 @@
  * rule 1 in the GtkTreeModel documentation.
  *
  * A second case is required to support visible functions which depend on
- * the state of a node's children (see the public API documentation for
+ * the state of a node’s children (see the public API documentation for
  * GtkTreeModelFilter above). We build the child level of each node that
  * could be visible in the client (i.e. the level has an ext_ref_count > 0;
  * not the elt, because the elt might be invisible and thus unreferenced
diff --git a/gtk/gtktreemodelfilter.h b/gtk/gtktreemodelfilter.h
index 9d51997425..df2e37aeff 100644
--- a/gtk/gtktreemodelfilter.h
+++ b/gtk/gtktreemodelfilter.h
@@ -62,7 +62,7 @@ typedef gboolean (* GtkTreeModelFilterVisibleFunc) (GtkTreeModel *model,
  * It must fill @value with the display value for the column @column in the
  * row indicated by @iter.
  *
- * Since this function is called for each data access, it's not a
+ * Since this function is called for each data access, it’s not a
  * particularly efficient operation.
  */
 
diff --git a/gtk/gtktreeselection.c b/gtk/gtktreeselection.c
index 0b14d0e599..f9cd68afba 100644
--- a/gtk/gtktreeselection.c
+++ b/gtk/gtktreeselection.c
@@ -377,7 +377,7 @@ gtk_tree_selection_get_mode (GtkTreeSelection *selection)
  * gtk_tree_selection_set_select_function:
  * @selection: A #GtkTreeSelection.
  * @func: The selection function. May be %NULL
- * @data: The selection function's data. May be %NULL
+ * @data: The selection function’s data. May be %NULL
  * @destroy: The destroy function for user data.  May be %NULL
  *
  * Sets the selection function.
diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c
index 8bfdd8ee62..95f7765e1b 100644
--- a/gtk/gtktreestore.c
+++ b/gtk/gtktreestore.c
@@ -1325,7 +1325,7 @@ gtk_tree_store_insert (GtkTreeStore *tree_store,
  * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
  *
  * Inserts a new row before @sibling.  If @sibling is %NULL, then the row will
- * be appended to @parent 's children.  If @parent and @sibling are %NULL, then
+ * be appended to @parent ’s children.  If @parent and @sibling are %NULL, then
  * the row will be appended to the toplevel.  If both @sibling and @parent are
  * set, then @parent must be the parent of @sibling.  When @sibling is set,
  * @parent is optional.
@@ -1406,7 +1406,7 @@ gtk_tree_store_insert_before (GtkTreeStore *tree_store,
  * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
  *
  * Inserts a new row after @sibling.  If @sibling is %NULL, then the row will be
- * prepended to @parent 's children.  If @parent and @sibling are %NULL, then
+ * prepended to @parent ’s children.  If @parent and @sibling are %NULL, then
  * the row will be prepended to the toplevel.  If both @sibling and @parent are
  * set, then @parent must be the parent of @sibling.  When @sibling is set,
  * @parent is optional.
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index 201df03c40..512e4b843f 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -4759,7 +4759,7 @@ gtk_tree_view_draw_grid_lines (GtkTreeView    *tree_view,
  * Modify at your own risk
  *
  * KEEP IN SYNC WITH gtk_tree_view_create_row_drag_icon()!
- * FIXME: It's not...
+ * FIXME: It’s not...
  */
 static gboolean
 gtk_tree_view_bin_draw (GtkWidget      *widget,
@@ -6934,7 +6934,7 @@ gtk_tree_view_set_top_row (GtkTreeView *tree_view,
 }
 
 /* Always call this iff dy is in the visible range.  If the tree is empty, then
- * it's set to be NULL, and top_row_dy is 0;
+ * it’s set to be NULL, and top_row_dy is 0;
  */
 static void
 gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view)
@@ -8412,7 +8412,7 @@ gtk_tree_view_header_focus (GtkTreeView      *tree_view,
 }
 
 /* This function returns in 'path' the first focusable path, if the given path
- * is already focusable, it's the returned one.
+ * is already focusable, it’s the returned one.
  */
 static gboolean
 search_first_focusable_path (GtkTreeView  *tree_view,
@@ -9534,7 +9534,7 @@ _gtk_tree_path_new_from_rbtree (GtkRBTree   *tree,
 }
 
 /* Returns TRUE if we ran out of tree before finding the path.  If the path is
- * invalid (ie. points to a node that's not in the tree), *tree and *node are
+ * invalid (ie. points to a node that’s not in the tree), *tree and *node are
  * both set to NULL.
  */
 gboolean
@@ -11734,7 +11734,7 @@ gtk_tree_view_get_headers_clickable (GtkTreeView *tree_view)
  * application requires users to read across tree rows and associate
  * cells with one another. By default, GTK+ will then render the tree
  * with alternating row colors. Do not use it
- * just because you prefer the appearance of the ruled tree; that's a
+ * just because you prefer the appearance of the ruled tree; that’s a
  * question for the theme. Some themes will draw tree rows in
  * alternating colors even when rules are turned off, and users who
  * prefer that appearance all the time can choose those themes. You
@@ -13052,7 +13052,7 @@ gtk_tree_view_get_reorderable (GtkTreeView *tree_view)
  * #GtkTreeDragDestIface.  Both #GtkTreeStore and #GtkListStore support
  * these.  If @reorderable is %TRUE, then the user can reorder the
  * model by dragging and dropping rows. The developer can listen to
- * these changes by connecting to the model's row_inserted and
+ * these changes by connecting to the model’s row_inserted and
  * row_deleted signals. The reordering is implemented by setting up
  * the tree view as a drag source and destination. Therefore, drag and
  * drop can not be used in a reorderable view for any other purpose.
@@ -13227,7 +13227,7 @@ gtk_tree_view_get_cursor (GtkTreeView        *tree_view,
  * @start_editing: %TRUE if the specified cell should start being edited.
  *
  * Sets the current keyboard focus to be at @path, and selects it.  This is
- * useful when you want to focus the user's attention on a particular row.  If
+ * useful when you want to focus the user’s attention on a particular row.  If
  * @focus_column is not %NULL, then focus is given to the column specified by 
  * it. Additionally, if @focus_column is specified, and @start_editing is 
  * %TRUE, then editing should be started in the specified cell.  
@@ -13257,7 +13257,7 @@ gtk_tree_view_set_cursor (GtkTreeView       *tree_view,
  * @start_editing: %TRUE if the specified cell should start being edited.
  *
  * Sets the current keyboard focus to be at @path, and selects it.  This is
- * useful when you want to focus the user's attention on a particular row.  If
+ * useful when you want to focus the user’s attention on a particular row.  If
  * @focus_column is not %NULL, then focus is given to the column specified by
  * it. If @focus_column and @focus_cell are not %NULL, and @focus_column
  * contains 2 or more editable or activatable cells, then focus is given to
@@ -16246,7 +16246,7 @@ gtk_tree_view_set_tooltip_cell (GtkTreeView       *tree_view,
  * tooltips the row returned will be the cursor row.  When %TRUE, then any of
  * @model, @path and @iter which have been provided will be set to point to
  * that row and the corresponding model.  @x and @y will always be converted
- * to be relative to @tree_view's bin_window if @keyboard_tooltip is %FALSE.
+ * to be relative to @tree_view’s bin_window if @keyboard_tooltip is %FALSE.
  *
  * Return value: whether or not the given tooltip context points to a row.
  *
@@ -16355,11 +16355,11 @@ gtk_tree_view_set_tooltip_query_cb (GtkWidget  *widget,
 /**
  * gtk_tree_view_set_tooltip_column:
  * @tree_view: a #GtkTreeView
- * @column: an integer, which is a valid column number for @tree_view's model
+ * @column: an integer, which is a valid column number for @tree_view’s model
  *
  * If you only plan to have simple (text-only) tooltips on full rows, you
  * can use this function to have #GtkTreeView handle these automatically
- * for you. @column should be set to the column in @tree_view's model
+ * for you. @column should be set to the column in @tree_view’s model
  * containing the tooltip texts, or -1 to disable this feature.
  *
  * When enabled, #GtkWidget:has-tooltip will be set to %TRUE and
@@ -16404,8 +16404,8 @@ gtk_tree_view_set_tooltip_column (GtkTreeView *tree_view,
  * gtk_tree_view_get_tooltip_column:
  * @tree_view: a #GtkTreeView
  *
- * Returns the column of @tree_view's model which is being used for
- * displaying tooltips on @tree_view's rows.
+ * Returns the column of @tree_view’s model which is being used for
+ * displaying tooltips on @tree_view’s rows.
  *
  * Return value: the index of the tooltip column that is currently being
  * used, or -1 if this is disabled.
diff --git a/gtk/gtktreeview.h b/gtk/gtktreeview.h
index 5ccc300342..121e10a205 100644
--- a/gtk/gtktreeview.h
+++ b/gtk/gtktreeview.h
@@ -149,7 +149,7 @@ typedef gboolean (* GtkTreeViewColumnDropFunc) (GtkTreeView             *tree_vi
 /**
  * GtkTreeViewMappingFunc:
  * @tree_view: A #GtkTreeView
- * @path: The path that's expanded
+ * @path: The path that’s expanded
  * @user_data: user data
  *
  * Function used for gtk_tree_view_map_expanded_rows().
diff --git a/gtk/gtktreeviewcolumn.c b/gtk/gtktreeviewcolumn.c
index 26225f2fbd..963af15006 100644
--- a/gtk/gtktreeviewcolumn.c
+++ b/gtk/gtktreeviewcolumn.c
@@ -1652,7 +1652,7 @@ gtk_tree_view_column_new_with_area (GtkCellArea *area)
  * gtk_tree_view_column_pack_start(), and
  * gtk_tree_view_column_set_attributes() on the newly created #GtkTreeViewColumn.
  *
- * Here's a simple example:
+ * Here’s a simple example:
  * |[<!-- language="C" -->
  *  enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
  *  ...
@@ -2302,7 +2302,7 @@ gtk_tree_view_column_get_min_width (GtkTreeViewColumn *tree_column)
  * 
  * Sets the maximum width of the @tree_column.  If @max_width is -1, then the
  * maximum width is unset.  Note, the column can actually be wider than max
- * width if it's the last column in a view.  In this case, the column expands to
+ * width if it’s the last column in a view.  In this case, the column expands to
  * fill any extra space.
  **/
 void
@@ -2839,7 +2839,7 @@ gtk_tree_view_column_get_sort_order      (GtkTreeViewColumn     *tree_column)
  * gtk_tree_view_column_cell_set_cell_data:
  * @tree_column: A #GtkTreeViewColumn.
  * @tree_model: The #GtkTreeModel to to get the cell renderers attributes from.
- * @iter: The #GtkTreeIter to to get the cell renderer's attributes from.
+ * @iter: The #GtkTreeIter to to get the cell renderer’s attributes from.
  * @is_expander: %TRUE, if the row has children
  * @is_expanded: %TRUE, if the row has visible children
  * 
diff --git a/gtk/gtkviewport.c b/gtk/gtkviewport.c
index 1176cf75a3..51b6e3a216 100644
--- a/gtk/gtkviewport.c
+++ b/gtk/gtkviewport.c
@@ -55,7 +55,7 @@
  * ignore the presence of the viewport.
  *
  * The #GtkViewport will start scrolling content only if allocated less
- * than the child widget's minimum size in a given orientation.
+ * than the child widget’s minimum size in a given orientation.
  */
 
 struct _GtkViewportPrivate
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index e882bb2b88..9e565ea748 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -121,7 +121,7 @@
  * After the toplevel window has initially requested its size in both
  * dimensions it can go on to allocate itself a reasonable size (or a size
  * previously specified with gtk_window_set_default_size()). During the
- * recursive allocation process it's important to note that request cycles
+ * recursive allocation process it’s important to note that request cycles
  * will be recursively executed while container widgets allocate their children.
  * Each container widget, once allocated a size, will go on to first share the
  * space in one orientation among its children and then request each child's
@@ -133,7 +133,7 @@
  * to avoid re-querying for the same sizes in one allocation cycle.
  *
  * See
- * [GtkContainer's geometry management section][container-geometry-management]
+ * [GtkContainer’s geometry management section][container-geometry-management]
  * to learn more about how height-for-width allocations are performed
  * by container widgets.
  *
@@ -4060,7 +4060,7 @@ gtk_widget_freeze_child_notify (GtkWidget *widget)
  * gtk_widget_child_notify:
  * @widget: a #GtkWidget
  * @child_property: the name of a child property installed on the
- *                  class of @widget<!-- -->'s parent
+ *                  class of @widget<!-- -->’s parent
  *
  * Emits a #GtkWidget::child-notify signal for the
  * [child property][child-properties] @child_property
@@ -4307,7 +4307,7 @@ gtk_widget_destroy (GtkWidget *widget)
  * @widget_pointer: (inout) (transfer none): address of a variable that contains @widget
  *
  * This function sets *@widget_pointer to %NULL if @widget_pointer !=
- * %NULL.  It's intended to be used as a callback connected to the
+ * %NULL.  It’s intended to be used as a callback connected to the
  * “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
@@ -4332,7 +4332,7 @@ gtk_widget_destroyed (GtkWidget      *widget,
  *
  * Flags a widget to be displayed. Any widget that isn't shown will
  * not appear on the screen. If you want to show all the widgets in a
- * container, it's easier to call gtk_widget_show_all() on the
+ * container, it’s easier to call gtk_widget_show_all() on the
  * container, instead of individually showing the widgets.
  *
  * Remember that you have to show the containers containing a widget,
@@ -4575,7 +4575,7 @@ gtk_widget_map (GtkWidget *widget)
  * @widget: a #GtkWidget
  *
  * This function is only for use in widget implementations. Causes
- * a widget to be unmapped if it's currently mapped.
+ * a widget to be unmapped if it’s currently mapped.
  **/
 void
 gtk_widget_unmap (GtkWidget *widget)
@@ -4975,8 +4975,8 @@ gtk_widget_disconnect_frame_clock (GtkWidget     *widget,
  * realized and mapped automatically.
  *
  * Realizing a widget requires all
- * the widget's parent widgets to be realized; calling
- * gtk_widget_realize() realizes the widget's parents in addition to
+ * the widget’s parent widgets to be realized; calling
+ * gtk_widget_realize() realizes the widget’s parents in addition to
  * @widget itself. If a widget is not yet inside a toplevel window
  * when you realize it, bad things will happen.
  *
@@ -5119,7 +5119,7 @@ gtk_widget_real_queue_draw_region (GtkWidget         *widget,
  * @region: region to draw
  *
  * Invalidates the area of @widget defined by @region by calling
- * gdk_window_invalidate_region() on the widget's window and all its
+ * gdk_window_invalidate_region() on the widget’s window and all its
  * child windows. Once the main loop becomes idle (after the current
  * batch of events has been processed, roughly), the window will
  * receive expose events for the union of all regions that have been
@@ -5221,7 +5221,7 @@ gtk_widget_queue_draw (GtkWidget *widget)
  * Flags a widget to have its size renegotiated; should
  * be called when a widget for some reason has a new size request.
  * For example, when you change the text in a #GtkLabel, #GtkLabel
- * queues a resize to ensure there's enough space for the new text.
+ * queues a resize to ensure there’s enough space for the new text.
  *
  * Note that you cannot call gtk_widget_queue_resize() on a widget
  * from inside its implementation of the GtkWidgetClass::size_allocate 
@@ -5276,9 +5276,9 @@ gtk_widget_queue_resize_no_redraw (GtkWidget *widget)
  * frame). gtk_widget_queue_draw() will also end up requesting a frame
  * on the appropriate frame clock.
  *
- * A widget's frame clock will not change while the widget is
+ * A widget’s frame clock will not change while the widget is
  * mapped. Reparenting a widget (which implies a temporary unmap) can
- * change the widget's frame clock.
+ * change the widget’s frame clock.
  *
  * Unrealized widgets do not have a frame clock.
  *
@@ -5425,7 +5425,7 @@ gtk_widget_invalidate_widget_windows (GtkWidget *widget,
  * adjust_size_allocation virtual and adjust_baseline_allocation
  * methods on the child will be used to adjust the allocation and
  * baseline. Standard adjustments include removing the widget's
- * margins, and applying the widget's #GtkWidget:halign and
+ * margins, and applying the widget’s #GtkWidget:halign and
  * #GtkWidget:valign properties.
  *
  * If the child widget does not have a valign of %GTK_ALIGN_BASELINE the
@@ -5646,8 +5646,8 @@ out:
  * In this function, the allocation may be adjusted. It will be forced
  * to a 1x1 minimum size, and the adjust_size_allocation virtual
  * method on the child will be used to adjust the allocation. Standard
- * adjustments include removing the widget's margins, and applying the
- * widget's #GtkWidget:halign and #GtkWidget:valign properties.
+ * adjustments include removing the widget’s margins, and applying the
+ * widget’s #GtkWidget:halign and #GtkWidget:valign properties.
  *
  * For baseline support in containers you need to use gtk_widget_size_allocate_with_baseline()
  * instead.
@@ -5727,8 +5727,8 @@ gtk_widget_common_ancestor (GtkWidget *widget_a,
  * @dest_x: (out): location to store X position relative to @dest_widget
  * @dest_y: (out): location to store Y position relative to @dest_widget
  *
- * Translate coordinates relative to @src_widget's allocation to coordinates
- * relative to @dest_widget's allocations. In order to perform this
+ * Translate coordinates relative to @src_widget’s allocation to coordinates
+ * relative to @dest_widget’s allocations. In order to perform this
  * operation, both widgets must be realized, and must share a common
  * toplevel.
  *
@@ -6082,7 +6082,7 @@ widget_new_accel_closure (GtkWidget *widget,
  *
  * Installs an accelerator for this @widget in @accel_group that causes
  * @accel_signal to be emitted if the accelerator is activated.
- * The @accel_group needs to be added to the widget's toplevel via
+ * The @accel_group needs to be added to the widget’s toplevel via
  * gtk_window_add_accel_group(), and the signal must be of type %G_SIGNAL_ACTION.
  * Accelerators added through this function are not user changeable during
  * runtime. If you want to support accelerators that can be changed by the
@@ -6699,7 +6699,7 @@ _gtk_widget_draw (GtkWidget *widget,
  * example changing the operator using cairo_set_operator() or the
  * line width using cairo_set_line_width() might have unwanted side
  * effects.
- * You may however change the context's transform matrix - like with
+ * You may however change the context’s transform matrix - like with
  * cairo_scale(), cairo_translate() or cairo_set_matrix() and clip
  * region with cairo_clip() prior to calling this function. Also, it
  * is fine to modify the context with cairo_save() and
@@ -6964,7 +6964,7 @@ _gtk_widget_get_translation_to_window (GtkWidget      *widget,
  *
  * Transforms the given cairo context @cr that from @widget-relative
  * coordinates to @window-relative coordinates.
- * If the @widget's window is not an ancestor of @window, no
+ * If the @widget’s window is not an ancestor of @window, no
  * modification will be applied.
  *
  * This is the inverse to the transformation GTK applies when
@@ -7211,7 +7211,7 @@ gtk_widget_event_internal (GtkWidget *widget,
 
 /**
  * gtk_widget_activate:
- * @widget: a #GtkWidget that's activatable
+ * @widget: a #GtkWidget that’s activatable
  *
  * For widgets that can be “activated” (buttons, menu items, etc.)
  * this function activates them. Activation is what happens when you
@@ -7366,7 +7366,7 @@ gtk_widget_reparent (GtkWidget *widget,
  * @area: a rectangle
  * @intersection: rectangle to store intersection of @widget and @area
  *
- * Computes the intersection of a @widget's area and @area, storing
+ * Computes the intersection of a @widget’s area and @area, storing
  * the intersection in @intersection, and returns %TRUE if there was
  * an intersection.  @intersection may be %NULL if you're only
  * interested in whether there was an intersection.
@@ -7412,7 +7412,7 @@ gtk_widget_intersect (GtkWidget	         *widget,
  *          for %NO_WINDOW widgets; relative to the parent window
  *          of @widget->window for widgets with their own window.
  *
- * Computes the intersection of a @widget's area and @region, returning
+ * Computes the intersection of a @widget’s area and @region, returning
  * the intersection. The result may be empty, use cairo_region_is_empty() to
  * check.
  *
@@ -8331,7 +8331,7 @@ gtk_widget_set_state (GtkWidget           *widget,
  * gtk_widget_get_state:
  * @widget: a #GtkWidget
  *
- * Returns the widget's state. See gtk_widget_set_state().
+ * Returns the widget’s state. See gtk_widget_set_state().
  *
  * Returns: the state of @widget.
  *
@@ -8412,7 +8412,7 @@ _gtk_widget_set_visible_flag (GtkWidget *widget,
  * @widget: a #GtkWidget
  *
  * Determines whether the widget is visible. If you want to
- * take into account whether the widget's parent is also marked as
+ * take into account whether the widget’s parent is also marked as
  * visible, use gtk_widget_is_visible() instead.
  *
  * This function does not check if the widget is obscured in any way.
@@ -8472,7 +8472,7 @@ gtk_widget_is_visible (GtkWidget *widget)
  * Specifies whether @widget has a #GdkWindow of its own. Note that
  * 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
+ * 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
  * themselves in #GtkWidget::realize must announce this by
  * calling this function with @has_window = %FALSE.
@@ -8844,11 +8844,11 @@ gtk_widget_set_sensitive (GtkWidget *widget,
  * gtk_widget_get_sensitive:
  * @widget: a #GtkWidget
  *
- * Returns the widget's sensitivity (in the sense of returning
+ * Returns the widget’s sensitivity (in the sense of returning
  * the value that has been set using gtk_widget_set_sensitive()).
  *
  * The effective sensitivity of a widget is however determined by both its
- * own and its parent widget's sensitivity. See gtk_widget_is_sensitive().
+ * own and its parent widget’s sensitivity. See gtk_widget_is_sensitive().
  *
  * Returns: %TRUE if the widget is sensitive
  *
@@ -8866,7 +8866,7 @@ gtk_widget_get_sensitive (GtkWidget *widget)
  * gtk_widget_is_sensitive:
  * @widget: a #GtkWidget
  *
- * Returns the widget's effective sensitivity, which means
+ * Returns the widget’s effective sensitivity, which means
  * it is sensitive itself and also its parent widget is sensitive
  *
  * Returns: %TRUE if the widget is effectively sensitive
@@ -9061,7 +9061,7 @@ _gtk_widget_get_modifier_properties (GtkWidget *widget)
  * This way, your widget library can install a #GtkCssProvider
  * with the %GTK_STYLE_PROVIDER_PRIORITY_FALLBACK priority in order
  * to provide a default styling for those widgets that need so, and
- * this theming may fully overridden by the user's theme.
+ * this theming may fully overridden by the user’s theme.
  *
  * Note that for complex widgets this may bring in undesired
  * results (such as uniform background color everywhere), in
@@ -9346,7 +9346,7 @@ gtk_widget_propagate_screen_changed_recurse (GtkWidget *widget,
  *
  * Whether @widget can rely on having its alpha channel
  * drawn correctly. On X11 this function returns whether a
- * compositing manager is running for @widget's screen.
+ * compositing manager is running for @widget’s screen.
  *
  * Please note that the semantics of this call will change
  * in the future if used on a widget that has a composited
@@ -9645,7 +9645,7 @@ gtk_widget_peek_pango_context (GtkWidget *widget)
  * by gtk_widget_create_pango_context(), this context is owned by
  * the widget (it can be used until the screen for the widget changes
  * or the widget is removed from its toplevel), and will be updated to
- * match any changes to the widget's attributes. This can be tracked
+ * match any changes to the widget’s attributes. This can be tracked
  * by using the #GtkWidget::screen-changed signal on the widget.
  *
  * Return value: (transfer none): the #PangoContext for the widget.
@@ -9884,7 +9884,7 @@ gtk_widget_set_parent_window (GtkWidget *widget,
  * gtk_widget_get_parent_window:
  * @widget: a #GtkWidget.
  *
- * Gets @widget's parent window.
+ * Gets @widget’s parent window.
  *
  * Returns: (transfer none): the parent window of @widget.
  **/
@@ -10240,7 +10240,7 @@ gtk_widget_child_focus (GtkWidget       *widget,
  *
  * When %FALSE is returned, the caller should continue with keyboard
  * navigation outside the widget, e.g. by calling
- * gtk_widget_child_focus() on the widget's toplevel.
+ * gtk_widget_child_focus() on the widget’s toplevel.
  *
  * The default ::keynav-failed handler returns %TRUE for
  * %GTK_DIR_TAB_FORWARD and %GTK_DIR_TAB_BACKWARD. For the other
@@ -10358,7 +10358,7 @@ gtk_widget_set_usize_internal (GtkWidget          *widget,
  * @width: width @widget should request, or -1 to unset
  * @height: height @widget should request, or -1 to unset
  *
- * Sets the minimum size of a widget; that is, the widget's size
+ * Sets the minimum size of a widget; that is, the widget’s size
  * request will be at least @width by @height. You can use this 
  * function to force a widget to be larger than it normally would be.
  *
@@ -10449,7 +10449,7 @@ gtk_widget_get_size_request (GtkWidget *widget,
  *
  * Temporarily establishes a forced minimum size for a widget; this
  * is used by GtkWindow when calculating the size to add to the
- * window's geometry widget. Cached sizes for the widget and its
+ * window’s geometry widget. Cached sizes for the widget and its
  * parents are invalidated, so that subsequent calls to the size
  * negotiation machinery produce the overriden result, but the
  * widget is not queued for relayout or redraw. The old size must
@@ -10493,7 +10493,7 @@ _gtk_widget_restore_size_request (GtkWidget *widget,
  * Sets the event mask (see #GdkEventMask) for a widget. The event
  * mask determines which events a widget will receive. Keep in mind
  * that different widgets have different default event masks, and by
- * changing the event mask you may disrupt a widget's functionality,
+ * changing the event mask you may disrupt a widget’s functionality,
  * so be careful. This function must be called while a widget is
  * unrealized. Consider gtk_widget_add_events() for widgets that are
  * already realized, or if you want to preserve the existing event
@@ -10523,7 +10523,7 @@ gtk_widget_set_events (GtkWidget *widget,
  * Sets the device event mask (see #GdkEventMask) for a widget. The event
  * mask determines which events a widget will receive from @device. Keep
  * in mind that different widgets have different default event masks, and by
- * changing the event mask you may disrupt a widget's functionality,
+ * changing the event mask you may disrupt a widget’s functionality,
  * so be careful. This function must be called while a widget is
  * unrealized. Consider gtk_widget_add_device_events() for widgets that are
  * already realized, or if you want to preserve the existing event
@@ -10766,7 +10766,7 @@ gtk_widget_add_device_events (GtkWidget    *widget,
  * ]|
  *
  * Return value: (transfer none): the topmost ancestor of @widget, or @widget itself
- *    if there's no ancestor.
+ *    if there’s no ancestor.
  **/
 GtkWidget*
 gtk_widget_get_toplevel (GtkWidget *widget)
@@ -10786,7 +10786,7 @@ gtk_widget_get_toplevel (GtkWidget *widget)
  *
  * Gets the first ancestor of @widget with type @widget_type. For example,
  * `gtk_widget_get_ancestor (widget, GTK_TYPE_BOX)` gets
- * the first #GtkBox that's an ancestor of @widget. No reference will be
+ * the first #GtkBox that’s an ancestor of @widget. No reference will be
  * added to the returned widget; it should not be unreferenced. See note
  * about checking for a toplevel #GtkWindow in the docs for
  * gtk_widget_get_toplevel().
@@ -11086,8 +11086,8 @@ gtk_widget_get_composite_name (GtkWidget *widget)
  * Makes all newly-created widgets as composite children until
  * the corresponding gtk_widget_pop_composite_child() call.
  *
- * A composite child is a child that's an implementation detail of the
- * container it's inside and should not be visible to people using the
+ * A composite child is a child that’s an implementation detail of the
+ * container it’s inside and should not be visible to people using the
  * container. Composite children aren't treated differently by GTK (but
  * see gtk_container_foreach() vs. gtk_container_forall()), but e.g. GUI
  * builders might want to treat them in a different way.
@@ -11739,10 +11739,10 @@ gtk_widget_real_adjust_baseline_request (GtkWidget         *widget,
 /**
  * _gtk_widget_peek_request_cache:
  *
- * Returns the address of the widget's request cache (strictly for
+ * Returns the address of the widget’s request cache (strictly for
  * internal use in gtksizerequest.c)
  *
- * Return value: the address of @widget's size request cache.
+ * Return value: the address of @widget’s size request cache.
  **/
 gpointer
 _gtk_widget_peek_request_cache (GtkWidget *widget)
@@ -12256,7 +12256,7 @@ gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info)
  * @widget: a #GtkWidget
  * @region: (allow-none): shape to be added, or %NULL to remove an existing shape
  *
- * Sets a shape for this widget's GDK window. This allows for
+ * Sets a shape for this widget’s GDK window. This allows for
  * transparent windows etc., see gdk_window_shape_combine_region()
  * for more information.
  *
@@ -12304,7 +12304,7 @@ gtk_widget_shape_combine_region (GtkWidget *widget,
  * @widget: a #GtkWidget
  * @region: (allow-none): shape to be added, or %NULL to remove an existing shape
  *
- * Sets an input shape for this widget's GDK window. This allows for
+ * Sets an input shape for this widget’s GDK window. This allows for
  * windows which react to mouse click in a nonrectangular region, see
  * gdk_window_input_shape_combine_region() for more information.
  *
@@ -12690,7 +12690,7 @@ gtk_widget_class_set_accessible_type (GtkWidgetClass *widget_class,
  * instead.
  *
  * If @role is #ATK_ROLE_INVALID, the default role will not be changed
- * and the accessible's default role will be used instead.
+ * and the accessible’s default role will be used instead.
  *
  * This function should only be called from class init functions of widgets.
  *
@@ -12714,7 +12714,7 @@ gtk_widget_class_set_accessible_role (GtkWidgetClass *widget_class,
  * @widget: a #GtkWidget
  *
  * Gets the accessible for @widget, if it has been created yet.
- * Otherwise, this function returns %NULL. If the @widget's implementation
+ * Otherwise, this function returns %NULL. If the @widget’s implementation
  * does not use the default way to create accessibles, %NULL will always be
  * returned.
  *
@@ -12820,8 +12820,8 @@ gtk_widget_real_get_accessible (GtkWidget *widget)
 }
 
 /*
- * Initialize a AtkImplementorIface instance's virtual pointers as
- * appropriate to this implementor's class (GtkWidget).
+ * Initialize a AtkImplementorIface instance’s virtual pointers as
+ * appropriate to this implementor’s class (GtkWidget).
  */
 static void
 gtk_widget_accessible_interface_init (AtkImplementorIface *iface)
@@ -13078,7 +13078,7 @@ gtk_widget_set_expand_set (GtkWidget      *widget,
  * has the expand flag set. If any child of a widget wants to
  * expand, the parent may ask to expand also.
  *
- * This function only looks at the widget's own hexpand flag, rather
+ * This function only looks at the widget’s own hexpand flag, rather
  * than computing whether the entire widget tree rooted at this widget
  * wants to expand.
  *
@@ -13120,7 +13120,7 @@ gtk_widget_get_hexpand (GtkWidget *widget)
  * This function forces the widget to expand or not to expand,
  * regardless of children.  The override occurs because
  * gtk_widget_set_hexpand() sets the hexpand-set property (see
- * gtk_widget_set_hexpand_set()) which causes the widget's hexpand
+ * gtk_widget_set_hexpand_set()) which causes the widget’s hexpand
  * value to be used, rather than looking at children and widget state.
  */
 void
@@ -13144,7 +13144,7 @@ gtk_widget_set_hexpand (GtkWidget      *widget,
  * set, then the expand value depends on whether any
  * children of the widget would like to expand.
  *
- * There are few reasons to use this function, but it's here
+ * There are few reasons to use this function, but it’s here
  * for completeness and consistency.
  *
  * Return value: whether hexpand has been explicitly set
@@ -13175,7 +13175,7 @@ gtk_widget_get_hexpand_set (GtkWidget      *widget)
  * set, then the expand value depends on whether any
  * children of the widget would like to expand.
  *
- * There are few reasons to use this function, but it's here
+ * There are few reasons to use this function, but it’s here
  * for completeness and consistency.
  */
 void
@@ -14838,10 +14838,10 @@ gtk_widget_get_has_tooltip (GtkWidget *widget)
  * @widget: a #GtkWidget
  * @allocation: (out): a pointer to a #GtkAllocation to copy to
  *
- * Retrieves the widget's allocation.
+ * 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
+ * Note, when implementing a #GtkContainer: a widget’s allocation will
+ * 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.
@@ -14876,8 +14876,8 @@ gtk_widget_get_allocation (GtkWidget     *widget,
  * @widget: a #GtkWidget
  * @allocation: a pointer to a #GtkAllocation to copy from
  *
- * Sets the widget's allocation.  This should not be used
- * directly, but from within a widget's size_allocate method.
+ * 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
  * allocation. If you're implementing a #GtkContainer, you want to use
@@ -14965,10 +14965,10 @@ gtk_widget_get_allocated_baseline (GtkWidget *widget)
  * @widget: a #GtkWidget
  * @requisition: (out): a pointer to a #GtkRequisition to copy to
  *
- * Retrieves the widget's requisition.
+ * Retrieves the widget’s requisition.
  *
  * This function should only be used by widget implementations in
- * order to figure whether the widget's requisition has actually
+ * order to figure whether the widget’s requisition has actually
  * changed after some internal state change (so that they can call
  * gtk_widget_queue_resize() instead of gtk_widget_queue_draw()).
  *
@@ -14995,15 +14995,15 @@ gtk_widget_get_requisition (GtkWidget      *widget,
  * @widget: a #GtkWidget
  * @window: (transfer full): a #GdkWindow
  *
- * Sets a widget's window. This function should only be used in a
- * widget's #GtkWidget::realize implementation. The %window passed is
+ * Sets a widget’s window. This function should only be used in a
+ * widget’s #GtkWidget::realize implementation. The %window passed is
  * usually either new window created with gdk_window_new(), or the
  * window of its parent widget as returned by
  * gtk_widget_get_parent_window().
  *
  * Widgets must indicate whether they will create their own #GdkWindow
  * by calling gtk_widget_set_has_window(). This is usually done in the
- * widget's init() function.
+ * widget’s init() function.
  *
  * Note that this function does not add any reference to @window.
  *
@@ -15096,9 +15096,9 @@ gtk_widget_unregister_window (GtkWidget    *widget,
  * gtk_widget_get_window:
  * @widget: a #GtkWidget
  *
- * Returns the widget's window if it is realized, %NULL otherwise
+ * Returns the widget’s window if it is realized, %NULL otherwise
  *
- * Return value: (transfer none): @widget's window.
+ * Return value: (transfer none): @widget’s window.
  *
  * Since: 2.14
  */
@@ -15210,7 +15210,7 @@ gtk_widget_update_alpha (GtkWidget *widget)
  * For toplevel widgets this depends on the capabilities of the windowing
  * system. On X11 this has any effect only on X screens with a compositing manager
  * running. See gtk_widget_is_composited(). On Windows it should work
- * always, although setting a window's opacity after the window has been
+ * always, although setting a window’s opacity after the window has been
  * shown causes it to flicker once on Windows.
  *
  * For child widgets it doesn't work if any affected widget has a native window, or
@@ -15283,7 +15283,7 @@ _gtk_widget_set_has_focus (GtkWidget *widget,
  * This function is not meant to be used by applications. The only time it
  * should be used is when it is necessary for a #GtkWidget to assign focus
  * to a widget that is semantically owned by the first widget even though
- * it's not a direct child - for instance, a search entry in a floating
+ * it’s not a direct child - for instance, a search entry in a floating
  * window similar to the quick search in #GtkTreeView.
  *
  * An example of its usage is:
@@ -15631,7 +15631,7 @@ _gtk_widget_invalidate_style_context (GtkWidget    *widget,
  * @widget: a #GtkWidget
  * @intent: the use case for the modifier mask
  *
- * Returns the modifier mask the @widget's windowing system backend
+ * Returns the modifier mask the @widget’s windowing system backend
  * uses for a particular purpose.
  *
  * See gdk_keymap_get_modifier_mask().
@@ -15897,7 +15897,7 @@ setup_template_child (GtkWidgetTemplate *template_data,
  * initializers.
  *
  * Another reason is that when calling g_object_new() on a widget with
- * composite templates, it's important to build the composite widgets
+ * composite templates, it’s important to build the composite widgets
  * before the construct properties are set. Properties passed to g_object_new()
  * should take precedence over properties set in the private template XML.
  *
@@ -15997,7 +15997,7 @@ gtk_widget_init_template (GtkWidget *widget)
  * For convenience, gtk_widget_class_set_template_from_resource() is also provided.
  *
  * Note that any class that installs templates must call gtk_widget_init_template()
- * in the widget's instance initializer.
+ * in the widget’s instance initializer.
  *
  * Since: 3.10
  */
@@ -16021,7 +16021,7 @@ gtk_widget_class_set_template (GtkWidgetClass    *widget_class,
  * A convenience function to call gtk_widget_class_set_template().
  *
  * Note that any class that installs templates must call gtk_widget_init_template()
- * in the widget's instance initializer.
+ * in the widget’s instance initializer.
  *
  * Since: 3.10
  */
@@ -16095,7 +16095,7 @@ gtk_widget_class_bind_template_callback_full (GtkWidgetClass *widget_class,
  *                        class finalization time, when no classes of type @widget_type are in use anymore.
  *
  * For use in lanuage bindings, this will override the default #GtkBuilderConnectFunc to be
- * used when parsing GtkBuilder xml from this class's template data.
+ * used when parsing GtkBuilder xml from this class’s template data.
  *
  * Note that this must be called from a composite widget classes class
  * initializer after calling gtk_widget_class_set_template().
@@ -16127,17 +16127,17 @@ gtk_widget_class_set_connect_func (GtkWidgetClass        *widget_class,
  * @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
+ * @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.
  *
  * Automatically assign an object declared in the class template XML to be set to a location
- * on a freshly built instance's private data, or alternatively accessible via gtk_widget_get_template_child().
+ * on a freshly built instance’s private data, or alternatively accessible via gtk_widget_get_template_child().
  *
  * The struct can point either into the public instance, then you should use G_STRUCT_OFFSET(WidgetType, member)
  * for @struct_offset,  or in the private struct, then you should use G_PRIVATE_OFFSET(WidgetType, member).
  *
  * An explicit strong reference will be held automatically for the duration of your
- * instance's life cycle, it will be released automatically when #GObjectClass.dispose() runs
+ * instance’s life cycle, it will be released automatically when #GObjectClass.dispose() runs
  * on your instance and if a @struct_offset that is != 0 is specified, then the automatic location
  * in your instance public or private data will be set to %NULL. You can however access an automated child
  * pointer the first time your classes #GObjectClass.dispose() runs, or alternatively in
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 31a0a5195f..7649054454 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -41,7 +41,7 @@ G_BEGIN_DECLS
 /**
  * GtkWidgetHelpType:
  * @GTK_WIDGET_HELP_TOOLTIP: Tooltip.
- * @GTK_WIDGET_HELP_WHATS_THIS: What's this.
+ * @GTK_WIDGET_HELP_WHATS_THIS: What’s this.
  *
  * Kinds of widget-specific help. Used by the ::show-help signal.
  */
@@ -70,15 +70,15 @@ typedef struct _GtkWidgetAuxInfo       GtkWidgetAuxInfo;
 
 /**
  * GtkAllocation:
- * @x: the X position of the widget's area relative to its parents allocation.
- * @y: the Y position of the widget's area relative to its parents allocation.
- * @width: the width of the widget's allocated area.
- * @height: the height of the widget's allocated area.
+ * @x: the X position of the widget’s area relative to its parents allocation.
+ * @y: the Y position of the widget’s area relative to its parents allocation.
+ * @width: the width of the widget’s allocated area.
+ * @height: the height of the widget’s allocated area.
  *
  * A #GtkAllocation-struct of a widget represents region
  * which has been allocated to the widget by its parent. It is a subregion
  * of its parents allocation. See
- * [GtkWidget's geometry management section][geometry-management] for
+ * [GtkWidget’s geometry management section][geometry-management] for
  * more information.
  */
 typedef 	GdkRectangle	   GtkAllocation;
@@ -113,11 +113,11 @@ typedef gboolean (*GtkTickCallback) (GtkWidget     *widget,
 
 /**
  * GtkRequisition:
- * @width: the widget's desired width
- * @height: the widget's desired height
+ * @width: the widget’s desired width
+ * @height: the widget’s desired height
  *
  * A #GtkRequisition-struct represents the desired size of a widget. See
- * [GtkWidget's geometry management section][geometry-management] for
+ * [GtkWidget’s geometry management section][geometry-management] for
  * more information.
  */
 struct _GtkRequisition
@@ -196,7 +196,7 @@ struct _GtkWidget
  *   %GTK_SIZE_REQUEST_CONSTANT_SIZE disables any height-for-width or
  *   width-for-height geometry management for a said widget and is the
  *   default return.
- *   It's important to note (as described below) that any widget
+ *   It’s important to note (as described below) that any widget
  *   which trades height-for-width or width-for-height must respond properly 
  *   to both of the virtual methods #GtkWidgetClass.get_preferred_height_for_width()
  *   and #GtkWidgetClass.get_preferred_width_for_height() since it might be 
@@ -208,14 +208,14 @@ struct _GtkWidget
  *   #GtkWidgetClass.get_preferred_height()).
  * @get_preferred_width_for_height: This is analogous to
  *   #GtkWidgetClass.get_preferred_height_for_width() except that it
- *   operates in the oposite orientation. It's rare that a widget actually
+ *   operates in the oposite orientation. It’s rare that a widget actually
  *   does %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT requests but this can happen
  *   when, for example, a widget or container gets additional columns to
  *   compensate for a smaller allocated height.
  * @get_preferred_width: This is called by containers to obtain the minimum
  *   and natural width of a widget. A widget will never be allocated a width
  *   less than its minimum and will only ever be allocated a width greater
- *   than the natural width once all of the said widget's siblings have
+ *   than the natural width once all of the said widget’s siblings have
  *   received their natural widths.
  *   Furthermore, a widget will only ever be allocated a width greater than
  *   its natural width if it was configured to receive extra expand space
@@ -228,7 +228,7 @@ struct _GtkWidget
  * @mnemonic_activate: Activates the @widget if @group_cycling is
  *   %FALSE, and just grabs the focus if @group_cycling is %TRUE.
  * @grab_focus: Causes @widget to have the keyboard focus for the
- *   #GtkWindow it's inside.
+ *   #GtkWindow it’s inside.
  * @focus:
  * @move_focus: Signal emitted when a change of focus is requested
  * @keynav_failed: Signal emitted if keyboard navigation fails.
@@ -244,36 +244,36 @@ struct _GtkWidget
  * @scroll_event: Signal emitted when a button in the 4 to 7 range is
  *   pressed.
  * @motion_notify_event: Signal emitted when the pointer moves over
- *   the widget's #GdkWindow.
+ *   the widget’s #GdkWindow.
  * @delete_event: Signal emitted if a user requests that a toplevel
  *   window is closed.
  * @destroy_event: Signal is emitted when a #GdkWindow is destroyed.
  * @key_press_event: Signal emitted when a key is pressed.
  * @key_release_event: Signal is emitted when a key is released.
  * @enter_notify_event: Signal event will be emitted when the pointer
- *   enters the widget's window.
+ *   enters the widget’s window.
  * @leave_notify_event: Will be emitted when the pointer leaves the
- *   widget's window.
+ *   widget’s window.
  * @configure_event: Signal will be emitted when the size, position or
- *   stacking of the widget's window has changed.
+ *   stacking of the widget’s window has changed.
  * @focus_in_event: Signal emitted when the keyboard focus enters the
- * widget's window.
+ * widget’s window.
  * @focus_out_event: Signal emitted when the keyboard focus leaves the
- * widget's window.
- * @map_event: Signal emitted when the widget's window is mapped.
- * @unmap_event: Signal will be emitted when the widget's window is
+ * widget’s window.
+ * @map_event: Signal emitted when the widget’s window is mapped.
+ * @unmap_event: Signal will be emitted when the widget’s window is
  *   unmapped.
  * @property_notify_event: Signal will be emitted when a property on
- *   the widget's window has been changed or deleted.
+ *   the widget’s window has been changed or deleted.
  * @selection_clear_event: Signal will be emitted when the the
- *   widget's window has lost ownership of a selection.
+ *   widget’s window has lost ownership of a selection.
  * @selection_request_event: Signal will be emitted when another
  *   client requests ownership of the selection owned by the widget's
  *   window.
  * @selection_notify_event:
  * @proximity_in_event:
  * @proximity_out_event:
- * @visibility_notify_event: Signal emitted when the widget's window is
+ * @visibility_notify_event: Signal emitted when the widget’s window is
  *   obscured or unobscured.
  * @window_state_event: Signal emitted when the state of the toplevel
  *   window associated to the widget changes.
@@ -329,14 +329,14 @@ struct _GtkWidget
  *   greater than -1, it is the proposed allocation in the opposing
  *   orientation that we need the request for. Implementations of
  *   adjust_size_request should chain up to the default implementation,
- *   which applies #GtkWidget's margin properties and imposes any values
+ *   which applies #GtkWidget’s margin properties and imposes any values
  *   from gtk_widget_set_size_request(). Chaining up should be last,
  *   after your subclass adjusts the request, so
  *   #GtkWidget can apply constraints and add the margin properly.
  * @adjust_size_allocation: Convert an initial size allocation assigned
  *   by a #GtkContainer using gtk_widget_size_allocate(), into an actual
  *   size allocation to be used by the widget. adjust_size_allocation
- *   adjusts to a child widget's actual allocation
+ *   adjusts to a child widget’s actual allocation
  *   from what a parent container computed for the
  *   child. The adjusted allocation must be entirely within the original
  *   allocation. In any custom implementation, chain up to the default
@@ -609,11 +609,11 @@ struct _GtkWidgetClass
 
 /**
  * GtkWidgetAuxInfo:
- * @width: the widget's width
- * @height: the widget's height
- * @halign: the widget's horizontal alignment
- * @valign: the widget's horizontal alignment
- * @margin: the widget's #GtkBorder margins
+ * @width: the widget’s width
+ * @height: the widget’s height
+ * @halign: the widget’s horizontal alignment
+ * @valign: the widget’s horizontal alignment
+ * @margin: the widget’s #GtkBorder margins
  *
  */
 struct _GtkWidgetAuxInfo
diff --git a/gtk/gtkwin32embed.h b/gtk/gtkwin32embed.h
index 6694a6044b..da08dfd875 100644
--- a/gtk/gtkwin32embed.h
+++ b/gtk/gtkwin32embed.h
@@ -37,7 +37,7 @@ G_BEGIN_DECLS
  * So far all the window messages are posted to the other
  * process. Maybe some later enhancement will add also messages that
  * are sent, i.e. where the sending process waits for the receiving
- * process's window procedure to handle the message.
+ * process’s window procedure to handle the message.
  */
 
 typedef enum {					/* send or post? */
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 960784e220..462ac7f86e 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -1903,7 +1903,7 @@ gtk_window_set_title_internal (GtkWindow   *window,
  * displayed in its title bar; on the X Window System, the title bar
  * is rendered by the [window manager][gtk-X11-arch],
  * so exactly how the title appears to users may vary
- * according to a user's exact configuration. The title should help a
+ * according to a user’s exact configuration. The title should help a
  * user distinguish this window from other windows they may have
  * open. A good title might include the application name and current
  * document filename, for example.
@@ -1983,7 +1983,7 @@ gtk_window_set_wmclass (GtkWindow *window,
  * In combination with the window title, the window role allows a
  * [window manager][gtk-X11-arch] 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.
  *
@@ -2170,10 +2170,10 @@ _gtk_window_internal_set_focus (GtkWindow *window,
  * @default_widget: (allow-none): widget to be the default, or %NULL to unset the
  *                  default widget for the toplevel.
  *
- * The default widget is the widget that's activated when the user
+ * The default widget is the widget that’s activated when the user
  * presses Enter in a dialog (for example). This function sets or
  * unsets the default widget for a #GtkWindow about. When setting
- * (rather than unsetting) the default widget it's generally easier to
+ * (rather than unsetting) the default widget it’s generally easier to
  * call gtk_widget_grab_focus() on the widget. Before making a widget
  * the default widget, you must call gtk_widget_set_can_default() on the
  * widget you'd like to make the default.
@@ -2962,7 +2962,7 @@ gtk_window_get_attached_to (GtkWindow *window)
  * running. See gtk_widget_is_composited(). On Windows it should work
  * always.
  * 
- * Note that setting a window's opacity after the window has been
+ * Note that setting a window’s opacity after the window has been
  * shown causes it to flicker once on Windows.
  *
  * Since: 2.12
@@ -3438,7 +3438,7 @@ gtk_window_get_destroy_with_parent (GtkWindow *window)
  * @window: a #GtkWindow
  * @setting: whether to hide the titlebar when @window is maximized
  *
- * If @setting is %TRUE, then @window will request that it's titlebar
+ * If @setting is %TRUE, then @window will request that it’s titlebar
  * should be hidden when maximized.
  * This is useful for windows that don't convey any information other
  * than the application name in the titlebar, to put the available
@@ -3761,7 +3761,7 @@ _gtk_window_titlebar_shows_app_menu (GtkWindow *window)
  * function may not have any effect when called on a window that is
  * already visible, so you should call it before calling gtk_widget_show().
  *
- * On Windows, this function always works, since there's no window manager
+ * On Windows, this function always works, since there’s no window manager
  * policy involved.
  * 
  **/
@@ -3835,7 +3835,7 @@ gtk_window_get_decorated (GtkWindow *window)
  * function may not have any effect when called on a window that is
  * already visible, so you should call it before calling gtk_widget_show().
  *
- * On Windows, this function always works, since there's no window manager
+ * On Windows, this function always works, since there’s no window manager
  * policy involved.
  *
  * Since: 2.10
@@ -4166,7 +4166,7 @@ gtk_window_unrealize_icon (GtkWindow *window)
  *
  * Note that transient windows (those who have been set transient for another
  * window using gtk_window_set_transient_for()) will inherit their
- * icon from their transient parent. So there's no need to explicitly
+ * icon from their transient parent. So there’s no need to explicitly
  * set the icon on transient windows.
  **/
 void
@@ -4210,7 +4210,7 @@ gtk_window_set_icon_list (GtkWindow  *window,
  * The list is copied, but the reference count on each
  * member won't be incremented.
  *
- * Return value: (element-type GdkPixbuf) (transfer container): copy of window's icon list
+ * Return value: (element-type GdkPixbuf) (transfer container): copy of window’s icon list
  **/
 GList*
 gtk_window_get_icon_list (GtkWindow  *window)
@@ -4670,7 +4670,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
@@ -4684,7 +4684,7 @@ gtk_window_set_default_size_internal (GtkWindow    *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).
  *
- * For more control over a window's initial size and how resizing works,
+ * For more control over a window’s initial size and how resizing works,
  * investigate gtk_window_set_geometry_hints().
  *
  * For some uses, gtk_window_resize() is a more appropriate function.
@@ -4871,7 +4871,7 @@ gtk_window_resize_to_geometry (GtkWindow *window,
  *
  * Note 3: If you are getting a window size in order to position
  * the window onscreen, there may be a better way. The preferred
- * way is to simply set the window's semantic type with
+ * way is to simply set the window’s semantic type with
  * gtk_window_set_type_hint(), which allows the window manager to
  * e.g. center dialogs. Also, if you set the transient parent of
  * dialogs with gtk_window_set_transient_for() window managers
@@ -4884,7 +4884,7 @@ gtk_window_resize_to_geometry (GtkWindow *window,
  * application cannot.
  *
  * In any case, if you insist on application-specified window
- * positioning, there's still a better way than
+ * positioning, there’s still a better way than
  * doing it yourself - gtk_window_set_position() will frequently
  * handle the details for you.
  * 
@@ -5059,8 +5059,8 @@ gtk_window_move (GtkWindow *window,
  * gravity to do things like place a window in a corner of the screen,
  * because static gravity ignores the window manager decorations.
  *
- * If you are saving and restoring your application's window
- * positions, you should know that it's impossible for applications to
+ * If you are saving and restoring your application’s window
+ * positions, you should know that it’s impossible for applications to
  * 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
@@ -7449,7 +7449,7 @@ gtk_window_get_has_resize_grip (GtkWindow *window)
  * If a window has a resize grip, this will retrieve the grip
  * position, width and height into the specified #GdkRectangle.
  *
- * Returns: %TRUE if the resize grip's area was retrieved
+ * Returns: %TRUE if the resize grip’s area was retrieved
  *
  * Since: 3.0
  */
@@ -9936,13 +9936,13 @@ gtk_window_draw (GtkWidget *widget,
  * Presents a window to the user. This may mean raising the window
  * in the stacking order, deiconifying it, moving it to the current
  * desktop, and/or giving it the keyboard focus, possibly dependent
- * on the user's platform, window manager, and preferences.
+ * on the user’s platform, window manager, and preferences.
  *
  * If @window is hidden, this function calls gtk_widget_show()
  * as well.
  * 
  * This function should be used when the user tries to open a window
- * that's already open. Say for example the preferences dialog is
+ * that’s already open. Say for example the preferences dialog is
  * currently open, and the user chooses Preferences from the menu
  * a second time; use gtk_window_present() to move the already-open dialog
  * where the user can see it.
@@ -10027,7 +10027,7 @@ gtk_window_present_with_time (GtkWindow *window,
  * iconification isn't possible, etc. But normally the window will end
  * up iconified. Just don't write code that crashes if not.
  *
- * It's permitted to call this function before showing a window,
+ * It’s permitted to call this function before showing a window,
  * in which case the window will be iconified before it ever appears
  * onscreen.
  *
@@ -10100,7 +10100,7 @@ gtk_window_deiconify (GtkWindow *window)
  * windows. But normally the window will end up stuck. Just don't
  * write code that crashes if not.
  *
- * It's permitted to call this function before showing a window.
+ * It’s permitted to call this function before showing a window.
  *
  * You can track stickiness via the “window-state-event” signal
  * on #GtkWidget.
@@ -10131,7 +10131,7 @@ gtk_window_stick (GtkWindow *window)
  * @window: a #GtkWindow
  *
  * Asks to unstick @window, which means that it will appear on only
- * one of the user's desktops. Note that you shouldn't assume the
+ * one of the user’s desktops. Note that you shouldn't assume the
  * window is definitely unstuck afterward, because other entities
  * (e.g. the user or [window manager][gtk-X11-arch]) could
  * stick it again. But normally the window will
@@ -10173,7 +10173,7 @@ gtk_window_unstick (GtkWindow *window)
  * normally the window will end up maximized. Just don't write code
  * that crashes if not.
  *
- * It's permitted to call this function before showing a window,
+ * It’s permitted to call this function before showing a window,
  * in which case the window will be maximized when it appears onscreen
  * initially.
  *
@@ -10324,7 +10324,7 @@ gtk_window_unfullscreen (GtkWindow *window)
  * normally the window will end kept above. Just don't write code
  * that crashes if not.
  *
- * It's permitted to call this function before showing a window,
+ * It’s permitted to call this function before showing a window,
  * in which case the window will be kept above when it appears onscreen
  * initially.
  *
@@ -10375,7 +10375,7 @@ gtk_window_set_keep_above (GtkWindow *window,
  * normally the window will be kept below. Just don't write code
  * that crashes if not.
  *
- * It's permitted to call this function before showing a window,
+ * It’s permitted to call this function before showing a window,
  * in which case the window will be kept below when it appears onscreen
  * initially.
  *
@@ -11821,7 +11821,7 @@ _gtk_window_set_is_active (GtkWindow *window,
  * in-process, parented GtkPlug)
  *
  * Internal function used by #GtkPlug when it gets parented/unparented by a
- * #GtkSocket.  This keeps the @window's #GTK_WINDOW_TOPLEVEL flag in sync
+ * #GtkSocket.  This keeps the @window’s #GTK_WINDOW_TOPLEVEL flag in sync
  * with the global list of toplevel windows.
  */
 void