docs: use proper apostrophe

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

27 files changed, 101 insertions, 101 deletions

diff --git a/gdk/gdkdevice.c b/gdk/gdkdevice.c
index d41380430d..a9ecf39b63 100644
--- a/gdk/gdkdevice.c
+++ b/gdk/gdkdevice.c
@@ -388,7 +388,7 @@ gdk_device_get_property (GObject    *object,
  * @mask: location to store the modifiers, or %NULL.
  *
  * Gets the current state of a pointer device relative to @window. As a slave
- * device's coordinates are those of its master pointer, this
+ * device’s coordinates are those of its master pointer, this
  * function may not be called on devices of type %GDK_DEVICE_TYPE_SLAVE,
  * unless there is an ongoing grab on them. See gdk_device_grab().
  */
@@ -740,7 +740,7 @@ gdk_device_get_mode (GdkDevice *device)
  * @mode: the input mode.
  *
  * Sets a the mode of an input device. The mode controls if the
- * device is active and whether the device's range is mapped to the
+ * device is active and whether the device’s range is mapped to the
  * entire screen or to a single window.
  *
  * Returns: %TRUE if the mode was successfully changed.
diff --git a/gdk/gdkdevice.h b/gdk/gdkdevice.h
index f9f853d6a4..a67f4b5890 100644
--- a/gdk/gdkdevice.h
+++ b/gdk/gdkdevice.h
@@ -64,9 +64,9 @@ typedef enum
 /**
  * GdkInputMode:
  * @GDK_MODE_DISABLED: the device is disabled and will not report any events.
- * @GDK_MODE_SCREEN: the device is enabled. The device's coordinate space
+ * @GDK_MODE_SCREEN: the device is enabled. The device’s coordinate space
  *                   maps to the entire screen.
- * @GDK_MODE_WINDOW: the device is enabled. The device's coordinate space
+ * @GDK_MODE_WINDOW: the device is enabled. The device’s coordinate space
  *                   is mapped to a single window. The manner in which this window
  *                   is chosen is undefined, but it will typically be the same
  *                   way in which the focus window for key events is determined.
@@ -132,7 +132,7 @@ typedef enum {
 /**
  * GdkTimeCoord:
  * @time: The timestamp for this event.
- * @axes: the values of the device's axes.
+ * @axes: the values of the device’s axes.
  *
  * A #GdkTimeCoord stores a single event in a motion history.
  */
diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index c7cfabdfb4..acea8bd31f 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -326,7 +326,7 @@ gdk_display_get_event (GdkDisplay *display)
  * gdk_display_peek_event:
  * @display: a #GdkDisplay 
  * 
- * Gets a copy of the first #GdkEvent in the @display's event queue, without
+ * Gets a copy of the first #GdkEvent in the @display’s event queue, without
  * removing the event from the queue.  (Note that this function will
  * not get more events from the windowing system.  It only checks the events
  * that have already been moved to the GDK event queue.)
@@ -1615,7 +1615,7 @@ gdk_display_request_selection_notification (GdkDisplay *display,
  * @display: a #GdkDisplay
  *
  * Returns whether the speicifed display supports clipboard
- * persistance; i.e. if it's possible to store the clipboard data after an
+ * persistance; i.e. if it’s possible to store the clipboard data after an
  * application has quit. On X11 this checks if a clipboard daemon is
  * running.
  *
@@ -1945,7 +1945,7 @@ _gdk_display_get_next_serial (GdkDisplay *display)
  *
  * Indicates to the GUI environment that the application has finished
  * loading. If the applications opens windows, this function is
- * normally called after opening the application's initial set of
+ * normally called after opening the application’s initial set of
  * windows.
  *
  * GTK+ will call this function automatically after opening the first
diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index e191739aa5..11a8064561 100644
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -464,7 +464,7 @@ gdk_event_peek (void)
  * @event: a #GdkEvent.
  *
  * Appends a copy of the given event onto the front of the event
- * queue for event->any.window's display, or the default event
+ * queue for event->any.window’s display, or the default event
  * queue if event->any.window is %NULL. See gdk_display_put_event().
  **/
 void
@@ -611,7 +611,7 @@ _gdk_event_get_pointer_emulated (GdkEvent *event)
  * @event: a #GdkEvent
  * 
  * Copies a #GdkEvent, copying or incrementing the reference count of the
- * resources associated with it (e.g. #GdkWindow's and strings).
+ * resources associated with it (e.g. #GdkWindow’s and strings).
  * 
  * Return value: a copy of @event. The returned #GdkEvent should be freed with
  * gdk_event_free().
@@ -913,7 +913,7 @@ gdk_event_get_time (const GdkEvent *event)
  * 
  * If the event contains a “state” field, puts that field in @state. Otherwise
  * stores an empty state (0). Returns %TRUE if there was a state field
- * in the event. @event may be %NULL, in which case it's treated
+ * in the event. @event may be %NULL, in which case it’s treated
  * as if the event had no state field.
  * 
  * Return value: %TRUE if there was a state field in the event 
diff --git a/gdk/gdkevents.h b/gdk/gdkevents.h
index a490548a7f..aebca9e4a3 100644
--- a/gdk/gdkevents.h
+++ b/gdk/gdkevents.h
@@ -993,11 +993,11 @@ struct _GdkEventOwnerChange
  * @device: the master device that the event originated from. Use
  * gdk_event_get_source_device() to get the slave device.
  *
- * Proximity events are generated when using GDK's wrapper for the
+ * Proximity events are generated when using GDK’s wrapper for the
  * XInput extension. The XInput extension is an add-on for standard X
  * that allows you to use nonstandard devices such as graphics tablets.
  * A proximity event indicates that the stylus has moved in or out of
- * contact with the tablet, or perhaps that the user's finger has moved
+ * contact with the tablet, or perhaps that the user’s finger has moved
  * in or out of contact with a touch screen.
  *
  * This event type will be used pretty rarely. It only is important for
diff --git a/gdk/gdkframeclock.c b/gdk/gdkframeclock.c
index 26ce86347a..6a76cfa1aa 100644
--- a/gdk/gdkframeclock.c
+++ b/gdk/gdkframeclock.c
@@ -252,10 +252,10 @@ gdk_frame_clock_init (GdkFrameClock *clock)
  * @frame_clock: a #GdkFrameClock
  *
  * Gets the time that should currently be used for animations.  Inside
- * the processing of a frame, it's the time used to compute the
+ * the processing of a frame, it’s the time used to compute the
  * animation position of everything in a frame. Outside of a frame, it's
  * the time of the conceptual “previous frame,” which may be either
- * the actual previous frame time, or if that's too old, an updated
+ * the actual previous frame time, or if that’s too old, an updated
  * time.
  *
  * Since: 3.8
diff --git a/gdk/gdkframetimings.c b/gdk/gdkframetimings.c
index 5f671d0ad5..0245d469d2 100644
--- a/gdk/gdkframetimings.c
+++ b/gdk/gdkframetimings.c
@@ -25,11 +25,11 @@
  * @Title: Frame timings
  *
  * A #GdkFrameTimings object holds timing information for a single frame
- * of the application's displays. To retrieve #GdkFrameTimings objects,
+ * of the application’s displays. To retrieve #GdkFrameTimings objects,
  * use gdk_frame_clock_get_timings() or gdk_frame_clock_get_current_timings().
  * The information in #GdkFrameTimings is useful for precise synchronization
  * of video with the event or audio streams, and for measuring
- * quality metrics for the application's display, such as latency and jitter.
+ * quality metrics for the application’s display, such as latency and jitter.
  */
 
 G_DEFINE_BOXED_TYPE (GdkFrameTimings, gdk_frame_timings,
diff --git a/gdk/gdkkeys.c b/gdk/gdkkeys.c
index e3297dc787..145a2e0629 100644
--- a/gdk/gdkkeys.c
+++ b/gdk/gdkkeys.c
@@ -80,7 +80,7 @@
  * two Hebrew characters. The Hebrew characters will be printed on the key next to
  * the English characters.
  *
- * In order to use a keymap to interpret a key event, it's necessary to first
+ * In order to use a keymap to interpret a key event, it’s necessary to first
  * convert the keyboard state into an effective group and level. This is done via a
  * set of rules that varies widely according to type of keyboard and user
  * configuration. The function gdk_keymap_translate_keyboard_state() accepts a
@@ -649,7 +649,7 @@ gdk_keymap_real_get_modifier_mask (GdkKeymap         *keymap,
  * @keymap: a #GdkKeymap
  * @intent: the use case for the modifier mask
  *
- * Returns the modifier mask the @keymap's windowing system backend
+ * Returns the modifier mask the @keymap’s windowing system backend
  * uses for a particular purpose.
  *
  * Note that this function always returns real hardware modifiers, not
diff --git a/gdk/gdkpango.c b/gdk/gdkpango.c
index 7b5227e107..ba46f2a68b 100644
--- a/gdk/gdkpango.c
+++ b/gdk/gdkpango.c
@@ -200,7 +200,7 @@ layout_iter_get_line_clip_region (PangoLayoutIter *iter,
  * Obtains a clip region which contains the areas where the given
  * ranges of text would be drawn. @x_origin and @y_origin are the top left
  * position of the layout. @index_ranges
- * should contain ranges of bytes in the layout's text. The clip
+ * should contain ranges of bytes in the layout’s text. The clip
  * region will include space to the left or right of the line (to the
  * layout bounding box) if you have indexes above or below the indexes
  * contained inside the line. This is to draw the selection all the way
@@ -249,7 +249,7 @@ gdk_pango_layout_line_get_clip_region (PangoLayoutLine *line,
  * Obtains a clip region which contains the areas where the given ranges
  * of text would be drawn. @x_origin and @y_origin are the top left point
  * to center the layout. @index_ranges should contain
- * ranges of bytes in the layout's text.
+ * ranges of bytes in the layout’s text.
  * 
  * Note that the regions returned correspond to logical extents of the text
  * ranges, not ink extents. So the drawn layout may in fact touch areas out of
@@ -315,7 +315,7 @@ gdk_pango_layout_get_clip_region (PangoLayout *layout,
  * #cairo_font_options_t) for the default screen; if these options
  * change it will not be updated. Using gtk_widget_get_pango_context()
  * is more convenient if you want to keep a context around and track
- * changes to the screen's font rendering settings.
+ * changes to the screen’s font rendering settings.
  *
  * Return value: (transfer full): a new #PangoContext for the default display
  **/
@@ -341,7 +341,7 @@ gdk_pango_context_get (void)
  * (see #cairo_font_options_t) for the screen; if these options
  * change it will not be updated. Using gtk_widget_get_pango_context()
  * is more convenient if you want to keep a context around and track
- * changes to the screen's font rendering settings.
+ * changes to the screen’s font rendering settings.
  * 
  * Return value: (transfer full): a new #PangoContext for @screen
  *
diff --git a/gdk/gdkpixbuf-drawable.c b/gdk/gdkpixbuf-drawable.c
index b6d238e390..2bf954baa7 100644
--- a/gdk/gdkpixbuf-drawable.c
+++ b/gdk/gdkpixbuf-drawable.c
@@ -68,7 +68,7 @@
  * other windows, then the contents of the pixbuf areas corresponding
  * to the obscured regions are undefined.
  *
- * If the window is not mapped (typically because it's iconified/minimized
+ * If the window is not mapped (typically because it’s iconified/minimized
  * or not on the current workspace), then %NULL will be returned.
  *
  * If memory can't be allocated for the return value, %NULL will be returned
diff --git a/gdk/gdkrectangle.c b/gdk/gdkrectangle.c
index c06e719ecf..919c3a2a30 100644
--- a/gdk/gdkrectangle.c
+++ b/gdk/gdkrectangle.c
@@ -33,7 +33,7 @@
  * @Title: Points and Rectangles
  *
  * GDK provides the #GdkPoint and #GdkRectangle data types for representing pixels
- * and sets of pixels on the screen. Together with Cairo's #cairo_region_t data
+ * and sets of pixels on the screen. Together with Cairo’s #cairo_region_t data
  * type, they make up the central types for representing graphical data.
  *
  * A #GdkPoint represents an x and y coordinate of a point.
@@ -86,7 +86,7 @@ gdk_rectangle_union (const GdkRectangle *src1,
  *
  * Calculates the intersection of two rectangles. It is allowed for
  * @dest to be the same as either @src1 or @src2. If the rectangles 
- * do not intersect, @dest's width and height is set to 0 and its x 
+ * do not intersect, @dest’s width and height is set to 0 and its x 
  * and y values are undefined. If you are only interested in whether
  * the rectangles intersect, but not in the intersecting area itself,
  * pass %NULL for @dest.
diff --git a/gdk/gdkrgba.c b/gdk/gdkrgba.c
index f60929f33f..88fcdf81ce 100644
--- a/gdk/gdkrgba.c
+++ b/gdk/gdkrgba.c
@@ -36,7 +36,7 @@
  * @Title: RGBA Colors
  *
  * #GdkRGBA is a convenient way to pass rgba colors around.
- * It's based on cairo's way to deal with colors and mirrors its behavior.
+ * It’s based on cairo’s way to deal with colors and mirrors its behavior.
  * All values are in the range from 0.0 to 1.0 inclusive. So the color
  * (0.0, 0.0, 0.0, 0.0) represents transparent black and
  * (1.0, 1.0, 1.0, 1.0) is opaque white. Other values will be clamped
diff --git a/gdk/gdkscreen.c b/gdk/gdkscreen.c
index 22479a930b..f54dcca37d 100644
--- a/gdk/gdkscreen.c
+++ b/gdk/gdkscreen.c
@@ -394,7 +394,7 @@ gdk_screen_height_mm (void)
  *   previously set default font options.
  *
  * Sets the default font options for the screen. These
- * options will be set on any #PangoContext's newly created
+ * options will be set on any #PangoContext’s newly created
  * with gdk_pango_context_get_for_screen(). Changing the
  * default set of font options does not affect contexts that
  * have already been created.
@@ -865,7 +865,7 @@ gdk_screen_list_visuals (GdkScreen *screen)
  * gdk_screen_get_system_visual:
  * @screen: a #GdkScreen.
  *
- * Get the system's default visual for @screen.
+ * Get the system’s default visual for @screen.
  * This is the visual for the root window of the display.
  * The return value should not be freed.
  *
@@ -889,7 +889,7 @@ gdk_screen_get_system_visual (GdkScreen * screen)
  * The windowing system on which GTK+ is running
  * may not support this capability, in which case %NULL will
  * be returned. Even if a non-%NULL value is returned, its
- * possible that the window's alpha channel won't be honored
+ * possible that the window’s alpha channel won't be honored
  * when displaying the window on the screen: in particular, for
  * X an appropriate windowing manager and compositing manager
  * must be running to provide appropriate display.
@@ -989,7 +989,7 @@ gdk_screen_make_display_name (GdkScreen *screen)
  * gdk_screen_get_active_window:
  * @screen: a #GdkScreen
  *
- * Returns the screen's currently active window.
+ * Returns the screen’s currently active window.
  *
  * On X11, this is done by inspecting the _NET_ACTIVE_WINDOW property
  * on the root window, as described in the
diff --git a/gdk/gdktypes.h b/gdk/gdktypes.h
index ce1c2da801..7b46d242c5 100644
--- a/gdk/gdktypes.h
+++ b/gdk/gdktypes.h
@@ -276,7 +276,7 @@ typedef enum
  * currently used windowing system backend uses for particular
  * purposes. For example, on X11/Windows, the Control key is used for
  * invoking menu shortcuts (accelerators), whereas on Apple computers
- * it's the Command key (which correspond to %GDK_CONTROL_MASK and
+ * it’s the Command key (which correspond to %GDK_CONTROL_MASK and
  * %GDK_MOD2_MASK, respectively).
  *
  * Since: 3.4
diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c
index caea334d7d..89fa04589d 100644
--- a/gdk/gdkvisual.c
+++ b/gdk/gdkvisual.c
@@ -40,7 +40,7 @@
  * may be in the top 8 bits of the pixel, or may be in the lower 4 bits.
  *
  * There are several standard visuals. The visual returned by
- * gdk_screen_get_system_visual() is the system's default visual.
+ * gdk_screen_get_system_visual() is the system’s default visual.
  *
  * A number of functions are provided for determining the “best” available
  * visual. For the purposes of making this determination, higher bit depths
@@ -96,7 +96,7 @@ gdk_list_visuals (void)
 /**
  * gdk_visual_get_system:
  *
- * Get the system's default visual for the default GDK screen.
+ * Get the system’s default visual for the default GDK screen.
  * This is the visual for the root window of the display.
  * The return value should not be freed.
  *
@@ -222,7 +222,7 @@ gdk_visual_get_best_with_both (gint          depth,
  * @count: return location for number of available depths
  *
  * This function returns the available bit depths for the default
- * screen. It's equivalent to listing the visuals
+ * screen. It’s equivalent to listing the visuals
  * (gdk_list_visuals()) and then looking at the depth field in each
  * visual, removing duplicates.
  *
@@ -244,7 +244,7 @@ gdk_query_depths (gint **depths,
  * @count: return location for the number of available visual types
  *
  * This function returns the available visual types for the default
- * screen. It's equivalent to listing the visuals
+ * screen. It’s equivalent to listing the visuals
  * (gdk_list_visuals()) and then looking at the type field in each
  * visual, removing duplicates.
  *
diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index 68414d0961..407695cb4f 100644
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -54,7 +54,7 @@
  * @Title: Windows
  *
  * A #GdkWindow is a (usually) rectangular region on the screen.
- * It's a low-level object, used to implement high-level objects such as
+ * It’s a low-level object, used to implement high-level objects such as
  * #GtkWidget and #GtkWindow on the GTK+ level. A #GtkWindow is a toplevel
  * window, the thing a user might think of as a “window” with a titlebar
  * and so on; a #GtkWindow may contain many #GdkWindows. For example,
@@ -2045,7 +2045,7 @@ _gdk_window_destroy (GdkWindow *window,
  *
  * Destroys the window system resources associated with @window and decrements @window's
  * reference count. The window system resources for all children of @window are also
- * destroyed, but the children's reference counts are not decremented.
+ * destroyed, but the children’s reference counts are not decremented.
  *
  * Note that a window will not be destroyed automatically when its reference count
  * reaches zero. You must call this function yourself before that happens.
@@ -2239,7 +2239,7 @@ gdk_window_has_native (GdkWindow *window)
  * current window position, regardless of which events have been
  * received or processed.
  *
- * The position coordinates are relative to the window's parent window.
+ * The position coordinates are relative to the window’s parent window.
  *
  **/
 void
@@ -2287,7 +2287,7 @@ gdk_window_get_parent (GdkWindow *window)
  *
  * Obtains the parent of @window, as known to GDK. Works like
  * gdk_window_get_parent() for normal windows, but returns the
- * window's embedder for offscreen windows.
+ * window’s embedder for offscreen windows.
  *
  * See also: gdk_offscreen_window_get_embedder()
  *
@@ -2310,14 +2310,14 @@ gdk_window_get_effective_parent (GdkWindow *window)
  * gdk_window_get_toplevel:
  * @window: a #GdkWindow
  *
- * Gets the toplevel window that's an ancestor of @window.
+ * Gets the toplevel window that’s an ancestor of @window.
  *
  * Any window type but %GDK_WINDOW_CHILD is considered a
  * toplevel window, as is a %GDK_WINDOW_CHILD window that
  * has a root window as parent.
  *
  * Note that you should use gdk_window_get_effective_toplevel() when
- * you want to get to a window's toplevel as seen on screen, because
+ * you want to get to a window’s toplevel as seen on screen, because
  * gdk_window_get_toplevel() will most likely not do what you expect
  * if there are offscreen windows in the hierarchy.
  *
@@ -2342,7 +2342,7 @@ gdk_window_get_toplevel (GdkWindow *window)
  * gdk_window_get_effective_toplevel:
  * @window: a #GdkWindow
  *
- * Gets the toplevel window that's an ancestor of @window.
+ * Gets the toplevel window that’s an ancestor of @window.
  *
  * Works like gdk_window_get_toplevel(), but treats an offscreen window's
  * embedder as its parent, using gdk_window_get_effective_parent().
@@ -2373,7 +2373,7 @@ gdk_window_get_effective_toplevel (GdkWindow *window)
  *
  * Gets the list of children of @window known to GDK.
  * This function only returns children created via GDK,
- * so for example it's useless when used with the root window;
+ * so for example it’s useless when used with the root window;
  * it only returns windows an application created itself.
  *
  * The returned list must be freed, but the elements in the
@@ -3710,7 +3710,7 @@ gdk_window_process_updates_with_mode (GdkWindow     *window,
  * Sends one or more expose events to @window. The areas in each
  * expose event will cover the entire update area for the window (see
  * gdk_window_invalidate_region() for details). Normally GDK calls
- * gdk_window_process_all_updates() on your behalf, so there's no
+ * gdk_window_process_all_updates() on your behalf, so there’s no
  * need to call this function unless you want to force expose events
  * to be delivered immediately and synchronously (vs. the usual
  * case, where GDK delivers them in an idle handler). Occasionally
@@ -3956,7 +3956,7 @@ gdk_window_invalidate_maybe_recurse_full (GdkWindow            *window,
  *
  * GDK will call gdk_window_process_all_updates() on your behalf
  * whenever your program returns to the main loop and becomes idle, so
- * normally there's no need to do that manually, you just need to
+ * normally there’s no need to do that manually, you just need to
  * invalidate regions that you know should be redrawn.
  *
  * The @child_func parameter controls whether the region of
@@ -4007,7 +4007,7 @@ gdk_window_invalidate_region_full (GdkWindow       *window,
  *
  * GDK will call gdk_window_process_all_updates() on your behalf
  * whenever your program returns to the main loop and becomes idle, so
- * normally there's no need to do that manually, you just need to
+ * normally there’s no need to do that manually, you just need to
  * invalidate regions that you know should be redrawn.
  *
  * The @invalidate_children parameter controls whether the region of
@@ -4041,7 +4041,7 @@ gdk_window_invalidate_region (GdkWindow       *window,
  *
  * GDK will call gdk_window_process_all_updates() on your behalf
  * whenever your program returns to the main loop and becomes idle, so
- * normally there's no need to do that manually, you just need to
+ * normally there’s no need to do that manually, you just need to
  * invalidate regions that you know should be redrawn.
  *
  * This version of invalidation is used when you recieve expose events
@@ -4068,7 +4068,7 @@ _gdk_window_invalidate_for_expose (GdkWindow       *window,
  * no longer have an invalid/dirty region; the update area is removed
  * from @window and handed to you. If a window has no update area,
  * gdk_window_get_update_area() returns %NULL. You are responsible for
- * calling cairo_region_destroy() on the returned region if it's non-%NULL.
+ * calling cairo_region_destroy() on the returned region if it’s non-%NULL.
  *
  * Return value: the update area for @window
  **/
@@ -4254,7 +4254,7 @@ gdk_window_thaw_toplevel_updates_libgtk_only (GdkWindow *window)
  * if you are redrawing the same region 400 times you may never
  * notice, aside from noticing a speed problem. Enabling update
  * debugging causes GTK to flicker slowly and noticeably, so you can
- * see exactly what's being redrawn when, in what order.
+ * see exactly what’s being redrawn when, in what order.
  *
  * The --gtk-debug=updates command line option passed to GTK+ programs
  * enables this debug option at application startup time. That's
@@ -5058,7 +5058,7 @@ gdk_window_restack (GdkWindow     *window,
  * top of the window stack (moves the window to the front of the
  * Z-order).
  *
- * This function maps a window so it's visible onscreen. Its opposite
+ * This function maps a window so it’s visible onscreen. Its opposite
  * is gdk_window_hide().
  *
  * When implementing a #GtkWidget, you should call this function on the widget's
@@ -5547,8 +5547,8 @@ gdk_window_move_resize_internal (GdkWindow *window,
 /**
  * gdk_window_move:
  * @window: a #GdkWindow
- * @x: X coordinate relative to window's parent
- * @y: Y coordinate relative to window's parent
+ * @x: X coordinate relative to window’s parent
+ * @y: Y coordinate relative to window’s parent
  *
  * Repositions a window relative to its parent window.
  * For toplevel windows, window managers may ignore or modify the move;
@@ -5594,8 +5594,8 @@ gdk_window_resize (GdkWindow *window,
 /**
  * gdk_window_move_resize:
  * @window: a #GdkWindow
- * @x: new X position relative to window's parent
- * @y: new Y position relative to window's parent
+ * @x: new X position relative to window’s parent
+ * @y: new Y position relative to window’s parent
  * @width: new width
  * @height: new height
  *
@@ -5628,7 +5628,7 @@ gdk_window_move_resize (GdkWindow *window,
  * strictly be necessary.
  *
  * For X11, a minimum area will be invalidated if the window has no
- * subwindows, or if the edges of the window's parent do not extend
+ * subwindows, or if the edges of the window’s parent do not extend
  * beyond the edges of the window. In other cases, a multi-step process
  * is used to scroll the window which may produce temporary visual
  * artifacts and unnecessary invalidations.
@@ -5815,7 +5815,7 @@ gdk_window_set_background_pattern (GdkWindow *window,
  * returned and you'll have to query it yourself.
  *
  * Returns: (transfer none): The pattern to use for the background or
- *     %NULL to use the parent's background.
+ *     %NULL to use the parent’s background.
  *
  * Since: 2.22
  **/
@@ -6200,12 +6200,12 @@ gdk_window_get_root_coords (GdkWindow *window,
 /**
  * gdk_window_coords_to_parent:
  * @window: a child window
- * @x: X coordinate in child's coordinate system
- * @y: Y coordinate in child's coordinate system
+ * @x: X coordinate in child’s coordinate system
+ * @y: Y coordinate in child’s coordinate system
  * @parent_x: (out) (allow-none): return location for X coordinate
- * in parent's coordinate system, or %NULL
+ * in parent’s coordinate system, or %NULL
  * @parent_y: (out) (allow-none): return location for Y coordinate
- * in parent's coordinate system, or %NULL
+ * in parent’s coordinate system, or %NULL
  *
  * Transforms window coordinates from a child window to its parent
  * window, where the parent window is the normal parent as returned by
@@ -6260,10 +6260,10 @@ gdk_window_coords_to_parent (GdkWindow *window,
 /**
  * gdk_window_coords_from_parent:
  * @window: a child window
- * @parent_x: X coordinate in parent's coordinate system
- * @parent_y: Y coordinate in parent's coordinate system
- * @x: (out) (allow-none): return location for X coordinate in child's coordinate system
- * @y: (out) (allow-none): return location for Y coordinate in child's coordinate system
+ * @parent_x: X coordinate in parent’s coordinate system
+ * @parent_y: Y coordinate in parent’s coordinate system
+ * @x: (out) (allow-none): return location for X coordinate in child’s coordinate system
+ * @y: (out) (allow-none): return location for Y coordinate in child’s coordinate system
  *
  * Transforms window coordinates from a parent window to a child
  * window, where the parent window is the normal parent as returned by
@@ -6453,7 +6453,7 @@ gdk_window_set_child_shapes (GdkWindow *window)
  * for @window. See gdk_window_shape_combine_region().
  *
  * This function is distinct from gdk_window_set_child_shapes()
- * because it includes @window's shape mask in the set of shapes to
+ * because it includes @window’s shape mask in the set of shapes to
  * be merged.
  */
 void
@@ -6579,7 +6579,7 @@ gdk_window_set_child_input_shapes (GdkWindow *window)
  * for @window. See gdk_window_input_shape_combine_region().
  *
  * This function is distinct from gdk_window_set_child_input_shapes()
- * because it includes @window's input shape mask in the set of
+ * because it includes @window’s input shape mask in the set of
  * shapes to be merged.
  *
  * Since: 2.10
@@ -6651,7 +6651,7 @@ gdk_window_get_composited (GdkWindow *window)
  * windows do not automatically have their contents drawn to
  * the screen. Drawing is redirected to an offscreen buffer
  * and an expose event is emitted on the parent of the composited
- * window. It is the responsibility of the parent's expose handler
+ * window. It is the responsibility of the parent’s expose handler
  * to manually merge the off-screen content onto the screen in
  * whatever way it sees fit.
  *
@@ -9449,7 +9449,7 @@ gdk_window_set_modal_hint (GdkWindow *window,
  * @skips_taskbar: %TRUE to skip the taskbar
  *
  * Toggles whether a window should appear in a task list or window
- * list. If a window's semantic type as specified with
+ * list. If a window’s semantic type as specified with
  * gdk_window_set_type_hint() already fully describes the window, this
  * function should not be called in addition,
  * instead you should allow the window to be treated according to
@@ -9472,7 +9472,7 @@ gdk_window_set_skip_taskbar_hint (GdkWindow *window,
  * Toggles whether a window should appear in a pager (workspace
  * switcher, or other desktop utility program that displays a small
  * thumbnail representation of the windows on the desktop). If a
- * window's semantic type as specified with gdk_window_set_type_hint()
+ * window’s semantic type as specified with gdk_window_set_type_hint()
  * already fully describes the window, this function should
  * not be called in addition, instead you should
  * allow the window to be treated according to standard policy for
@@ -9567,7 +9567,7 @@ gdk_window_set_title (GdkWindow   *window,
  * When using GTK+, typically you should use gtk_window_set_role() instead
  * of this low-level function.
  *
- * The window manager and session manager use a window's role to
+ * The window manager and session manager use a window’s role to
  * distinguish it from other kinds of window in the same application.
  * When an application is restarted after being saved in a previous
  * session, all windows with the same title and role are treated as
@@ -9850,7 +9850,7 @@ gdk_window_deiconify (GdkWindow *window)
  * gdk_window_stick:
  * @window: a toplevel #GdkWindow
  *
- * “Pins” a window such that it's on all workspaces and does not scroll
+ * “Pins” a window such that it’s on all workspaces and does not scroll
  * with viewports, for window managers that have scrollable viewports.
  * (When using #GtkWindow, gtk_window_stick() may be more useful.)
  *
@@ -9858,7 +9858,7 @@ gdk_window_deiconify (GdkWindow *window)
  * support, so may have no effect with many window managers. However,
  * GDK will do the best it can to convince the window manager to stick
  * the window. For window managers that don't support this operation,
- * there's nothing you can do to force it to happen.
+ * there’s nothing you can do to force it to happen.
  *
  **/
 void
diff --git a/gdk/gdkwindow.h b/gdk/gdkwindow.h
index b3287d7c59..95bdca52d9 100644
--- a/gdk/gdkwindow.h
+++ b/gdk/gdkwindow.h
@@ -122,9 +122,9 @@ typedef enum
  * @GDK_HINT_ASPECT: aspect ratio fields are set
  * @GDK_HINT_RESIZE_INC: resize increment fields are set
  * @GDK_HINT_WIN_GRAVITY: window gravity field is set
- * @GDK_HINT_USER_POS: indicates that the window's position was explicitly set
+ * @GDK_HINT_USER_POS: indicates that the window’s position was explicitly set
  *  by the user
- * @GDK_HINT_USER_SIZE: indicates that the window's size was explicitly set by
+ * @GDK_HINT_USER_SIZE: indicates that the window’s size was explicitly set by
  *  the user
  *
  * Used to indicate which fields of a #GdkGeometry struct should be paid
@@ -389,7 +389,7 @@ struct _GdkWindowAttr
  * @win_gravity: window gravity, see gtk_window_set_gravity()
  *
  * The #GdkGeometry struct gives the window manager information about
- * a window's geometry constraints. Normally you would set these on
+ * a window’s geometry constraints. Normally you would set these on
  * the GTK+ level using gtk_window_set_geometry_hints(). #GtkWindow
  * then sets the hints on the #GdkWindow it creates.
  *
@@ -416,7 +416,7 @@ struct _GdkWindowAttr
  * terminal will have a 1x1 character terminal area, and only terminal sizes on
  * the “character grid” will be allowed.
  *
- * Here's an example of how the terminal example would be implemented, assuming
+ * Here’s an example of how the terminal example would be implemented, assuming
  * a terminal area widget called “terminal” and a toplevel window “toplevel”:
  *
  * |[<!-- language="C" -->
@@ -631,7 +631,7 @@ void gdk_window_set_composited   (GdkWindow *window,
 
 /*
  * This routine allows you to merge (ie ADD) child shapes to your
- * own window's shape keeping its current shape and ADDING the child
+ * own window’s shape keeping its current shape and ADDING the child
  * shapes to it.
  * 
  * - Raster
diff --git a/gdk/quartz/gdkeventloop-quartz.c b/gdk/quartz/gdkeventloop-quartz.c
index bc1ecbb3d8..33f935a81f 100644
--- a/gdk/quartz/gdkeventloop-quartz.c
+++ b/gdk/quartz/gdkeventloop-quartz.c
@@ -32,7 +32,7 @@
  * stages of the GLib main loop (prepare, check, dispatch), and make the
  * appropriate calls into GLib.
  *
- * Both cases share a single problem: the OS X API's don't allow us to
+ * Both cases share a single problem: the OS X API’s don't allow us to
  * wait simultaneously for file descriptors and for events. So when we
  * need to do a blocking wait that includes file descriptor activity, we
  * push the actual work of calling select() to a helper thread (the
@@ -102,7 +102,7 @@ static GQueue *current_events;
 
 /* The default poll function for GLib; we replace this with our own
  * Cocoa-aware version and then call the old version to do actual
- * file descriptor polling. There's no actual need to chain to the
+ * file descriptor polling. There’s no actual need to chain to the
  * old one; we could reimplement the same functionality from scratch,
  * but since the default implementation does the right thing, why
  * bother.
diff --git a/gdk/quartz/gdkwindow-quartz.c b/gdk/quartz/gdkwindow-quartz.c
index f3d168bc23..fe798e5b2a 100644
--- a/gdk/quartz/gdkwindow-quartz.c
+++ b/gdk/quartz/gdkwindow-quartz.c
@@ -253,7 +253,7 @@ gdk_window_impl_quartz_finalize (GObject *object)
  * a view) too often. We do this by limiting the manual flushing done
  * outside of expose calls to less than some frequency when measured over
  * the last 4 flushes. This is a bit arbitray, but seems to make it possible
- * for some quick manual flushes (such as gtkruler or gimp's marching ants)
+ * for some quick manual flushes (such as gtkruler or gimp’s marching ants)
  * without hitting the max flush frequency.
  *
  * If drawable NULL, no flushing is done, only registering that a flush was
@@ -1509,7 +1509,7 @@ gdk_window_quartz_reparent (GdkWindow *window,
 }
 
 /* Get the toplevel ordering from NSApp and update our own list. We do
- * this on demand since the NSApp's list is not up to date directly
+ * this on demand since the NSApp’s list is not up to date directly
  * after we get windowDidBecomeMain.
  */
 static void
diff --git a/gdk/win32/gdkdnd-win32.c b/gdk/win32/gdkdnd-win32.c
index 6b350592a9..d74e74c9a0 100644
--- a/gdk/win32/gdkdnd-win32.c
+++ b/gdk/win32/gdkdnd-win32.c
@@ -48,7 +48,7 @@
  *
  * As such, the data type conversion from gdk selection targets to OLE2 CF_* data
  * type specifiers is partially hardwired. Fixing this is complicated by (a) the
- * fact that the widget's declared selection types aren't accessible in calls here
+ * fact that the widget’s declared selection types aren't accessible in calls here
  * that need to declare the corresponding OLE2 data types, and (b) there isn't a
  * 1-1 correspondence between gdk target types and OLE2 types. The former needs
  * some redesign in gtk dnd (something a gdk/gtk expert should do; I have tried
@@ -375,7 +375,7 @@ get_suggested_action (DWORD grfKeyState)
 }
 
 /* Process pending events -- we don't want to service non-GUI events
- * forever so do one iteration and then do more only if there's a
+ * forever so do one iteration and then do more only if there’s a
  * pending GDK event.
  */
 static void
diff --git a/gdk/win32/gdkevents-win32.c b/gdk/win32/gdkevents-win32.c
index 6106318bfd..9757da8ea8 100644
--- a/gdk/win32/gdkevents-win32.c
+++ b/gdk/win32/gdkevents-win32.c
@@ -1009,13 +1009,13 @@ apply_event_filters (GdkWindow  *window,
  * On Windows, transient windows will not have their own taskbar entries.
  * Because of this, we must hide and restore groups of transients in both
  * directions.  That is, all transient children must be hidden or restored
- * with this window, but if this window's transient owner also has a
- * transient owner then this window's transient owner must be hidden/restored
+ * with this window, but if this window’s transient owner also has a
+ * transient owner then this window’s transient owner must be hidden/restored
  * with this one.  And etc, up the chain until we hit an ancestor that has no
  * transient owner.
  *
  * It would be a good idea if applications don't chain transient windows
- * together.  There's a limit to how much evil GTK can try to shield you
+ * together.  There’s a limit to how much evil GTK can try to shield you
  * from.
  */
 static void
diff --git a/gdk/win32/gdkmain-win32.c b/gdk/win32/gdkmain-win32.c
index 81b7455487..459b0f5b61 100644
--- a/gdk/win32/gdkmain-win32.c
+++ b/gdk/win32/gdkmain-win32.c
@@ -158,7 +158,7 @@ _gdk_other_api_failed (const gchar *where,
  * have to be g_free()d. The buffer is of bounded size and reused
  * cyclically. Thus the return value is valid only until that part of
  * the buffer happens to get reused. This doesn't matter as this
- * function's return value is used in debugging output right after the call,
+ * function’s return value is used in debugging output right after the call,
  * and the return value isn't used after that.
  */
 static gchar *
diff --git a/gdk/x11/gdkcursor-x11.c b/gdk/x11/gdkcursor-x11.c
index 3a6534fcef..b12a80d10f 100644
--- a/gdk/x11/gdkcursor-x11.c
+++ b/gdk/x11/gdkcursor-x11.c
@@ -64,7 +64,7 @@ static guint theme_serial = 0;
 /* cursor_cache holds a cache of non-pixmap cursors to avoid expensive 
  * libXcursor searches, cursors are added to it but only removed when
  * their display is closed. We make the assumption that since there are 
- * a small number of display's and a small number of cursor's that this 
+ * a small number of display’s and a small number of cursor’s that this 
  * list will stay small enough not to be a problem.
  */
 static GSList* cursor_cache = NULL;
diff --git a/gdk/x11/gdkdisplay-x11.c b/gdk/x11/gdkdisplay-x11.c
index 5a157a5648..cd2215a944 100644
--- a/gdk/x11/gdkdisplay-x11.c
+++ b/gdk/x11/gdkdisplay-x11.c
@@ -1981,9 +1981,9 @@ gdk_x11_lookup_xdisplay (Display *xdisplay)
 /**
  * _gdk_x11_display_screen_for_xrootwin:
  * @display: a #GdkDisplay
- * @xrootwin: window ID for one of of the screen's of the display.
+ * @xrootwin: window ID for one of of the screen’s of the display.
  * 
- * Given the root window ID of one of the screen's of a #GdkDisplay,
+ * Given the root window ID of one of the screen’s of a #GdkDisplay,
  * finds the screen.
  * 
  * Return value: (transfer none): the #GdkScreen corresponding to
@@ -2473,7 +2473,7 @@ gdk_x11_register_standard_event_type (GdkDisplay *display,
 }
 
 /* look up the extension name for a given major opcode.  grubs around in
- * xlib to do it since a) it's already cached there b) XQueryExtension
+ * xlib to do it since a) it’s already cached there b) XQueryExtension
  * emits protocol so we can't use it in an error handler.
  */
 static const char *
@@ -2788,8 +2788,8 @@ gdk_x11_display_error_trap_pop_ignored (GdkDisplay *display)
  * @sm_client_id: the client id assigned by the session manager when the
  *    connection was opened, or %NULL to remove the property.
  *
- * Sets the `SM_CLIENT_ID` property on the application's leader window so that
- * the window manager can save the application's state using the X11R6 ICCCM
+ * Sets the `SM_CLIENT_ID` property on the application’s leader window so that
+ * the window manager can save the application’s state using the X11R6 ICCCM
  * session management protocol.
  *
  * See the X Session Management Library documentation for more information on
diff --git a/gdk/x11/gdkkeys-x11.c b/gdk/x11/gdkkeys-x11.c
index 2af3898f08..5d0c86e337 100644
--- a/gdk/x11/gdkkeys-x11.c
+++ b/gdk/x11/gdkkeys-x11.c
@@ -1042,7 +1042,7 @@ gdk_x11_keymap_lookup_key (GdkKeymap          *keymap,
  *  - add the group and level return.
  *  - change the interpretation of mods_rtrn as described
  *    in the docs for gdk_keymap_translate_keyboard_state()
- * It's unchanged for ease of diff against the Xlib sources; don't
+ * It’s unchanged for ease of diff against the Xlib sources; don't
  * reformat it.
  */
 static Bool
@@ -1444,7 +1444,7 @@ gdk_x11_keymap_add_virtual_modifiers (GdkKeymap       *keymap,
  * @keycode: the hardware keycode from a key event
  *
  * Determines whether a particular key code represents a key that
- * is a modifier. That is, it's a key that normally just affects
+ * is a modifier. That is, it’s a key that normally just affects
  * the keyboard state and the behavior of other keys rather than
  * producing a direct effect itself. This is only needed for code
  * processing raw X events, since #GdkEventKey directly includes
diff --git a/gdk/x11/gdkproperty-x11.c b/gdk/x11/gdkproperty-x11.c
index 70d29ef3e4..33a48b13f4 100644
--- a/gdk/x11/gdkproperty-x11.c
+++ b/gdk/x11/gdkproperty-x11.c
@@ -383,11 +383,11 @@ _gdk_x11_get_xatom_for_display_printf (GdkDisplay    *display,
  * gdk_x11_get_xatom_by_name:
  * @atom_name: a string
  * 
- * Returns the X atom for GDK's default display corresponding to @atom_name.
+ * Returns the X atom for GDK’s default display corresponding to @atom_name.
  * This function caches the result, so if called repeatedly it is much
  * faster than XInternAtom(), which is a round trip to the server each time.
  * 
- * Return value: a X atom for GDK's default display.
+ * Return value: a X atom for GDK’s default display.
  **/
 Atom
 gdk_x11_get_xatom_by_name (const gchar *atom_name)
@@ -422,9 +422,9 @@ gdk_x11_get_xatom_name_for_display (GdkDisplay *display,
 
 /**
  * gdk_x11_get_xatom_name:
- * @xatom: an X atom for GDK's default display
+ * @xatom: an X atom for GDK’s default display
  * 
- * Returns the name of an X atom for GDK's default display. This
+ * Returns the name of an X atom for GDK’s default display. This
  * function is meant mainly for debugging, so for convenience, unlike
  * XAtomName() and gdk_atom_name(), the result 
  * doesn't need to be freed. Also, this function will never return %NULL, 
diff --git a/gdk/x11/gdkwindow-x11.c b/gdk/x11/gdkwindow-x11.c
index 788b57eac9..09ddb430be 100644
--- a/gdk/x11/gdkwindow-x11.c
+++ b/gdk/x11/gdkwindow-x11.c
@@ -5521,7 +5521,7 @@ gdk_x11_get_server_time (GdkWindow *window)
  * 
  * Returns the X resource (window) belonging to a #GdkWindow.
  * 
- * Return value: the ID of @drawable's X resource.
+ * Return value: the ID of @drawable’s X resource.
  **/
 XID
 gdk_x11_window_get_xid (GdkWindow *window)