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.
*
......
......@@ -54,7 +54,7 @@
* @Title: Windows
*
* A #GdkWindow is a (usually) rectangular region on the screen.
* It's a low-level object, used to implement high-level objects such as
* Its a low-level object, used to implement high-level objects such as
* #GtkWidget and #GtkWindow on the GTK+ level. A #GtkWindow is a toplevel
* window, the thing a user might think of as a “window” with a titlebar
* and so on; a #GtkWindow may contain many #GdkWindows. For example,
......@@ -2045,7 +2045,7 @@ _gdk_window_destroy (GdkWindow *window,
*
* Destroys the window system resources associated with @window and decrements @window's
* reference count. The window system resources for all children of @window are also
* destroyed, but the children's reference counts are not decremented.
* destroyed, but the childrens reference counts are not decremented.
*
* Note that a window will not be destroyed automatically when its reference count
* reaches zero. You must call this function yourself before that happens.
......@@ -2239,7 +2239,7 @@ gdk_window_has_native (GdkWindow *window)
* current window position, regardless of which events have been
* received or processed.
*
* The position coordinates are relative to the window's parent window.
* The position coordinates are relative to the windows parent window.
*
**/
void
......@@ -2287,7 +2287,7 @@ gdk_window_get_parent (GdkWindow *window)
*
* Obtains the parent of @window, as known to GDK. Works like
* gdk_window_get_parent() for normal windows, but returns the
* window's embedder for offscreen windows.
* windows embedder for offscreen windows.
*
* See also: gdk_offscreen_window_get_embedder()
*
......@@ -2310,14 +2310,14 @@ gdk_window_get_effective_parent (GdkWindow *window)
* gdk_window_get_toplevel:
* @window: a #GdkWindow
*
* Gets the toplevel window that's an ancestor of @window.
* Gets the toplevel window thats an ancestor of @window.
*
* Any window type but %GDK_WINDOW_CHILD is considered a
* toplevel window, as is a %GDK_WINDOW_CHILD window that
* has a root window as parent.
*
* Note that you should use gdk_window_get_effective_toplevel() when
* you want to get to a window's toplevel as seen on screen, because
* you want to get to a windows toplevel as seen on screen, because
* gdk_window_get_toplevel() will most likely not do what you expect
* if there are offscreen windows in the hierarchy.
*
......@@ -2342,7 +2342,7 @@ gdk_window_get_toplevel (GdkWindow *window)
* gdk_window_get_effective_toplevel:
* @window: a #GdkWindow
*
* Gets the toplevel window that's an ancestor of @window.
* Gets the toplevel window thats an ancestor of @window.
*
* Works like gdk_window_get_toplevel(), but treats an offscreen window's
* embedder as its parent, using gdk_window_get_effective_parent().
......@@ -2373,7 +2373,7 @@ gdk_window_get_effective_toplevel (GdkWindow *window)
*
* Gets the list of children of @window known to GDK.
* This function only returns children created via GDK,
* so for example it's useless when used with the root window;
* so for example its useless when used with the root window;
* it only returns windows an application created itself.
*
* The returned list must be freed, but the elements in the
......@@ -3710,7 +3710,7 @@ gdk_window_process_updates_with_mode (GdkWindow *window,
* Sends one or more expose events to @window. The areas in each
* expose event will cover the entire update area for the window (see
* gdk_window_invalidate_region() for details). Normally GDK calls
* gdk_window_process_all_updates() on your behalf, so there's no
* gdk_window_process_all_updates() on your behalf, so theres no
* need to call this function unless you want to force expose events
* to be delivered immediately and synchronously (vs. the usual
* case, where GDK delivers them in an idle handler). Occasionally
......@@ -3956,7 +3956,7 @@ gdk_window_invalidate_maybe_recurse_full (GdkWindow *window,
*
* GDK will call gdk_window_process_all_updates() on your behalf
* whenever your program returns to the main loop and becomes idle, so
* normally there's no need to do that manually, you just need to
* normally theres no need to do that manually, you just need to
* invalidate regions that you know should be redrawn.
*
* The @child_func parameter controls whether the region of
......@@ -4007,7 +4007,7 @@ gdk_window_invalidate_region_full (GdkWindow *window,
*
* GDK will call gdk_window_process_all_updates() on your behalf
* whenever your program returns to the main loop and becomes idle, so
* normally there's no need to do that manually, you just need to
* normally theres no need to do that manually, you just need to
* invalidate regions that you know should be redrawn.
*
* The @invalidate_children parameter controls whether the region of
......@@ -4041,7 +4041,7 @@ gdk_window_invalidate_region (GdkWindow *window,
*
* GDK will call gdk_window_process_all_updates() on your behalf
* whenever your program returns to the main loop and becomes idle, so
* normally there's no need to do that manually, you just need to
* normally theres no need to do that manually, you just need to
* invalidate regions that you know should be redrawn.
*
* This version of invalidation is used when you recieve expose events
......@@ -4068,7 +4068,7 @@ _gdk_window_invalidate_for_expose (GdkWindow *window,
* no longer have an invalid/dirty region; the update area is removed
* from @window and handed to you. If a window has no update area,
* gdk_window_get_update_area() returns %NULL. You are responsible for
* calling cairo_region_destroy() on the returned region if it's non-%NULL.
* calling cairo_region_destroy() on the returned region if its non-%NULL.
*
* Return value: the update area for @window
**/
......@@ -4254,7 +4254,7 @@ gdk_window_thaw_toplevel_updates_libgtk_only (GdkWindow *window)
* if you are redrawing the same region 400 times you may never
* notice, aside from noticing a speed problem. Enabling update
* debugging causes GTK to flicker slowly and noticeably, so you can
* see exactly what's being redrawn when, in what order.
* see exactly whats being redrawn when, in what order.
*
* The --gtk-debug=updates command line option passed to GTK+ programs
* enables this debug option at application startup time. That's
......@@ -5058,7 +5058,7 @@ gdk_window_restack (GdkWindow *window,
* top of the window stack (moves the window to the front of the
* Z-order).
*
* This function maps a window so it's visible onscreen. Its opposite
* This function maps a window so its visible onscreen. Its opposite
* is gdk_window_hide().
*
* When implementing a #GtkWidget, you should call this function on the widget's
......@@ -5547,8 +5547,8 @@ gdk_window_move_resize_internal (GdkWindow *window,
/**
* gdk_window_move:
* @window: a #GdkWindow
* @x: X coordinate relative to window's parent
* @y: Y coordinate relative to window's parent
* @x: X coordinate relative to windows parent
* @y: Y coordinate relative to windows parent
*
* Repositions a window relative to its parent window.
* For toplevel windows, window managers may ignore or modify the move;
......@@ -5594,8 +5594,8 @@ gdk_window_resize (GdkWindow *window,
/**
* gdk_window_move_resize:
* @window: a #GdkWindow
* @x: new X position relative to window's parent
* @y: new Y position relative to window's parent
* @x: new X position relative to windows parent
* @y: new Y position relative to windows parent
* @width: new width
* @height: new height
*
......@@ -5628,7 +5628,7 @@ gdk_window_move_resize (GdkWindow *window,
* strictly be necessary.
*
* For X11, a minimum area will be invalidated if the window has no
* subwindows, or if the edges of the window's parent do not extend
* subwindows, or if the edges of the windows parent do not extend
* beyond the edges of the window. In other cases, a multi-step process
* is used to scroll the window which may produce temporary visual
* artifacts and unnecessary invalidations.
......@@ -5815,7 +5815,7 @@ gdk_window_set_background_pattern (GdkWindow *window,
* returned and you'll have to query it yourself.
*
* Returns: (transfer none): The pattern to use for the background or
* %NULL to use the parent's background.
* %NULL to use the parents background.
*
* Since: 2.22
**/
......@@ -6200,12 +6200,12 @@ gdk_window_get_root_coords (GdkWindow *window,
/**
* gdk_window_coords_to_parent:
* @window: a child window
* @x: X coordinate in child's coordinate system
* @y: Y coordinate in child's coordinate system
* @x: X coordinate in childs coordinate system
* @y: Y coordinate in childs coordinate system
* @parent_x: (out) (allow-none): return location for X coordinate
* in parent's coordinate system, or %NULL
* in parents coordinate system, or %NULL
* @parent_y: (out) (allow-none): return location for Y coordinate
* in parent's coordinate system, or %NULL
* in parents coordinate system, or %NULL
*
* Transforms window coordinates from a child window to its parent
* window, where the parent window is the normal parent as returned by
......@@ -6260,10 +6260,10 @@ gdk_window_coords_to_parent (GdkWindow *window,
/**
* gdk_window_coords_from_parent:
* @window: a child window
* @parent_x: X coordinate in parent's coordinate system
* @parent_y: Y coordinate in parent's coordinate system
* @x: (out) (allow-none): return location for X coordinate in child's coordinate system
* @y: (out) (allow-none): return location for Y coordinate in child's coordinate system
* @parent_x: X coordinate in parents coordinate system
* @parent_y: Y coordinate in parents coordinate system
* @x: (out) (allow-none): return location for X coordinate in childs coordinate system
* @y: (out) (allow-none): return location for Y coordinate in childs coordinate system
*
* Transforms window coordinates from a parent window to a child
* window, where the parent window is the normal parent as returned by
......@@ -6453,7 +6453,7 @@ gdk_window_set_child_shapes (GdkWindow *window)
* for @window. See gdk_window_shape_combine_region().
*
* This function is distinct from gdk_window_set_child_shapes()
* because it includes @window's shape mask in the set of shapes to
* because it includes @windows shape mask in the set of shapes to
* be merged.
*/
void
......@@ -6579,7 +6579,7 @@ gdk_window_set_child_input_shapes (GdkWindow *window)
* for @window. See gdk_window_input_shape_combine_region().
*
* This function is distinct from gdk_window_set_child_input_shapes()
* because it includes @window's input shape mask in the set of
* because it includes @windows input shape mask in the set of
* shapes to be merged.
*
* Since: 2.10
......@@ -6651,7 +6651,7 @@ gdk_window_get_composited (GdkWindow *window)
* windows do not automatically have their contents drawn to
* the screen. Drawing is redirected to an offscreen buffer
* and an expose event is emitted on the parent of the composited
* window. It is the responsibility of the parent's expose handler
* window. It is the responsibility of the parents expose handler
* to manually merge the off-screen content onto the screen in
* whatever way it sees fit.
*
......@@ -9449,7 +9449,7 @@ gdk_window_set_modal_hint (GdkWindow *window,
* @skips_taskbar: %TRUE to skip the taskbar
*
* Toggles whether a window should appear in a task list or window
* list. If a window's semantic type as specified with
* list. If a windows semantic type as specified with
* gdk_window_set_type_hint() already fully describes the window, this
* function should not be called in addition,
* instead you should allow the window to be treated according to
......@@ -9472,7 +9472,7 @@ gdk_window_set_skip_taskbar_hint (GdkWindow *window,
* Toggles whether a window should appear in a pager (workspace
* switcher, or other desktop utility program that displays a small
* thumbnail representation of the windows on the desktop). If a
* window's semantic type as specified with gdk_window_set_type_hint()
* windows semantic type as specified with gdk_window_set_type_hint()
* already fully describes the window, this function should
* not be called in addition, instead you should
* allow the window to be treated according to standard policy for
......@@ -9567,7 +9567,7 @@ gdk_window_set_title (GdkWindow *window,
* When using GTK+, typically you should use gtk_window_set_role() instead
* of this low-level function.
*
* The window manager and session manager use a window's role to
* The window manager and session manager use a windows role to
* distinguish it from other kinds of window in the same application.
* When an application is restarted after being saved in a previous
* session, all windows with the same title and role are treated as
......@@ -9850,7 +9850,7 @@ gdk_window_deiconify (GdkWindow *window)
* gdk_window_stick:
* @window: a toplevel #GdkWindow
*
* “Pins” a window such that it's on all workspaces and does not scroll
* “Pins” a window such that its on all workspaces and does not scroll
* with viewports, for window managers that have scrollable viewports.
* (When using #GtkWindow, gtk_window_stick() may be more useful.)
*
......@@ -9858,7 +9858,7 @@ gdk_window_deiconify (GdkWindow *window)
* support, so may have no effect with many window managers. However,
* GDK will do the best it can to convince the window manager to stick
* the window. For window managers that don't support this operation,
* there's nothing you can do to force it to happen.
* theres nothing you can do to force it to happen.
*
**/
void
......
......@@ -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;