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 {
*
* - 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.
* So we use these as special codes:
*
......
......@@ -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
* 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().
*
* Since: 2.2
......@@ -495,7 +495,7 @@ gdk_init (int *argc, char ***argv)
* Before calling gdk_threads_leave() from a thread other
* than your main thread, you probably want to call gdk_flush()
* 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
* when it runs out of incoming events to process and has
* to sleep while waiting for more events.)
......@@ -776,7 +776,7 @@ gdk_threads_init (void)
* the GTK+ lock when entering a recursive main loop, the application
* 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
* be called multiple times.
......@@ -1041,7 +1041,7 @@ gdk_threads_add_timeout (guint interval,
*
* A variant of gdk_threads_add_timeout_full() with second-granularity.
* 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.
*
......@@ -1133,10 +1133,10 @@ gdk_set_program_class (const char *program_class)
* to gdk_display_open(), gtk_init(), gtk_init_with_args() or
* 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
* 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
*/
......
......@@ -88,7 +88,7 @@ gdk_keyboard_ungrab (guint32 time)
* Obtains the window underneath the mouse pointer, returning 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
* 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())
*
* NOTE: For multihead-aware widgets or applications use
......
......@@ -1226,8 +1226,8 @@ get_native_grab_event_mask (GdkEventMask grab_mask)
* gdk_device_grab:
* @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
* gdk_device_manager_get_client_pointer() but only in code that isn't triggered by a
* #GdkEvent and there aren't other means to get a meaningful #GdkDevice to operate on.
* gdk_device_manager_get_client_pointer() but only in code that isnt triggered by a
* #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)
* @grab_ownership: specifies the grab ownership.
* @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)
* elsewhere.
* @time_: the timestamp of the event which led to this pointer grab. This
* 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
* this application until the device is ungrabbed with gdk_device_ungrab(),
......
......@@ -57,7 +57,7 @@
* #GdkDeviceManager implementation will be used as the input source.
* 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”
* provides a reasonable approximation to a simple setup with a single
* pointer and keyboard. The device that has been set as the client
......@@ -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
* pattern under the presence of several pointers.
*
* You should use this function seldomly, only in code that isn't triggered by a #GdkEvent
* and there aren't other means to get a meaningful #GdkDevice to operate on.
* You should use this function seldomly, only in code that isnt triggered by a #GdkEvent
* and there arent other means to get a meaningful #GdkDevice to operate on.
*
* Returns: (transfer none): The client pointer. This memory is
* owned by GDK and must not be freed or unreferenced.
......
......@@ -2097,7 +2097,7 @@ static GQueue gdk_error_traps = G_QUEUE_INIT;
* 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
* 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().
* 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.
......@@ -2206,7 +2206,7 @@ gdk_error_trap_pop_ignored (void)
* Removes an error trap pushed with gdk_error_trap_push().
* May block until an error has been definitively received
* 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
* need the return value of gdk_error_trap_pop(), use
* gdk_error_trap_pop_ignored().
......
......@@ -40,7 +40,7 @@
#ifdef GDK_WINDOWING_QUARTZ
/* 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
* gdkprivate-quartz.h so that we wont have to enable -xobjective-c
* for the “generic” GDK source code.
* #include "quartz/gdkquartzdisplaymanager.h"
*/
......
......@@ -47,7 +47,7 @@ G_BEGIN_DECLS
* @GDK_ACTION_LINK: Add a link to the data. Note that this is only
* useful if source and destination agree on what it means.
* @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.
*
* Used in #GdkDragContext to indicate what the destination
......
......@@ -161,7 +161,7 @@ _gdk_event_queue_append (GdkDisplay *display,
* @sibling: Append after this event.
* @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.
*
* Returns: the newly appended list node.
......@@ -189,7 +189,7 @@ _gdk_event_queue_insert_after (GdkDisplay *display,
* @sibling: Append before this event
* @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.
*
* Returns: the newly prepended list node.
......@@ -1633,7 +1633,7 @@ gdk_event_set_source_device (GdkEvent *event,
*
* This function returns the hardware (slave) #GdkDevice that has
* 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
* in synthesized crossing events after a #GdkWindow updates its
* geometry or a grab is acquired/released.
......
......@@ -415,7 +415,7 @@ typedef enum
* 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.
* 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.
*/
......
......@@ -95,7 +95,7 @@
* 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
* 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.
*/
......@@ -493,7 +493,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* actually used for the translation; some keys such as Enter are not
* affected by the active keyboard group. The @level is derived from
* @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
* from @state when comparing this key press to a hot key. For
......@@ -518,7 +518,7 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* this allowed accelerators to be stored with irrelevant consumed
* modifiers, by doing:
* |[<!-- language="C" -->
* /&ast; XXX Don't do this XXX &ast;/
* /&ast; XXX Dont do this XXX &ast;/
* if (keyval == accel_keyval &&
* (event->state & ~consumed & ALL_ACCELS_MASK) == (accel_mods & ~consumed))
* /&ast; Accelerator was pressed &ast;/
......
......@@ -34,7 +34,7 @@
/* 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
* GDK_POINTER_MOTION_HINT_MASK isn't effective
*/
......
......@@ -71,7 +71,7 @@
* 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
* If memory cant be allocated for the return value, %NULL will be returned
* instead.
*
* (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)
* gdk_atom_intern:
* @atom_name: a string.
* @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
* existance of an atom is as expensive as creating it.
*
......
......@@ -195,7 +195,7 @@ _gdk_screen_close (GdkScreen *screen)
}
/* Fallback used when the monitor "at" a point or window
* doesn't exist.
* doesnt exist.
*/
static gint
get_nearest_monitor (GdkScreen *screen,
......@@ -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 arent actually
* involved; the terminology is conventional.)
* Sets the resolution for font handling on the screen. This is a
......@@ -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 wont 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.
......
This diff is collapsed.
......@@ -48,7 +48,7 @@ typedef struct _GdkWindowRedirect GdkWindowRedirect;
* @GDK_INPUT_OUTPUT windows are the standard kind of window you might expect.
* Such windows receive events and are also displayed on screen.
* @GDK_INPUT_ONLY windows are invisible; they are usually placed above other
* windows in order to trap or filter the events. You can't draw on
* windows in order to trap or filter the events. You cant draw on
* @GDK_INPUT_ONLY windows.
*/
typedef enum
......@@ -344,8 +344,8 @@ typedef enum
* @visual: #GdkVisual for window
* @window_type: type of window
* @cursor: cursor for the window (see gdk_window_set_cursor())
* @wmclass_name: don't use (see gtk_window_set_wmclass())
* @wmclass_class: don't use (see gtk_window_set_wmclass())
* @wmclass_name: dont use (see gtk_window_set_wmclass())
* @wmclass_class: dont use (see gtk_window_set_wmclass())
* @override_redirect: %TRUE to bypass the window manager
* @type_hint: a hint of the function of the window
*
......
......@@ -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 dont 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
......@@ -53,7 +53,7 @@
static int current_loop_level = 0;
/* Run loop level at which we acquired ownership of the GLib main
* loop. See note in run_loop_entry(). -1 means that we don't have
* loop. See note in run_loop_entry(). -1 means that we dont have
* ownership
*/
static int acquired_loop_level = -1;
......@@ -96,7 +96,7 @@ static GPollFD event_poll_fd;
/* Current NSEvents that we've gotten from Cocoa but haven't yet converted
* to GdkEvents. We wait until our dispatch() function to do the conversion
* since the conversion can conceivably cause signals to be emmitted
* or other things that shouldn't happen inside a poll function.
* or other things that shouldnt happen inside a poll function.
*/
static GQueue *current_events;
......
......@@ -2275,7 +2275,7 @@ gdk_wayland_window_get_wl_surface (GdkWindow *window)
*
* A good example would be writing a panel or on-screen-keyboard as an
* out-of-process helper - as opposed to having those in the compositor
* process. In this case the underlying surface isn't an xdg_shell
* process. In this case the underlying surface isnt an xdg_shell
* surface and the panel or OSK client need to identify the wl_surface
* as a panel or OSK to the compositor. The assumption is that the
* compositor will expose a private interface to the special client
......
......@@ -48,8 +48,8 @@
*
* 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
* that need to declare the corresponding OLE2 data types, and (b) there isn't a
* fact that the widget’s declared selection types arent accessible in calls here
* that need to declare the corresponding OLE2 data types, and (b) there isnt 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
* and failed!). As an example of the latter: gdk STRING, TEXT, COMPOUND_TEXT map
......@@ -62,7 +62,7 @@
* Note that in combination with another hack originated by Archaeopteryx
* Software, the text conversions here may go to utf-8 unicode as the standard
* within-gtk target or to single-byte ascii when the USE_ACP_TEXT compilation
* flag is TRUE. This mode was added to support applications that aren't using
* flag is TRUE. This mode was added to support applications that arent using
* utf-8 across the gtk/gdk API but instead use single-byte ascii according to
* the current Windows code page. See gdkim-win32.c for more info on that.
*
......
......@@ -26,7 +26,7 @@
*/
/* Cannot use TrackMouseEvent, as the stupid WM_MOUSELEAVE message
* doesn't tell us where the mouse has gone. Thus we cannot use it to
* doesnt tell us where the mouse has gone. Thus we cannot use it to
* generate a correct GdkNotifyType. Pity, as using TrackMouseEvent
* otherwise would make it possible to reliably generate
* GDK_LEAVE_NOTIFY events, which would help get rid of those pesky
......@@ -1014,7 +1014,7 @@ apply_event_filters (GdkWindow *window,
* 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
* It would be a good idea if applications dont chain transient windows
* together. There’s a limit to how much evil GTK can try to shield you
* from.
*/
......
......@@ -157,9 +157,9 @@ _gdk_other_api_failed (const gchar *where,
* Like g_strdup_printf, but to a static buffer. Return value does not
* 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
* the buffer happens to get reused. This doesnt matter as this
* function’s return value is used in debugging output right after the call,
* and the return value isn't used after that.
* and the return value isnt used after that.
*/
static gchar *
static_printf (const gchar *format,
......
......@@ -116,15 +116,15 @@ end_startup_notification (GdkDisplay *display,
/* This should be fairly long, as it's confusing to users if a startup
* ends when it shouldn't (it appears that the startup failed, and
* ends when it shouldnt (it appears that the startup failed, and
* they have to relaunch the app). Also the timeout only matters when
* there are bugs and apps don't end their own startup sequence.
* there are bugs and apps dont end their own startup sequence.
*
* This timeout is a "last resort" timeout that ignores whether the
* startup sequence has shown activity or not. Metacity and the
* tasklist have smarter, and correspondingly able-to-be-shorter
* timeouts. The reason our timeout is dumb is that we don't monitor
* the sequence (don't use an SnMonitorContext)
* timeouts. The reason our timeout is dumb is that we dont monitor
* the sequence (dont use an SnMonitorContext)
*/
#define STARTUP_TIMEOUT_LENGTH_SECONDS 30
#define STARTUP_TIMEOUT_LENGTH (STARTUP_TIMEOUT_LENGTH_SECONDS * 1000)
......
......@@ -85,7 +85,7 @@ _gdk_x11_device_manager_new (GdkDisplay *display)
* Returns the #GdkDevice that wraps the given device ID.
*
* Returns: (transfer none) (allow-none) (type GdkX11DeviceCore): The #GdkDevice wrapping the device ID,
* or %NULL if the given ID doesn't currently represent a device.
* or %NULL if the given ID doesnt currently represent a device.
*
* Since: 3.2
**/
......
......@@ -2474,7 +2474,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
* emits protocol so we can't use it in an error handler.
* emits protocol so we cant use it in an error handler.
*/
static const char *
_gdk_x11_decode_request_code(Display *dpy, int code)
......@@ -2743,7 +2743,7 @@ gdk_x11_display_set_window_scale (GdkDisplay *display,
* the error is known to have occurred or not occurred,
* so the error code can be returned.
*
* If you don't need to use the return value,
* If you dont need to use the return value,
* gdk_x11_display_error_trap_pop_ignored() would be more efficient.
*
* See gdk_error_trap_pop() for the all-displays-at-once
......
......@@ -1470,7 +1470,7 @@ xdnd_read_actions (GdkX11DragContext *context_x11)
/* We have to make sure that the XdndActionList we keep internally
* is up to date with the XdndActionList on the source window
* because we get no notification, because Xdnd wasn't meant
* because we get no notification, because Xdnd wasnt meant
* to continually send actions. So we select on PropertyChangeMask
* and add this filter.
*/
......
......@@ -403,11 +403,11 @@ gdk_x11_get_xatom_by_name (const gchar *atom_name)
*
* Returns the name of an X atom for its display. This
* function is meant mainly for debugging, so for convenience, unlike
* XAtomName() and gdk_atom_name(), the result doesn't need to
* XAtomName() and gdk_atom_name(), the result doesnt need to
* be freed.
*
* Return value: name of the X atom; this string is owned by GDK,
* so it shouldn't be modifed or freed.
* so it shouldnt be modifed or freed.
*
* Since: 2.2
**/
......@@ -427,11 +427,11 @@ gdk_x11_get_xatom_name_for_display (GdkDisplay *display,
* 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,
* doesnt need to be freed. Also, this function will never return %NULL,
* even if @xatom is invalid.
*
* Return value: name of the X atom; this string is owned by GTK+,
* so it shouldn't be modifed or freed.
* so it shouldnt be modifed or freed.
**/
const gchar *
gdk_x11_get_xatom_name (Atom xatom)
......
......@@ -1546,7 +1546,7 @@ fetch_net_wm_check_window (GdkScreen *screen)
* [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
*
* When using this function, keep in mind that the window manager
* can change over time; so you shouldn't use this function in
* can change over time; so you shouldnt use this function in
* a way that impacts persistent application state. A common bug
* is that your application can start up before the window manager
* does when the user logs in, and before the window manager starts
......
......@@ -69,7 +69,7 @@ _gdk_x11_selection_window_destroyed (GdkWindow *window)
}
/* We only pass through those SelectionClear events that actually
* reflect changes to the selection owner that we didn't make ourself.
* reflect changes to the selection owner that we didnt make ourself.
*/
gboolean
_gdk_x11_selection_filter_clear_event (XSelectionClearEvent *event)
......
......@@ -477,7 +477,7 @@ _gdk_x11_screen_list_visuals (GdkScreen *screen)
* Looks up the #GdkVisual for a particular screen and X Visual ID.
*
* Returns: (transfer none) (type GdkX11Visual): the #GdkVisual (owned by the screen
* object), or %NULL if the visual ID wasn't found.
* object), or %NULL if the visual ID wasnt found.
*
* Since: 2.2
*/
......
......@@ -1187,7 +1187,7 @@ x_event_mask_to_gdk_event_mask (long mask)
*
* Return value: (transfer full): a #GdkWindow wrapper for the native
* window, or %NULL if the window has been destroyed. The wrapper
* will be newly created, if one doesn't exist already.
* will be newly created, if one doesnt exist already.
*
* Since: 2.24
*/
......
......@@ -1171,7 +1171,7 @@ gtk_action_is_sensitive (GtkAction *action)
* gtk_action_get_sensitive:
* @action: the action object
*
* Returns whether the action itself is sensitive. Note that this doesn't
* Returns whether the action itself is sensitive. Note that this doesnt
* necessarily mean effective sensitivity. See gtk_action_is_sensitive()
* for that.
*
......@@ -1196,7 +1196,7 @@ gtk_action_get_sensitive (GtkAction *action)
* @sensitive: %TRUE to make the action sensitive
*
* Sets the :sensitive property of the action to @sensitive. Note that
* this doesn't necessarily mean effective sensitivity. See
* this doesnt necessarily mean effective sensitivity. See
* gtk_action_is_sensitive()
* for that.
*
......@@ -1251,7 +1251,7 @@ gtk_action_is_visible (GtkAction *action)
* gtk_action_get_visible:
* @action: the action object
*
* Returns whether the action itself is visible. Note that this doesn't
* Returns whether the action itself is visible. Note that this doesnt
* necessarily mean effective visibility. See gtk_action_is_sensitive()
* for that.
*
......@@ -1276,7 +1276,7 @@ gtk_action_get_visible (GtkAction *action)
* @visible: %TRUE to make the action visible
*
* Sets the :visible property of the action to @visible. Note that
* this doesn't necessarily mean effective visibility. See
* this doesnt necessarily mean effective visibility. See
* gtk_action_is_visible()
* for that.
*
......@@ -1995,7 +1995,7 @@ gtk_action_set_accel_group (GtkAction *action,
*
* Since multiple proxies may independently trigger the installation
* of the accelerator, the @action counts the number of times this
* function has been called and doesn't remove the accelerator until
* function has been called and doesnt remove the accelerator until
* gtk_action_disconnect_accelerator() has been called as many times.
*
* Since: 2.4
......
......@@ -66,7 +66,7 @@
* a custom &lt;accelerator&gt; element, which has attributes named key and
* modifiers and allows to specify accelerators. This is similar to the
* &lt;accelerator&gt; element of #GtkWidget, the main difference is that
* it doesn't allow you to specify a signal.
* it doesnt allow you to specify a signal.
*
* ## A #GtkDialog UI definition fragment. ##
* |[
......
......@@ -727,7 +727,7 @@ gtk_color_selection_unrealize (GtkWidget *widget)
}
/* We override show-all since we have internal widgets that
* shouldn't be shown when you call show_all(), like the
* shouldnt be shown when you call show_all(), like the
* palette and opacity sliders.
*/
static void
......
......@@ -1519,7 +1519,7 @@ gtk_font_selection_select_font_desc (GtkFontSelection *fontsel,
* @fontsel is inserted in a toplevel window before you call this function.
*
* Return value: %TRUE if the font could be set successfully; %FALSE if no
* such font exists or if the @fontsel doesn't belong to a particular
* such font exists or if the @fontsel doesnt belong to a particular
* screen yet.
*
* Deprecated: 3.2: Use #GtkFontChooser
......
......@@ -249,7 +249,7 @@ gtk_gradient_unref (GtkGradient *gradient)
*
* If @gradient is resolvable, @resolved_gradient will be filled in
* with the resolved gradient as a cairo_pattern_t, and %TRUE will
* be returned. Generally, if @gradient can't be resolved, it is
* be returned. Generally, if @gradient cant be resolved, it is
* due to it being defined on top of a named color that doesn't
* exist in @props.
*
......
......@@ -50,7 +50,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* from #GtkBox. No further changes are needed, since the default
* value of the #GtkOrientable:orientation property is
* %GTK_ORIENTATION_HORIZONTAL.
* If you don't need first-child or last-child styling, and want your code
* If you dont need first-child or last-child styling, and want your code
* to be future-proof, the recommendation is to switch to #GtkGrid instead
* of nested boxes. For more information about migrating to #GtkGrid,
* see [Migrating from other containers to GtkGrid][gtk-migrating-GtkGrid].
......
......@@ -58,7 +58,7 @@
* different sizes and widget states). Icons in an icon factory are named by a
* stock ID, which is a simple string identifying the icon. Each #GtkStyle has a
* list of #GtkIconFactory derived from the current theme; those icon factories
* are consulted first when searching for an icon. If the theme doesn't set a
* are consulted first when searching for an icon. If the theme doesnt set a
* particular icon, GTK+ looks for the icon in a list of default icon factories,
* maintained by gtk_icon_factory_add_default() and
* gtk_icon_factory_remove_default(). Applications with icons should add a default
......@@ -259,7 +259,7 @@ gtk_icon_factory_finalize (GObject *object)
* stock ID, which is a simple string identifying the icon. Each
* #GtkStyle has a list of #GtkIconFactory<!-- -->s derived from the current
* theme; those icon factories are consulted first when searching for
* an icon. If the theme doesn't set a particular icon, GTK+ looks for
* an icon. If the theme doesnt set a particular icon, GTK+ looks for
* the icon in a list of default icon factories, maintained by
* gtk_icon_factory_add_default() and
* gtk_icon_factory_remove_default(). Applications with icons should
......@@ -755,7 +755,7 @@ icon_size_lookup_intern (GtkIconSize size,
* modified by user preferences for a particular
* #GtkSettings. Normally @size would be
* #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_BUTTON, etc. This function
* isn't normally needed, gtk_widget_render_icon_pixbuf() is the usual
* isnt normally needed, gtk_widget_render_icon_pixbuf() is the usual
* way to get an icon for rendering, then just look at the size of
* the rendered pixbuf. The rendered pixbuf may not even correspond to
* the width/height returned by gtk_icon_size_lookup(), because themes
......@@ -787,7 +787,7 @@ gtk_icon_size_lookup_for_settings (GtkSettings *settings,
*
* Obtains the pixel size of a semantic icon size @size:
* #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_BUTTON, etc. This function
* isn't normally needed, gtk_icon_theme_load_icon() is the usual
* isnt normally needed, gtk_icon_theme_load_icon() is the usual
* way to get an icon for rendering, then just look at the size of
* the rendered pixbuf. The rendered pixbuf may not even correspond to
* the width/height returned by gtk_icon_size_lookup(), because themes
......@@ -1055,7 +1055,7 @@ gtk_icon_set_new (void)
* @pixbuf: a #GdkPixbuf
*
* Creates a new #GtkIconSet with @pixbuf as the default/fallback
* source image. If you don't add any additional #GtkIconSource to the
* source image. If you dont add any additional #GtkIconSource to the
* icon set, all variants of the icon will be created from @pixbuf,
* using scaling, pixelation, etc. as required to adjust the icon size
* or make the icon look insensitive/prelighted.
......@@ -1542,12 +1542,12 @@ G_GNUC_END_IGNORE_DEPRECATIONS;
* @icon_set: a #GtkIconSet
* @context: a #GtkStyleContext
* @size: (type int): icon size. A size of (GtkIconSize)-1
* means render at the size of the source and don't scale.
* means render at the size of the source and dont scale.
*
* Renders an icon using gtk_render_icon_pixbuf(). In most cases,
* gtk_widget_render_icon_pixbuf() is better, since it automatically provides
* most of the arguments from the current widget settings. This
* function never returns %NULL; if the icon can't be rendered
* function never returns %NULL; if the icon cant be rendered
* (perhaps because an image file fails to load), a default "missing
* image" icon will be returned instead.
*
......@@ -1573,14 +1573,14 @@ gtk_icon_set_render_icon_pixbuf (GtkIconSet *icon_set,
* @icon_set: a #GtkIconSet
* @context: a #GtkStyleContext
* @size: (type int): icon size. A size of (GtkIconSize)-1
* means render at the size of the source and don't scale.
* means render at the size of the source and dont scale.
* @scale: the window scale to render for
* @for_window: (allow-none): #GdkWindow to optimize drawing for, or %NULL
*
* Renders an icon using gtk_render_icon_pixbuf() and converts it to a
* cairo surface.
*
* This function never returns %NULL; if the icon can't be rendered
* This function never returns %NULL; if the icon cant be rendered
* (perhaps because an image file fails to load), a default "missing
* image" icon will be returned instead.
*
......@@ -1615,7 +1615,7 @@ gtk_icon_set_render_icon_surface (GtkIconSet *icon_set,
* @direction: text direction
* @state: widget state
* @size: (type int): icon size. A size of (GtkIconSize)-1
* means render at the size of the source and don't scale.
* means render at the size of the source and dont scale.
* @widget: (allow-none): widget that will display the icon, or %NULL.
* The only use that is typically made of this
* is to determine the appropriate #GdkScreen.
......@@ -1626,7 +1626,7 @@ gtk_icon_set_render_icon_surface (GtkIconSet *icon_set,
* Renders an icon using gtk_style_render_icon(). In most cases,
* gtk_widget_render_icon() is better, since it automatically provides
* most of the arguments from the current widget settings. This
* function never returns %NULL; if the icon can't be rendered
* function never returns %NULL; if the icon cant be rendered
* (perhaps because an image file fails to load), a default "missing
* image" icon will be returned instead.
*
......@@ -2720,7 +2720,7 @@ _gtk_icon_set_invalidate_caches (void)
* _gtk_icon_factory_list_ids:
*
* Gets all known IDs stored in an existing icon factory.
* The strings in the returned list aren't copied.
* The strings in the returned list arent copied.
* The list itself should be freed.
*
* Return value: List of ids in icon factories
......
......@@ -96,7 +96,7 @@ GDK_DEPRECATED_IN_3_10
GtkIconSet* gtk_icon_factory_lookup_default (const gchar *stock_id);
/* Get preferred real size from registered semantic size. Note that
* themes SHOULD use this size, but they aren't required to; for size
* themes SHOULD use this size, but they arent required to; for size
* requests and such, you should get the actual pixbuf from the icon
* set and see what size was rendered.
*
......
......@@ -556,7 +556,7 @@
* When selecting an icon source to use, GTK+ will consider text direction most
* important, state second, and size third. It will select the best match based on
* those criteria. If an attribute matches exactly (e.g. you specified
* `PRELIGHT` or specified the size), GTK+ won't modify the image;
* `PRELIGHT` or specified the size), GTK+ wont modify the image;
* if the attribute matches with a wildcard, GTK+ will scale or modify the image to
* match the state and size the user requested.