Use proper quotes in gdk

gdk/gdk.c

@@ -468,7 +468,7 @@ gdk_init (int *argc, char ***argv)
  * locked for performance reasons. So e.g. you must coordinate
  * accesses to the same #GHashTable from multiple threads.
  *
- * GTK+ is "thread aware" but not thread safe — it provides a
+ * GTK+ is “thread aware” but not thread safe — it provides a
  * global lock controlled by gdk_threads_enter()/gdk_threads_leave()
  * which protects all use of GTK+. That is, only one thread can use GTK+
  * at any given time.

gdk/gdkcursor.c

@@ -297,7 +297,7 @@ gdk_cursor_new_from_name (GdkDisplay  *display,
  * cursor sizes.
  *
  * If @x or @y are `-1`, the pixbuf must have
- * options named "x_hot" and "y_hot", resp., containing
+ * options named “x_hot” and “y_hot”, resp., containing
  * integer values between `0` and the width resp. height of
  * the pixbuf. (Since: 3.0)
  *

gdk/gdkdevice.h

@@ -41,7 +41,7 @@ typedef struct _GdkTimeCoord GdkTimeCoord;
  * @GDK_SOURCE_PEN: the device is a stylus of a graphics tablet or similar device.
  * @GDK_SOURCE_ERASER: the device is an eraser. Typically, this would be the other end
  *                     of a stylus on a graphics tablet.
- * @GDK_SOURCE_CURSOR: the device is a graphics tablet "puck" or similar device.
+ * @GDK_SOURCE_CURSOR: the device is a graphics tablet “puck” or similar device.
  * @GDK_SOURCE_KEYBOARD: the device is a keyboard.
  * @GDK_SOURCE_TOUCHSCREEN: the device is a direct-input touch device, such
  *     as a touchscreen or tablet. This device type has been added in 3.4.

gdk/gdkdevicemanager.c

@@ -75,7 +75,7 @@
  *
  * There may be several virtual devices, and several physical devices could
  * be controlling each of these virtual devices. Physical devices may also
- * be "floating", which means they are not attached to any virtual device.
+ * be “floating”, which means they are not attached to any virtual device.
  *
  * # Master and slave devices
  *

gdk/gdkdisplaymanager.c

@@ -41,7 +41,7 @@
 /* When the gdk_quartz_display_open function is removed We can
  * immediately include gdkquartzdisplaymanager.h here instead of
  * gdkprivate-quartz.h so that we won't have to enable -xobjective-c
- * for the "generic" GDK source code.
+ * for the “generic” GDK source code.
  * #include "quartz/gdkquartzdisplaymanager.h"
  */
 #include "quartz/gdkprivate-quartz.h"

gdk/gdkevents.c

@@ -911,7 +911,7 @@ gdk_event_get_time (const GdkEvent *event)
  * @event: a #GdkEvent or NULL
  * @state: (out): return location for state
  * 
- * If the event contains a "state" field, puts that field in @state. Otherwise
+ * 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
  * as if the event had no state field.
@@ -1506,7 +1506,7 @@ gdk_event_set_device (GdkEvent  *event,
  * gdk_event_get_device:
  * @event: a #GdkEvent.
  *
- * If the event contains a "device" field, this function will return
+ * If the event contains a “device” field, this function will return
  * it, else it will return %NULL.
  *
  * Returns: (transfer none): a #GdkDevice, or %NULL.

gdk/gdkevents.h

@@ -533,7 +533,7 @@ struct _GdkEventAny
  * @area: bounding box of @region.
  * @region: the region that needs to be redrawn.
  * @count: the number of contiguous %GDK_EXPOSE events following this one.
- *   The only use for this is "exposure compression", i.e. handling all
+ *   The only use for this is “exposure compression”, i.e. handling all
  *   contiguous %GDK_EXPOSE events in one go, though GDK performs some
  *   exposure compression so this is not normally needed.
  *

gdk/gdkframeclock.c

@@ -60,7 +60,7 @@
  * as g_get_monotonic_time(). The frame time does not advance during
  * the time a frame is being painted, and outside of a frame, an attempt
  * is made so that all calls to gdk_frame_clock_get_frame_time() that
- * are called at a "similar" time get the same value. This means that
+ * are called at a “similar” time get the same value. This means that
  * if different animations are timed by looking at the difference in
  * time between an initial value from gdk_frame_clock_get_frame_time()
  * and the value inside the #GdkFrameClock::update signal of the clock,
@@ -254,7 +254,7 @@ gdk_frame_clock_init (GdkFrameClock *clock)
  * Gets the time that should currently be used for animations.  Inside
  * 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 time of the conceptual “previous frame,” which may be either
  * the actual previous frame time, or if that's too old, an updated
  * time.
  *

gdk/gdkframetimings.c

@@ -203,7 +203,7 @@ gdk_frame_timings_get_predicted_presentation_time (GdkFrameTimings *timings)
  *
  * Gets the natural interval between presentation times for
  * the display that this frame was displayed on. Frame presentation
- * usually happens during the "vertical blanking interval".
+ * usually happens during the “vertical blanking interval”.
  *
  * Returns: the refresh interval of the display, in microseconds,
  *  or 0 if the refresh interval is not available.

gdk/gdkkeys.c

@@ -68,8 +68,8 @@
  * this is an identifying number for a physical key. Second, it contains the
  * “level” of the key. The level indicates which symbol on the
  * key will be used, in a vertical direction. So on a standard US keyboard, the key
- * with the number "1" on it also has the exclamation point ("!") character on
+ * with the number “1“ on it also has the exclamation point (”!”) character on
- * it. The level indicates whether to use the "1" or the "!" symbol.  The letter
+ * it. The level indicates whether to use the “1” or the “!” symbol.  The letter
  * keys are considered to have a lowercase letter at level 0, and an uppercase
  * letter at level 1, though only the uppercase letter is printed.  Third, the
  * #GdkKeymapKey contains a group; groups are not used on standard US keyboards,
@@ -87,7 +87,7 @@
  * keyboard state -- consisting of hardware keycode pressed, active modifiers, and
  * active group -- applies the appropriate rules, and returns the group/level to be
  * used to index the keymap, along with the modifiers which did not affect the
- * group and level. i.e. it returns "unconsumed modifiers." The keyboard group may
+ * group and level. i.e. it returns “unconsumed modifiers.” The keyboard group may
  * differ from the effective group used for keymap lookups because some keys don't
  * have multiple groups - e.g. the Enter key is always in group 0 regardless of
  * keyboard state.
@@ -682,7 +682,7 @@ gdk_keymap_get_modifier_mask (GdkKeymap         *keymap,
  *
  * The names are the same as those in the
  * `gdk/gdkkeysyms.h` header file
- * but without the leading "GDK_KEY_".
+ * but without the leading “GDK_KEY_”.
  *
  * Return value: (transfer none): a string containing the name of the key,
  *     or %NULL if @keyval is not a valid key. The string should not be
@@ -702,7 +702,7 @@ gdk_keyval_name (guint keyval)
  *
  * The names are the same as those in the
  * `gdk/gdkkeysyms.h` header file
- * but without the leading "GDK_KEY_".
+ * but without the leading “GDK_KEY_”.
  *
  * Returns: the corresponding key value, or %GDK_KEY_VoidSymbol
  *     if the key name is not a valid key

gdk/gdkkeys.h

@@ -46,9 +46,9 @@ typedef struct _GdkKeymapKey GdkKeymapKey;
  *   characters, and in group 1 it might have two Hebrew characters. The Hebrew
  *   characters will be printed on the key next to the English characters.
  * @level: indicates which symbol on the key will be used, in a vertical direction.
- *   So on a standard US keyboard, the key with the number "1" on it also has the
+ *   So on a standard US keyboard, the key with the number “1” on it also has the
  *   exclamation point ("!") character on it. The level indicates whether to use
- *   the "1" or the "!" symbol. The letter keys are considered to have a lowercase
+ *   the “1” or the “!” symbol. The letter keys are considered to have a lowercase
  *   letter at level 0, and an uppercase letter at level 1, though only the
  *   uppercase letter is printed.
  *

gdk/gdkscreen.c

@@ -443,7 +443,7 @@ gdk_screen_get_font_options (GdkScreen *screen)
 /**
  * gdk_screen_set_resolution:
  * @screen: a #GdkScreen
- * @dpi: the resolution in "dots per inch". (Physical inches aren't actually
+ * @dpi: the resolution in “dots per inch”. (Physical inches aren't actually
  *   involved; the terminology is conventional.)
  
  * Sets the resolution for font handling on the screen. This is a
@@ -814,7 +814,7 @@ gdk_screen_get_monitor_geometry (GdkScreen    *screen,
  *     the monitor workarea
  *
  * Retrieves the #GdkRectangle representing the size and position of
- * the "work area" on a monitor within the entire screen area.
+ * the “work area” on a monitor within the entire screen area.
  *
  * The work area should be considered when positioning menus and
  * similar popups, to avoid placing them below panels, docks or other

gdk/gdkvisual.c

@@ -36,13 +36,13 @@
  * the way the bits are stored in memory. For example, a piece of display
  * hardware might support 24-bit color, 16-bit color, or 8-bit color;
  * meaning 24/16/8-bit pixel sizes. For a given pixel size, pixels can
- * be in different formats; for example the "red" element of an RGB pixel
+ * be in different formats; for example the “red” element of an RGB pixel
  * 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.
  *
- * A number of functions are provided for determining the "best" available
+ * A number of functions are provided for determining the “best” available
  * visual. For the purposes of making this determination, higher bit depths
  * are considered better, and for visuals of the same bit depth,
  * %GDK_VISUAL_PSEUDO_COLOR is preferred at 8bpp, otherwise, the visual
@@ -111,8 +111,8 @@ gdk_visual_get_system (void)
 /**
  * gdk_visual_get_best_depth:
  *
- * Get the best available depth for the default GDK screen.  "Best"
+ * Get the best available depth for the default GDK screen.  “Best”
- * means "largest," i.e. 32 preferred over 24 preferred over 8 bits
+ * means “largest,” i.e. 32 preferred over 24 preferred over 8 bits
  * per pixel.
  *
  * Return value: best available depth
@@ -357,8 +357,8 @@ gdk_visual_get_bits_per_rgb (GdkVisual *visual)
  * @precision: (out) (allow-none): A pointer to a #gint to be filled in, or %NULL
  *
  * Obtains values that are needed to calculate red pixel values in TrueColor
- * and DirectColor. The "mask" is the significant bits within the pixel.
+ * and DirectColor. The “mask” is the significant bits within the pixel.
- * The "shift" is the number of bits left we must shift a primary for it
+ * The “shift” is the number of bits left we must shift a primary for it
  * to be in position (according to the "mask"). Finally, "precision" refers
  * to how much precision the pixel value contains for a particular primary.
  *
@@ -390,8 +390,8 @@ gdk_visual_get_red_pixel_details (GdkVisual *visual,
  * @precision: (out) (allow-none): A pointer to a #gint to be filled in, or %NULL
  *
  * Obtains values that are needed to calculate green pixel values in TrueColor
- * and DirectColor. The "mask" is the significant bits within the pixel.
+ * and DirectColor. The “mask” is the significant bits within the pixel.
- * The "shift" is the number of bits left we must shift a primary for it
+ * The “shift” is the number of bits left we must shift a primary for it
  * to be in position (according to the "mask"). Finally, "precision" refers
  * to how much precision the pixel value contains for a particular primary.
  *
@@ -423,8 +423,8 @@ gdk_visual_get_green_pixel_details (GdkVisual *visual,
  * @precision: (out) (allow-none): A pointer to a #gint to be filled in, or %NULL
  *
  * Obtains values that are needed to calculate blue pixel values in TrueColor
- * and DirectColor. The "mask" is the significant bits within the pixel.
+ * and DirectColor. The “mask” is the significant bits within the pixel.
- * The "shift" is the number of bits left we must shift a primary for it
+ * The “shift” is the number of bits left we must shift a primary for it
  * to be in position (according to the "mask"). Finally, "precision" refers
  * to how much precision the pixel value contains for a particular primary.
  *

gdk/gdkwindow.c

@@ -56,7 +56,7 @@
  * A #GdkWindow is a (usually) rectangular region on the screen.
  * 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
+ * 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,
  * each #GtkButton has a #GdkWindow associated with it.
  *
@@ -93,15 +93,15 @@
  * be it a toplevel window or a child window. In this setup the
  * GdkWindow (and other GdkDrawables) were platform independent classes,
  * and the actual platform specific implementation was in a delegate
- * object available as "impl" in the window object.
+ * object available as “impl” in the window object.
  *
  * With the addition of client side windows and offscreen windows this
  * changes a bit. The application-visible GdkWindow object behaves as
  * it did before, but not all such windows now have a corresponding native
- * window. Instead windows that are "client side" are emulated by the gdk
+ * window. Instead windows that are “client side” are emulated by the gdk
  * code such that clipping, drawing, moving, events etc work as expected.
  *
- * For GdkWindows that have a native window the "impl" object is the
+ * For GdkWindows that have a native window the “impl” object is the
  * same as before. However, for all client side windows the impl object
  * is shared with its parent (i.e. all client windows descendants of one
  * native window has the same impl.
@@ -112,8 +112,8 @@
  * windows). Such windows work by allocating a #cairo_surface_t as the backing
  * store for drawing operations, which is resized with the window.
  *
- * GdkWindows have a pointer to the "impl window" they are in, i.e.
+ * GdkWindows have a pointer to the “impl window” they are in, i.e.
- * the topmost GdkWindow which have the same "impl" value. This is stored
+ * the topmost GdkWindow which have the same “impl” value. This is stored
  * in impl_window, which is different from the window itself only for client
  * side windows.
  * All GdkWindows (native or not) track the position of the window in the parent
@@ -1052,7 +1052,7 @@ _gdk_window_update_size (GdkWindow *window)
 }
 
 /* Find the native window that would be just above "child"
- * in the native stacking order if "child" was a native window
+ * in the native stacking order if “child” was a native window
  * (it doesn't have to be native). If there is no such native
  * window inside this native parent then NULL is returned.
  * If child is NULL, find lowest native window in parent.
@@ -3948,7 +3948,7 @@ gdk_window_invalidate_maybe_recurse_full (GdkWindow            *window,
  * @user_data: data passed to @child_func
  *
  * Adds @region to the update area for @window. The update area is the
- * region that needs to be redrawn, or "dirty region." The call
+ * region that needs to be redrawn, or “dirty region.” The call
  * gdk_window_process_updates() sends one or more expose events to the
  * window, which together cover the entire update area. An
  * application would normally redraw the contents of @window in
@@ -3999,7 +3999,7 @@ gdk_window_invalidate_region_full (GdkWindow       *window,
  * @invalidate_children: %TRUE to also invalidate child windows
  *
  * Adds @region to the update area for @window. The update area is the
- * region that needs to be redrawn, or "dirty region." The call
+ * region that needs to be redrawn, or “dirty region.” The call
  * gdk_window_process_updates() sends one or more expose events to the
  * window, which together cover the entire update area. An
  * application would normally redraw the contents of @window in
@@ -4033,7 +4033,7 @@ gdk_window_invalidate_region (GdkWindow       *window,
  * @region: a #cairo_region_t
  *
  * Adds @region to the update area for @window. The update area is the
- * region that needs to be redrawn, or "dirty region." The call
+ * region that needs to be redrawn, or “dirty region.” The call
  * gdk_window_process_updates() sends one or more expose events to the
  * window, which together cover the entire update area. An
  * application would normally redraw the contents of @window in
@@ -5062,7 +5062,7 @@ gdk_window_restack (GdkWindow     *window,
  * is gdk_window_hide().
  *
  * When implementing a #GtkWidget, you should call this function on the widget's
- * #GdkWindow as part of the "map" method.
+ * #GdkWindow as part of the “map” method.
  */
 void
 gdk_window_show (GdkWindow *window)
@@ -6480,7 +6480,7 @@ gdk_window_merge_child_shapes (GdkWindow *window)
  * The alpha channel of the window defines which pixels are
  * invisible and allows for nicely antialiased borders,
  * and the input shape controls where the window is
- * "clickable".
+ * “clickable”.
  *
  * On the X11 platform, this requires version 1.1 of the
  * shape extension.
@@ -9245,7 +9245,7 @@ _gdk_windowing_got_event (GdkDisplay *display,
  * with it.
  *
  * This function always returns a valid pointer, but it will return a
- * pointer to a "nil" surface if @other is already in an error state
+ * pointer to a “nil” surface if @other is already in an error state
  * or any other error occurs.
  *
  * Since: 2.22
@@ -9320,7 +9320,7 @@ gdk_window_create_similar_surface (GdkWindow *     window,
  * with it.
  *
  * This function always returns a valid pointer, but it will return a
- * pointer to a "nil" surface if @other is already in an error state
+ * pointer to a “nil” surface if @other is already in an error state
  * or any other error occurs.
  *
  * Since: 3.10
@@ -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.)
  *
@@ -9891,7 +9891,7 @@ gdk_window_unstick (GdkWindow *window)
  * On X11, asks the window manager to maximize @window, if the window
  * manager supports this operation. Not all window managers support
  * this, and some deliberately ignore it or don't have a concept of
- * "maximized"; so you can't rely on the maximization actually
+ * “maximized”; so you can't rely on the maximization actually
  * happening. But it will happen with most standard window managers,
  * and GDK makes a best effort to get it to happen.
  *
@@ -9914,7 +9914,7 @@ gdk_window_maximize (GdkWindow *window)
  * On X11, asks the window manager to unmaximize @window, if the
  * window manager supports this operation. Not all window managers
  * support this, and some deliberately ignore it or don't have a
- * concept of "maximized"; so you can't rely on the unmaximization
+ * concept of “maximized”; so you can't rely on the unmaximization
  * actually happening. But it will happen with most standard window
  * managers, and GDK makes a best effort to get it to happen.
  *
@@ -9940,7 +9940,7 @@ gdk_window_unmaximize (GdkWindow *window)
  * On X11, asks the window manager to put @window in a fullscreen
  * state, if the window manager supports this operation. Not all
  * window managers support this, and some deliberately ignore it or
- * don't have a concept of "fullscreen"; so you can't rely on the
+ * don't have a concept of “fullscreen”; so you can't rely on the
  * fullscreenification actually happening. But it will happen with
  * most standard window managers, and GDK makes a best effort to get
  * it to happen.
@@ -10024,7 +10024,7 @@ gdk_window_get_fullscreen_mode (GdkWindow *window)
  * On X11, asks the window manager to move @window out of the fullscreen
  * state, if the window manager supports this operation. Not all
  * window managers support this, and some deliberately ignore it or
- * don't have a concept of "fullscreen"; so you can't rely on the
+ * don't have a concept of “fullscreen”; so you can't rely on the
  * unfullscreenification actually happening. But it will happen with
  * most standard window managers, and GDK makes a best effort to get
  * it to happen.
@@ -10048,7 +10048,7 @@ gdk_window_unfullscreen (GdkWindow *window)
  * On X11, asks the window manager to keep @window above, if the window
  * manager supports this operation. Not all window managers support
  * this, and some deliberately ignore it or don't have a concept of
- * "keep above"; so you can't rely on the window being kept above.
+ * “keep above”; so you can't rely on the window being kept above.
  * But it will happen with most standard window managers,
  * and GDK makes a best effort to get it to happen.
  *
@@ -10072,7 +10072,7 @@ gdk_window_set_keep_above (GdkWindow *window,
  * On X11, asks the window manager to keep @window below, if the window
  * manager supports this operation. Not all window managers support
  * this, and some deliberately ignore it or don't have a concept of
- * "keep below"; so you can't rely on the window being kept below.
+ * “keep below”; so you can't rely on the window being kept below.
  * But it will happen with most standard window managers,
  * and GDK makes a best effort to get it to happen.
  *
@@ -10128,7 +10128,7 @@ gdk_window_set_group (GdkWindow *window,
  * @window: a toplevel #GdkWindow
  * @decorations: decoration hint mask
  *
- * "Decorations" are the features the window manager adds to a toplevel #GdkWindow.
+ * “Decorations” are the features the window manager adds to a toplevel #GdkWindow.
  * This function sets the traditional Motif window manager hints that tell the
  * window manager which decorations you would like your window to have.
  * Usually you should use gtk_window_set_decorated() on a #GtkWindow instead of
@@ -10206,7 +10206,7 @@ gdk_window_set_functions (GdkWindow    *window,
  * @timestamp: timestamp of mouse click that began the drag (use gdk_event_get_time())
  *
  * Begins a window resize operation (for a toplevel window).
- * You might use this function to implement a "window resize grip," for
+ * You might use this function to implement a “window resize grip,” for
  * example; in fact #GtkStatusbar uses it. The function works best
  * with window managers that support the
  * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
@@ -10268,7 +10268,7 @@ gdk_window_begin_resize_drag (GdkWindow     *window,
  * @timestamp: timestamp of mouse click that began the drag
  *
  * Begins a window move operation (for a toplevel window).
- * You might use this function to implement a "window move grip," for
+ * You might use this function to implement a “window move grip,” for
  * example. The function works best with window managers that support the
  * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
  * but has a fallback implementation for other window managers.

gdk/gdkwindow.h

@@ -93,8 +93,8 @@ typedef enum
  * @GDK_WA_TYPE_HINT: Honor the type_hint field
  *
  * Used to indicate which fields in the #GdkWindowAttr struct should be honored.
- * For example, if you filled in the "cursor" and "x" fields of #GdkWindowAttr,
+ * For example, if you filled in the “cursor” and “x” fields of #GdkWindowAttr,
- * pass "@GDK_WA_X | @GDK_WA_CURSOR" to gdk_window_new(). Fields in
+ * pass “@GDK_WA_X | @GDK_WA_CURSOR” to gdk_window_new(). Fields in
  * #GdkWindowAttr not covered by a bit in this enum are required; for example,
  * the @width/@height, @wclass, and @window_type fields are required, they have
  * no corresponding flag in #GdkWindowAttributesType.
@@ -168,7 +168,7 @@ typedef enum
  * @GDK_WINDOW_TYPE_HINT_POPUP_MENU: A menu that does not belong to a menubar,
  *  e.g. a context menu.
  * @GDK_WINDOW_TYPE_HINT_TOOLTIP: A tooltip.
- * @GDK_WINDOW_TYPE_HINT_NOTIFICATION: A notification - typically a "bubble"
+ * @GDK_WINDOW_TYPE_HINT_NOTIFICATION: A notification - typically a “bubble”
  *  that belongs to a status icon.
  * @GDK_WINDOW_TYPE_HINT_COMBO: A popup from a combo box.
  * @GDK_WINDOW_TYPE_HINT_DND: A window that is used to implement a DND cursor.
@@ -414,10 +414,10 @@ struct _GdkWindowAttr
  * size of one character in the terminal. Finally, the base size should be set
  * to the size of one character. The net effect is that the minimum size of the
  * terminal will have a 1x1 character terminal area, and only terminal sizes on
- * the "character grid" will be allowed.
+ * the “character grid” will be allowed.
  *
  * Here's an example of how the terminal example would be implemented, assuming
- * a terminal area widget called "terminal" and a toplevel window "toplevel":
+ * a terminal area widget called “terminal” and a toplevel window “toplevel”:
  *
  * |[<!-- language="C" -->
  * 	GdkGeometry hints;