Commit e34bd413 authored by William Jon McCann's avatar William Jon McCann

docs: use apostrophes in *n't

parent f0000b2f
...@@ -154,7 +154,7 @@ struct encoder { ...@@ -154,7 +154,7 @@ struct encoder {
* *
* - all 1 pixel colors are encoded literally * - all 1 pixel colors are encoded literally
* *
* - We don't need to support colors with alpha 0 and non-zero * - We dont need to support colors with alpha 0 and non-zero
* color components, as they mean the same on the canvas anyway. * color components, as they mean the same on the canvas anyway.
* So we use these as special codes: * So we use these as special codes:
* *
......
...@@ -299,7 +299,7 @@ gdk_pre_parse_libgtk_only (void) ...@@ -299,7 +299,7 @@ gdk_pre_parse_libgtk_only (void)
* Any arguments used by GDK are removed from the array and @argc and @argv are * Any arguments used by GDK are removed from the array and @argc and @argv are
* updated accordingly. * updated accordingly.
* *
* You shouldn't call this function explicitly if you are using * You shouldnt call this function explicitly if you are using
* gtk_init(), gtk_init_check(), gdk_init(), or gdk_init_check(). * gtk_init(), gtk_init_check(), gdk_init(), or gdk_init_check().
* *
* Since: 2.2 * Since: 2.2
...@@ -495,7 +495,7 @@ gdk_init (int *argc, char ***argv) ...@@ -495,7 +495,7 @@ gdk_init (int *argc, char ***argv)
* Before calling gdk_threads_leave() from a thread other * Before calling gdk_threads_leave() from a thread other
* than your main thread, you probably want to call gdk_flush() * than your main thread, you probably want to call gdk_flush()
* to send all pending commands to the windowing system. * to send all pending commands to the windowing system.
* (The reason you don't need to do this from the main thread * (The reason you dont need to do this from the main thread
* is that GDK always automatically flushes pending commands * is that GDK always automatically flushes pending commands
* when it runs out of incoming events to process and has * when it runs out of incoming events to process and has
* to sleep while waiting for more events.) * to sleep while waiting for more events.)
...@@ -776,7 +776,7 @@ gdk_threads_init (void) ...@@ -776,7 +776,7 @@ gdk_threads_init (void)
* the GTK+ lock when entering a recursive main loop, the application * the GTK+ lock when entering a recursive main loop, the application
* must temporarily release its lock as well. * must temporarily release its lock as well.
* *
* Most threaded GTK+ apps won't need to use this method. * Most threaded GTK+ apps wont need to use this method.
* *
* This method must be called before gdk_threads_init(), and cannot * This method must be called before gdk_threads_init(), and cannot
* be called multiple times. * be called multiple times.
...@@ -1041,7 +1041,7 @@ gdk_threads_add_timeout (guint interval, ...@@ -1041,7 +1041,7 @@ gdk_threads_add_timeout (guint interval,
* *
* A variant of gdk_threads_add_timeout_full() with second-granularity. * A variant of gdk_threads_add_timeout_full() with second-granularity.
* See g_timeout_add_seconds_full() for a discussion of why it is * See g_timeout_add_seconds_full() for a discussion of why it is
* a good idea to use this function if you don't need finer granularity. * a good idea to use this function if you dont need finer granularity.
* *
* Return value: the ID (greater than 0) of the event source. * Return value: the ID (greater than 0) of the event source.
* *
...@@ -1133,10 +1133,10 @@ gdk_set_program_class (const char *program_class) ...@@ -1133,10 +1133,10 @@ gdk_set_program_class (const char *program_class)
* to gdk_display_open(), gtk_init(), gtk_init_with_args() or * to gdk_display_open(), gtk_init(), gtk_init_with_args() or
* gtk_init_check() in order to take effect. * gtk_init_check() in order to take effect.
* *
* Most common GTK+ applications won't ever need to call this. Only * Most common GTK+ applications wont ever need to call this. Only
* applications that do mixed GDK/Xlib calls could want to disable * applications that do mixed GDK/Xlib calls could want to disable
* multidevice support if such Xlib code deals with input devices in * multidevice support if such Xlib code deals with input devices in
* any way and doesn't observe the presence of XInput 2. * any way and doesnt observe the presence of XInput 2.
* *
* Since: 3.0 * Since: 3.0
*/ */
......
...@@ -88,7 +88,7 @@ gdk_keyboard_ungrab (guint32 time) ...@@ -88,7 +88,7 @@ gdk_keyboard_ungrab (guint32 time)
* Obtains the window underneath the mouse pointer, returning the * Obtains the window underneath the mouse pointer, returning the
* location of that window in @win_x, @win_y. Returns %NULL if the * location of that window in @win_x, @win_y. Returns %NULL if the
* window under the mouse pointer is not known to GDK (if the window * window under the mouse pointer is not known to GDK (if the window
* belongs to another application and a #GdkWindow hasn't been created * belongs to another application and a #GdkWindow hasnt been created
* for it with gdk_window_foreign_new()) * for it with gdk_window_foreign_new())
* *
* NOTE: For multihead-aware widgets or applications use * NOTE: For multihead-aware widgets or applications use
......
...@@ -1226,8 +1226,8 @@ get_native_grab_event_mask (GdkEventMask grab_mask) ...@@ -1226,8 +1226,8 @@ get_native_grab_event_mask (GdkEventMask grab_mask)
* gdk_device_grab: * gdk_device_grab:
* @device: a #GdkDevice. To get the device you can use gtk_get_current_event_device() * @device: a #GdkDevice. To get the device you can use gtk_get_current_event_device()
* or gdk_event_get_device() if the grab is in reaction to an event. Also, you can use * or gdk_event_get_device() if the grab is in reaction to an event. Also, you can use
* gdk_device_manager_get_client_pointer() but only in code that isn't triggered by a * gdk_device_manager_get_client_pointer() but only in code that isnt triggered by a
* #GdkEvent and there aren't other means to get a meaningful #GdkDevice to operate on. * #GdkEvent and there arent other means to get a meaningful #GdkDevice to operate on.
* @window: the #GdkWindow which will own the grab (the grab window) * @window: the #GdkWindow which will own the grab (the grab window)
* @grab_ownership: specifies the grab ownership. * @grab_ownership: specifies the grab ownership.
* @owner_events: if %FALSE then all device events are reported with respect to * @owner_events: if %FALSE then all device events are reported with respect to
...@@ -1244,7 +1244,7 @@ get_native_grab_event_mask (GdkEventMask grab_mask) ...@@ -1244,7 +1244,7 @@ get_native_grab_event_mask (GdkEventMask grab_mask)
* elsewhere. * elsewhere.
* @time_: the timestamp of the event which led to this pointer grab. This * @time_: the timestamp of the event which led to this pointer grab. This
* usually comes from the #GdkEvent struct, though %GDK_CURRENT_TIME * usually comes from the #GdkEvent struct, though %GDK_CURRENT_TIME
* can be used if the time isn't known. * can be used if the time isnt known.
* *
* Grabs the device so that all events coming from this device are passed to * Grabs the device so that all events coming from this device are passed to
* this application until the device is ungrabbed with gdk_device_ungrab(), * this application until the device is ungrabbed with gdk_device_ungrab(),
......
...@@ -57,7 +57,7 @@ ...@@ -57,7 +57,7 @@
* #GdkDeviceManager implementation will be used as the input source. * #GdkDeviceManager implementation will be used as the input source.
* Otherwise either the core or XInput 1 implementations will be used. * Otherwise either the core or XInput 1 implementations will be used.
* *
* For simple applications that don't have any special interest in * For simple applications that dont have any special interest in
* input devices, the so-called “client pointer” * input devices, the so-called “client pointer”
* provides a reasonable approximation to a simple setup with a single * provides a reasonable approximation to a simple setup with a single
* pointer and keyboard. The device that has been set as the client * pointer and keyboard. The device that has been set as the client
...@@ -330,8 +330,8 @@ gdk_device_manager_list_devices (GdkDeviceManager *device_manager, ...@@ -330,8 +330,8 @@ gdk_device_manager_list_devices (GdkDeviceManager *device_manager,
* for this application. In X11, window managers may change this depending on the interaction * for this application. In X11, window managers may change this depending on the interaction
* pattern under the presence of several pointers. * pattern under the presence of several pointers.
* *
* You should use this function seldomly, only in code that isn't triggered by a #GdkEvent * You should use this function seldomly, only in code that isnt triggered by a #GdkEvent
* and there aren't other means to get a meaningful #GdkDevice to operate on. * and there arent other means to get a meaningful #GdkDevice to operate on.
* *
* Returns: (transfer none): The client pointer. This memory is * Returns: (transfer none): The client pointer. This memory is
* owned by GDK and must not be freed or unreferenced. * owned by GDK and must not be freed or unreferenced.
......
...@@ -2097,7 +2097,7 @@ static GQueue gdk_error_traps = G_QUEUE_INIT; ...@@ -2097,7 +2097,7 @@ static GQueue gdk_error_traps = G_QUEUE_INIT;
* behavior of exiting the application. It should only be used if it * behavior of exiting the application. It should only be used if it
* is not possible to avoid the X error in any other way. Errors are * is not possible to avoid the X error in any other way. Errors are
* ignored on all #GdkDisplay currently known to the * ignored on all #GdkDisplay currently known to the
* #GdkDisplayManager. If you don't care which error happens and just * #GdkDisplayManager. If you dont care which error happens and just
* want to ignore everything, pop with gdk_error_trap_pop_ignored(). * want to ignore everything, pop with gdk_error_trap_pop_ignored().
* If you need the error code, use gdk_error_trap_pop() which may have * If you need the error code, use gdk_error_trap_pop() which may have
* to block and wait for the error to arrive from the X server. * to block and wait for the error to arrive from the X server.
...@@ -2206,7 +2206,7 @@ gdk_error_trap_pop_ignored (void) ...@@ -2206,7 +2206,7 @@ gdk_error_trap_pop_ignored (void)
* Removes an error trap pushed with gdk_error_trap_push(). * Removes an error trap pushed with gdk_error_trap_push().
* May block until an error has been definitively received * May block until an error has been definitively received
* or not received from the X server. gdk_error_trap_pop_ignored() * or not received from the X server. gdk_error_trap_pop_ignored()
* is preferred if you don't need to know whether an error * is preferred if you dont need to know whether an error
* occurred, because it never has to block. If you don't * occurred, because it never has to block. If you don't
* need the return value of gdk_error_trap_pop(), use * need the return value of gdk_error_trap_pop(), use
* gdk_error_trap_pop_ignored(). * gdk_error_trap_pop_ignored().
......
...@@ -40,7 +40,7 @@ ...@@ -40,7 +40,7 @@
#ifdef GDK_WINDOWING_QUARTZ #ifdef GDK_WINDOWING_QUARTZ
/* When the gdk_quartz_display_open function is removed We can /* When the gdk_quartz_display_open function is removed We can
* immediately include gdkquartzdisplaymanager.h here instead of * immediately include gdkquartzdisplaymanager.h here instead of
* gdkprivate-quartz.h so that we won't have to enable -xobjective-c * gdkprivate-quartz.h so that we wont have to enable -xobjective-c
* for the “generic” GDK source code. * for the “generic” GDK source code.
* #include "quartz/gdkquartzdisplaymanager.h" * #include "quartz/gdkquartzdisplaymanager.h"
*/ */
......
...@@ -47,7 +47,7 @@ G_BEGIN_DECLS ...@@ -47,7 +47,7 @@ G_BEGIN_DECLS
* @GDK_ACTION_LINK: Add a link to the data. Note that this is only * @GDK_ACTION_LINK: Add a link to the data. Note that this is only
* useful if source and destination agree on what it means. * useful if source and destination agree on what it means.
* @GDK_ACTION_PRIVATE: Special action which tells the source that the * @GDK_ACTION_PRIVATE: Special action which tells the source that the
* destination will do something that the source doesn't understand. * destination will do something that the source doesnt understand.
* @GDK_ACTION_ASK: Ask the user what to do with the data. * @GDK_ACTION_ASK: Ask the user what to do with the data.
* *
* Used in #GdkDragContext to indicate what the destination * Used in #GdkDragContext to indicate what the destination
......
...@@ -161,7 +161,7 @@ _gdk_event_queue_append (GdkDisplay *display, ...@@ -161,7 +161,7 @@ _gdk_event_queue_append (GdkDisplay *display,
* @sibling: Append after this event. * @sibling: Append after this event.
* @event: Event to append. * @event: Event to append.
* *
* Appends an event after the specified event, or if it isn't in * Appends an event after the specified event, or if it isnt in
* the queue, onto the tail of the event queue. * the queue, onto the tail of the event queue.
* *
* Returns: the newly appended list node. * Returns: the newly appended list node.
...@@ -189,7 +189,7 @@ _gdk_event_queue_insert_after (GdkDisplay *display, ...@@ -189,7 +189,7 @@ _gdk_event_queue_insert_after (GdkDisplay *display,
* @sibling: Append before this event * @sibling: Append before this event
* @event: Event to prepend * @event: Event to prepend
* *
* Prepends an event before the specified event, or if it isn't in * Prepends an event before the specified event, or if it isnt in
* the queue, onto the head of the event queue. * the queue, onto the head of the event queue.
* *
* Returns: the newly prepended list node. * Returns: the newly prepended list node.
...@@ -1633,7 +1633,7 @@ gdk_event_set_source_device (GdkEvent *event, ...@@ -1633,7 +1633,7 @@ gdk_event_set_source_device (GdkEvent *event,
* *
* This function returns the hardware (slave) #GdkDevice that has * This function returns the hardware (slave) #GdkDevice that has
* triggered the event, falling back to the virtual (master) device * triggered the event, falling back to the virtual (master) device
* (as in gdk_event_get_device()) if the event wasn't caused by * (as in gdk_event_get_device()) if the event wasnt caused by
* interaction with a hardware device. This may happen for example * interaction with a hardware device. This may happen for example
* in synthesized crossing events after a #GdkWindow updates its * in synthesized crossing events after a #GdkWindow updates its
* geometry or a grab is acquired/released. * geometry or a grab is acquired/released.
......
...@@ -415,7 +415,7 @@ typedef enum ...@@ -415,7 +415,7 @@ typedef enum
* this event is synthetic as the pointer might have not left the window. * this event is synthetic as the pointer might have not left the window.
* @GDK_CROSSING_DEVICE_SWITCH: crossing because of a device switch (i.e. * @GDK_CROSSING_DEVICE_SWITCH: crossing because of a device switch (i.e.
* a mouse taking control of the pointer after a touch device), this event * a mouse taking control of the pointer after a touch device), this event
* is synthetic as the pointer didn't leave the window. * is synthetic as the pointer didnt leave the window.
* *
* Specifies the crossing mode for #GdkEventCrossing. * Specifies the crossing mode for #GdkEventCrossing.
*/ */
......
...@@ -95,7 +95,7 @@ ...@@ -95,7 +95,7 @@
* Note that gdk_keymap_translate_keyboard_state() also returns the keyval, i.e. it * Note that gdk_keymap_translate_keyboard_state() also returns the keyval, i.e. it
* goes ahead and performs the keymap lookup in addition to telling you which * goes ahead and performs the keymap lookup in addition to telling you which
* effective group/level values were used for the lookup. #GdkEventKey already * effective group/level values were used for the lookup. #GdkEventKey already
* contains this keyval, however, so you don't normally need to call * contains this keyval, however, so you dont normally need to call
* gdk_keymap_translate_keyboard_state() just to get the keyval. * gdk_keymap_translate_keyboard_state() just to get the keyval.
*/ */
...@@ -493,7 +493,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap, ...@@ -493,7 +493,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* actually used for the translation; some keys such as Enter are not * actually used for the translation; some keys such as Enter are not
* affected by the active keyboard group. The @level is derived from * affected by the active keyboard group. The @level is derived from
* @state. For convenience, #GdkEventKey already contains the translated * @state. For convenience, #GdkEventKey already contains the translated
* keyval, so this function isn't as useful as you might think. * keyval, so this function isnt as useful as you might think.
* *
* @consumed_modifiers gives modifiers that should be masked out * @consumed_modifiers gives modifiers that should be masked out
* from @state when comparing this key press to a hot key. For * from @state when comparing this key press to a hot key. For
...@@ -518,7 +518,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap, ...@@ -518,7 +518,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* this allowed accelerators to be stored with irrelevant consumed * this allowed accelerators to be stored with irrelevant consumed
* modifiers, by doing: * modifiers, by doing:
* |[<!-- language="C" --> * |[<!-- language="C" -->
* /&ast; XXX Don't do this XXX &ast;/ * /&ast; XXX Dont do this XXX &ast;/
* if (keyval == accel_keyval && * if (keyval == accel_keyval &&
* (event->state & ~consumed & ALL_ACCELS_MASK) == (accel_mods & ~consumed)) * (event->state & ~consumed & ALL_ACCELS_MASK) == (accel_mods & ~consumed))
* /&ast; Accelerator was pressed &ast;/ * /&ast; Accelerator was pressed &ast;/
......
...@@ -34,7 +34,7 @@ ...@@ -34,7 +34,7 @@
/* LIMITATIONS: /* LIMITATIONS:
* *
* Offscreen windows can't be the child of a foreign window, * Offscreen windows cant be the child of a foreign window,
* nor contain foreign windows * nor contain foreign windows
* GDK_POINTER_MOTION_HINT_MASK isn't effective * GDK_POINTER_MOTION_HINT_MASK isn't effective
*/ */
......
...@@ -71,7 +71,7 @@ ...@@ -71,7 +71,7 @@
* 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. * 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 * If memory cant be allocated for the return value, %NULL will be returned
* instead. * instead.
* *
* (In short, there are several ways this function can fail, and if it fails * (In short, there are several ways this function can fail, and if it fails
......
...@@ -182,7 +182,7 @@ intern_atom_internal (const gchar *atom_name, gboolean allocate) ...@@ -182,7 +182,7 @@ intern_atom_internal (const gchar *atom_name, gboolean allocate)
* gdk_atom_intern: * gdk_atom_intern:
* @atom_name: a string. * @atom_name: a string.
* @only_if_exists: if %TRUE, GDK is allowed to not create a new atom, but * @only_if_exists: if %TRUE, GDK is allowed to not create a new atom, but
* just return %GDK_NONE if the requested atom doesn't already * just return %GDK_NONE if the requested atom doesnt already
* exists. Currently, the flag is ignored, since checking the * exists. Currently, the flag is ignored, since checking the
* existance of an atom is as expensive as creating it. * existance of an atom is as expensive as creating it.
* *
......
...@@ -195,7 +195,7 @@ _gdk_screen_close (GdkScreen *screen) ...@@ -195,7 +195,7 @@ _gdk_screen_close (GdkScreen *screen)
} }
/* Fallback used when the monitor "at" a point or window /* Fallback used when the monitor "at" a point or window
* doesn't exist. * doesnt exist.
*/ */
static gint static gint
get_nearest_monitor (GdkScreen *screen, get_nearest_monitor (GdkScreen *screen,
...@@ -443,7 +443,7 @@ gdk_screen_get_font_options (GdkScreen *screen) ...@@ -443,7 +443,7 @@ gdk_screen_get_font_options (GdkScreen *screen)
/** /**
* gdk_screen_set_resolution: * gdk_screen_set_resolution:
* @screen: a #GdkScreen * @screen: a #GdkScreen
* @dpi: the resolution in “dots per inch”. (Physical inches aren't actually * @dpi: the resolution in “dots per inch”. (Physical inches arent actually
* involved; the terminology is conventional.) * involved; the terminology is conventional.)
* Sets the resolution for font handling on the screen. This is a * Sets the resolution for font handling on the screen. This is a
...@@ -889,7 +889,7 @@ gdk_screen_get_system_visual (GdkScreen * screen) ...@@ -889,7 +889,7 @@ gdk_screen_get_system_visual (GdkScreen * screen)
* The windowing system on which GTK+ is running * The windowing system on which GTK+ is running
* may not support this capability, in which case %NULL will * may not support this capability, in which case %NULL will
* be returned. Even if a non-%NULL value is returned, its * 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 wont be honored
* when displaying the window on the screen: in particular, for * when displaying the window on the screen: in particular, for
* X an appropriate windowing manager and compositing manager * X an appropriate windowing manager and compositing manager
* must be running to provide appropriate display. * must be running to provide appropriate display.
......
...@@ -1025,10 +1025,10 @@ recompute_visible_regions_internal (GdkWindow *private, ...@@ -1025,10 +1025,10 @@ recompute_visible_regions_internal (GdkWindow *private,
* *
* It will recalculate abs_x/y and the clip regions * It will recalculate abs_x/y and the clip regions
* *
* Unless the window didn't change stacking order or size/pos, pass in TRUE * Unless the window didnt change stacking order or size/pos, pass in TRUE
* for recalculate_siblings. (Mostly used internally for the recursion) * for recalculate_siblings. (Mostly used internally for the recursion)
* *
* If a child window was removed (and you can't use that child for * If a child window was removed (and you cant use that child for
* recompute_visible_regions), pass in TRUE for recalculate_children on the parent * recompute_visible_regions), pass in TRUE for recalculate_children on the parent
*/ */
static void static void
...@@ -1053,7 +1053,7 @@ _gdk_window_update_size (GdkWindow *window) ...@@ -1053,7 +1053,7 @@ _gdk_window_update_size (GdkWindow *window)
/* Find the native window that would be just above "child" /* 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 * (it doesnt have to be native). If there is no such native
* window inside this native parent then NULL is returned. * window inside this native parent then NULL is returned.
* If child is NULL, find lowest native window in parent. * If child is NULL, find lowest native window in parent.
*/ */
...@@ -2943,7 +2943,7 @@ gdk_window_free_paint_stack (GdkWindow *window) ...@@ -2943,7 +2943,7 @@ gdk_window_free_paint_stack (GdkWindow *window)
* Normally this should be completely invisible to applications, as * Normally this should be completely invisible to applications, as
* we automatically flush the windows when required, but this might * we automatically flush the windows when required, but this might
* be needed if you for instance mix direct native drawing with * be needed if you for instance mix direct native drawing with
* gdk drawing. For Gtk widgets that don't use double buffering this * gdk drawing. For Gtk widgets that dont use double buffering this
* will be called automatically before sending the expose event. * will be called automatically before sending the expose event.
* *
* Since: 2.18 * Since: 2.18
...@@ -4152,7 +4152,7 @@ _gdk_window_clear_update_area (GdkWindow *window) ...@@ -4152,7 +4152,7 @@ _gdk_window_clear_update_area (GdkWindow *window)
* gdk_window_freeze_updates: * gdk_window_freeze_updates:
* @window: a #GdkWindow * @window: a #GdkWindow
* *
* Temporarily freezes a window such that it won't receive expose * Temporarily freezes a window such that it wont receive expose
* events. The window will begin receiving expose events again when * events. The window will begin receiving expose events again when
* gdk_window_thaw_updates() is called. If gdk_window_freeze_updates() * gdk_window_thaw_updates() is called. If gdk_window_freeze_updates()
* has been called more than once, gdk_window_thaw_updates() must be called * has been called more than once, gdk_window_thaw_updates() must be called
...@@ -4414,7 +4414,7 @@ gdk_window_constrain_size (GdkGeometry *geometry, ...@@ -4414,7 +4414,7 @@ gdk_window_constrain_size (GdkGeometry *geometry,
* *
* Return value: (transfer none): the window containing the pointer (as with * Return value: (transfer none): the window containing the pointer (as with
* gdk_window_at_pointer()), or %NULL if the window containing the * gdk_window_at_pointer()), or %NULL if the window containing the
* pointer isn't known to GDK * pointer isnt known to GDK
* *
* Deprecated: 3.0: Use gdk_window_get_device_position() instead. * Deprecated: 3.0: Use gdk_window_get_device_position() instead.
**/ **/
...@@ -4783,7 +4783,7 @@ gdk_window_show_internal (GdkWindow *window, gboolean raise) ...@@ -4783,7 +4783,7 @@ gdk_window_show_internal (GdkWindow *window, gboolean raise)
* *
* On the X11 platform, in Xlib terms, this function calls * On the X11 platform, in Xlib terms, this function calls
* XMapWindow() (it also updates some internal GDK state, which means * XMapWindow() (it also updates some internal GDK state, which means
* that you can't really use XMapWindow() directly on a GDK window). * that you cant really use XMapWindow() directly on a GDK window).
*/ */
void void
gdk_window_show_unraised (GdkWindow *window) gdk_window_show_unraised (GdkWindow *window)
...@@ -4919,7 +4919,7 @@ gdk_window_invalidate_in_parent (GdkWindow *private) ...@@ -4919,7 +4919,7 @@ gdk_window_invalidate_in_parent (GdkWindow *private)
* request to move the window in the Z-order, gdk_window_lower() only * request to move the window in the Z-order, gdk_window_lower() only
* requests the restack, does not guarantee it. * requests the restack, does not guarantee it.
* *
* Note that gdk_window_show() raises the window again, so don't call this * Note that gdk_window_show() raises the window again, so dont call this
* function before gdk_window_show(). (Try gdk_window_show_unraised().) * function before gdk_window_show(). (Try gdk_window_show_unraised().)
*/ */
void void
...@@ -5076,7 +5076,7 @@ gdk_window_show (GdkWindow *window) ...@@ -5076,7 +5076,7 @@ gdk_window_show (GdkWindow *window)
* *
* For toplevel windows, withdraws them, so they will no longer be * For toplevel windows, withdraws them, so they will no longer be
* known to the window manager; for all windows, unmaps them, so * known to the window manager; for all windows, unmaps them, so
* they won't be displayed. Normally done automatically as * they wont be displayed. Normally done automatically as
* part of gtk_widget_hide(). * part of gtk_widget_hide().
*/ */
void void
...@@ -5602,7 +5602,7 @@ gdk_window_resize (GdkWindow *window, ...@@ -5602,7 +5602,7 @@ gdk_window_resize (GdkWindow *window,
* Equivalent to calling gdk_window_move() and gdk_window_resize(), * Equivalent to calling gdk_window_move() and gdk_window_resize(),
* except that both operations are performed at once, avoiding strange * except that both operations are performed at once, avoiding strange
* visual effects. (i.e. the user may be able to see the window first * visual effects. (i.e. the user may be able to see the window first
* move, then resize, if you don't use gdk_window_move_resize().) * move, then resize, if you dont use gdk_window_move_resize().)
**/ **/
void void
gdk_window_move_resize (GdkWindow *window, gdk_window_move_resize (GdkWindow *window,
...@@ -6001,7 +6001,7 @@ gdk_window_set_device_cursor (GdkWindow *window, ...@@ -6001,7 +6001,7 @@ gdk_window_set_device_cursor (GdkWindow *window,
* @height: (out) (allow-none): return location for height of window * @height: (out) (allow-none): return location for height of window
* *
* Any of the return location arguments to this function may be %NULL, * Any of the return location arguments to this function may be %NULL,
* if you aren't interested in getting the value of that field. * if you arent interested in getting the value of that field.
* *
* The X and Y coordinates returned are relative to the parent window * The X and Y coordinates returned are relative to the parent window
* of @window, which for toplevels usually means relative to the * of @window, which for toplevels usually means relative to the
...@@ -6601,7 +6601,7 @@ gdk_window_merge_child_input_shapes (GdkWindow *window) ...@@ -6601,7 +6601,7 @@ gdk_window_merge_child_input_shapes (GdkWindow *window)
* Set the bit gravity of the given window to static, and flag it so * Set the bit gravity of the given window to static, and flag it so
* all children get static subwindow gravity. This is used if you are * all children get static subwindow gravity. This is used if you are
* implementing scary features that involve deep knowledge of the * implementing scary features that involve deep knowledge of the
* windowing system. Don't worry about it unless you have to. * windowing system. Dont worry about it unless you have to.
* *
* Return value: %TRUE if the server supports static gravity * Return value: %TRUE if the server supports static gravity
*/ */
...@@ -7792,7 +7792,7 @@ _gdk_display_set_window_under_pointer (GdkDisplay *display, ...@@ -7792,7 +7792,7 @@ _gdk_display_set_window_under_pointer (GdkDisplay *display,
* for @window is used for all other windows. * for @window is used for all other windows.
* @time_: the timestamp of the event which led to this pointer grab. This usually * @time_: the timestamp of the event which led to this pointer grab. This usually
* comes from a #GdkEventButton struct, though %GDK_CURRENT_TIME can be used if * comes from a #GdkEventButton struct, though %GDK_CURRENT_TIME can be used if
* the time isn't known. * the time isnt known.
* *
* Grabs the pointer (usually a mouse) so that all events are passed to this * Grabs the pointer (usually a mouse) so that all events are passed to this
* application until the pointer is ungrabbed with gdk_pointer_ungrab(), or * application until the pointer is ungrabbed with gdk_pointer_ungrab(), or
...@@ -9527,7 +9527,7 @@ gdk_window_set_urgency_hint (GdkWindow *window, ...@@ -9527,7 +9527,7 @@ gdk_window_set_urgency_hint (GdkWindow *window,
* has been turned on via gdk_window_set_override_redirect() * has been turned on via gdk_window_set_override_redirect()
* since these windows are not resizable by the user. * since these windows are not resizable by the user.
* *
* Since you can't count on the windowing system doing the * Since you cant count on the windowing system doing the
* constraints for programmatic resizes, you should generally * constraints for programmatic resizes, you should generally
* call gdk_window_constrain_size() yourself to determine * call gdk_window_constrain_size() yourself to determine
* appropriate sizes. * appropriate sizes.
...@@ -9547,7 +9547,7 @@ gdk_window_set_geometry_hints (GdkWindow *window, ...@@ -9547,7 +9547,7 @@ gdk_window_set_geometry_hints (GdkWindow *window,
* @title: title of @window * @title: title of @window
* *
* Sets the title of a toplevel window, to be displayed in the titlebar. * Sets the title of a toplevel window, to be displayed in the titlebar.
* If you haven't explicitly set the icon name for the window * If you havent explicitly set the icon name for the window
* (using gdk_window_set_icon_name()), the icon name will be set to * (using gdk_window_set_icon_name()), the icon name will be set to
* @title as well. @title must be in UTF-8 encoding (as with all * @title as well. @title must be in UTF-8 encoding (as with all
* user-readable strings in GDK/GTK+). @title may not be %NULL. * user-readable strings in GDK/GTK+). @title may not be %NULL.
...@@ -9573,7 +9573,7 @@ gdk_window_set_title (GdkWindow *window, ...@@ -9573,7 +9573,7 @@ gdk_window_set_title (GdkWindow *window,
* session, all windows with the same title and role are treated as * session, all windows with the same title and role are treated as
* interchangeable. So if you have two windows with the same title * interchangeable. So if you have two windows with the same title
* that should be distinguished for session management purposes, you * that should be distinguished for session management purposes, you
* should set the role on those windows. It doesn't matter what string * should set the role on those windows. It doesnt matter what string
* you use for the role, as long as you have a different role for each * you use for the role, as long as you have a different role for each
* non-interchangeable kind of window. * non-interchangeable kind of window.
* *
...@@ -9665,9 +9665,9 @@ gdk_window_get_frame_extents (GdkWindow *window, ...@@ -9665,9 +9665,9 @@ gdk_window_get_frame_extents (GdkWindow *window,
* @override_redirect: %TRUE if window should be override redirect * @override_redirect: %TRUE if window should be override redirect
* *
* An override redirect window is not under the control of the window manager. * An override redirect window is not under the control of the window manager.
* This means it won't have a titlebar, won't be minimizable, etc. - it will * This means it won’t have a titlebar, won’t be minimizable, etc. - it will
* be entirely under the control of the application. The window manager * be entirely under the control of the application. The window manager
* can't see the override redirect window at all. * cant see the override redirect window at all.
* *
* Override redirect should only be used for short-lived temporary * Override redirect should only be used for short-lived temporary
* windows, such as popup menus. #GtkMenu uses an override redirect * windows, such as popup menus. #GtkMenu uses an override redirect
...@@ -9687,7 +9687,7 @@ gdk_window_set_override_redirect (GdkWindow *window, ...@@ -9687,7 +9687,7 @@ gdk_window_set_override_redirect (GdkWindow *window,
* @accept_focus: %TRUE if the window should receive input focus * @accept_focus: %TRUE if the window should receive input focus
* *
* Setting @accept_focus to %FALSE hints the desktop environment that the * Setting @accept_focus to %FALSE hints the desktop environment that the
* window doesn't want to receive input focus. * window doesnt want to receive input focus.
* *
* On X, it is the responsibility of the window manager to interpret this * On X, it is the responsibility of the window manager to interpret this
* hint. ICCCM-compliant window manager usually respect it. * hint. ICCCM-compliant window manager usually respect it.
...@@ -9707,8 +9707,8 @@ gdk_window_set_accept_focus (GdkWindow *window, ...@@ -9707,8 +9707,8 @@ gdk_window_set_accept_focus (GdkWindow *window,
* @focus_on_map: %TRUE if the window should receive input focus when mapped * @focus_on_map: %TRUE if the window should receive input focus when mapped
* *
* Setting @focus_on_map to %FALSE hints the desktop environment that the * Setting @focus_on_map to %FALSE hints the desktop environment that the
* window doesn't want to receive input focus when it is mapped. * window doesnt want to receive input focus when it is mapped.
* focus_on_map should be turned off for windows that aren't triggered * focus_on_map should be turned off for windows that arent triggered
* interactively (such as popups from network activity). * interactively (such as popups from network activity).
* *
* On X, it is the responsibility of the window manager to interpret * On X, it is the responsibility of the window manager to interpret
...@@ -9857,7 +9857,7 @@ gdk_window_deiconify (GdkWindow *window) ...@@ -9857,7 +9857,7 @@ gdk_window_deiconify (GdkWindow *window)
* On the X11 platform, this function depends on window manager * On the X11 platform, this function depends on window manager
* support, so may have no effect with many window managers. However, * 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 * 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, * the window. For window managers that dont 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.
* *
**/ **/
...@@ -9890,8 +9890,8 @@ gdk_window_unstick (GdkWindow *window) ...@@ -9890,8 +9890,8 @@ gdk_window_unstick (GdkWindow *window)
* *
* On X11, asks the window manager to maximize @window, if the window * On X11, asks the window manager to maximize @window, if the window
* manager supports this operation. Not all window managers support * manager supports this operation. Not all window managers support
* this, and some deliberately ignore it or don't have a concept of * this, and some deliberately ignore it or dont have a concept of
* “maximized”; so you can't rely on the maximization actually * “maximized”; so you cant rely on the maximization actually
* happening. But it will happen with most standard window managers, * happening. But it will happen with