Commit 7a208fbb authored by William Jon McCann's avatar William Jon McCann

docs: use proper apostrophe

https://wiki.gnome.org/Design/OS/Typography
parent f116f007
......@@ -388,7 +388,7 @@ gdk_device_get_property (GObject *object,
* @mask: location to store the modifiers, or %NULL.
*
* Gets the current state of a pointer device relative to @window. As a slave
* device's coordinates are those of its master pointer, this
* devices coordinates are those of its master pointer, this
* function may not be called on devices of type %GDK_DEVICE_TYPE_SLAVE,
* unless there is an ongoing grab on them. See gdk_device_grab().
*/
......@@ -740,7 +740,7 @@ gdk_device_get_mode (GdkDevice *device)
* @mode: the input mode.
*
* Sets a the mode of an input device. The mode controls if the
* device is active and whether the device's range is mapped to the
* device is active and whether the devices range is mapped to the
* entire screen or to a single window.
*
* Returns: %TRUE if the mode was successfully changed.
......
......@@ -64,9 +64,9 @@ typedef enum
/**
* GdkInputMode:
* @GDK_MODE_DISABLED: the device is disabled and will not report any events.
* @GDK_MODE_SCREEN: the device is enabled. The device's coordinate space
* @GDK_MODE_SCREEN: the device is enabled. The devices coordinate space
* maps to the entire screen.
* @GDK_MODE_WINDOW: the device is enabled. The device's coordinate space
* @GDK_MODE_WINDOW: the device is enabled. The devices coordinate space
* is mapped to a single window. The manner in which this window
* is chosen is undefined, but it will typically be the same
* way in which the focus window for key events is determined.
......@@ -132,7 +132,7 @@ typedef enum {
/**
* GdkTimeCoord:
* @time: The timestamp for this event.
* @axes: the values of the device's axes.
* @axes: the values of the devices axes.
*
* A #GdkTimeCoord stores a single event in a motion history.
*/
......
......@@ -326,7 +326,7 @@ gdk_display_get_event (GdkDisplay *display)
* gdk_display_peek_event:
* @display: a #GdkDisplay
*
* Gets a copy of the first #GdkEvent in the @display's event queue, without
* Gets a copy of the first #GdkEvent in the @displays event queue, without
* removing the event from the queue. (Note that this function will
* not get more events from the windowing system. It only checks the events
* that have already been moved to the GDK event queue.)
......@@ -1615,7 +1615,7 @@ gdk_display_request_selection_notification (GdkDisplay *display,
* @display: a #GdkDisplay
*
* Returns whether the speicifed display supports clipboard
* persistance; i.e. if it's possible to store the clipboard data after an
* persistance; i.e. if its possible to store the clipboard data after an
* application has quit. On X11 this checks if a clipboard daemon is
* running.
*
......@@ -1945,7 +1945,7 @@ _gdk_display_get_next_serial (GdkDisplay *display)
*
* Indicates to the GUI environment that the application has finished
* loading. If the applications opens windows, this function is
* normally called after opening the application's initial set of
* normally called after opening the applications initial set of
* windows.
*
* GTK+ will call this function automatically after opening the first
......
......@@ -464,7 +464,7 @@ gdk_event_peek (void)
* @event: a #GdkEvent.
*
* Appends a copy of the given event onto the front of the event
* queue for event->any.window's display, or the default event
* queue for event->any.windows display, or the default event
* queue if event->any.window is %NULL. See gdk_display_put_event().
**/
void
......@@ -611,7 +611,7 @@ _gdk_event_get_pointer_emulated (GdkEvent *event)
* @event: a #GdkEvent
*
* Copies a #GdkEvent, copying or incrementing the reference count of the
* resources associated with it (e.g. #GdkWindow's and strings).
* resources associated with it (e.g. #GdkWindows and strings).
*
* Return value: a copy of @event. The returned #GdkEvent should be freed with
* gdk_event_free().
......@@ -913,7 +913,7 @@ gdk_event_get_time (const GdkEvent *event)
*
* If the event contains a “state” field, puts that field in @state. Otherwise
* stores an empty state (0). Returns %TRUE if there was a state field
* in the event. @event may be %NULL, in which case it's treated
* in the event. @event may be %NULL, in which case its treated
* as if the event had no state field.
*
* Return value: %TRUE if there was a state field in the event
......
......@@ -993,11 +993,11 @@ struct _GdkEventOwnerChange
* @device: the master device that the event originated from. Use
* gdk_event_get_source_device() to get the slave device.
*
* Proximity events are generated when using GDK's wrapper for the
* Proximity events are generated when using GDKs wrapper for the
* XInput extension. The XInput extension is an add-on for standard X
* that allows you to use nonstandard devices such as graphics tablets.
* A proximity event indicates that the stylus has moved in or out of
* contact with the tablet, or perhaps that the user's finger has moved
* contact with the tablet, or perhaps that the users finger has moved
* in or out of contact with a touch screen.
*
* This event type will be used pretty rarely. It only is important for
......
......@@ -252,10 +252,10 @@ gdk_frame_clock_init (GdkFrameClock *clock)
* @frame_clock: a #GdkFrameClock
*
* Gets the time that should currently be used for animations. Inside
* the processing of a frame, it's the time used to compute the
* the processing of a frame, its the time used to compute the
* animation position of everything in a frame. Outside of a frame, it's
* the time of the conceptual “previous frame,” which may be either
* the actual previous frame time, or if that's too old, an updated
* the actual previous frame time, or if thats too old, an updated
* time.
*
* Since: 3.8
......
......@@ -25,11 +25,11 @@
* @Title: Frame timings
*
* A #GdkFrameTimings object holds timing information for a single frame
* of the application's displays. To retrieve #GdkFrameTimings objects,
* of the applications displays. To retrieve #GdkFrameTimings objects,
* use gdk_frame_clock_get_timings() or gdk_frame_clock_get_current_timings().
* The information in #GdkFrameTimings is useful for precise synchronization
* of video with the event or audio streams, and for measuring
* quality metrics for the application's display, such as latency and jitter.
* quality metrics for the applications display, such as latency and jitter.
*/
G_DEFINE_BOXED_TYPE (GdkFrameTimings, gdk_frame_timings,
......
......@@ -80,7 +80,7 @@
* two Hebrew characters. The Hebrew characters will be printed on the key next to
* the English characters.
*
* In order to use a keymap to interpret a key event, it's necessary to first
* In order to use a keymap to interpret a key event, its necessary to first
* convert the keyboard state into an effective group and level. This is done via a
* set of rules that varies widely according to type of keyboard and user
* configuration. The function gdk_keymap_translate_keyboard_state() accepts a
......@@ -649,7 +649,7 @@ gdk_keymap_real_get_modifier_mask (GdkKeymap *keymap,
* @keymap: a #GdkKeymap
* @intent: the use case for the modifier mask
*
* Returns the modifier mask the @keymap's windowing system backend
* Returns the modifier mask the @keymaps windowing system backend
* uses for a particular purpose.
*
* Note that this function always returns real hardware modifiers, not
......
......@@ -200,7 +200,7 @@ layout_iter_get_line_clip_region (PangoLayoutIter *iter,
* Obtains a clip region which contains the areas where the given
* ranges of text would be drawn. @x_origin and @y_origin are the top left
* position of the layout. @index_ranges
* should contain ranges of bytes in the layout's text. The clip
* should contain ranges of bytes in the layouts text. The clip
* region will include space to the left or right of the line (to the
* layout bounding box) if you have indexes above or below the indexes
* contained inside the line. This is to draw the selection all the way
......@@ -249,7 +249,7 @@ gdk_pango_layout_line_get_clip_region (PangoLayoutLine *line,
* Obtains a clip region which contains the areas where the given ranges
* of text would be drawn. @x_origin and @y_origin are the top left point
* to center the layout. @index_ranges should contain
* ranges of bytes in the layout's text.
* ranges of bytes in the layouts text.
*
* Note that the regions returned correspond to logical extents of the text
* ranges, not ink extents. So the drawn layout may in fact touch areas out of
......@@ -315,7 +315,7 @@ gdk_pango_layout_get_clip_region (PangoLayout *layout,
* #cairo_font_options_t) for the default screen; if these options
* change it will not be updated. Using gtk_widget_get_pango_context()
* is more convenient if you want to keep a context around and track
* changes to the screen's font rendering settings.
* changes to the screens font rendering settings.
*
* Return value: (transfer full): a new #PangoContext for the default display
**/
......@@ -341,7 +341,7 @@ gdk_pango_context_get (void)
* (see #cairo_font_options_t) for the screen; if these options
* change it will not be updated. Using gtk_widget_get_pango_context()
* is more convenient if you want to keep a context around and track
* changes to the screen's font rendering settings.
* changes to the screens font rendering settings.
*
* Return value: (transfer full): a new #PangoContext for @screen
*
......
......@@ -68,7 +68,7 @@
* other windows, then the contents of the pixbuf areas corresponding
* to the obscured regions are undefined.
*
* If the window is not mapped (typically because it's iconified/minimized
* If the window is not mapped (typically because its 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
......
......@@ -33,7 +33,7 @@
* @Title: Points and Rectangles
*
* GDK provides the #GdkPoint and #GdkRectangle data types for representing pixels
* and sets of pixels on the screen. Together with Cairo's #cairo_region_t data
* and sets of pixels on the screen. Together with Cairos #cairo_region_t data
* type, they make up the central types for representing graphical data.
*
* A #GdkPoint represents an x and y coordinate of a point.
......@@ -86,7 +86,7 @@ gdk_rectangle_union (const GdkRectangle *src1,
*
* Calculates the intersection of two rectangles. It is allowed for
* @dest to be the same as either @src1 or @src2. If the rectangles
* do not intersect, @dest's width and height is set to 0 and its x
* do not intersect, @dests width and height is set to 0 and its x
* and y values are undefined. If you are only interested in whether
* the rectangles intersect, but not in the intersecting area itself,
* pass %NULL for @dest.
......
......@@ -36,7 +36,7 @@
* @Title: RGBA Colors
*
* #GdkRGBA is a convenient way to pass rgba colors around.
* It's based on cairo's way to deal with colors and mirrors its behavior.
* It’s based on cairo’s way to deal with colors and mirrors its behavior.
* All values are in the range from 0.0 to 1.0 inclusive. So the color
* (0.0, 0.0, 0.0, 0.0) represents transparent black and
* (1.0, 1.0, 1.0, 1.0) is opaque white. Other values will be clamped
......
......@@ -394,7 +394,7 @@ gdk_screen_height_mm (void)
* previously set default font options.
*
* Sets the default font options for the screen. These
* options will be set on any #PangoContext's newly created
* options will be set on any #PangoContexts newly created
* with gdk_pango_context_get_for_screen(). Changing the
* default set of font options does not affect contexts that
* have already been created.
......@@ -865,7 +865,7 @@ gdk_screen_list_visuals (GdkScreen *screen)
* gdk_screen_get_system_visual:
* @screen: a #GdkScreen.
*
* Get the system's default visual for @screen.
* Get the systems default visual for @screen.
* This is the visual for the root window of the display.
* The return value should not be freed.
*
......@@ -889,7 +889,7 @@ gdk_screen_get_system_visual (GdkScreen * screen)
* The windowing system on which GTK+ is running
* may not support this capability, in which case %NULL will
* be returned. Even if a non-%NULL value is returned, its
* possible that the window's alpha channel won't be honored
* possible that the windows alpha channel won't be honored
* when displaying the window on the screen: in particular, for
* X an appropriate windowing manager and compositing manager
* must be running to provide appropriate display.
......@@ -989,7 +989,7 @@ gdk_screen_make_display_name (GdkScreen *screen)
* gdk_screen_get_active_window:
* @screen: a #GdkScreen
*
* Returns the screen's currently active window.
* Returns the screens currently active window.
*
* On X11, this is done by inspecting the _NET_ACTIVE_WINDOW property
* on the root window, as described in the
......
......@@ -276,7 +276,7 @@ typedef enum
* currently used windowing system backend uses for particular
* purposes. For example, on X11/Windows, the Control key is used for
* invoking menu shortcuts (accelerators), whereas on Apple computers
* it's the Command key (which correspond to %GDK_CONTROL_MASK and
* its the Command key (which correspond to %GDK_CONTROL_MASK and
* %GDK_MOD2_MASK, respectively).
*
* Since: 3.4
......
......@@ -40,7 +40,7 @@
* may be in the top 8 bits of the pixel, or may be in the lower 4 bits.
*
* There are several standard visuals. The visual returned by
* gdk_screen_get_system_visual() is the system's default visual.
* gdk_screen_get_system_visual() is the systems default visual.
*
* A number of functions are provided for determining the “best” available
* visual. For the purposes of making this determination, higher bit depths
......@@ -96,7 +96,7 @@ gdk_list_visuals (void)
/**
* gdk_visual_get_system:
*
* Get the system's default visual for the default GDK screen.
* Get the systems default visual for the default GDK screen.
* This is the visual for the root window of the display.
* The return value should not be freed.
*
......@@ -222,7 +222,7 @@ gdk_visual_get_best_with_both (gint depth,
* @count: return location for number of available depths
*
* This function returns the available bit depths for the default
* screen. It's equivalent to listing the visuals
* screen. Its equivalent to listing the visuals
* (gdk_list_visuals()) and then looking at the depth field in each
* visual, removing duplicates.
*
......@@ -244,7 +244,7 @@ gdk_query_depths (gint **depths,
* @count: return location for the number of available visual types
*
* This function returns the available visual types for the default
* screen. It's equivalent to listing the visuals
* screen. Its equivalent to listing the visuals
* (gdk_list_visuals()) and then looking at the type field in each
* visual, removing duplicates.
*
......
This diff is collapsed.
......@@ -122,9 +122,9 @@ typedef enum
* @GDK_HINT_ASPECT: aspect ratio fields are set
* @GDK_HINT_RESIZE_INC: resize increment fields are set
* @GDK_HINT_WIN_GRAVITY: window gravity field is set
* @GDK_HINT_USER_POS: indicates that the window's position was explicitly set
* @GDK_HINT_USER_POS: indicates that the windows position was explicitly set
* by the user
* @GDK_HINT_USER_SIZE: indicates that the window's size was explicitly set by
* @GDK_HINT_USER_SIZE: indicates that the windows size was explicitly set by
* the user
*
* Used to indicate which fields of a #GdkGeometry struct should be paid
......@@ -389,7 +389,7 @@ struct _GdkWindowAttr
* @win_gravity: window gravity, see gtk_window_set_gravity()
*
* The #GdkGeometry struct gives the window manager information about
* a window's geometry constraints. Normally you would set these on
* a windows geometry constraints. Normally you would set these on
* the GTK+ level using gtk_window_set_geometry_hints(). #GtkWindow
* then sets the hints on the #GdkWindow it creates.
*
......@@ -416,7 +416,7 @@ struct _GdkWindowAttr
* terminal will have a 1x1 character terminal area, and only terminal sizes on
* the “character grid” will be allowed.
*
* Here's an example of how the terminal example would be implemented, assuming
* Heres an example of how the terminal example would be implemented, assuming
* a terminal area widget called “terminal” and a toplevel window “toplevel”:
*
* |[<!-- language="C" -->
......@@ -631,7 +631,7 @@ void gdk_window_set_composited (GdkWindow *window,
/*
* This routine allows you to merge (ie ADD) child shapes to your
* own window's shape keeping its current shape and ADDING the child
* own windows shape keeping its current shape and ADDING the child
* shapes to it.
*
* - Raster
......
......@@ -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 APIs don't allow us to
* wait simultaneously for file descriptors and for events. So when we
* need to do a blocking wait that includes file descriptor activity, we
* push the actual work of calling select() to a helper thread (the
......@@ -102,7 +102,7 @@ static GQueue *current_events;
/* The default poll function for GLib; we replace this with our own
* Cocoa-aware version and then call the old version to do actual
* file descriptor polling. There's no actual need to chain to the
* file descriptor polling. Theres no actual need to chain to the
* old one; we could reimplement the same functionality from scratch,
* but since the default implementation does the right thing, why
* bother.
......
......@@ -253,7 +253,7 @@ gdk_window_impl_quartz_finalize (GObject *object)
* a view) too often. We do this by limiting the manual flushing done
* outside of expose calls to less than some frequency when measured over
* the last 4 flushes. This is a bit arbitray, but seems to make it possible
* for some quick manual flushes (such as gtkruler or gimp's marching ants)
* for some quick manual flushes (such as gtkruler or gimps marching ants)
* without hitting the max flush frequency.
*
* If drawable NULL, no flushing is done, only registering that a flush was
......@@ -1509,7 +1509,7 @@ gdk_window_quartz_reparent (GdkWindow *window,
}
/* Get the toplevel ordering from NSApp and update our own list. We do
* this on demand since the NSApp's list is not up to date directly
* this on demand since the NSApps list is not up to date directly
* after we get windowDidBecomeMain.
*/
static void
......
......@@ -48,7 +48,7 @@
*
* As such, the data type conversion from gdk selection targets to OLE2 CF_* data
* type specifiers is partially hardwired. Fixing this is complicated by (a) the
* fact that the widget's declared selection types aren't accessible in calls here
* fact that the widgets declared selection types aren't accessible in calls here
* that need to declare the corresponding OLE2 data types, and (b) there isn't a
* 1-1 correspondence between gdk target types and OLE2 types. The former needs
* some redesign in gtk dnd (something a gdk/gtk expert should do; I have tried
......@@ -375,7 +375,7 @@ get_suggested_action (DWORD grfKeyState)
}
/* Process pending events -- we don't want to service non-GUI events
* forever so do one iteration and then do more only if there's a
* forever so do one iteration and then do more only if theres a
* pending GDK event.
*/
static void
......
......@@ -1009,13 +1009,13 @@ apply_event_filters (GdkWindow *window,
* On Windows, transient windows will not have their own taskbar entries.
* Because of this, we must hide and restore groups of transients in both
* directions. That is, all transient children must be hidden or restored
* with this window, but if this window's transient owner also has a
* transient owner then this window's transient owner must be hidden/restored
* with this window, but if this windows transient owner also has a
* transient owner then this windows transient owner must be hidden/restored
* with this one. And etc, up the chain until we hit an ancestor that has no
* transient owner.
*
* It would be a good idea if applications don't chain transient windows
* together. There's a limit to how much evil GTK can try to shield you
* together. Theres a limit to how much evil GTK can try to shield you
* from.
*/
static void
......
......@@ -158,7 +158,7 @@ _gdk_other_api_failed (const gchar *where,
* have to be g_free()d. The buffer is of bounded size and reused
* cyclically. Thus the return value is valid only until that part of
* the buffer happens to get reused. This doesn't matter as this
* function's return value is used in debugging output right after the call,
* functions return value is used in debugging output right after the call,
* and the return value isn't used after that.
*/
static gchar *
......
......@@ -64,7 +64,7 @@ static guint theme_serial = 0;
/* cursor_cache holds a cache of non-pixmap cursors to avoid expensive
* libXcursor searches, cursors are added to it but only removed when
* their display is closed. We make the assumption that since there are
* a small number of display's and a small number of cursor's that this
* a small number of display’s and a small number of cursor’s that this
* list will stay small enough not to be a problem.
*/
static GSList* cursor_cache = NULL;
......
......@@ -1981,9 +1981,9 @@ gdk_x11_lookup_xdisplay (Display *xdisplay)
/**
* _gdk_x11_display_screen_for_xrootwin:
* @display: a #GdkDisplay
* @xrootwin: window ID for one of of the screen's of the display.
* @xrootwin: window ID for one of of the screens of the display.
*
* Given the root window ID of one of the screen's of a #GdkDisplay,
* Given the root window ID of one of the screens of a #GdkDisplay,
* finds the screen.
*
* Return value: (transfer none): the #GdkScreen corresponding to
......@@ -2473,7 +2473,7 @@ gdk_x11_register_standard_event_type (GdkDisplay *display,
}
/* look up the extension name for a given major opcode. grubs around in
* xlib to do it since a) it's already cached there b) XQueryExtension
* xlib to do it since a) its already cached there b) XQueryExtension
* emits protocol so we can't use it in an error handler.
*/
static const char *
......@@ -2788,8 +2788,8 @@ gdk_x11_display_error_trap_pop_ignored (GdkDisplay *display)
* @sm_client_id: the client id assigned by the session manager when the
* connection was opened, or %NULL to remove the property.
*
* Sets the `SM_CLIENT_ID` property on the application's leader window so that
* the window manager can save the application's state using the X11R6 ICCCM
* Sets the `SM_CLIENT_ID` property on the applications leader window so that
* the window manager can save the applications state using the X11R6 ICCCM
* session management protocol.
*
* See the X Session Management Library documentation for more information on
......
......@@ -1042,7 +1042,7 @@ gdk_x11_keymap_lookup_key (GdkKeymap *keymap,
* - add the group and level return.
* - change the interpretation of mods_rtrn as described
* in the docs for gdk_keymap_translate_keyboard_state()
* It's unchanged for ease of diff against the Xlib sources; don't
* Its unchanged for ease of diff against the Xlib sources; don't
* reformat it.
*/
static Bool
......@@ -1444,7 +1444,7 @@ gdk_x11_keymap_add_virtual_modifiers (GdkKeymap *keymap,
* @keycode: the hardware keycode from a key event
*
* Determines whether a particular key code represents a key that
* is a modifier. That is, it's a key that normally just affects
* is a modifier. That is, its a key that normally just affects
* the keyboard state and the behavior of other keys rather than
* producing a direct effect itself. This is only needed for code
* processing raw X events, since #GdkEventKey directly includes
......
......@@ -383,11 +383,11 @@ _gdk_x11_get_xatom_for_display_printf (GdkDisplay *display,
* gdk_x11_get_xatom_by_name:
* @atom_name: a string
*
* Returns the X atom for GDK's default display corresponding to @atom_name.
* Returns the X atom for GDKs default display corresponding to @atom_name.
* This function caches the result, so if called repeatedly it is much
* faster than XInternAtom(), which is a round trip to the server each time.
*
* Return value: a X atom for GDK's default display.
* Return value: a X atom for GDKs default display.
**/
Atom
gdk_x11_get_xatom_by_name (const gchar *atom_name)
......@@ -422,9 +422,9 @@ gdk_x11_get_xatom_name_for_display (GdkDisplay *display,
/**
* gdk_x11_get_xatom_name:
* @xatom: an X atom for GDK's default display
* @xatom: an X atom for GDKs default display
*
* Returns the name of an X atom for GDK's default display. This
* Returns the name of an X atom for GDKs 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,
......
......@@ -5521,7 +5521,7 @@ gdk_x11_get_server_time (GdkWindow *window)
*
* Returns the X resource (window) belonging to a #GdkWindow.
*
* Return value: the ID of @drawable's X resource.
* Return value: the ID of @drawables X resource.
**/
XID
gdk_x11_window_get_xid (GdkWindow *window)
......
......@@ -71,7 +71,7 @@
*
* Each action can have one or more proxy widgets. To act as an action proxy,
* widget needs to implement #GtkActivatable interface. Proxies mirror the state
* of the action and should change when the action's state changes. Properties
* of the action and should change when the actions state changes. Properties
* that are always mirrored by proxies are #GtkAction:sensitive and
* #GtkAction:visible. #GtkAction:gicon, #GtkAction:icon-name, #GtkAction:label,
* #GtkAction:short-label and #GtkAction:stock-id properties are only mirorred
......@@ -1356,7 +1356,7 @@ gtk_action_get_is_important (GtkAction *action)
* @action: a #GtkAction
* @always_show: %TRUE if menuitem proxies should always show their image
*
* Sets whether @action<!-- -->'s menu item proxies will ignore the
* Sets whether @action<!-- -->s menu item proxies will ignore the
* #GtkSettings:gtk-menu-images setting and always show their image, if available.
*
* Use this if the menu item would be useless or hard to use
......@@ -1391,7 +1391,7 @@ gtk_action_set_always_show_image (GtkAction *action,
* gtk_action_get_always_show_image:
* @action: a #GtkAction
*
* Returns whether @action<!-- -->'s menu item proxies will always
* Returns whether @action<!-- -->s menu item proxies will always
* show their image, if available.
*
* Returns: %TRUE if the menu item proxies will always show their image
......@@ -1835,7 +1835,7 @@ gtk_action_set_gicon (GtkAction *action,
*
* Gets the gicon of @action.
*
* Returns: (transfer none): The action's #GIcon if one is set.
* Returns: (transfer none): The actions #GIcon if one is set.
*
* Since: 2.16
*
......
......@@ -41,7 +41,7 @@
* application that can edit multiple documents, one group holding global
* actions (e.g. quit, about, new), and one group per document holding
* actions that act on that document (eg. save, cut/copy/paste, etc). Each
* window's menus would be constructed from a combination of two action
* windows menus would be constructed from a combination of two action
* groups.
*
* ## Accelerators ## {#Action-Accel}
......
......@@ -414,7 +414,7 @@ gtk_activatable_action_notify (GtkAction *action,
* This function adds a reference to the currently set related
* action for you, it also makes sure the #GtkActivatable->update()
* method is called when the related #GtkAction properties change
* and registers to the action's proxy list.
* and registers to the actions proxy list.
*
* > Be careful to call this before setting the local
* > copy of the #GtkAction property, since this function uses
......
......@@ -39,7 +39,7 @@ typedef struct _GtkActivatableIface GtkActivatableIface;
/**
* GtkActivatableIface:
* @update: Called to update the activatable when its related action's properties change.
* @update: Called to update the activatable when its related actions properties change.
* You must check the #GtkActivatable:use-action-appearance property only apply action
* properties that are meant to effect the appearance accordingly.
* @sync_action_properties: Called to update the activatable completely, this is called internally when
......
......@@ -48,7 +48,7 @@
* #GtkColorSelection widget contained within the dialog. Use this widget
* and its gtk_color_selection_get_current_color()
* function to gain access to the selected color. Connect a handler
* for this widget's #GtkColorSelection::color-changed signal to be notified
* for this widgets #GtkColorSelection::color-changed signal to be notified
* when the color changes.
*
* # GtkColorSelectionDialog as GtkBuildable # {#GtkColorSelectionDialog-BUILDER-UI}
......
......@@ -43,7 +43,7 @@
* since they are mostly used behind the scenes by #GtkStyleContext and
* #GtkCssProvider.
*
* #GtkGradient is deprecated. It was used internally by GTK's CSS engine
* #GtkGradient is deprecated. It was used internally by GTKs CSS engine
* to represent gradients. As its handling is not conforming to modern
* web standards, it is not used anymore. If you want to use gradients in
* your own code, please use Cairo directly.
......
......@@ -1057,7 +1057,7 @@ gtk_handle_box_get_snap_edge (GtkHandleBox *handle_box)
* gtk_handle_box_get_child_detached:
* @handle_box: a #GtkHandleBox
*
* Whether the handlebox's child is currently detached.
* Whether the handleboxs child is currently detached.
*
* Return value: %TRUE if the child is currently detached, otherwise %FALSE
*
......
......@@ -43,7 +43,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* a horizontal slider. To create one, use gtk_hscale_new_with_range().
*
* The position to show the current value, and the number of decimal places
* shown can be set using the parent #GtkScale class's functions.
* shown can be set using the parent #GtkScale classs functions.
*
* GtkHScale has been deprecated, use #GtkScale instead.
*/
......@@ -95,7 +95,7 @@ gtk_hscale_new (GtkAdjustment *adjustment)
*
* Creates a new horizontal scale widget that lets the user input a
* number between @min and @max (including @min and @max) with the
* increment @step. @step must be nonzero; it's the distance the
* increment @step. @step must be nonzero; its the distance the
* slider moves when using the arrow keys to adjust the scale value.
*
* Note that the way in which the precision is derived works best if @step
......
......@@ -289,7 +289,7 @@ gtk_icon_factory_new (void)
* gtk_icon_factory_add_default(). Then they pass the @stock_id to
* widgets such as #GtkImage to display the icon. Themes can provide
* an icon with the same name (such as "myapp-whatever-icon") to
* override your application's default icons. If an icon already
* override your applications default icons. If an icon already
* existed in @factory for @stock_id, it is unreferenced and replaced
* with the new @icon_set.
*
......@@ -1736,7 +1736,7 @@ icon_source_compare (gconstpointer ap, gconstpointer bp)
* This function copies @source, so you can reuse the same source immediately
* without affecting the icon set.
*
* An example of when you'd use this function: a web browser's "Back
* An example of when you'd use this function: a web browsers "Back
* to Previous Page" icon might point in a different direction in
* Hebrew and in English; it might look different when insensitive;
* and it might change size depending on toolbar mode (small/large
......@@ -1864,7 +1864,7 @@ gtk_icon_set_get_sizes (GtkIconSet *icon_set,
* a set of icons that represent “the same” logical concept in different states,
* different global text directions, and different sizes.
*
* So for example a web browser's “Back to Previous Page” icon might
* So for example a web browsers “Back to Previous Page” icon might
* point in a different direction in Hebrew and in English; it might
* look different when insensitive; and it might change size depending
* on toolbar mode (small/large icons). So a single icon set would
......
......@@ -542,7 +542,7 @@
* `"gtk-button"`, `"gtk-dialog"`. Applications
* can define other sizes.
*
* It's also possible to use custom icons for a given state, for example:
* Its also possible to use custom icons for a given state, for example:
*
* |[<!-- language="C" -->
* stock["my-stock-item"] =
......
......@@ -51,7 +51,7 @@ Prebuilt common menu/toolbar items and corresponding icons
* of the menu or toolbar item; and/or with an icon stored in a
* #GtkIconFactory. The connection between a
* #GtkStockItem and stock icons is purely conventional (by virtue of
* using the same stock ID); it's possible to register a stock item but
* using the same stock ID); its possible to register a stock item but
* no icon, and vice versa. Stock icons may have a RTL variant which gets
* used for right-to-left locales.
*/
......
......@@ -910,7 +910,7 @@ gtk_style_has_context (GtkStyle *style)
* @window: a #GdkWindow.
*
* Attaches a style to a window; this process allocates the
* colors and creates the GC's for the style - it specializes
* colors and creates the GCs for the style - it specializes
* it to a particular visual. The process may involve the creation
* of a new style if the style has already been attached to a
* window with a different style and visual.
......@@ -987,7 +987,7 @@ gtk_style_lookup_icon_set (GtkStyle *style,
* @color_name: the name of the logical color to look up
* @color: (out): the #GdkColor to fill in
*
* Looks up @color_name in the style's logical color mappings,
* Looks up @color_name in the styles logical color mappings,
* filling in @color and returning %TRUE if found, otherwise