diff options
172 files changed, 751 insertions, 751 deletions
diff --git a/gdk/gdkdevice.c b/gdk/gdkdevice.c index d41380430d..a9ecf39b63 100644 --- a/gdk/gdkdevice.c +++ b/gdk/gdkdevice.c @@ -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 + * device’s 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 device’s range is mapped to the * entire screen or to a single window. * * Returns: %TRUE if the mode was successfully changed. diff --git a/gdk/gdkdevice.h b/gdk/gdkdevice.h index f9f853d6a4..a67f4b5890 100644 --- a/gdk/gdkdevice.h +++ b/gdk/gdkdevice.h @@ -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 device’s 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 device’s 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 device’s axes. * * A #GdkTimeCoord stores a single event in a motion history. */ diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c index c7cfabdfb4..acea8bd31f 100644 --- a/gdk/gdkdisplay.c +++ b/gdk/gdkdisplay.c @@ -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 @display’s 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 it’s 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 application’s initial set of * windows. * * GTK+ will call this function automatically after opening the first diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c index e191739aa5..11a8064561 100644 --- a/gdk/gdkevents.c +++ b/gdk/gdkevents.c @@ -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.window’s 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. #GdkWindow’s 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 it’s treated * as if the event had no state field. * * Return value: %TRUE if there was a state field in the event diff --git a/gdk/gdkevents.h b/gdk/gdkevents.h index a490548a7f..aebca9e4a3 100644 --- a/gdk/gdkevents.h +++ b/gdk/gdkevents.h @@ -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 GDK’s 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 user’s 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 diff --git a/gdk/gdkframeclock.c b/gdk/gdkframeclock.c index 26ce86347a..6a76cfa1aa 100644 --- a/gdk/gdkframeclock.c +++ b/gdk/gdkframeclock.c @@ -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, it’s the time used to compute the * animation position of everything in a frame. Outside of a frame, it's * the time of the conceptual “previous frame,” which may be either - * the actual previous frame time, or if that's too old, an updated + * the actual previous frame time, or if that’s too old, an updated * time. * * Since: 3.8 diff --git a/gdk/gdkframetimings.c b/gdk/gdkframetimings.c index 5f671d0ad5..0245d469d2 100644 --- a/gdk/gdkframetimings.c +++ b/gdk/gdkframetimings.c @@ -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 application’s 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 application’s display, such as latency and jitter. */ G_DEFINE_BOXED_TYPE (GdkFrameTimings, gdk_frame_timings, diff --git a/gdk/gdkkeys.c b/gdk/gdkkeys.c index e3297dc787..145a2e0629 100644 --- a/gdk/gdkkeys.c +++ b/gdk/gdkkeys.c @@ -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, it’s 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 @keymap’s windowing system backend * uses for a particular purpose. * * Note that this function always returns real hardware modifiers, not diff --git a/gdk/gdkpango.c b/gdk/gdkpango.c index 7b5227e107..ba46f2a68b 100644 --- a/gdk/gdkpango.c +++ b/gdk/gdkpango.c @@ -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 layout’s 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 layout’s 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 screen’s 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 screen’s font rendering settings. * * Return value: (transfer full): a new #PangoContext for @screen * diff --git a/gdk/gdkpixbuf-drawable.c b/gdk/gdkpixbuf-drawable.c index b6d238e390..2bf954baa7 100644 --- a/gdk/gdkpixbuf-drawable.c +++ b/gdk/gdkpixbuf-drawable.c @@ -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 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 diff --git a/gdk/gdkrectangle.c b/gdk/gdkrectangle.c index c06e719ecf..919c3a2a30 100644 --- a/gdk/gdkrectangle.c +++ b/gdk/gdkrectangle.c @@ -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 Cairo’s #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, @dest’s 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. diff --git a/gdk/gdkrgba.c b/gdk/gdkrgba.c index f60929f33f..88fcdf81ce 100644 --- a/gdk/gdkrgba.c +++ b/gdk/gdkrgba.c @@ -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 diff --git a/gdk/gdkscreen.c b/gdk/gdkscreen.c index 22479a930b..f54dcca37d 100644 --- a/gdk/gdkscreen.c +++ b/gdk/gdkscreen.c @@ -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 #PangoContext’s 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 system’s 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 window’s 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 screen’s currently active window. * * On X11, this is done by inspecting the _NET_ACTIVE_WINDOW property * on the root window, as described in the diff --git a/gdk/gdktypes.h b/gdk/gdktypes.h index ce1c2da801..7b46d242c5 100644 --- a/gdk/gdktypes.h +++ b/gdk/gdktypes.h @@ -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 + * it’s the Command key (which correspond to %GDK_CONTROL_MASK and * %GDK_MOD2_MASK, respectively). * * Since: 3.4 diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c index caea334d7d..89fa04589d 100644 --- a/gdk/gdkvisual.c +++ b/gdk/gdkvisual.c @@ -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 system’s 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 system’s 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. It’s 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. It’s equivalent to listing the visuals * (gdk_list_visuals()) and then looking at the type field in each * visual, removing duplicates. * diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c index 68414d0961..407695cb4f 100644 --- a/gdk/gdkwindow.c +++ b/gdk/gdkwindow.c @@ -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 + * It’s a low-level object, used to implement high-level objects such as * #GtkWidget and #GtkWindow on the GTK+ level. A #GtkWindow is a toplevel * window, the thing a user might think of as a “window” with a titlebar * 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 children’s 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 window’s 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. + * window’s 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 that’s 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 window’s 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 that’s 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 it’s 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 there’s 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 there’s 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 there’s 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 there’s 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 it’s 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 what’s 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 it’s 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 window’s parent + * @y: Y coordinate relative to window’s 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 window’s parent + * @y: new Y position relative to window’s 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 window’s 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 parent’s 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 child’s coordinate system + * @y: Y coordinate in child’s coordinate system * @parent_x: (out) (allow-none): return location for X coordinate - * in parent's coordinate system, or %NULL + * in parent’s coordinate system, or %NULL * @parent_y: (out) (allow-none): return location for Y coordinate - * in parent's coordinate system, or %NULL + * in parent’s 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 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 * * 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 @window’s 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 @window’s 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 parent’s 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 window’s 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() + * window’s 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 window’s 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 it’s on all workspaces and does not scroll * with viewports, for window managers that have scrollable viewports. * (When using #GtkWindow, gtk_window_stick() may be more useful.) * @@ -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. + * there’s nothing you can do to force it to happen. * **/ void diff --git a/gdk/gdkwindow.h b/gdk/gdkwindow.h index b3287d7c59..95bdca52d9 100644 --- a/gdk/gdkwindow.h +++ b/gdk/gdkwindow.h @@ -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 window’s 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 window’s 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 window’s 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 + * Here’s 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 window’s shape keeping its current shape and ADDING the child * shapes to it. * * - Raster diff --git a/gdk/quartz/gdkeventloop-quartz.c b/gdk/quartz/gdkeventloop-quartz.c index bc1ecbb3d8..33f935a81f 100644 --- a/gdk/quartz/gdkeventloop-quartz.c +++ b/gdk/quartz/gdkeventloop-quartz.c @@ -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 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. There’s 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. diff --git a/gdk/quartz/gdkwindow-quartz.c b/gdk/quartz/gdkwindow-quartz.c index f3d168bc23..fe798e5b2a 100644 --- a/gdk/quartz/gdkwindow-quartz.c +++ b/gdk/quartz/gdkwindow-quartz.c @@ -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 gimp’s 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 NSApp’s list is not up to date directly * after we get windowDidBecomeMain. */ static void diff --git a/gdk/win32/gdkdnd-win32.c b/gdk/win32/gdkdnd-win32.c index 6b350592a9..d74e74c9a0 100644 --- a/gdk/win32/gdkdnd-win32.c +++ b/gdk/win32/gdkdnd-win32.c @@ -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 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 * 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 there’s a * pending GDK event. */ static void diff --git a/gdk/win32/gdkevents-win32.c b/gdk/win32/gdkevents-win32.c index 6106318bfd..9757da8ea8 100644 --- a/gdk/win32/gdkevents-win32.c +++ b/gdk/win32/gdkevents-win32.c @@ -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 window’s transient owner also has a + * transient owner then this window’s 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. There’s a limit to how much evil GTK can try to shield you * from. */ static void diff --git a/gdk/win32/gdkmain-win32.c b/gdk/win32/gdkmain-win32.c index 81b7455487..459b0f5b61 100644 --- a/gdk/win32/gdkmain-win32.c +++ b/gdk/win32/gdkmain-win32.c @@ -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, + * function’s return value is used in debugging output right after the call, * and the return value isn't used after that. */ static gchar * diff --git a/gdk/x11/gdkcursor-x11.c b/gdk/x11/gdkcursor-x11.c index 3a6534fcef..b12a80d10f 100644 --- a/gdk/x11/gdkcursor-x11.c +++ b/gdk/x11/gdkcursor-x11.c @@ -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; diff --git a/gdk/x11/gdkdisplay-x11.c b/gdk/x11/gdkdisplay-x11.c index 5a157a5648..cd2215a944 100644 --- a/gdk/x11/gdkdisplay-x11.c +++ b/gdk/x11/gdkdisplay-x11.c @@ -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 screen’s 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 screen’s 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) it’s 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 application’s leader window so that + * the window manager can save the application’s state using the X11R6 ICCCM * session management protocol. * * See the X Session Management Library documentation for more information on diff --git a/gdk/x11/gdkkeys-x11.c b/gdk/x11/gdkkeys-x11.c index 2af3898f08..5d0c86e337 100644 --- a/gdk/x11/gdkkeys-x11.c +++ b/gdk/x11/gdkkeys-x11.c @@ -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 + * It’s 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, it’s 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 diff --git a/gdk/x11/gdkproperty-x11.c b/gdk/x11/gdkproperty-x11.c index 70d29ef3e4..33a48b13f4 100644 --- a/gdk/x11/gdkproperty-x11.c +++ b/gdk/x11/gdkproperty-x11.c @@ -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 GDK’s 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 GDK’s 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 GDK’s default display * - * Returns the name of an X atom for GDK's default display. This + * 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, diff --git a/gdk/x11/gdkwindow-x11.c b/gdk/x11/gdkwindow-x11.c index 788b57eac9..09ddb430be 100644 --- a/gdk/x11/gdkwindow-x11.c +++ b/gdk/x11/gdkwindow-x11.c @@ -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 @drawable’s X resource. **/ XID gdk_x11_window_get_xid (GdkWindow *window) diff --git a/gtk/deprecated/gtkaction.c b/gtk/deprecated/gtkaction.c index b9630ae2b3..0a6d672421 100644 --- a/gtk/deprecated/gtkaction.c +++ b/gtk/deprecated/gtkaction.c @@ -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 action’s 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 action’s #GIcon if one is set. * * Since: 2.16 * diff --git a/gtk/deprecated/gtkactiongroup.c b/gtk/deprecated/gtkactiongroup.c index 16dde2a70e..6b9b9adeb2 100644 --- a/gtk/deprecated/gtkactiongroup.c +++ b/gtk/deprecated/gtkactiongroup.c @@ -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 + * window’s menus would be constructed from a combination of two action * groups. * * ## Accelerators ## {#Action-Accel} diff --git a/gtk/deprecated/gtkactivatable.c b/gtk/deprecated/gtkactivatable.c index 3d36e391fd..f214b4a27e 100644 --- a/gtk/deprecated/gtkactivatable.c +++ b/gtk/deprecated/gtkactivatable.c @@ -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 action’s proxy list. * * > Be careful to call this before setting the local * > copy of the #GtkAction property, since this function uses diff --git a/gtk/deprecated/gtkactivatable.h b/gtk/deprecated/gtkactivatable.h index dd89d85b72..612dbba19a 100644 --- a/gtk/deprecated/gtkactivatable.h +++ b/gtk/deprecated/gtkactivatable.h @@ -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 action’s 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 diff --git a/gtk/deprecated/gtkcolorseldialog.c b/gtk/deprecated/gtkcolorseldialog.c index 18c651a125..7ff28ec866 100644 --- a/gtk/deprecated/gtkcolorseldialog.c +++ b/gtk/deprecated/gtkcolorseldialog.c @@ -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 widget’s #GtkColorSelection::color-changed signal to be notified * when the color changes. * * # GtkColorSelectionDialog as GtkBuildable # {#GtkColorSelectionDialog-BUILDER-UI} diff --git a/gtk/deprecated/gtkgradient.c b/gtk/deprecated/gtkgradient.c index e8759e05e7..7021d14fd3 100644 --- a/gtk/deprecated/gtkgradient.c +++ b/gtk/deprecated/gtkgradient.c @@ -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 GTK’s 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. diff --git a/gtk/deprecated/gtkhandlebox.c b/gtk/deprecated/gtkhandlebox.c index 36a788301c..3987c19106 100644 --- a/gtk/deprecated/gtkhandlebox.c +++ b/gtk/deprecated/gtkhandlebox.c @@ -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 handlebox’s child is currently detached. * * Return value: %TRUE if the child is currently detached, otherwise %FALSE * diff --git a/gtk/deprecated/gtkhscale.c b/gtk/deprecated/gtkhscale.c index 57d36ad559..58aa6e8b10 100644 --- a/gtk/deprecated/gtkhscale.c +++ b/gtk/deprecated/gtkhscale.c @@ -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 class’s 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; it’s 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 diff --git a/gtk/deprecated/gtkiconfactory.c b/gtk/deprecated/gtkiconfactory.c index b77c649ecd..efa7eb0036 100644 --- a/gtk/deprecated/gtkiconfactory.c +++ b/gtk/deprecated/gtkiconfactory.c @@ -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 application’s 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 browser’s "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 browser’s “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 diff --git a/gtk/deprecated/gtkrc.c b/gtk/deprecated/gtkrc.c index 8c27040b3e..6a30f9ea6f 100644 --- a/gtk/deprecated/gtkrc.c +++ b/gtk/deprecated/gtkrc.c @@ -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: + * It’s also possible to use custom icons for a given state, for example: * * |[<!-- language="C" --> * stock["my-stock-item"] = diff --git a/gtk/deprecated/gtkstock.c b/gtk/deprecated/gtkstock.c index 245d213c4c..e0bdccd5f0 100644 --- a/gtk/deprecated/gtkstock.c +++ b/gtk/deprecated/gtkstock.c @@ -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); it’s 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. */ diff --git a/gtk/deprecated/gtkstyle.c b/gtk/deprecated/gtkstyle.c index bf2a5ebbfa..3fb461c81e 100644 --- a/gtk/deprecated/gtkstyle.c +++ b/gtk/deprecated/gtkstyle.c @@ -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 GC’s 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 style’s logical color mappings, * filling in @color and returning %TRUE if found, otherwise * returning %FALSE. Do not cache the found mapping, because * it depends on the #GtkStyle and might change when a theme @@ -4063,14 +4063,14 @@ gtk_widget_get_default_style (void) * gtk_widget_style_attach: * @widget: a #GtkWidget * - * This function attaches the widget's #GtkStyle to the widget's + * This function attaches the widget’s #GtkStyle to the widget's * #GdkWindow. It is a replacement for * * |[ * widget->style = gtk_style_attach (widget->style, widget->window); * ]| * - * and should only ever be called in a derived widget's “realize” + * and should only ever be called in a derived widget’s “realize” * implementation which does not chain up to its parent class' * “realize” implementation, because one of the parent classes * (finally #GtkWidget) would attach the style itself. @@ -4160,7 +4160,7 @@ gtk_widget_ensure_style (GtkWidget *widget) * * Simply an accessor function that returns @widget->style. * - * Return value: (transfer none): the widget's #GtkStyle + * Return value: (transfer none): the widget’s #GtkStyle * * Deprecated:3.0: Use #GtkStyleContext instead */ @@ -4375,7 +4375,7 @@ gtk_widget_modify_fg (GtkWidget *widget, * See also gtk_widget_modify_style(). * * > Note that “no window” widgets (which have the %GTK_NO_WINDOW - * > flag set) draw on their parent container's window and thus may + * > flag set) draw on their parent container’s window and thus may * > not draw any background themselves. This is the case for e.g. * > #GtkLabel. * > @@ -4473,7 +4473,7 @@ gtk_widget_modify_text (GtkWidget *widget, * and #GtkTextView. See also gtk_widget_modify_style(). * * > Note that “no window” widgets (which have the %GTK_NO_WINDOW - * > flag set) draw on their parent container's window and thus may + * > flag set) draw on their parent container’s window and thus may * > not draw any background themselves. This is the case for e.g. * > #GtkLabel. * > @@ -4600,8 +4600,8 @@ gtk_widget_reset_rc_styles (GtkWidget *widget) * the name of a widget, you allow users or theme authors to apply * styles to that specific widget in their gtkrc * file. @path_reversed_p fills in the path in reverse order, - * i.e. starting with @widget's name instead of starting with the name - * of @widget's outermost ancestor. + * i.e. starting with @widget’s name instead of starting with the name + * of @widget’s outermost ancestor. * * Deprecated:3.0: Use gtk_widget_get_path() instead **/ @@ -4670,7 +4670,7 @@ gtk_widget_path (GtkWidget *widget, * @path_reversed: (out) (allow-none): location to store the reverse * class path as an allocated string, or %NULL * - * Same as gtk_widget_path(), but always uses the name of a widget's type, + * Same as gtk_widget_path(), but always uses the name of a widget’s type, * never uses a custom name set with gtk_widget_set_name(). * * Deprecated:3.0: Use gtk_widget_get_path() instead diff --git a/gtk/deprecated/gtktable.c b/gtk/deprecated/gtktable.c index c006e87ff2..4af47c49ed 100644 --- a/gtk/deprecated/gtktable.c +++ b/gtk/deprecated/gtktable.c @@ -626,7 +626,7 @@ gtk_table_new (guint rows, * @rows: The new number of rows. * @columns: The new number of columns. * - * If you need to change a table's size after + * If you need to change a table’s size after * it has been created, this function allows you to do so. * * Deprecated: 3.4: #GtkGrid resizes automatically. diff --git a/gtk/deprecated/gtkvscale.c b/gtk/deprecated/gtkvscale.c index a8cd171fd9..3944383b84 100644 --- a/gtk/deprecated/gtkvscale.c +++ b/gtk/deprecated/gtkvscale.c @@ -43,7 +43,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * a vertical 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 class’s functions. * * GtkVScale has been deprecated, use #GtkScale instead. */ @@ -93,7 +93,7 @@ gtk_vscale_new (GtkAdjustment *adjustment) * * Creates a new vertical 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; it’s 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 diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c index 3e17c339f8..736b7b7e59 100644 --- a/gtk/gtkaboutdialog.c +++ b/gtk/gtkaboutdialog.c @@ -2378,7 +2378,7 @@ close_cb (GtkAboutDialog *about) * @first_property_name: the name of the first property * @...: value of first property, followed by more properties, %NULL-terminated * - * This is a convenience function for showing an application's about box. + * This is a convenience function for showing an application’s about box. * The constructed dialog is associated with the parent window and * reused for future invocations of this function. * diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c index 8b2c696a03..15fa061376 100644 --- a/gtk/gtkaccelgroup.c +++ b/gtk/gtkaccelgroup.c @@ -47,7 +47,7 @@ * gtk_window_add_accel_group()). Usually you won't need to create a * #GtkAccelGroup directly; instead, when using #GtkUIManager, GTK+ * automatically sets up the accelerators for your menus in the ui - * manager's #GtkAccelGroup. + * manager’s #GtkAccelGroup. * * Note that “accelerators” are different from * “mnemonics”. Accelerators are shortcuts for diff --git a/gtk/gtkaccelmap.c b/gtk/gtkaccelmap.c index c5819d564e..ff6e417b2b 100644 --- a/gtk/gtkaccelmap.c +++ b/gtk/gtkaccelmap.c @@ -60,7 +60,7 @@ * “Gimp-Image”, “Abiword-Document” or “Gnumeric-Settings”. * The “Category1/.../Action” portion is most appropriately chosen by * the action the accelerator triggers, i.e. for accelerators on menu - * items, choose the item's menu path, e.g. “File/Save As”, + * items, choose the item’s menu path, e.g. “File/Save As”, * “Image/View/Zoom” or “Edit/Select All”. So a full valid accelerator * path may look like: “<Gimp-Toolbox>/File/Dialogs/Tool Options...”. * diff --git a/gtk/gtkaccessible.c b/gtk/gtkaccessible.c index 5845a00e46..e8fe6ca9f6 100644 --- a/gtk/gtkaccessible.c +++ b/gtk/gtkaccessible.c @@ -167,7 +167,7 @@ gtk_accessible_class_init (GtkAccessibleClass *klass) * Sets the #GtkWidget corresponding to the #GtkAccessible. * * @accessible will not hold a reference to @widget. - * It is the caller's responsibility to ensure that when @widget + * It is the caller’s responsibility to ensure that when @widget * is destroyed, the widget is unset by calling this function * again with @widget set to %NULL. * diff --git a/gtk/gtkactionable.c b/gtk/gtkactionable.c index 2be4783e25..12f8758284 100644 --- a/gtk/gtkactionable.c +++ b/gtk/gtkactionable.c @@ -168,7 +168,7 @@ gtk_actionable_get_action_target_value (GtkActionable *actionable) * will be associated with the same action, but with a different target * value for that action. Clicking on a particular button will activate * the action with the target of that button, which will typically cause - * the action's state to change to that value. Since the action's state + * the action’s state to change to that value. Since the action’s state * is now equal to the target value of the button, the button will now * be rendered as active (and the other buttons, with different targets, * rendered inactive). diff --git a/gtk/gtkadjustment.c b/gtk/gtkadjustment.c index 3173d2e37f..f550500a8f 100644 --- a/gtk/gtkadjustment.c +++ b/gtk/gtkadjustment.c @@ -468,7 +468,7 @@ gtk_adjustment_get_lower (GtkAdjustment *adjustment) * When setting multiple adjustment properties via their individual * setters, multiple #GtkAdjustment::changed signals will be emitted. However, since * the emission of the #GtkAdjustment::changed signal is tied to the emission of the - * #GObject::notify signals of the changed properties, it's possible + * #GObject::notify signals of the changed properties, it’s possible * to compress the #GtkAdjustment::changed signals into one by calling * g_object_freeze_notify() and g_object_thaw_notify() around the * calls to the individual setters. diff --git a/gtk/gtkappchooserwidget.h b/gtk/gtkappchooserwidget.h index 19aba13701..9b0625ab71 100644 --- a/gtk/gtkappchooserwidget.h +++ b/gtk/gtkappchooserwidget.h @@ -57,9 +57,9 @@ struct _GtkAppChooserWidget { * GtkAppChooserWidgetClass: * @parent_class: The parent class. * @application_selected: Signal emitted when an application item is - * selected from the widget's list. + * selected from the widget’s list. * @application_activated: Signal emitted when an application item is - * activated from the widget's list. + * activated from the widget’s list. * @populate_popup: Signal emitted when a context menu is about to * popup over an application item. */ diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c index c83790db02..25d6e18ee4 100644 --- a/gtk/gtkassistant.c +++ b/gtk/gtkassistant.c @@ -1805,7 +1805,7 @@ gtk_assistant_insert_page (GtkAssistant *assistant, * @page_num: the index of a page in the @assistant, * or -1 to remove the last page * - * Removes the @page_num's page from @assistant. + * Removes the @page_num’s page from @assistant. * * Since: 3.2 */ @@ -2164,7 +2164,7 @@ gtk_assistant_do_set_page_header_image (GtkAssistant *assistant, * Gets the header image for @page. * * Return value: (transfer none): the header image for @page, - * or %NULL if there's no header image for the page + * or %NULL if there’s no header image for the page * * Since: 2.10 * @@ -2255,7 +2255,7 @@ gtk_assistant_do_set_page_side_image (GtkAssistant *assistant, * Gets the side image for @page. * * Return value: (transfer none): the side image for @page, - * or %NULL if there's no side image for the page + * or %NULL if there’s no side image for the page * * Since: 2.10 * diff --git a/gtk/gtkassistant.h b/gtk/gtkassistant.h index 1a70e703bf..0f9de28af4 100644 --- a/gtk/gtkassistant.h +++ b/gtk/gtkassistant.h @@ -92,7 +92,7 @@ struct _GtkAssistant /** * GtkAssistantClass: * @parent_class: The parent class. - * @prepare: Signal emitted when a new page is set as the assistant's current page, before making the new page visible. + * @prepare: Signal emitted when a new page is set as the assistant’s current page, before making the new page visible. * @apply: Signal emitted when the apply button is clicked. * @close: Signal emitted either when the close button or last page apply button is clicked. * @cancel: Signal emitted when the cancel button is clicked. @@ -124,7 +124,7 @@ struct _GtkAssistantClass * @data: (closure): user data. * * A function used by gtk_assistant_set_forward_page_func() to know which - * is the next page given a current one. It's called both for computing the + * is the next page given a current one. It’s called both for computing the * next page when the user presses the “forward” button and for handling * the behavior of the “last” button. * diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c index 772038448c..6b0da96c53 100644 --- a/gtk/gtkbindings.c +++ b/gtk/gtkbindings.c @@ -130,7 +130,7 @@ * and “<Control>Left” key presses before it resorts to its default * bindings, and the match instructs it to abort (“unbind”) the search, * so the key presses are not consumed by this widget. As usual, further - * processing of the key presses, e.g. by an entry's parent widget, is + * processing of the key presses, e.g. by an entry’s parent widget, is * now possible. */ diff --git a/gtk/gtkbox.c b/gtk/gtkbox.c index 4a0613487a..16ef16cff1 100644 --- a/gtk/gtkbox.c +++ b/gtk/gtkbox.c @@ -1571,7 +1571,7 @@ gtk_box_get_preferred_height_for_width (GtkWidget *widget, /** * gtk_box_new: - * @orientation: the box's orientation. + * @orientation: the box’s orientation. * @spacing: the number of pixels to place by default between children. * * Creates a new #GtkBox. @@ -1835,7 +1835,7 @@ _gtk_box_get_spacing_set (GtkBox *box) * as well as widgets packed #GTK_PACK_END, in the order that these * widgets were added to @box. * - * A widget's position in the @box children list determines where + * A widget’s position in the @box children list determines where * the widget is packed into @box. A child widget at some position * in the list will be packed just after all other widgets of the * same packing type that appear earlier in the list. diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c index b2893e9a9d..e928bafed2 100644 --- a/gtk/gtkbuilder.c +++ b/gtk/gtkbuilder.c @@ -198,7 +198,7 @@ * respective objects. * * Additionally, since 3.10 a special <template> tag has been - * added to the format allowing one to define a widget class's components. + * added to the format allowing one to define a widget class’s components. */ #include "config.h" @@ -955,10 +955,10 @@ gtk_builder_new (void) * #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR * domain. * - * It's not really reasonable to attempt to handle failures of this + * It’s not really reasonable to attempt to handle failures of this * call. You should not use this function with untrusted files (ie: * files that are not part of your application). Broken #GtkBuilder - * files can easily crash your program, and it's possible that memory + * files can easily crash your program, and it’s possible that memory * was leaked leading up to the reported failure. The only reasonable * thing to do when an error is detected is to call g_error(). * @@ -1132,7 +1132,7 @@ _gtk_builder_extend_with_template (GtkBuilder *builder, * #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_RESOURCE_ERROR * domain. * - * It's not really reasonable to attempt to handle failures of this + * It’s not really reasonable to attempt to handle failures of this * call. The only reasonable thing to do when an error is detected is * to call g_error(). * @@ -1287,7 +1287,7 @@ gtk_builder_add_objects_from_resource (GtkBuilder *builder, * Upon errors 0 will be returned and @error will be assigned a * #GError from the #GTK_BUILDER_ERROR or #G_MARKUP_ERROR domain. * - * It's not really reasonable to attempt to handle failures of this + * It’s not really reasonable to attempt to handle failures of this * call. The only reasonable thing to do when an error is detected is * to call g_error(). * @@ -1562,8 +1562,8 @@ gtk_builder_connect_signals_default (GtkBuilder *builder, * This method is a simpler variation of gtk_builder_connect_signals_full(). * It uses symbols explicitly added to @builder with prior calls to * gtk_builder_add_callback_symbol(). In the case that symbols are not - * explicitly added; it uses #GModule's introspective features (by opening the module %NULL) - * to look at the application's symbol table. From here it tries to match + * explicitly added; it uses #GModule’s introspective features (by opening the module %NULL) + * to look at the application’s symbol table. From here it tries to match * the signal handler names given in the interface description with * symbols in the application and connects the signals. Note that this * function can only be called once, subsequent calls will do nothing. diff --git a/gtk/gtkbuilder.h b/gtk/gtkbuilder.h index 38e63a5217..65c6276a03 100644 --- a/gtk/gtkbuilder.h +++ b/gtk/gtkbuilder.h @@ -61,7 +61,7 @@ typedef struct _GtkBuilderPrivate GtkBuilderPrivate; * @GTK_BUILDER_ERROR_DUPLICATE_ID: An object id occurred twice. * @GTK_BUILDER_ERROR_OBJECT_TYPE_REFUSED: A specified object type is of the same type or * derived from the type of the composite class being extended with builder XML. - * @GTK_BUILDER_ERROR_TEMPLATE_MISMATCH: The wrong type was specified in a composite class's template XML + * @GTK_BUILDER_ERROR_TEMPLATE_MISMATCH: The wrong type was specified in a composite class’s template XML * * Error codes that identify various errors that can occur while using * #GtkBuilder. diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c index a9999852f2..0a3d8209b5 100644 --- a/gtk/gtkbutton.c +++ b/gtk/gtkbutton.c @@ -2895,10 +2895,10 @@ gtk_button_get_always_show_image (GtkButton *button) * gtk_button_get_event_window: * @button: a #GtkButton * - * Returns the button's event window if it is realized, %NULL otherwise. + * Returns the button’s event window if it is realized, %NULL otherwise. * This function should be rarely needed. * - * Return value: (transfer none): @button's event window. + * Return value: (transfer none): @button’s event window. * * Since: 2.22 */ diff --git a/gtk/gtkcellarea.c b/gtk/gtkcellarea.c index 1c41e21bee..7b283d6fc0 100644 --- a/gtk/gtkcellarea.c +++ b/gtk/gtkcellarea.c @@ -38,7 +38,7 @@ * # Requesting area sizes * * As outlined in - * [GtkWidget's geometry management section][geometry-management], + * [GtkWidget’s geometry management section][geometry-management], * GTK+ uses a height-for-width * geometry management system to compute the sizes of widgets and user * interfaces. #GtkCellArea uses the same semantics to calculate the @@ -52,7 +52,7 @@ * width and wrap the areas around, requesting height for more cell * areas when allocated less width. * - * It's also important for areas to maintain some cell + * It’s also important for areas to maintain some cell * alignments with areas rendered for adjacent rows (cells can * appear “columnized” inside an area even when the size of * cells are different in each row). For this reason the #GtkCellArea @@ -66,7 +66,7 @@ * The owning cell-layouting widget can create as many contexts as * it wishes to calculate sizes of rows which should receive the * same size in at least one orientation (horizontally or vertically), - * However, it's important that the same #GtkCellAreaContext which + * However, it’s important that the same #GtkCellAreaContext which * was used to request the sizes for a given #GtkTreeModel row be * used when rendering or processing events for that row. * @@ -89,7 +89,7 @@ * gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width); * ]| * - * Note that in this example it's not important to observe the + * Note that in this example it’s not important to observe the * returned minimum and natural width of the area for each row * unless the cell-layouting object is actually interested in the * widths of individual rows. The overall width is however stored @@ -132,7 +132,7 @@ * Requesting the height for width (or width for height) of an area is * a similar task except in this case the #GtkCellAreaContext does not * store the data (actually, it does not know how much space the layouting - * widget plans to allocate it for every row. It's up to the layouting + * widget plans to allocate it for every row. It’s up to the layouting * widget to render each row of data with the appropriate height and * width which was requested by the #GtkCellArea). * @@ -172,7 +172,7 @@ * In some cases the layouting widget is requested the height for an * arbitrary for_width, this is a special case for layouting widgets * who need to request size for tens of thousands of rows. For this - * case it's only important that the layouting widget calculate + * case it’s only important that the layouting widget calculate * one reasonably sized chunk of rows and return that height * synchronously. The reasoning here is that any layouting widget is * at least capable of synchronously calculating enough height to fill @@ -240,7 +240,7 @@ * * The #GtkCellArea drives keyboard focus from cell to cell in a way * similar to #GtkWidget. For layouting widgets that support giving - * focus to cells it's important to remember to pass %GTK_CELL_RENDERER_FOCUSED + * focus to cells it’s important to remember to pass %GTK_CELL_RENDERER_FOCUSED * to the area functions for the row that has focus and to tell the * area to paint the focus at render time. * @@ -1822,12 +1822,12 @@ gtk_cell_area_event (GtkCellArea *area, * @context: the #GtkCellAreaContext for this row of data. * @widget: the #GtkWidget that @area is rendering to * @cr: the #cairo_t to render with - * @background_area: the @widget relative coordinates for @area's background + * @background_area: the @widget relative coordinates for @area’s background * @cell_area: the @widget relative coordinates for @area * @flags: the #GtkCellRendererState for @area in this row. * @paint_focus: whether @area should paint focus on focused cells for focused rows or not. * - * Renders @area's cells according to @area's layout onto @widget at + * Renders @area’s cells according to @area’s layout onto @widget at * the given coordinates. * * Since: 3.0 @@ -2057,10 +2057,10 @@ gtk_cell_area_get_request_mode (GtkCellArea *area) * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL * @natural_width: (out) (allow-none): location to store the natural width, or %NULL * - * Retrieves a cell area's initial minimum and natural width. + * Retrieves a cell area’s initial minimum and natural width. * * @area will store some geometrical information in @context along the way; - * when requesting sizes over an arbitrary number of rows, it's not important + * when requesting sizes over an arbitrary number of rows, it’s not important * to check the @minimum_width and @natural_width of this call but rather to * consult gtk_cell_area_context_get_preferred_width() after a series of * requests. @@ -2090,11 +2090,11 @@ gtk_cell_area_get_preferred_width (GtkCellArea *area, * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL * @natural_height: (out) (allow-none): location to store the natural height, or %NULL * - * Retrieves a cell area's minimum and natural height if it would be given + * Retrieves a cell area’s minimum and natural height if it would be given * the specified @width. * * @area stores some geometrical information in @context along the way - * while calling gtk_cell_area_get_preferred_width(). It's important to + * while calling gtk_cell_area_get_preferred_width(). It’s important to * perform a series of gtk_cell_area_get_preferred_width() requests with * @context first and then call gtk_cell_area_get_preferred_height_for_width() * on each cell area individually to get the height for width of each @@ -2133,10 +2133,10 @@ gtk_cell_area_get_preferred_height_for_width (GtkCellArea *area, * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL * @natural_height: (out) (allow-none): location to store the natural height, or %NULL * - * Retrieves a cell area's initial minimum and natural height. + * Retrieves a cell area’s initial minimum and natural height. * * @area will store some geometrical information in @context along the way; - * when requesting sizes over an arbitrary number of rows, it's not important + * when requesting sizes over an arbitrary number of rows, it’s not important * to check the @minimum_height and @natural_height of this call but rather to * consult gtk_cell_area_context_get_preferred_height() after a series of * requests. @@ -2166,11 +2166,11 @@ gtk_cell_area_get_preferred_height (GtkCellArea *area, * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL * @natural_width: (out) (allow-none): location to store the natural width, or %NULL * - * Retrieves a cell area's minimum and natural width if it would be given + * Retrieves a cell area’s minimum and natural width if it would be given * the specified @height. * * @area stores some geometrical information in @context along the way - * while calling gtk_cell_area_get_preferred_height(). It's important to + * while calling gtk_cell_area_get_preferred_height(). It’s important to * perform a series of gtk_cell_area_get_preferred_height() requests with * @context first and then call gtk_cell_area_get_preferred_width_for_height() * on each cell area individually to get the height for width of each @@ -2869,7 +2869,7 @@ gtk_cell_area_is_activatable (GtkCellArea *area) * @area: a #GtkCellArea * @direction: the #GtkDirectionType * - * This should be called by the @area's owning layout widget + * This should be called by the @area’s owning layout widget * when focus is to be passed to @area, or moved within @area * for a given @direction and row data. * @@ -2895,7 +2895,7 @@ gtk_cell_area_focus (GtkCellArea *area, * @area: a #GtkCellArea * @context: the #GtkCellAreaContext in context with the current row data * @widget: the #GtkWidget that @area is rendering on - * @cell_area: the size and location of @area relative to @widget's allocation + * @cell_area: the size and location of @area relative to @widget’s allocation * @flags: the #GtkCellRendererState flags for @area for this row of data. * @edit_only: if %TRUE then only cell renderers that are %GTK_CELL_RENDERER_MODE_EDITABLE * will be activated. @@ -2999,9 +2999,9 @@ gtk_cell_area_get_focus_cell (GtkCellArea *area) * gtk_cell_area_add_focus_sibling: * @area: a #GtkCellArea * @renderer: the #GtkCellRenderer expected to have focus - * @sibling: the #GtkCellRenderer to add to @renderer's focus area + * @sibling: the #GtkCellRenderer to add to @renderer’s focus area * - * Adds @sibling to @renderer's focusable area, focus will be drawn + * Adds @sibling to @renderer’s focusable area, focus will be drawn * around @renderer and all of its siblings if @renderer can * focus for a given row. * @@ -3048,9 +3048,9 @@ gtk_cell_area_add_focus_sibling (GtkCellArea *area, * gtk_cell_area_remove_focus_sibling: * @area: a #GtkCellArea * @renderer: the #GtkCellRenderer expected to have focus - * @sibling: the #GtkCellRenderer to remove from @renderer's focus area + * @sibling: the #GtkCellRenderer to remove from @renderer’s focus area * - * Removes @sibling from @renderer's focus sibling list + * Removes @sibling from @renderer’s focus sibling list * (see gtk_cell_area_add_focus_sibling()). * * Since: 3.0 @@ -3085,9 +3085,9 @@ gtk_cell_area_remove_focus_sibling (GtkCellArea *area, * gtk_cell_area_is_focus_sibling: * @area: a #GtkCellArea * @renderer: the #GtkCellRenderer expected to have focus - * @sibling: the #GtkCellRenderer to check against @renderer's sibling list + * @sibling: the #GtkCellRenderer to check against @renderer’s sibling list * - * Returns whether @sibling is one of @renderer's focus siblings + * Returns whether @sibling is one of @renderer’s focus siblings * (see gtk_cell_area_add_focus_sibling()). * * Return value: %TRUE if @sibling is a focus sibling of @renderer @@ -3505,7 +3505,7 @@ gtk_cell_area_stop_editing (GtkCellArea *area, * gtk_cell_area_inner_cell_area: * @area: a #GtkCellArea * @widget: the #GtkWidget that @area is rendering onto - * @cell_area: the @widget relative coordinates where one of @area's cells + * @cell_area: the @widget relative coordinates where one of @area’s cells * is to be placed * @inner_area: (out): the return location for the inner cell area * @@ -3550,7 +3550,7 @@ gtk_cell_area_inner_cell_area (GtkCellArea *area, * @natural_size: (out) (allow-none): location to store the natural size, or %NULL * * This is a convenience function for #GtkCellArea implementations - * to request size for cell renderers. It's important to use this + * to request size for cell renderers. It’s important to use this * function to request size and then use gtk_cell_area_inner_cell_area() * at render and event time since this function will add padding * around the cell for focus painting. diff --git a/gtk/gtkcellarea.h b/gtk/gtkcellarea.h index ebb20a9c05..d82b2cf842 100644 --- a/gtk/gtkcellarea.h +++ b/gtk/gtkcellarea.h @@ -112,7 +112,7 @@ struct _GtkCellArea * @event: Handle an event in the area, this is generally used to activate * a cell at the event location for button events but can also be used * to generically pass events to #GtkWidgets drawn onto the area. - * @render: Actually render the area's cells to the specified rectangle, + * @render: Actually render the area’s cells to the specified rectangle, * @background_area should be correctly distributed to the cells * corresponding background areas. * @apply_attributes: Apply the cell attributes to the cells. This is diff --git a/gtk/gtkcellareacontext.c b/gtk/gtkcellareacontext.c index e90abc737e..f704e953a2 100644 --- a/gtk/gtkcellareacontext.c +++ b/gtk/gtkcellareacontext.c @@ -30,7 +30,7 @@ * #GtkTreeModel rows that are requested and rendered in the same context. * * #GtkCellLayout widgets can create any number of contexts in which to - * request and render groups of data rows. However, it's important that the + * request and render groups of data rows. However, it’s important that the * same context which was used to request sizes for a given #GtkTreeModel * row also be used for the same row when calling other #GtkCellArea APIs * such as gtk_cell_area_render() and gtk_cell_area_event(). @@ -330,7 +330,7 @@ gtk_cell_area_context_real_allocate (GtkCellAreaContext *context, * fetch information about the area it is being used for. * * For instance at #GtkCellAreaContextClass.allocate() time - * it's important to know details about any cell spacing + * it’s important to know details about any cell spacing * that the #GtkCellArea is configured with in order to * compute a proper allocation. * diff --git a/gtk/gtkcellareacontext.h b/gtk/gtkcellareacontext.h index cf35a626b7..c9f19c198c 100644 --- a/gtk/gtkcellareacontext.h +++ b/gtk/gtkcellareacontext.h @@ -57,9 +57,9 @@ struct _GtkCellAreaContext * @reset: Clear any previously stored information about requested and * allocated sizes for the context. * @get_preferred_height_for_width: Returns the aligned height for the given - * width that context must store while collecting sizes for it's rows. + * width that context must store while collecting sizes for it’s rows. * @get_preferred_width_for_height: Returns the aligned width for the given - * height that context must store while collecting sizes for it's rows. + * height that context must store while collecting sizes for it’s rows. */ struct _GtkCellAreaContextClass { diff --git a/gtk/gtkcelllayout.h b/gtk/gtkcelllayout.h index a0e17d509f..13cd9b23f9 100644 --- a/gtk/gtkcelllayout.h +++ b/gtk/gtkcelllayout.h @@ -46,7 +46,7 @@ typedef struct _GtkCellLayoutIface GtkCellLayoutIface; * @iter: a #GtkTreeIter indicating the row to set the value for * @data: user data passed to gtk_cell_layout_set_cell_data_func() * - * A function which should set the value of @cell_layout's cell renderer(s) + * A function which should set the value of @cell_layout’s cell renderer(s) * as appropriate. */ typedef void (* GtkCellLayoutDataFunc) (GtkCellLayout *cell_layout, diff --git a/gtk/gtkcellrenderer.c b/gtk/gtkcellrenderer.c index e72672228a..b58f66c1bb 100644 --- a/gtk/gtkcellrenderer.c +++ b/gtk/gtkcellrenderer.c @@ -46,7 +46,7 @@ * is rendered in the correct location using gtk_cell_renderer_render(). * * There are a number of rules that must be followed when writing a new - * #GtkCellRenderer. First and foremost, it's important that a certain set + * #GtkCellRenderer. First and foremost, it’s important that a certain set * of properties will always yield a cell renderer of the same size, * barring a #GtkStyle change. The #GtkCellRenderer also has a number of * generic properties that are expected to be honored by all children. @@ -962,7 +962,7 @@ gtk_cell_renderer_get_fixed_size (GtkCellRenderer *cell, * @xalign: the x alignment of the cell renderer * @yalign: the y alignment of the cell renderer * - * Sets the renderer's alignment within its available space. + * Sets the renderer’s alignment within its available space. * * Since: 2.18 **/ @@ -1032,7 +1032,7 @@ gtk_cell_renderer_get_alignment (GtkCellRenderer *cell, * @xpad: the x padding of the cell renderer * @ypad: the y padding of the cell renderer * - * Sets the renderer's padding. + * Sets the renderer’s padding. * * Since: 2.18 **/ @@ -1100,7 +1100,7 @@ gtk_cell_renderer_get_padding (GtkCellRenderer *cell, * @cell: A #GtkCellRenderer * @visible: the visibility of the cell * - * Sets the cell renderer's visibility. + * Sets the cell renderer’s visibility. * * Since: 2.18 **/ @@ -1125,7 +1125,7 @@ gtk_cell_renderer_set_visible (GtkCellRenderer *cell, * gtk_cell_renderer_get_visible: * @cell: A #GtkCellRenderer * - * Returns the cell renderer's visibility. + * Returns the cell renderer’s visibility. * * Returns: %TRUE if the cell renderer is visible * @@ -1144,7 +1144,7 @@ gtk_cell_renderer_get_visible (GtkCellRenderer *cell) * @cell: A #GtkCellRenderer * @sensitive: the sensitivity of the cell * - * Sets the cell renderer's sensitivity. + * Sets the cell renderer’s sensitivity. * * Since: 2.18 **/ @@ -1169,7 +1169,7 @@ gtk_cell_renderer_set_sensitive (GtkCellRenderer *cell, * gtk_cell_renderer_get_sensitive: * @cell: A #GtkCellRenderer * - * Returns the cell renderer's sensitivity. + * Returns the cell renderer’s sensitivity. * * Returns: %TRUE if the cell renderer is sensitive * @@ -1454,7 +1454,7 @@ gtk_cell_renderer_get_request_mode (GtkCellRenderer *cell) * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL * @natural_size: (out) (allow-none): location to store the natural size, or %NULL * - * Retreives a renderer's natural size when rendered to @widget. + * Retreives a renderer’s natural size when rendered to @widget. * * Since: 3.0 */ @@ -1502,7 +1502,7 @@ gtk_cell_renderer_get_preferred_width (GtkCellRenderer *cell, * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL * @natural_size: (out) (allow-none): location to store the natural size, or %NULL * - * Retreives a renderer's natural size when rendered to @widget. + * Retreives a renderer’s natural size when rendered to @widget. * * Since: 3.0 */ @@ -1551,7 +1551,7 @@ gtk_cell_renderer_get_preferred_height (GtkCellRenderer *cell, * @minimum_width: (out) (allow-none): location for storing the minimum size, or %NULL * @natural_width: (out) (allow-none): location for storing the preferred size, or %NULL * - * Retreives a cell renderers's minimum and natural width if it were rendered to + * Retreives a cell renderers’s minimum and natural width if it were rendered to * @widget with the specified @height. * * Since: 3.0 @@ -1601,7 +1601,7 @@ gtk_cell_renderer_get_preferred_width_for_height (GtkCellRenderer *cell, * @minimum_height: (out) (allow-none): location for storing the minimum size, or %NULL * @natural_height: (out) (allow-none): location for storing the preferred size, or %NULL * - * Retreives a cell renderers's minimum and natural height if it were rendered to + * Retreives a cell renderers’s minimum and natural height if it were rendered to * @widget with the specified @width. * * Since: 3.0 @@ -1651,7 +1651,7 @@ gtk_cell_renderer_get_preferred_height_for_width (GtkCellRenderer *cell, * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL * * Retrieves the minimum and natural size of a cell taking - * into account the widget's preference for height-for-width management. + * into account the widget’s preference for height-for-width management. * * Since: 3.0 */ diff --git a/gtk/gtkcellrenderer.h b/gtk/gtkcellrenderer.h index afa45ecf51..679b21b8ee 100644 --- a/gtk/gtkcellrenderer.h +++ b/gtk/gtkcellrenderer.h @@ -94,10 +94,10 @@ struct _GtkCellRenderer * GtkCellRendererClass: * @get_request_mode: Called to gets whether the cell renderer prefers * a height-for-width layout or a width-for-height layout. - * @get_preferred_width: Called to get a renderer's natural width. - * @get_preferred_height_for_width: Called to get a renderer's natural height for width. - * @get_preferred_height: Called to get a renderer's natural height. - * @get_preferred_width_for_height: Called to get a renderer's natural width for height. + * @get_preferred_width: Called to get a renderer’s natural width. + * @get_preferred_height_for_width: Called to get a renderer’s natural height for width. + * @get_preferred_height: Called to get a renderer’s natural height. + * @get_preferred_width_for_height: Called to get a renderer’s natural width for height. * @get_aligned_area: Called to get the aligned area used by @cell inside @cell_area. * @get_size: Called to get the width and height needed to render the cell. Deprecated: 3.0. * @render: Called to render the content of the #GtkCellRenderer. diff --git a/gtk/gtkcellview.c b/gtk/gtkcellview.c index d30f6d2f6a..f577dcd14b 100644 --- a/gtk/gtkcellview.c +++ b/gtk/gtkcellview.c @@ -1435,7 +1435,7 @@ gtk_cell_view_get_fit_model (GtkCellView *cell_view) * Sets whether @cell_view should request space to fit the entire #GtkTreeModel. * * This is used by #GtkComboBox to ensure that the cell view displayed on - * the combo box's button always gets enough space and does not resize + * the combo box’s button always gets enough space and does not resize * when selection changes. * * Since: 3.0 diff --git a/gtk/gtkcheckmenuitem.c b/gtk/gtkcheckmenuitem.c index 059b464d71..54c23bf21f 100644 --- a/gtk/gtkcheckmenuitem.c +++ b/gtk/gtkcheckmenuitem.c @@ -314,7 +314,7 @@ gtk_check_menu_item_new_with_mnemonic (const gchar *label) * @check_menu_item: a #GtkCheckMenuItem. * @is_active: boolean value indicating whether the check box is active. * - * Sets the active state of the menu item's check box. + * Sets the active state of the menu item’s check box. */ void gtk_check_menu_item_set_active (GtkCheckMenuItem *check_menu_item, diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c index 99a071386a..9c361f4767 100644 --- a/gtk/gtkclipboard.c +++ b/gtk/gtkclipboard.c @@ -79,7 +79,7 @@ * simply free the data blob. The latter is more useful when the * contents of clipboard reflect the internal state of a #GObject * (As an example, for the PRIMARY clipboard, when an entry widget - * provides the clipboard's contents the contents are simply the + * provides the clipboard’s contents the contents are simply the * text within the selected region.) If the contents change, the * entry widget can call gtk_clipboard_set_with_owner() to update * the timestamp for clipboard ownership, without having to worry @@ -337,7 +337,7 @@ clipboard_display_closed (GdkDisplay *display, * selections under the X window system. On Win32 the * #GDK_SELECTION_PRIMARY clipboard is essentially ignored.) * - * It's possible to have arbitrary named clipboards; if you do invent + * It’s possible to have arbitrary named clipboards; if you do invent * new clipboards, you should prefix the selection name with an * underscore (because the ICCCM requires that nonstandard atoms are * underscore-prefixed), and namespace it as well. For example, @@ -1123,7 +1123,7 @@ request_rich_text_received_func (GtkClipboard *clipboard, * * The @text parameter to @callback will contain the resulting rich * text if the request succeeded, or %NULL if it failed. The @length - * parameter will contain @text's length. This function can fail for + * parameter will contain @text’s length. This function can fail for * various reasons, in particular if the clipboard was empty or if the * contents of the clipboard could not be converted into rich text form. * @@ -1960,7 +1960,7 @@ gtk_clipboard_owner_change (GtkClipboard *clipboard, * function can be used to determine if a “Paste” menu item should be * insensitive or not. * - * If you want to see if there's text available on the clipboard, use + * If you want to see if there’s text available on the clipboard, use * gtk_clipboard_wait_is_text_available () instead. * * Return value: %TRUE if the target is available, %FALSE otherwise. diff --git a/gtk/gtkcombobox.c b/gtk/gtkcombobox.c index 5a33a01cd3..cf7bbb48e4 100644 --- a/gtk/gtkcombobox.c +++ b/gtk/gtkcombobox.c @@ -4255,14 +4255,14 @@ gtk_combo_box_set_column_span_column (GtkComboBox *combo_box, * gtk_combo_box_get_active: * @combo_box: A #GtkComboBox * - * Returns the index of the currently active item, or -1 if there's no + * Returns the index of the currently active item, or -1 if there’s no * active item. If the model is a non-flat treemodel, and the active item * is not an immediate child of the root of the tree, this function returns * `gtk_tree_path_get_indices (path)[0]`, where * `path` is the #GtkTreePath of the active item. * * Return value: An integer which is the index of the currently active item, - * or -1 if there's no active item. + * or -1 if there’s no active item. * * Since: 2.4 */ @@ -5067,7 +5067,7 @@ gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box, * Gets the current title of the menu in tearoff mode. See * gtk_combo_box_set_add_tearoffs(). * - * Returns: the menu's title in tearoff mode. This is an internal copy of the + * Returns: the menu’s title in tearoff mode. This is an internal copy of the * string which must not be freed. * * Since: 2.10 @@ -5100,7 +5100,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS; * @combo_box: a #GtkComboBox * @title: a title for the menu in tearoff mode * - * Sets the menu's title in tearoff mode. + * Sets the menu’s title in tearoff mode. * * Since: 2.10 * @@ -5134,7 +5134,7 @@ gtk_combo_box_set_title (GtkComboBox *combo_box, * @combo_box: a #GtkComboBox * @fixed: whether to use a fixed popup width * - * Specifies whether the popup's width should be a fixed width + * Specifies whether the popup’s width should be a fixed width * matching the allocated width of the combo box. * * Since: 3.0 @@ -5177,13 +5177,13 @@ gtk_combo_box_get_popup_fixed_width (GtkComboBox *combo_box) * gtk_combo_box_get_popup_accessible: * @combo_box: a #GtkComboBox * - * Gets the accessible object corresponding to the combo box's popup. + * Gets the accessible object corresponding to the combo box’s popup. * * This function is mostly intended for use by accessibility technologies; * applications should have little use for it. * * Returns: (transfer none): the accessible object corresponding - * to the combo box's popup. + * to the combo box’s popup. * * Since: 2.6 */ diff --git a/gtk/gtkcombobox.h b/gtk/gtkcombobox.h index a4277121a2..0cded838b7 100644 --- a/gtk/gtkcombobox.h +++ b/gtk/gtkcombobox.h @@ -52,7 +52,7 @@ struct _GtkComboBox * @parent_class: The parent class. * @changed: Signal is emitted when the active item is changed. * @format_entry_text: Signal which allows you to change how the text - * displayed in a combo box's entry is displayed. + * displayed in a combo box’s entry is displayed. */ struct _GtkComboBoxClass { diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c index 202668c9d2..db6e26f76e 100644 --- a/gtk/gtkcontainer.c +++ b/gtk/gtkcontainer.c @@ -86,8 +86,8 @@ * width-for-height). * * There are some things to keep in mind when implementing container widgets - * that make use of GTK+'s height for width geometry management system. First, - * it's important to note that a container must prioritize one of its + * that make use of GTK+’s height for width geometry management system. First, + * it’s important to note that a container must prioritize one of its * dimensions, that is to say that a widget or container can only have a * #GtkSizeRequestMode that is %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH or * %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT. However, every widget and container @@ -161,7 +161,7 @@ * The container will then move on to request the preferred height for each child by using * gtk_widget_get_preferred_height_for_width() and using the sizes stored in the #GtkRequestedSize array. * - * To allocate a height-for-width container, it's again important + * To allocate a height-for-width container, it’s again important * to consider that a container must prioritize one dimension over the other. So if * a container is a height-for-width container it must first allocate all widgets horizontally * using a #GtkRequestedSize array and gtk_distribute_natural_allocation() and then add any @@ -177,7 +177,7 @@ * that the container adds. Then vertical expand space should be added where appropriate and available * and the container should go on to actually allocating the child widgets. * - * See [GtkWidget's geometry management section][geometry-management] + * See [GtkWidget’s geometry management section][geometry-management] * to learn more about implementing height-for-width geometry management for widgets. * * # Child properties @@ -1554,9 +1554,9 @@ gtk_container_add (GtkContainer *container, * Note that @container will own a reference to @widget, and that this * may be the last reference held; so removing a widget from its * container can destroy that widget. If you want to use @widget - * again, you need to add a reference to it while it's not inside + * again, you need to add a reference to it while it’s not inside * a container, using g_object_ref(). If you don't want to use @widget - * again it's usually more efficient to simply destroy it directly + * again it’s usually more efficient to simply destroy it directly * using gtk_widget_destroy() since this will remove it from the * container and help break any circular reference count cycles. **/ @@ -1588,7 +1588,7 @@ _gtk_container_dequeue_resize_handler (GtkContainer *container) * Sets the resize mode for the container. * * The resize mode of a container determines whether a resize request - * will be passed to the container's parent, queued for later execution + * will be passed to the container’s parent, queued for later execution * or executed immediately. * * Deprecated: 3.12: Resize modes are deprecated. They aren't necessary @@ -1645,7 +1645,7 @@ gtk_container_get_resize_mode (GtkContainer *container) /** * gtk_container_set_reallocate_redraws: * @container: a #GtkContainer - * @needs_redraws: the new value for the container's @reallocate_redraws flag + * @needs_redraws: the new value for the container’s @reallocate_redraws flag * * Sets the @reallocate_redraws flag of the container to the given value. * @@ -2212,10 +2212,10 @@ gtk_container_get_focus_child (GtkContainer *container) * gtk_container_get_children: * @container: a #GtkContainer * - * Returns the container's non-internal children. See + * Returns the container’s non-internal children. See * gtk_container_forall() for details on what constitutes an "internal" child. * - * Return value: (element-type GtkWidget) (transfer container): a newly-allocated list of the container's non-internal children. + * Return value: (element-type GtkWidget) (transfer container): a newly-allocated list of the container’s non-internal children. **/ GList* gtk_container_get_children (GtkContainer *container) @@ -3041,7 +3041,7 @@ chain_widget_destroyed (GtkWidget *widget, * Sets a focus chain, overriding the one computed automatically by GTK+. * * In principle each widget in the chain should be a descendant of the - * container, but this is not enforced by this method, since it's allowed + * container, but this is not enforced by this method, since it’s allowed * to set the focus chain before you pack the widgets, or have a widget * in the chain that isn't always packed. The necessary checks are done * when the focus chain is actually traversed. @@ -3455,7 +3455,7 @@ gtk_container_should_propagate_draw (GtkContainer *container, * @container: a #GtkContainer * @child: a child of @container * @cr: Cairo context as passed to the container. If you want to use @cr - * in container's draw function, consider using cairo_save() and + * in container’s draw function, consider using cairo_save() and * cairo_restore() before calling this function. * * When a container receives a call to the draw function, it must send diff --git a/gtk/gtkcontainer.h b/gtk/gtkcontainer.h index 29d510fe63..00c3936b4d 100644 --- a/gtk/gtkcontainer.h +++ b/gtk/gtkcontainer.h @@ -64,7 +64,7 @@ struct _GtkContainer * @forall: Invokes callback on each child of container. * @set_focus_child: Sets the focused child of container. * @child_type: Returns the type of the children supported by the container. - * @composite_name: Gets a widget's composite name. Deprecated: 3.10. + * @composite_name: Gets a widget’s composite name. Deprecated: 3.10. * @set_child_property: Set a property on a child of container. * @get_child_property: Get a property from a child of container. * @get_path_for_child: Get path representing entire widget hierarchy diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c index 04cfab3457..2792acf79a 100644 --- a/gtk/gtkcssprovider.c +++ b/gtk/gtkcssprovider.c @@ -123,7 +123,7 @@ * background-color: #898989 * } * - * /* Theme notebooks, and anything that's within these */ + * /* Theme notebooks, and anything that’s within these */ * GtkNotebook { * background-color: #a939f0 * } @@ -269,7 +269,7 @@ * * # @ Rules * - * GTK+'s CSS supports the @import rule, in order to load another + * GTK+’s CSS supports the @import rule, in order to load another * CSS style sheet in addition to the currently parsed one. * * An example for using the @import rule: @@ -404,7 +404,7 @@ * </row> * <row> * <entry>alpha(@color, @f)</entry> - * <entry>Modifies passed color's alpha by a factor @f. @f is a + * <entry>Modifies passed color’s alpha by a factor @f. @f is a * floating point number. @f < 1.0 results in a more transparent * color while @f > 1.0 results in a more opaque color. * </entry> diff --git a/gtk/gtkcsssection.h b/gtk/gtkcsssection.h index 7966982f12..4f88eee0ee 100644 --- a/gtk/gtkcsssection.h +++ b/gtk/gtkcsssection.h @@ -44,7 +44,7 @@ G_BEGIN_DECLS * Animations](http://dev.w3.org/csswg/css3-animations/#keyframes) for details. Since 3.6 * * The different types of sections indicate parts of a CSS document as - * parsed by GTK's CSS parser. They are oriented towards the + * parsed by GTK’s CSS parser. They are oriented towards the * [CSS Grammar](http://www.w3.org/TR/CSS21/grammar.html), * but may contain extensions. * diff --git a/gtk/gtkcssstyleproperty.c b/gtk/gtkcssstyleproperty.c index 33d6bda256..5468d20fbc 100644 --- a/gtk/gtkcssstyleproperty.c +++ b/gtk/gtkcssstyleproperty.c @@ -363,7 +363,7 @@ _gtk_css_style_property_get_n_properties (void) * @id: the id of the property * * Gets the style property with the given id. All style properties (but not - * shorthand properties) are indexable by id so that it's easy to use arrays + * shorthand properties) are indexable by id so that it’s easy to use arrays * when doing style lookups. * * Returns: (transfer none): The style property with the given id diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c index cf09b250f3..e5b2c03c2f 100644 --- a/gtk/gtkdialog.c +++ b/gtk/gtkdialog.c @@ -52,7 +52,7 @@ * * Dialog boxes are a convenient way to prompt the user for a small amount * of input, e.g. to display a message, ask a question, or anything else - * that does not require extensive effort on the user's part. + * that does not require extensive effort on the user’s part. * * GTK+ treats a dialog as a window split vertically. The top section is a * #GtkVBox, and is where widgets such as a #GtkLabel or a #GtkEntry should @@ -842,7 +842,7 @@ gtk_dialog_new_empty (const gchar *title, * #GTK_DIALOG_DESTROY_WITH_PARENT flag. Buttons are from left to right, * so the first button in the list will be the leftmost button in the dialog. * - * Here's a simple example: + * Here’s a simple example: * |[<!-- language="C" --> * GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog", * main_app_window, @@ -914,7 +914,7 @@ get_response_data (GtkWidget *widget, * Adds an activatable widget to the action area of a #GtkDialog, * connecting a signal handler that will emit the #GtkDialog::response * signal on the dialog when the widget is activated. The widget is - * appended to the end of the dialog's action area. If you want to add a + * appended to the end of the dialog’s action area. If you want to add a * non-activatable widget, simply pack it into the @action_area field * of the #GtkDialog struct. **/ @@ -945,7 +945,7 @@ gtk_dialog_add_action_widget (GtkDialog *dialog, * Adds a button with the given text and sets things up so that * clicking the button will emit the #GtkDialog::response signal with * the given @response_id. The button is appended to the end of the - * dialog's action area. The button widget is returned, but usually + * dialog’s action area. The button widget is returned, but usually * you don't need it. * * Return value: (transfer none): the #GtkButton widget that was added @@ -1045,7 +1045,7 @@ gtk_dialog_add_buttons (GtkDialog *dialog, * @setting: %TRUE for sensitive * * Calls `gtk_widget_set_sensitive (widget, @setting)` - * for each widget in the dialog's action area with the given @response_id. + * for each widget in the dialog’s action area with the given @response_id. * A convenient way to sensitize/desensitize dialog buttons. **/ void @@ -1080,7 +1080,7 @@ gtk_dialog_set_response_sensitive (GtkDialog *dialog, * @dialog: a #GtkDialog * @response_id: a response ID * - * Sets the last widget in the dialog's action area with the given @response_id + * Sets the last widget in the dialog’s action area with the given @response_id * as the default widget for the dialog. Pressing “Enter” normally activates * the default widget. **/ @@ -1449,8 +1449,8 @@ gtk_dialog_set_alternative_button_order_valist (GtkDialog *dialog, /** * gtk_dialog_set_alternative_button_order: * @dialog: a #GtkDialog - * @first_response_id: a response id used by one @dialog's buttons - * @...: a list of more response ids of @dialog's buttons, terminated by -1 + * @first_response_id: a response id used by one @dialog’s buttons + * @...: a list of more response ids of @dialog’s buttons, terminated by -1 * * Sets an alternative button order. If the * #GtkSettings:gtk-alternative-button-order setting is set to %TRUE, @@ -1520,7 +1520,7 @@ gtk_dialog_set_alternative_button_order (GtkDialog *dialog, * @dialog: a #GtkDialog * @n_params: the number of response ids in @new_order * @new_order: (array length=n_params): an array of response ids of - * @dialog's buttons + * @dialog’s buttons * * Sets an alternative button order. If the * #GtkSettings:gtk-alternative-button-order setting is set to %TRUE, diff --git a/gtk/gtkdnd-quartz.c b/gtk/gtkdnd-quartz.c index 8420612e30..e1680f4957 100644 --- a/gtk/gtkdnd-quartz.c +++ b/gtk/gtkdnd-quartz.c @@ -597,7 +597,7 @@ gtk_drag_dest_get_target_list (GtkWidget *widget) /** * gtk_drag_dest_set_target_list: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * @target_list: (allow-none): list of droppable targets, or %NULL for none */ void @@ -630,7 +630,7 @@ gtk_drag_dest_set_target_list (GtkWidget *widget, /** * gtk_drag_dest_add_text_targets: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination */ void gtk_drag_dest_add_text_targets (GtkWidget *widget) @@ -650,7 +650,7 @@ gtk_drag_dest_add_text_targets (GtkWidget *widget) /** * gtk_drag_dest_add_image_targets: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination */ void gtk_drag_dest_add_image_targets (GtkWidget *widget) @@ -669,7 +669,7 @@ gtk_drag_dest_add_image_targets (GtkWidget *widget) /** * gtk_drag_dest_add_uri_targets: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination */ void gtk_drag_dest_add_uri_targets (GtkWidget *widget) @@ -940,7 +940,7 @@ gtk_drag_dest_drop (GtkWidget *widget, /** * gtk_drag_dest_set_track_motion: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * @track_motion: whether to accept all targets */ void @@ -960,7 +960,7 @@ gtk_drag_dest_set_track_motion (GtkWidget *widget, /** * gtk_drag_dest_get_track_motion: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination */ gboolean gtk_drag_dest_get_track_motion (GtkWidget *widget) @@ -1524,7 +1524,7 @@ gtk_drag_source_get_target_list (GtkWidget *widget) /** * gtk_drag_source_set_target_list: (method) - * @widget: a #GtkWidget that's a drag source + * @widget: a #GtkWidget that’s a drag source * @target_list: (allow-none): list of draggable targets, or %NULL for none */ void @@ -1554,7 +1554,7 @@ gtk_drag_source_set_target_list (GtkWidget *widget, /** * gtk_drag_source_add_text_targets: - * @widget: a #GtkWidget that's is a drag source + * @widget: a #GtkWidget that’s is a drag source * * Add the text targets supported by #GtkSelection to * the target list of the drag source. The targets @@ -1581,7 +1581,7 @@ gtk_drag_source_add_text_targets (GtkWidget *widget) /** * gtk_drag_source_add_image_targets: (method) - * @widget: a #GtkWidget that's is a drag source + * @widget: a #GtkWidget that’s is a drag source */ void gtk_drag_source_add_image_targets (GtkWidget *widget) @@ -1600,7 +1600,7 @@ gtk_drag_source_add_image_targets (GtkWidget *widget) /** * gtk_drag_source_add_uri_targets: (method) - * @widget: a #GtkWidget that's is a drag source + * @widget: a #GtkWidget that’s is a drag source */ void gtk_drag_source_add_uri_targets (GtkWidget *widget) diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c index 1c864ffa4a..f290aa6782 100644 --- a/gtk/gtkdnd.c +++ b/gtk/gtkdnd.c @@ -1357,10 +1357,10 @@ gtk_drag_dest_set_internal (GtkWidget *widget, * Sets a widget as a potential drop destination, and adds default behaviors. * * The default behaviors listed in @flags have an effect similar - * to installing default handlers for the widget's drag-and-drop signals + * to installing default handlers for the widget’s drag-and-drop signals * (#GtkWidget::drag-motion, #GtkWidget::drag-drop, ...). They all exist * for convenience. When passing #GTK_DEST_DEFAULT_ALL for instance it is - * sufficient to connect to the widget's #GtkWidget::drag-data-received + * sufficient to connect to the widget’s #GtkWidget::drag-data-received * signal to get primitive, but consistent drag-and-drop support. * * Things become more complicated when you try to preview the dragged data, @@ -1372,8 +1372,8 @@ gtk_drag_dest_set_internal (GtkWidget *widget, * Especially the later is dramatic, when your own #GtkWidget::drag-motion * handler calls gtk_drag_get_data() to inspect the dragged data. * - * There's no way to set a default action here, you can use the - * #GtkWidget::drag-motion callback for that. Here's an example which selects + * There’s no way to set a default action here, you can use the + * #GtkWidget::drag-motion callback for that. Here’s an example which selects * the action to use depending on whether the control key is pressed or not: * |[<!-- language="C" --> * static void @@ -1514,7 +1514,7 @@ gtk_drag_dest_get_target_list (GtkWidget *widget) /** * gtk_drag_dest_set_target_list: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * @target_list: (allow-none): list of droppable targets, or %NULL for none * * Sets the target types that this widget can accept from drag-and-drop. @@ -1549,7 +1549,7 @@ gtk_drag_dest_set_target_list (GtkWidget *widget, /** * gtk_drag_dest_add_text_targets: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * * Add the text targets supported by #GtkSelectionData to * the target list of the drag destination. The targets @@ -1576,7 +1576,7 @@ gtk_drag_dest_add_text_targets (GtkWidget *widget) /** * gtk_drag_dest_add_image_targets: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * * Add the image targets supported by #GtkSelectionData to * the target list of the drag destination. The targets @@ -1603,7 +1603,7 @@ gtk_drag_dest_add_image_targets (GtkWidget *widget) /** * gtk_drag_dest_add_uri_targets: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * * Add the URI targets supported by #GtkSelectionData to * the target list of the drag destination. The targets @@ -1630,7 +1630,7 @@ gtk_drag_dest_add_uri_targets (GtkWidget *widget) /** * gtk_drag_dest_set_track_motion: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * @track_motion: whether to accept all targets * * Tells the widget to emit #GtkWidget::drag-motion and @@ -1659,7 +1659,7 @@ gtk_drag_dest_set_track_motion (GtkWidget *widget, /** * gtk_drag_dest_get_track_motion: (method) - * @widget: a #GtkWidget that's a drag destination + * @widget: a #GtkWidget that’s a drag destination * * Returns whether the widget has been configured to always * emit #GtkWidget::drag-motion signals. @@ -2857,7 +2857,7 @@ gtk_drag_source_get_target_list (GtkWidget *widget) /** * gtk_drag_source_set_target_list: (method) - * @widget: a #GtkWidget that's a drag source + * @widget: a #GtkWidget that’s a drag source * @target_list: (allow-none): list of draggable targets, or %NULL for none * * Changes the target types that this widget offers for drag-and-drop. @@ -2893,7 +2893,7 @@ gtk_drag_source_set_target_list (GtkWidget *widget, /** * gtk_drag_source_add_text_targets: (method) - * @widget: a #GtkWidget that's is a drag source + * @widget: a #GtkWidget that’s is a drag source * * Add the text targets supported by #GtkSelectionData to * the target list of the drag source. The targets @@ -2920,7 +2920,7 @@ gtk_drag_source_add_text_targets (GtkWidget *widget) /** * gtk_drag_source_add_image_targets: (method) - * @widget: a #GtkWidget that's is a drag source + * @widget: a #GtkWidget that’s is a drag source * * Add the writable image targets supported by #GtkSelectionData to * the target list of the drag source. The targets @@ -2947,7 +2947,7 @@ gtk_drag_source_add_image_targets (GtkWidget *widget) /** * gtk_drag_source_add_uri_targets: (method) - * @widget: a #GtkWidget that's is a drag source + * @widget: a #GtkWidget that’s is a drag source * * Add the URI targets supported by #GtkSelectionData to * the target list of the drag source. The targets diff --git a/gtk/gtkdnd.h b/gtk/gtkdnd.h index 83fda61cee..c7060da857 100644 --- a/gtk/gtkdnd.h +++ b/gtk/gtkdnd.h @@ -40,14 +40,14 @@ G_BEGIN_DECLS /** * GtkDestDefaults: * @GTK_DEST_DEFAULT_MOTION: If set for a widget, GTK+, during a drag over this - * widget will check if the drag matches this widget's list of possible targets + * widget will check if the drag matches this widget’s list of possible targets * and actions. * GTK+ will then call gdk_drag_status() as appropriate. * @GTK_DEST_DEFAULT_HIGHLIGHT: If set for a widget, GTK+ will draw a highlight on * this widget as long as a drag is over this widget and the widget drag format * and action are acceptable. * @GTK_DEST_DEFAULT_DROP: If set for a widget, when a drop occurs, GTK+ will - * will check if the drag matches this widget's list of possible targets and + * will check if the drag matches this widget’s list of possible targets and * actions. If so, GTK+ will call gtk_drag_get_data() on behalf of the widget. * Whether or not the drop is successful, GTK+ will call gtk_drag_finish(). If * the action was a move, then if the drag was successful, then %TRUE will be diff --git a/gtk/gtkdrawingarea.c b/gtk/gtkdrawingarea.c index ca5f34e246..f2775ea803 100644 --- a/gtk/gtkdrawingarea.c +++ b/gtk/gtkdrawingarea.c @@ -35,7 +35,7 @@ * @See_also: #GtkImage * * The #GtkDrawingArea widget is used for creating custom user interface - * elements. It's essentially a blank widget; you can draw on it. After + * elements. It’s essentially a blank widget; you can draw on it. After * creating a drawing area, the application may want to connect to: * * - Mouse and button press signals to respond to input from @@ -93,9 +93,9 @@ * ]| * * Draw signals are normally delivered when a drawing area first comes - * onscreen, or when it's covered by another window and then uncovered. + * onscreen, or when it’s covered by another window and then uncovered. * You can also force an expose event by adding to the “damage region” - * of the drawing area's window; gtk_widget_queue_draw_area() and + * of the drawing area’s window; gtk_widget_queue_draw_area() and * gdk_window_invalidate_rect() are equally good ways to do this. * You'll then get a draw signal for the invalid region. * diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c index b10db21b94..7715e05ae7 100644 --- a/gtk/gtkentry.c +++ b/gtk/gtkentry.c @@ -7422,7 +7422,7 @@ gtk_entry_set_buffer (GtkEntry *entry, * @entry: a #GtkEntry * @text_area: (out): Return location for the text area. * - * Gets the area where the entry's text is drawn. This function is + * Gets the area where the entry’s text is drawn. This function is * useful when drawing something to the entry in a draw callback. * * If the entry is not realized, @text_area is filled with zeros. @@ -7800,7 +7800,7 @@ gtk_entry_get_text_length (GtkEntry *entry) /** * gtk_entry_set_activates_default: * @entry: a #GtkEntry - * @setting: %TRUE to activate window's default widget on Enter keypress + * @setting: %TRUE to activate window’s default widget on Enter keypress * * If @setting is %TRUE, pressing Enter in the @entry will activate the default * widget for the window containing the entry. This usually means that @@ -7939,8 +7939,8 @@ gtk_entry_get_has_frame (GtkEntry *entry) * @entry: a #GtkEntry * @border: (allow-none): a #GtkBorder, or %NULL * - * Sets %entry's inner-border property to @border, or clears it if %NULL - * is passed. The inner-border is the area around the entry's text, but + * Sets %entry’s inner-border property to @border, or clears it if %NULL + * is passed. The inner-border is the area around the entry’s text, but * inside its frame. * * If set, this property overrides the inner-border style property. @@ -7967,10 +7967,10 @@ gtk_entry_set_inner_border (GtkEntry *entry, * gtk_entry_get_inner_border: * @entry: a #GtkEntry * - * This function returns the entry's #GtkEntry:inner-border property. See + * This function returns the entry’s #GtkEntry:inner-border property. See * gtk_entry_set_inner_border() for more information. * - * Return value: (transfer none): the entry's #GtkBorder, or %NULL if none was set. + * Return value: (transfer none): the entry’s #GtkBorder, or %NULL if none was set. * * Since: 2.10 * @@ -8023,7 +8023,7 @@ gtk_entry_get_layout (GtkEntry *entry) * * Converts from a position in the entry contents (returned * by gtk_entry_get_text()) to a position in the - * entry's #PangoLayout (returned by gtk_entry_get_layout(), + * entry’s #PangoLayout (returned by gtk_entry_get_layout(), * with text retrieved via pango_layout_get_text()). * * Return value: byte index into the entry contents @@ -8061,7 +8061,7 @@ gtk_entry_layout_index_to_text_index (GtkEntry *entry, * @entry: a #GtkEntry * @text_index: byte index into the entry contents * - * Converts from a position in the entry's #PangoLayout (returned by + * Converts from a position in the entry’s #PangoLayout (returned by * gtk_entry_get_layout()) to a position in the entry contents * (returned by gtk_entry_get_text()). * @@ -8782,7 +8782,7 @@ gtk_entry_get_icon_storage_type (GtkEntry *entry, * @y: the y coordinate of the position to find * * Finds the icon at the given position and return its index. The - * position's coordinates are relative to the @entry's top left corner. + * position’s coordinates are relative to the @entry’s top left corner. * If @x, @y doesn't lie inside an icon, -1 is returned. * This function is intended for use in a #GtkWidget::query-tooltip * signal handler. @@ -8910,9 +8910,9 @@ gtk_entry_get_current_icon_drag_source (GtkEntry *entry) * gtk_entry_get_icon_area: * @entry: A #GtkEntry * @icon_pos: Icon position - * @icon_area: (out): Return location for the icon's area + * @icon_area: (out): Return location for the icon’s area * - * Gets the area where entry's icon at @icon_pos is drawn. + * Gets the area where entry’s icon at @icon_pos is drawn. * This function is useful when drawing something to the * entry in a draw callback. * @@ -10189,9 +10189,9 @@ gtk_entry_get_cursor_hadjustment (GtkEntry *entry) /** * gtk_entry_set_progress_fraction: * @entry: a #GtkEntry - * @fraction: fraction of the task that's been completed + * @fraction: fraction of the task that’s been completed * - * Causes the entry's progress indicator to “fill in” the given + * Causes the entry’s progress indicator to “fill in” the given * fraction of the bar. The fraction should be between 0.0 and 1.0, * inclusive. * @@ -10242,7 +10242,7 @@ gtk_entry_set_progress_fraction (GtkEntry *entry, * gtk_entry_get_progress_fraction: * @entry: a #GtkEntry * - * Returns the current fraction of the task that's been completed. + * Returns the current fraction of the task that’s been completed. * See gtk_entry_set_progress_fraction(). * * Return value: a fraction from 0.0 to 1.0 @@ -10312,7 +10312,7 @@ gtk_entry_get_progress_pulse_step (GtkEntry *entry) * @entry: a #GtkEntry * * Indicates that some progress is made, but you don't know how much. - * Causes the entry's progress indicator to enter “activity mode,” + * Causes the entry’s progress indicator to enter “activity mode,” * where a block bounces back and forth. Each call to * gtk_entry_progress_pulse() causes the block to move by a little bit * (the amount of movement per pulse is determined by diff --git a/gtk/gtkentrybuffer.c b/gtk/gtkentrybuffer.c index 067048ff97..cf72518078 100644 --- a/gtk/gtkentrybuffer.c +++ b/gtk/gtkentrybuffer.c @@ -42,7 +42,7 @@ * #GtkEntryBuffer may be derived from. Such a derived class might allow * text to be stored in an alternate location, such as non-pageable memory, * useful in the case of important passwords. Or a derived class could - * integrate with an application's concept of undo/redo. + * integrate with an application’s concept of undo/redo. * * Since: 2.18 */ diff --git a/gtk/gtkentrycompletion.c b/gtk/gtkentrycompletion.c index 869b64ebe0..a386adad9b 100644 --- a/gtk/gtkentrycompletion.c +++ b/gtk/gtkentrycompletion.c @@ -1403,7 +1403,7 @@ gtk_entry_completion_insert_action (GtkEntryCompletion *completion, * @index_: the index of the item to insert * @text: text of the item to insert * - * Inserts an action in @completion's action item list at position @index_ + * Inserts an action in @completion’s action item list at position @index_ * with text @text. If you want the action item to have markup, use * gtk_entry_completion_insert_action_markup(). * @@ -1426,7 +1426,7 @@ gtk_entry_completion_insert_action_text (GtkEntryCompletion *completion, * @index_: the index of the item to insert * @markup: markup of the item to insert * - * Inserts an action in @completion's action item list at position @index_ + * Inserts an action in @completion’s action item list at position @index_ * with markup @markup. * * Since: 2.4 @@ -1447,7 +1447,7 @@ gtk_entry_completion_insert_action_markup (GtkEntryCompletion *completion, * @completion: a #GtkEntryCompletion * @index_: the index of the item to delete * - * Deletes the action at @index_ from @completion's action list. + * Deletes the action at @index_ from @completion’s action list. * * Since: 2.4 */ @@ -1921,7 +1921,7 @@ gtk_entry_completion_real_insert_prefix (GtkEntryCompletion *completion, * @completion: a #GtkEntryCompletion * * Get the original text entered by the user that triggered - * the completion or %NULL if there's no completion ongoing. + * the completion or %NULL if there’s no completion ongoing. * * Returns: the prefix for the current completion * diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h index 0b88f71e32..34efa1fc0f 100644 --- a/gtk/gtkenums.h +++ b/gtk/gtkenums.h @@ -610,7 +610,7 @@ typedef enum * @GTK_SELECTION_SINGLE: Zero or one element may be selected. * @GTK_SELECTION_BROWSE: Exactly one element is selected. * In some circumstances, such as initially or during a search - * operation, it's possible for no element to be selected with + * operation, it’s possible for no element to be selected with * %GTK_SELECTION_BROWSE. What is really enforced is that the user * can't deselect a currently selected element except by selecting * another element. @@ -689,7 +689,7 @@ typedef enum * other, rather than vertically stacked * * Used to customize the appearance of a #GtkToolbar. Note that - * setting the toolbar style overrides the user's preferences + * setting the toolbar style overrides the user’s preferences * for the default toolbar style. Note that if the button has only * a label set and GTK_TOOLBAR_ICONS is used, the label will be * visible, and vice versa. diff --git a/gtk/gtkexpander.c b/gtk/gtkexpander.c index 270068fea3..a9bc69ab9a 100644 --- a/gtk/gtkexpander.c +++ b/gtk/gtkexpander.c @@ -1903,10 +1903,10 @@ gtk_expander_get_use_underline (GtkExpander *expander) /** * gtk_expander_set_use_markup: * @expander: a #GtkExpander - * @use_markup: %TRUE if the label's text should be parsed for markup + * @use_markup: %TRUE if the label’s text should be parsed for markup * * Sets whether the text of the label contains markup in - * [Pango's text markup language][PangoMarkupFormat]. + * [Pango’s text markup language][PangoMarkupFormat]. * See gtk_label_set_markup(). * * Since: 2.4 @@ -1938,11 +1938,11 @@ gtk_expander_set_use_markup (GtkExpander *expander, * gtk_expander_get_use_markup: * @expander: a #GtkExpander * - * Returns whether the label's text is interpreted as marked up with + * Returns whether the label’s text is interpreted as marked up with * the [Pango text markup language][PangoMarkupFormat]. * See gtk_expander_set_use_markup(). * - * Return value: %TRUE if the label's text will be parsed for markup + * Return value: %TRUE if the label’s text will be parsed for markup * * Since: 2.4 */ diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c index 90bc88a3a2..091ef50339 100644 --- a/gtk/gtkfilechooser.c +++ b/gtk/gtkfilechooser.c @@ -704,10 +704,10 @@ gtk_file_chooser_get_filename (GtkFileChooser *chooser) * @filename: (type filename): the filename to set as current * * Sets @filename as the current filename for the file chooser, by changing to - * the file's parent folder and actually selecting the file in list; all other + * the file’s parent folder and actually selecting the file in list; all other * files will be unselected. If the @chooser is in - * %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name will also appear in - * the dialog's file name entry. + * %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file’s base name will also appear in + * the dialog’s file name entry. * * Note that the file must exist, or nothing will be done except * for the directory change. @@ -733,7 +733,7 @@ gtk_file_chooser_get_filename (GtkFileChooser *chooser) * ]| * * In the first case, the file chooser will present the user with useful suggestions - * as to where to save his new file. In the second case, the file's existing location + * as to where to save his new file. In the second case, the file’s existing location * is already known, so the file chooser will use it. * * Return value: Not useful. @@ -996,10 +996,10 @@ gtk_file_chooser_set_current_name (GtkFileChooser *chooser, * change the extension of the typed filename based on the chosen format, say, * from “.jpg” to “.png”. * - * Returns: The raw text from the file chooser's “Name” entry. Free this with + * Returns: The raw text from the file chooser’s “Name” entry. Free this with * g_free(). Note that this string is not a full pathname or URI; it is * whatever the contents of the entry are. Note also that this string is in - * UTF-8 encoding, which is not necessarily the system's encoding for filenames. + * UTF-8 encoding, which is not necessarily the system’s encoding for filenames. * * Since: 3.10 **/ @@ -1057,9 +1057,9 @@ gtk_file_chooser_get_uri (GtkFileChooser *chooser) * @uri: the URI to set as current * * Sets the file referred to by @uri as the current file for the file chooser, - * by changing to the URI's parent folder and actually selecting the URI in the - * list. If the @chooser is %GTK_FILE_CHOOSER_ACTION_SAVE mode, the URI's base - * name will also appear in the dialog's file name entry. + * by changing to the URI’s parent folder and actually selecting the URI in the + * list. If the @chooser is %GTK_FILE_CHOOSER_ACTION_SAVE mode, the URI’s base + * name will also appear in the dialog’s file name entry. * * Note that the URI must exist, or nothing will be done except for the * directory change. @@ -1086,7 +1086,7 @@ gtk_file_chooser_get_uri (GtkFileChooser *chooser) * * * In the first case, the file chooser will present the user with useful suggestions - * as to where to save his new file. In the second case, the file's existing location + * as to where to save his new file. In the second case, the file’s existing location * is already known, so the file chooser will use it. * * Return value: Not useful. @@ -1418,9 +1418,9 @@ gtk_file_chooser_get_files (GtkFileChooser *chooser) * @error: (allow-none): location to store the error, or %NULL to ignore errors. * * Sets @file as the current filename for the file chooser, by changing - * to the file's parent folder and actually selecting the file in list. If - * the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name - * will also appear in the dialog's file name entry. + * to the file’s parent folder and actually selecting the file in list. If + * the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file’s base name + * will also appear in the dialog’s file name entry. * * If the file name isn't in the current folder of @chooser, then the current * folder of @chooser will be changed to the folder containing @filename. This @@ -2012,7 +2012,7 @@ gtk_file_chooser_add_shortcut_folder (GtkFileChooser *chooser, * @folder: (type filename): filename of the folder to remove * @error: (allow-none): location to store error, or %NULL * - * Removes a folder from a file chooser's list of shortcut folders. + * Removes a folder from a file chooser’s list of shortcut folders. * * Return value: %TRUE if the operation succeeds, %FALSE otherwise. * In the latter case, the @error will be set as appropriate. @@ -2110,7 +2110,7 @@ gtk_file_chooser_add_shortcut_folder_uri (GtkFileChooser *chooser, * @uri: URI of the folder to remove * @error: (allow-none): location to store error, or %NULL * - * Removes a folder URI from a file chooser's list of shortcut folders. + * Removes a folder URI from a file chooser’s list of shortcut folders. * * Return value: %TRUE if the operation succeeds, %FALSE otherwise. * In the latter case, the @error will be set as appropriate. diff --git a/gtk/gtkfilechooser.h b/gtk/gtkfilechooser.h index 6dff84ec2b..d1f5543e52 100644 --- a/gtk/gtkfilechooser.h +++ b/gtk/gtkfilechooser.h @@ -64,14 +64,14 @@ typedef enum * @GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM: The file chooser will present * its stock dialog to confirm about overwriting an existing file. * @GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME: The file chooser will - * terminate and accept the user's choice of a file name. + * terminate and accept the user’s choice of a file name. * @GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN: The file chooser will * continue running, so as to let the user select another file name. * * Used as a return value of handlers for the * #GtkFileChooser::confirm-overwrite signal of a #GtkFileChooser. This * value determines whether the file chooser will present the stock - * confirmation dialog, accept the user's choice of a filename, or + * confirmation dialog, accept the user’s choice of a filename, or * let the user choose another filename. * * Since: 2.8 diff --git a/gtk/gtkfilechooserbutton.c b/gtk/gtkfilechooserbutton.c index 43d8c84677..b8c2313e62 100644 --- a/gtk/gtkfilechooserbutton.c +++ b/gtk/gtkfilechooserbutton.c @@ -2774,7 +2774,7 @@ combo_box_changed_cb (GtkComboBox *combo_box, /* Calback for the "notify::popup-shown" signal on the combo box. * When the combo is popped up, we don't want the ROW_TYPE_EMPTY_SELECTION to be visible - * at all; otherwise we would be showing a “(None)” item in the combo box's popup. + * at all; otherwise we would be showing a “(None)” item in the combo box’s popup. * * However, when the combo box is *not* popped up, we want the empty-selection row * to be visible depending on the selection. @@ -3007,7 +3007,7 @@ gtk_file_chooser_button_set_title (GtkFileChooserButton *button, * Retrieves the title of the browse dialog used by @button. The returned value * should not be modified or freed. * - * Returns: a pointer to the browse dialog's title. + * Returns: a pointer to the browse dialog’s title. * * Since: 2.6 **/ @@ -3023,7 +3023,7 @@ gtk_file_chooser_button_get_title (GtkFileChooserButton *button) * gtk_file_chooser_button_get_width_chars: * @button: the button widget to examine. * - * Retrieves the width in characters of the @button widget's entry and/or label. + * Retrieves the width in characters of the @button widget’s entry and/or label. * * Returns: an integer width (in characters) that the button will use to size itself. * diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c index 8731f41769..771f38e007 100644 --- a/gtk/gtkfilechooserdialog.c +++ b/gtk/gtkfilechooserdialog.c @@ -123,7 +123,7 @@ * * - To choose a folder instead of a file. Use #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER. * - * Note that old versions of the file chooser's documentation suggested + * Note that old versions of the file chooser’s documentation suggested * using gtk_file_chooser_set_current_folder() in various * situations, with the intention of letting the application * suggest a reasonable default folder. This is no longer diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c index ec5cb3a548..bef5003fb0 100644 --- a/gtk/gtkfilechooserwidget.c +++ b/gtk/gtkfilechooserwidget.c @@ -2463,8 +2463,8 @@ put_recent_folder_in_pathbar (GtkFileChooserWidget *impl, GtkTreeIter *iter) } /* Sets the pathbar in the appropriate mode according to the current operation mode and action. This is the central function for - * dealing with the pathbar's widgets; as long as impl->action and impl->operation_mode are set correctly, then calling this - * function will update all the pathbar's widgets. + * dealing with the pathbar’s widgets; as long as impl->action and impl->operation_mode are set correctly, then calling this + * function will update all the pathbar’s widgets. */ static void path_bar_update (GtkFileChooserWidget *impl) @@ -3265,7 +3265,7 @@ switch_to_cwd (GtkFileChooserWidget *impl) } /* Sets the file chooser to showing Recent Files or $CWD, depending on the - * user's settings. + * user’s settings. */ static void set_startup_mode (GtkFileChooserWidget *impl) diff --git a/gtk/gtkfilesystemmodel.c b/gtk/gtkfilesystemmodel.c index c103619464..ff60a98bc3 100644 --- a/gtk/gtkfilesystemmodel.c +++ b/gtk/gtkfilesystemmodel.c @@ -99,7 +99,7 @@ * For this, the model keeps a model->n_nodes_valid field which is the count of valid nodes starting from the * beginning of the model->files array. When a node changes its information, or when a node gets deleted, that * node and the following ones get invalidated by simply setting model->n_nodes_valid to the array index of the - * node. If the model happens to need a node's row number and that node is in the model->files array after + * node. If the model happens to need a node’s row number and that node is in the model->files array after * model->n_nodes_valid, then the nodes get re-validated up to the sought node. See node_validate_rows() for * this logic. * diff --git a/gtk/gtkflowbox.c b/gtk/gtkflowbox.c index 22ad2cf1a1..e13df856dd 100644 --- a/gtk/gtkflowbox.c +++ b/gtk/gtkflowbox.c @@ -4278,7 +4278,7 @@ gtk_flow_box_get_column_spacing (GtkFlowBox *box) * @n_children: the minimum number of children per line * * Sets the minimum number of children to line up - * in @box's orientation before flowing. + * in @box’s orientation before flowing. * * Since: 3.12 */ @@ -4321,7 +4321,7 @@ gtk_flow_box_get_min_children_per_line (GtkFlowBox *box) * @n_children: the maximum number of children per line * * Sets the maximum number of children to request and - * allocate space for in @box's orientation. + * allocate space for in @box’s orientation. * * Setting the maximum number of children per line * limits the overall natural size request to be no more diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c index ec0f9267bc..4a2ac00109 100644 --- a/gtk/gtkframe.c +++ b/gtk/gtkframe.c @@ -421,7 +421,7 @@ gtk_frame_set_label (GtkFrame *frame, * gtk_frame_get_label: * @frame: a #GtkFrame * - * If the frame's label widget is a #GtkLabel, returns the + * If the frame’s label widget is a #GtkLabel, returns the * text in the label widget. (The frame will have a #GtkLabel * for the label widget if a non-%NULL argument was passed * to gtk_frame_new().) @@ -523,7 +523,7 @@ gtk_frame_get_label_widget (GtkFrame *frame) * 0.0 or 1.0 the gap in the frame won't be painted because the label * will be completely above or below the frame. * - * Sets the alignment of the frame widget's label. The + * Sets the alignment of the frame widget’s label. The * default values for a newly created frame are 0.0 and 0.5. **/ void @@ -561,11 +561,11 @@ gtk_frame_set_label_align (GtkFrame *frame, * gtk_frame_get_label_align: * @frame: a #GtkFrame * @xalign: (out) (allow-none): location to store X alignment of - * frame's label, or %NULL + * frame’s label, or %NULL * @yalign: (out) (allow-none): location to store X alignment of - * frame's label, or %NULL + * frame’s label, or %NULL * - * Retrieves the X and Y alignment of the frame's label. See + * Retrieves the X and Y alignment of the frame’s label. See * gtk_frame_set_label_align(). **/ void diff --git a/gtk/gtkgladecatalog.c b/gtk/gtkgladecatalog.c index c179ea271c..f9fb7df064 100644 --- a/gtk/gtkgladecatalog.c +++ b/gtk/gtkgladecatalog.c @@ -33,7 +33,7 @@ /* This function is referred to in gtk/glade/gtk-private-widgets.xml * and is used to ensure the private types for use in Glade while - * editing UI files that define GTK+'s various composite widget classes. + * editing UI files that define GTK+’s various composite widget classes. */ _GDK_EXTERN void gtk_glade_catalog_init (const gchar *catalog_name) diff --git a/gtk/gtkgrid.c b/gtk/gtkgrid.c index 15754e7a62..14e7dd6de6 100644 --- a/gtk/gtkgrid.c +++ b/gtk/gtkgrid.c @@ -36,7 +36,7 @@ * * GtkGrid is a container which arranges its child widgets in * rows and columns. It is a very similar to #GtkTable and #GtkBox, - * but it consistently uses #GtkWidget's #GtkWidget:margin and #GtkWidget:expand + * but it consistently uses #GtkWidget’s #GtkWidget:margin and #GtkWidget:expand * properties instead of custom child properties, and it fully supports * [height-for-width geometry management][geometry-management]. * diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c index 08d3aba862..2cd943f3ce 100644 --- a/gtk/gtkicontheme.c +++ b/gtk/gtkicontheme.c @@ -108,7 +108,7 @@ * or stock items, rather than directly, but looking up icons * directly is also simple. The #GtkIconTheme object acts * as a database of all the icons in the current theme. You - * can create new #GtkIconTheme objects, but it's much more + * can create new #GtkIconTheme objects, but it’s much more * efficient to use the standard icon theme for the #GdkScreen * so that the icon information is shared with other people * looking up icons. In the case where the default screen is @@ -538,7 +538,7 @@ gtk_icon_theme_class_init (GtkIconThemeClass *klass) /* Callback when the display that the icon theme is attached to - * is closed; unset the screen, and if it's the unique theme + * is closed; unset the screen, and if it’s the unique theme * for the screen, drop the reference */ static void @@ -637,7 +637,7 @@ unset_screen (GtkIconTheme *icon_theme) * @screen: a #GdkScreen * * Sets the screen for an icon theme; the screen is used - * to track the user's currently configured icon theme, + * to track the user’s currently configured icon theme, * which might be different for different screens. * * Since: 2.4 @@ -891,7 +891,7 @@ gtk_icon_theme_finalize (GObject *object) * one or more of the directories in @path with the same name * as the icon theme. (Themes from multiple of the path elements * are combined to allow themes to be extended by adding icons - * in the user's home directory.) + * in the user’s home directory.) * * In addition if an icon found isn't found either in the current * icon theme or the default icon theme, and an image file with @@ -5043,7 +5043,7 @@ gtk_icon_info_get_display_name (GtkIconInfo *icon_info) * of built-in icons is to allow an application or library * that uses themed icons to function requiring files to * be present in the file system. For instance, the default - * images for all of GTK+'s stock icons are registered + * images for all of GTK+’s stock icons are registered * as built-icons. * * In general, if you use gtk_icon_theme_add_builtin_icon() diff --git a/gtk/gtkiconview.c b/gtk/gtkiconview.c index f4184f3d6e..ce40e6894c 100644 --- a/gtk/gtkiconview.c +++ b/gtk/gtkiconview.c @@ -61,7 +61,7 @@ * Note that if the tree model is backed by an actual tree store (as * opposed to a flat list where the mapping to icons is obvious), * #GtkIconView will only display the first level of the tree and - * ignore the tree's branches. + * ignore the tree’s branches. */ #define SCROLL_EDGE_SIZE 15 @@ -1451,7 +1451,7 @@ adjust_wrap_width (GtkIconView *icon_view) * * padded size * This is the cell size plus the item padding on each side. * * spaced size - * This is the padded size plus the spacing. This is what's used for most + * This is the padded size plus the spacing. This is what’s used for most * calculations because it can (ab)use the following formula: * iconview_size = 2 * margin + n_items * spaced_size - spacing * So when reading this code and fixing my bugs where I confuse these two, be @@ -2182,7 +2182,7 @@ gtk_icon_view_remove_editable (GtkCellArea *area, * @start_editing: %TRUE if the specified cell should start being edited. * * Sets the current keyboard focus to be at @path, and selects it. This is - * useful when you want to focus the user's attention on a particular item. + * useful when you want to focus the user’s attention on a particular item. * If @cell is not %NULL, then focus is given to the cell specified by * it. Additionally, if @start_editing is %TRUE, then editing should be * started in the specified cell. @@ -4668,7 +4668,7 @@ gtk_icon_view_set_tooltip_cell (GtkIconView *icon_view, * tooltips the item returned will be the cursor item. When %TRUE, then any of * @model, @path and @iter which have been provided will be set to point to * that row and the corresponding model. @x and @y will always be converted - * to be relative to @icon_view's bin_window if @keyboard_tooltip is %FALSE. + * to be relative to @icon_view’s bin_window if @keyboard_tooltip is %FALSE. * * Return value: whether or not the given tooltip context points to a item * @@ -4761,11 +4761,11 @@ gtk_icon_view_set_tooltip_query_cb (GtkWidget *widget, /** * gtk_icon_view_set_tooltip_column: * @icon_view: a #GtkIconView - * @column: an integer, which is a valid column number for @icon_view's model + * @column: an integer, which is a valid column number for @icon_view’s model * * If you only plan to have simple (text-only) tooltips on full items, you * can use this function to have #GtkIconView handle these automatically - * for you. @column should be set to the column in @icon_view's model + * for you. @column should be set to the column in @icon_view’s model * containing the tooltip texts, or -1 to disable this feature. * * When enabled, #GtkWidget:has-tooltip will be set to %TRUE and @@ -4810,8 +4810,8 @@ gtk_icon_view_set_tooltip_column (GtkIconView *icon_view, * gtk_icon_view_get_tooltip_column: * @icon_view: a #GtkIconView * - * Returns the column of @icon_view's model which is being used for - * displaying tooltips on @icon_view's rows. + * Returns the column of @icon_view’s model which is being used for + * displaying tooltips on @icon_view’s rows. * * Return value: the index of the tooltip column that is currently being * used, or -1 if this is disabled. @@ -5254,7 +5254,7 @@ gtk_icon_view_set_text_column (GtkIconView *icon_view, * * Returns the column with text for @icon_view. * - * Returns: the text column, or -1 if it's unset. + * Returns: the text column, or -1 if it’s unset. * * Since: 2.6 */ @@ -5317,7 +5317,7 @@ gtk_icon_view_set_markup_column (GtkIconView *icon_view, * * Returns the column with markup text for @icon_view. * - * Returns: the markup column, or -1 if it's unset. + * Returns: the markup column, or -1 if it’s unset. * * Since: 2.6 */ @@ -5379,7 +5379,7 @@ gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view, * * Returns the column with pixbufs for @icon_view. * - * Returns: the pixbuf column, or -1 if it's unset. + * Returns: the pixbuf column, or -1 if it’s unset. * * Since: 2.6 */ @@ -6013,7 +6013,7 @@ gtk_icon_view_get_margin (GtkIconView *icon_view) * @item_padding: the item padding * * Sets the #GtkIconView:item-padding property which specifies the padding - * around each of the icon view's items. + * around each of the icon view’s items. * * Since: 2.18 */ diff --git a/gtk/gtkimage.c b/gtk/gtkimage.c index 686677bd21..abe536df14 100644 --- a/gtk/gtkimage.c +++ b/gtk/gtkimage.c @@ -50,7 +50,7 @@ * The #GtkImage widget displays an image. Various kinds of object * can be displayed as an image; most typically, you would load a * #GdkPixbuf ("pixel buffer") from a file, and then display that. - * There's a convenience function to do this, gtk_image_new_from_file(), + * There’s a convenience function to do this, gtk_image_new_from_file(), * used as follows: * |[<!-- language="C" --> * GtkWidget *image; @@ -705,7 +705,7 @@ gtk_image_new_from_stock (const gchar *stock_id, * * Creates a #GtkImage displaying an icon set. Sample stock sizes are * #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_SMALL_TOOLBAR. Instead of using - * this function, usually it's better to create a #GtkIconFactory, put + * this function, usually it’s better to create a #GtkIconFactory, put * your icon sets in the icon factory, add the icon factory to the * list of default factories with gtk_icon_factory_add_default(), and * then use gtk_image_new_from_stock(). This will allow themes to diff --git a/gtk/gtkimcontext.c b/gtk/gtkimcontext.c index e2c3257a19..09355c9eb7 100644 --- a/gtk/gtkimcontext.c +++ b/gtk/gtkimcontext.c @@ -194,7 +194,7 @@ G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE (GtkIMContext, gtk_im_context, G_TYPE_OBJECT * other means if turned off. * @set_surrounding: Called via gtk_im_context_set_surrounding() in response * to signal #GtkIMContext::retrieve-surrounding to update the input - * method's idea of the context around the cursor. It is not necessary to + * method’s idea of the context around the cursor. It is not necessary to * override this method even with input methods which implement * context-dependent behavior. The base implementation is sufficient for * gtk_im_context_get_surrounding() to work. diff --git a/gtk/gtkinfobar.c b/gtk/gtkinfobar.c index 902b5420ef..3beffdc9c7 100644 --- a/gtk/gtkinfobar.c +++ b/gtk/gtkinfobar.c @@ -886,7 +886,7 @@ gtk_info_bar_new_with_buttons (const gchar *first_button_text, * @setting: TRUE for sensitive * * Calls gtk_widget_set_sensitive (widget, setting) for each - * widget in the info bars's action area with the given response_id. + * widget in the info bars’s action area with the given response_id. * A convenient way to sensitize/desensitize dialog buttons. * * Since: 2.18 @@ -919,7 +919,7 @@ gtk_info_bar_set_response_sensitive (GtkInfoBar *info_bar, * @info_bar: a #GtkInfoBar * @response_id: a response ID * - * Sets the last widget in the info bar's action area with + * Sets the last widget in the info bar’s action area with * the given response_id as the default widget for the dialog. * Pressing “Enter” normally activates the default widget. * diff --git a/gtk/gtkkeyhash.c b/gtk/gtkkeyhash.c index 64d98aa53f..a46d72fe02 100644 --- a/gtk/gtkkeyhash.c +++ b/gtk/gtkkeyhash.c @@ -529,7 +529,7 @@ _gtk_key_hash_lookup (GtkKeyHash *key_hash, * @event: a #GtkEvent * * Looks up the best matching entry or entries in the hash table for a - * given keyval/modifiers pair. It's better to use + * given keyval/modifiers pair. It’s better to use * _gtk_key_hash_lookup() if you have the original #GdkEventKey * available. The results are sorted so that entries with less * modifiers come before entries with more modifiers. diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c index 7cb976a2e9..64ff248713 100644 --- a/gtk/gtklabel.c +++ b/gtk/gtklabel.c @@ -101,8 +101,8 @@ * * Mnemonics automatically activate any activatable widget the label is * inside, such as a #GtkButton; if the label is not inside the - * mnemonic's target widget, you have to tell the label about the target - * using gtk_label_set_mnemonic_widget(). Here's a simple example where + * mnemonic’s target widget, you have to tell the label about the target + * using gtk_label_set_mnemonic_widget(). Here’s a simple example where * the label is inside a button: * * |[<!-- language="C" --> @@ -112,7 +112,7 @@ * gtk_container_add (GTK_CONTAINER (button), label); * ]| * - * There's a convenience function to create buttons with a mnemonic label + * There’s a convenience function to create buttons with a mnemonic label * already inside: * * |[<!-- language="C" --> @@ -137,7 +137,7 @@ * fonts, etc.), label text can be provided in a simple * [markup format][PangoMarkupFormat]. * - * Here's how to create a label with a small font: + * Here’s how to create a label with a small font: * |[<!-- language="C" --> * label = gtk_label_new (NULL); * gtk_label_set_markup (GTK_LABEL (label), "<small>Small text</small>"); @@ -1948,7 +1948,7 @@ gtk_label_set_mnemonic_widget (GtkLabel *label, * Retrieves the target of the mnemonic (keyboard shortcut) of this * label. See gtk_label_set_mnemonic_widget(). * - * Return value: (transfer none): the target of the label's mnemonic, + * Return value: (transfer none): the target of the label’s mnemonic, * or %NULL if none has been set and the default algorithm will be used. **/ GtkWidget * @@ -2596,7 +2596,7 @@ gtk_label_set_markup_internal (GtkLabel *label, * * Parses @str which is marked up with the * [Pango text markup language][PangoMarkupFormat], setting the - * label's text and attribute list based on the parse results. If the @str is + * label’s text and attribute list based on the parse results. If the @str is * external data, you may need to escape it with g_markup_escape_text() or * g_markup_printf_escaped()<!-- -->: * |[<!-- language="C" --> @@ -2632,7 +2632,7 @@ gtk_label_set_markup (GtkLabel *label, * * Parses @str which is marked up with the * [Pango text markup language][PangoMarkupFormat], - * setting the label's text and attribute list based on the parse results. + * setting the label’s text and attribute list based on the parse results. * If characters in @str are preceded by an underscore, they are underlined * indicating that they represent a keyboard accelerator called a mnemonic. * @@ -2984,14 +2984,14 @@ gtk_label_get_max_width_chars (GtkLabel *label) * @wrap: the setting * * Toggles line wrapping within the #GtkLabel widget. %TRUE makes it break - * lines if text exceeds the widget's size. %FALSE lets the text get cut off + * lines if text exceeds the widget’s size. %FALSE lets the text get cut off * by the edge of the widget if it exceeds the widget size. * * Note that setting line wrapping to %TRUE does not make the label - * wrap at its parent container's width, because GTK+ widgets + * wrap at its parent container’s width, because GTK+ widgets * conceptually can't make their requisition depend on the parent - * container's size. For a label that wraps at a specific position, - * set the label's width using gtk_widget_set_size_request(). + * container’s size. For a label that wraps at a specific position, + * set the label’s width using gtk_widget_set_size_request(). **/ void gtk_label_set_line_wrap (GtkLabel *label, @@ -3133,8 +3133,8 @@ gtk_label_clear_layout (GtkLabel *label) * @width: the width to measure with in pango units, or -1 for infinite * * Gets a layout that can be used for measuring sizes. The returned - * layout will be identical to the label's layout except for the - * layout's width, which will be set to @width. Do not modify the returned + * layout will be identical to the label’s layout except for the + * layout’s width, which will be set to @width. Do not modify the returned * layout. * * Returns: a new reference to a pango layout @@ -4300,7 +4300,7 @@ gtk_label_set_uline_text_internal (GtkLabel *label, * @label: a #GtkLabel * @str: a string * - * Sets the label's text from the string @str. + * Sets the label’s text from the string @str. * If characters in @str are preceded by an underscore, they are underlined * indicating that they represent a keyboard accelerator called a mnemonic. * The mnemonic key can be used to activate another widget, chosen @@ -5449,7 +5449,7 @@ gtk_label_select_region (GtkLabel *label, * @end: (out): return location for end of selection, as a character offset * * Gets the selected range of characters in the label, returning %TRUE - * if there's a selection. + * if there’s a selection. * * Return value: %TRUE if selection is non-empty **/ @@ -5571,10 +5571,10 @@ gtk_label_get_layout_offsets (GtkLabel *label, /** * gtk_label_set_use_markup: * @label: a #GtkLabel - * @setting: %TRUE if the label's text should be parsed for markup. + * @setting: %TRUE if the label’s text should be parsed for markup. * * Sets whether the text of the label contains markup in - * [Pango's text markup language][PangoMarkupFormat]. + * [Pango’s text markup language][PangoMarkupFormat]. * See gtk_label_set_markup(). **/ void @@ -5595,11 +5595,11 @@ gtk_label_set_use_markup (GtkLabel *label, * gtk_label_get_use_markup: * @label: a #GtkLabel * - * Returns whether the label's text is interpreted as marked up with + * Returns whether the label’s text is interpreted as marked up with * the [Pango text markup language][PangoMarkupFormat]. * See gtk_label_set_use_markup (). * - * Return value: %TRUE if the label's text will be parsed for markup. + * Return value: %TRUE if the label’s text will be parsed for markup. **/ gboolean gtk_label_get_use_markup (GtkLabel *label) diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c index 1c410d2a18..d3c53890b5 100644 --- a/gtk/gtklayout.c +++ b/gtk/gtklayout.c @@ -46,10 +46,10 @@ * @Title: GtkLayout * @See_also: #GtkDrawingArea, #GtkScrolledWindow * - * #GtkLayout is similar to #GtkDrawingArea in that it's a “blank slate” + * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate” * and doesn't do anything but paint a blank background by default. It's * different in that it supports scrolling natively (you can add it to a - * #GtkScrolledWindow), and it can contain child widgets, since it's a + * #GtkScrolledWindow), and it can contain child widgets, since it’s a * #GtkContainer. However if you're just going to draw, a #GtkDrawingArea * is a better choice since it has lower overhead. * @@ -601,7 +601,7 @@ gtk_layout_set_size (GtkLayout *layout, * @layout, or %NULL * * Gets the size that has been set on the layout, and that determines - * the total extents of the layout's scrollbar area. See + * the total extents of the layout’s scrollbar area. See * gtk_layout_set_size (). **/ void diff --git a/gtk/gtklevelbar.c b/gtk/gtklevelbar.c index a6f3639bb3..ce9118a526 100644 --- a/gtk/gtklevelbar.c +++ b/gtk/gtklevelbar.c @@ -67,7 +67,7 @@ * } * ]| * - * The default interval of values is between zero and one, but it's possible to + * The default interval of values is between zero and one, but it’s possible to * modify the interval using gtk_level_bar_set_min_value() and * gtk_level_bar_set_max_value(). The value will be always drawn in proportion to * the admissible interval, i.e. a value of 15 with a specified interval between @@ -76,7 +76,7 @@ * as a finite and number of separated blocks instead of a single one. The number * of blocks that will be rendered is equal to the number of units specified by * the admissible interval. - * For instance, to build a bar rendered with five blocks, it's sufficient to + * For instance, to build a bar rendered with five blocks, it’s sufficient to * set the minimum value to 0 and the maximum value to 5 after changing the indicator * mode to discrete. * diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c index 0217a53b17..9a384409cb 100644 --- a/gtk/gtkliststore.c +++ b/gtk/gtkliststore.c @@ -1680,7 +1680,7 @@ gtk_list_store_reorder_func (GSequenceIter *a, * @new_order: (array zero-terminated=1): an array of integers mapping the new * position of each child to its old position before the re-ordering, * i.e. @new_order`[newpos] = oldpos`. It must have - * exactly as many items as the list store's length. + * exactly as many items as the list store’s length. * * Reorders @store to follow the order indicated by @new_order. Note that * this function only works with unsorted stores. diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c index d4d1bd84c2..398bb85efb 100644 --- a/gtk/gtkmain.c +++ b/gtk/gtkmain.c @@ -82,7 +82,7 @@ * } * ]| * - * It's OK to use the GLib main loop directly instead of gtk_main(), though it + * It’s OK to use the GLib main loop directly instead of gtk_main(), though it * involves slightly more typing. See #GMainLoop in the GLib documentation. */ @@ -383,7 +383,7 @@ static gboolean do_setlocale = TRUE; * gtk_parse_args() from automatically * calling `setlocale (LC_ALL, "")`. You would * want to use this function if you wanted to set the locale for - * your program to something other than the user's locale, or if + * your program to something other than the user’s locale, or if * you wanted to set different values for different locale categories. * * Most programs should not need to call this function. diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c index bb7cd27fec..7922698fc8 100644 --- a/gtk/gtkmenu.c +++ b/gtk/gtkmenu.c @@ -2385,7 +2385,7 @@ gtk_menu_get_tearoff_state (GtkMenu *menu) * The title is displayed when the menu is shown as a tearoff * menu. If @title is %NULL, the menu will see if it is attached * to a parent menu item, and if so it will try to use the same - * text as that menu item's label. + * text as that menu item’s label. * * Deprecated: 3.10 */ diff --git a/gtk/gtkmenubutton.c b/gtk/gtkmenubutton.c index c0a1ff5110..068a1fc9d5 100644 --- a/gtk/gtkmenubutton.c +++ b/gtk/gtkmenubutton.c @@ -821,7 +821,7 @@ gtk_menu_button_get_align_widget (GtkMenuButton *menu_button) * @direction: a #GtkArrowType * * Sets the direction in which the menu will be popped up, as - * well as changing the arrow's direction. The child will not + * well as changing the arrow’s direction. The child will not * be changed to an arrow if it was customized. * * If the menu when popped out would have collided with screen edges, diff --git a/gtk/gtkmenuitem.c b/gtk/gtkmenuitem.c index 09e30653d7..69fa4cb1bb 100644 --- a/gtk/gtkmenuitem.c +++ b/gtk/gtkmenuitem.c @@ -1319,7 +1319,7 @@ gtk_menu_item_set_use_action_appearance (GtkMenuItem *menu_item, * @menu_item: a #GtkMenuItem * @submenu: (allow-none): the submenu, or %NULL * - * Sets or replaces the menu item's submenu, or removes it when a %NULL + * Sets or replaces the menu item’s submenu, or removes it when a %NULL * submenu is passed. */ void @@ -2397,10 +2397,10 @@ _gtk_menu_item_refresh_accel_path (GtkMenuItem *menu_item, * gtk_menu_item_set_accel_path: * @menu_item: a valid #GtkMenuItem * @accel_path: (allow-none): accelerator path, corresponding to this menu - * item's functionality, or %NULL to unset the current path. + * item’s functionality, or %NULL to unset the current path. * * Set the accelerator path on @menu_item, through which runtime - * changes of the menu item's accelerator caused by the user can be + * changes of the menu item’s accelerator caused by the user can be * identified and saved to persistent storage (see gtk_accel_map_save() * on this). To set up a default accelerator for this menu item, call * gtk_accel_map_add_entry() with the same @accel_path. See also @@ -2462,7 +2462,7 @@ gtk_menu_item_set_accel_path (GtkMenuItem *menu_item, * See gtk_menu_item_set_accel_path() for details. * * Returns: the accelerator path corresponding to this menu - * item's functionality, or %NULL if not set + * item’s functionality, or %NULL if not set * * Since: 2.14 */ diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c index d711e89fe2..4cf34a8a5b 100644 --- a/gtk/gtkmenushell.c +++ b/gtk/gtkmenushell.c @@ -534,7 +534,7 @@ gtk_menu_shell_prepend (GtkMenuShell *menu_shell, * @position: The position in the item list where @child * is added. Positions are numbered from 0 to n-1 * - * Adds a new #GtkMenuItem to the menu shell's item list + * Adds a new #GtkMenuItem to the menu shell’s item list * at the position indicated by @position. */ void diff --git a/gtk/gtkmenutoolbutton.c b/gtk/gtkmenutoolbutton.c index 1b98e5d0dd..cb71576533 100644 --- a/gtk/gtkmenutoolbutton.c +++ b/gtk/gtkmenutoolbutton.c @@ -448,7 +448,7 @@ gtk_menu_tool_button_get_menu (GtkMenuToolButton *button) /** * gtk_menu_tool_button_set_arrow_tooltip_text: * @button: a #GtkMenuToolButton - * @text: text to be used as tooltip text for button's arrow button + * @text: text to be used as tooltip text for button’s arrow button * * Sets the tooltip text to be used as tooltip for the arrow button which * pops up the menu. See gtk_tool_item_set_tooltip_text() for setting a tooltip @@ -468,7 +468,7 @@ gtk_menu_tool_button_set_arrow_tooltip_text (GtkMenuToolButton *button, /** * gtk_menu_tool_button_set_arrow_tooltip_markup: * @button: a #GtkMenuToolButton - * @markup: markup text to be used as tooltip text for button's arrow button + * @markup: markup text to be used as tooltip text for button’s arrow button * * Sets the tooltip markup text to be used as tooltip for the arrow button * which pops up the menu. See gtk_tool_item_set_tooltip_text() for setting diff --git a/gtk/gtkmenutracker.c b/gtk/gtkmenutracker.c index d9e57f3fd4..2e650fba32 100644 --- a/gtk/gtkmenutracker.c +++ b/gtk/gtkmenutracker.c @@ -127,7 +127,7 @@ gtk_menu_tracker_section_find_model (GtkMenuTrackerSection *section, * * we only ever show separators if we have _actual_ children (ie: we do * not show a separator if the section contains only empty child - * sections). it's difficult to determine this on-the-fly, so we have + * sections). it’s difficult to determine this on-the-fly, so we have * this separate function to come back later and figure it out. * * 'section' is that section. diff --git a/gtk/gtkmenutrackeritem.c b/gtk/gtkmenutrackeritem.c index f80ee65e59..8477a6b6f4 100644 --- a/gtk/gtkmenutrackeritem.c +++ b/gtk/gtkmenutrackeritem.c @@ -37,7 +37,7 @@ * * If an item is one of the non-normal classes (submenu, separator), only the * label of the item needs to be respected. Otherwise, all the properties - * of the item contribute to the item's appearance and state. + * of the item contribute to the item’s appearance and state. * * Implementing the appearance of the menu item is up to toolkits, and certain * toolkits may choose to ignore certain properties, like icon or accel. The @@ -66,7 +66,7 @@ * Applications using submenus may want to lazily build their submenus in * response to the user clicking on it, as building a submenu may be expensive. * - * Thus, the submenu has two special controls -- the submenu's visibility + * Thus, the submenu has two special controls -- the submenu’s visibility * should be controlled by the GtkMenuTrackerItem::submenu-shown property, * and if a user clicks on the submenu, do not immediately show the menu, * but call gtk_menu_tracker_item_request_submenu_shown() and wait for the diff --git a/gtk/gtkmessagedialog.c b/gtk/gtkmessagedialog.c index 0362cf7b7e..d02352580c 100644 --- a/gtk/gtkmessagedialog.c +++ b/gtk/gtkmessagedialog.c @@ -45,7 +45,7 @@ * @See_also:#GtkDialog * * #GtkMessageDialog presents a dialog with an image representing the type of - * message (Error, Question, etc.) alongside some message text. It's simply a + * message (Error, Question, etc.) alongside some message text. It’s simply a * convenience widget; you could construct the equivalent of #GtkMessageDialog * from #GtkDialog without too much effort, but #GtkMessageDialog saves typing. * @@ -656,7 +656,7 @@ gtk_message_dialog_new_with_markup (GtkWindow *parent, * @dialog: a #GtkMessageDialog * @image: the image * - * Sets the dialog's image to @image. + * Sets the dialog’s image to @image. * * Since: 2.10 **/ @@ -695,9 +695,9 @@ gtk_message_dialog_set_image (GtkMessageDialog *dialog, * gtk_message_dialog_get_image: * @dialog: a #GtkMessageDialog * - * Gets the dialog's image. + * Gets the dialog’s image. * - * Return value: (transfer none): the dialog's image + * Return value: (transfer none): the dialog’s image * * Since: 2.14 **/ @@ -845,9 +845,9 @@ gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog, * @message_dialog: a #GtkMessageDialog * * Returns the message area of the dialog. This is the box where the - * dialog's primary and secondary labels are packed. You can add your + * dialog’s primary and secondary labels are packed. You can add your * own extra content to that box and it will appear below those labels, - * on the right side of the dialog's image (or on the left for right-to-left + * on the right side of the dialog’s image (or on the left for right-to-left * languages). See gtk_dialog_get_content_area() for the corresponding * function in the parent #GtkDialog. * diff --git a/gtk/gtknumerableicon.c b/gtk/gtknumerableicon.c index 84fba13d85..836e1a7104 100644 --- a/gtk/gtknumerableicon.c +++ b/gtk/gtknumerableicon.c @@ -812,7 +812,7 @@ gtk_numerable_icon_set_count (GtkNumerableIcon *self, * @self: a #GtkNumerableIcon * * Returns the #GtkStyleContext used by the icon for theming, - * or %NULL if there's none. + * or %NULL if there’s none. * * Returns: (transfer none): a #GtkStyleContext, or %NULL. * This object is internal to GTK+ and should not be unreffed. @@ -903,7 +903,7 @@ gtk_numerable_icon_set_background_gicon (GtkNumerableIcon *self, * @self: a #GtkNumerableIcon * * Returns the #GIcon that was set as the base background image, or - * %NULL if there's none. The caller of this function does not own + * %NULL if there’s none. The caller of this function does not own * a reference to the returned #GIcon. * * Returns: (transfer none): a #GIcon, or %NULL @@ -973,7 +973,7 @@ gtk_numerable_icon_set_background_icon_name (GtkNumerableIcon *self, * @self: a #GtkNumerableIcon * * Returns the icon name used as the base background image, - * or %NULL if there's none. + * or %NULL if there’s none. * * Returns: an icon name, or %NULL * diff --git a/gtk/gtkorientable.c b/gtk/gtkorientable.c index 0f72542473..cb9994df96 100644 --- a/gtk/gtkorientable.c +++ b/gtk/gtkorientable.c @@ -68,7 +68,7 @@ gtk_orientable_default_init (GtkOrientableInterface *iface) /** * gtk_orientable_set_orientation: * @orientable: a #GtkOrientable - * @orientation: the orientable's new orientation. + * @orientation: the orientable’s new orientation. * * Sets the orientation of the @orientable. * diff --git a/gtk/gtkpaned.c b/gtk/gtkpaned.c index e97de29f2b..9c4b07aa24 100644 --- a/gtk/gtkpaned.c +++ b/gtk/gtkpaned.c @@ -1873,7 +1873,7 @@ gtk_paned_motion (GtkWidget *widget, /** * gtk_paned_new: - * @orientation: the paned's orientation. + * @orientation: the paned’s orientation. * * Creates a new #GtkPaned widget. * @@ -2832,7 +2832,7 @@ gtk_paned_toggle_handle_focus (GtkPaned *paned) * enables the callback to distinguish between the window * of the paned, a child and the handle. * - * Return value: (transfer none): the paned's handle window. + * Return value: (transfer none): the paned’s handle window. * * Since: 2.20 **/ diff --git a/gtk/gtkplacessidebar.c b/gtk/gtkplacessidebar.c index 8df22555ba..97034ec4e4 100644 --- a/gtk/gtkplacessidebar.c +++ b/gtk/gtkplacessidebar.c @@ -1,7 +1,7 @@ /* * GtkPlacesSidebar - sidebar widget for places in the filesystem * - * This code comes from Nautilus, GNOME's file manager. + * This code comes from Nautilus, GNOME’s file manager. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License as @@ -74,7 +74,7 @@ * @See_also: #GtkFileChooser * * #GtkPlacesSidebar is a widget that displays a list of frequently-used places in the - * file system: the user's home directory, the user's bookmarks, and volumes and drives. + * file system: the user’s home directory, the user’s bookmarks, and volumes and drives. * This widget is used as a sidebar in #GtkFileChooser and may be used by file managers * and similar programs. * @@ -4524,7 +4524,7 @@ gtk_places_sidebar_set_location (GtkPlacesSidebar *sidebar, * * Gets the currently-selected location in the @sidebar. This can be #NULL when * nothing is selected, for example, when gtk_places_sidebar_set_location() has - * been called with a location that is not among the sidebar's list of places to + * been called with a location that is not among the sidebar’s list of places to * show. * * You can use this function to get the selection in the @sidebar. Also, if you @@ -4569,7 +4569,7 @@ gtk_places_sidebar_get_location (GtkPlacesSidebar *sidebar) * * Sets whether the @sidebar should show an item for the Desktop folder. * The default value for this option is determined by the desktop - * environment and the user's configuration, but this function can be + * environment and the user’s configuration, but this function can be * used to override it on a per-application basis. * * Since: 3.10 @@ -4731,7 +4731,7 @@ find_shortcut_link (GtkPlacesSidebar *sidebar, * shortcuts. The shortcuts are application-specific; they are not shared * across applications, and they are not persistent. If this function * is called multiple times with different locations, then they are added - * to the sidebar's list in the same order as the function is called. + * to the sidebar’s list in the same order as the function is called. * * Since: 3.10 */ diff --git a/gtk/gtkplacessidebar.h b/gtk/gtkplacessidebar.h index 47af0f11d6..a358f5ba67 100644 --- a/gtk/gtkplacessidebar.h +++ b/gtk/gtkplacessidebar.h @@ -3,7 +3,7 @@ /* * GtkPlacesSidebar - sidebar widget for places in the filesystem * - * This code comes from Nautilus, GNOME's file manager. + * This code comes from Nautilus, GNOME’s file manager. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License as diff --git a/gtk/gtkplug.c b/gtk/gtkplug.c index ae24dd6c01..8482dce7b1 100644 --- a/gtk/gtkplug.c +++ b/gtk/gtkplug.c @@ -49,10 +49,10 @@ * Together with #GtkSocket, #GtkPlug provides the ability to embed * widgets from one process into another process in a fashion that is * transparent to the user. One process creates a #GtkSocket widget - * and passes the ID of that widget's window to the other process, + * and passes the ID of that widget’s window to the other process, * which then creates a #GtkPlug with that window ID. Any widgets * contained in the #GtkPlug then will appear inside the first - * application's window. + * application’s window. * * The communication between a #GtkSocket and a #GtkPlug follows the * [XEmbed Protocol](http://www.freedesktop.org/Standards/xembed-spec). @@ -541,7 +541,7 @@ _gtk_plug_remove_from_socket (GtkPlug *plug, /** * gtk_plug_construct: * @plug: a #GtkPlug. - * @socket_id: the XID of the socket's window. + * @socket_id: the XID of the socket’s window. * * Finish the initialization of @plug for a given #GtkSocket identified by * @socket_id. This function will generally only be used by classes deriving from #GtkPlug. @@ -556,9 +556,9 @@ gtk_plug_construct (GtkPlug *plug, /** * gtk_plug_construct_for_display: * @plug: a #GtkPlug. - * @display: the #GdkDisplay associated with @socket_id's + * @display: the #GdkDisplay associated with @socket_id’s * #GtkSocket. - * @socket_id: the XID of the socket's window. + * @socket_id: the XID of the socket’s window. * * Finish the initialization of @plug for a given #GtkSocket identified by * @socket_id which is currently displayed on @display. @@ -634,7 +634,7 @@ gtk_plug_new (Window socket_id) /** * gtk_plug_new_for_display: * @display: the #GdkDisplay on which @socket_id is displayed - * @socket_id: the XID of the socket's window. + * @socket_id: the XID of the socket’s window. * * Create a new plug widget inside the #GtkSocket identified by socket_id. * diff --git a/gtk/gtkprinter.c b/gtk/gtkprinter.c index d8097363aa..a3959208fe 100644 --- a/gtk/gtkprinter.c +++ b/gtk/gtkprinter.c @@ -946,7 +946,7 @@ _gtk_printer_create_cairo_surface (GtkPrinter *printer, * @printer: a #GtkPrinter * * Lists all the paper sizes @printer supports. - * This will return and empty list unless the printer's details are + * This will return and empty list unless the printer’s details are * available, see gtk_printer_has_details() and gtk_printer_request_details(). * * Return value: (element-type GtkPageSetup) (transfer full): a newly allocated list of newly allocated #GtkPageSetup s. @@ -996,7 +996,7 @@ gtk_printer_get_default_page_size (GtkPrinter *printer) * Retrieve the hard margins of @printer, i.e. the margins that define * the area at the borders of the paper that the printer cannot print to. * - * Note: This will not succeed unless the printer's details are available, + * Note: This will not succeed unless the printer’s details are available, * see gtk_printer_has_details() and gtk_printer_request_details(). * * Return value: %TRUE iff the hard margins were retrieved @@ -1019,16 +1019,16 @@ gtk_printer_get_hard_margins (GtkPrinter *printer, * gtk_printer_get_capabilities: * @printer: a #GtkPrinter * - * Returns the printer's capabilities. + * Returns the printer’s capabilities. * - * This is useful when you're using #GtkPrintUnixDialog's manual-capabilities + * This is useful when you're using #GtkPrintUnixDialog’s manual-capabilities * setting and need to know which settings the printer can handle and which * you must handle yourself. * - * This will return 0 unless the printer's details are available, see + * This will return 0 unless the printer’s details are available, see * gtk_printer_has_details() and gtk_printer_request_details(). * - * Return value: the printer's capabilities + * Return value: the printer’s capabilities * * Since: 2.12 */ diff --git a/gtk/gtkprivate.c b/gtk/gtkprivate.c index fb1c6b57ee..c6d166f081 100644 --- a/gtk/gtkprivate.c +++ b/gtk/gtkprivate.c @@ -87,7 +87,7 @@ _gtk_get_data_prefix (void) * names spelled out in English. * However, this function does check the above environment * variables, and does return a Unix-style locale string based on - * either said environment variables or the thread's current locale. + * either said environment variables or the thread’s current locale. * * Return value: a dynamically allocated string, free with g_free(). */ diff --git a/gtk/gtkprogressbar.c b/gtk/gtkprogressbar.c index 097d9b524b..103bf15b0f 100644 --- a/gtk/gtkprogressbar.c +++ b/gtk/gtkprogressbar.c @@ -1053,7 +1053,7 @@ gtk_progress_bar_set_activity_mode (GtkProgressBar *pbar, /** * gtk_progress_bar_set_fraction: * @pbar: a #GtkProgressBar - * @fraction: fraction of the task that's been completed + * @fraction: fraction of the task that’s been completed * * Causes the progress bar to “fill in” the given fraction * of the bar. The fraction should be between 0.0 and 1.0, @@ -1288,7 +1288,7 @@ gtk_progress_bar_get_text (GtkProgressBar *pbar) * gtk_progress_bar_get_fraction: * @pbar: a #GtkProgressBar * - * Returns the current fraction of the task that's been completed. + * Returns the current fraction of the task that’s been completed. * * Return value: a fraction from 0.0 to 1.0 */ diff --git a/gtk/gtkquartz.c b/gtk/gtkquartz.c index 722a00bac8..ba204f3c93 100644 --- a/gtk/gtkquartz.c +++ b/gtk/gtkquartz.c @@ -288,7 +288,7 @@ _gtk_quartz_set_selection_data_for_pasteboard (NSPasteboard *pasteboard, /* Bundle-based functions for various directories. These almost work * even when the application isn't in a bundle, becuase mainBundle - * paths point to the bin directory in that case. It's a simple matter + * paths point to the bin directory in that case. It’s a simple matter * to test for that and remove the last element. */ diff --git a/gtk/gtkradiobutton.c b/gtk/gtkradiobutton.c index fc7744403c..0d93796ce9 100644 --- a/gtk/gtkradiobutton.c +++ b/gtk/gtkradiobutton.c @@ -266,7 +266,7 @@ gtk_radio_button_get_property (GObject *object, * @group: (element-type GtkRadioButton) (allow-none): an existing radio * button group, such as one returned from gtk_radio_button_get_group(), or %NULL. * - * Sets a #GtkRadioButton's group. It should be noted that this does not change + * Sets a #GtkRadioButton’s group. It should be noted that this does not change * the layout of your interface in any way, so if you are changing the group, * it is likely you will need to re-arrange the user interface to reflect these * changes. diff --git a/gtk/gtkrange.c b/gtk/gtkrange.c index dee451294e..fc16d4b98d 100644 --- a/gtk/gtkrange.c +++ b/gtk/gtkrange.c @@ -937,8 +937,8 @@ gtk_range_get_flippable (GtkRange *range) * @range: a #GtkRange * @size_fixed: %TRUE to make the slider size constant * - * Sets whether the range's slider has a fixed size, or a size that - * depends on its adjustment's page size. + * Sets whether the range’s slider has a fixed size, or a size that + * depends on its adjustment’s page size. * * This function is useful mainly for #GtkRange subclasses. * @@ -975,7 +975,7 @@ gtk_range_set_slider_size_fixed (GtkRange *range, * * See gtk_range_set_slider_size_fixed(). * - * Return value: whether the range's slider has a fixed size. + * Return value: whether the range’s slider has a fixed size. * * Since: 2.20 **/ @@ -990,9 +990,9 @@ gtk_range_get_slider_size_fixed (GtkRange *range) /** * gtk_range_set_min_slider_size: * @range: a #GtkRange - * @min_size: The slider's minimum size + * @min_size: The slider’s minimum size * - * Sets the minimum size of the range's slider. + * Sets the minimum size of the range’s slider. * * This function is useful mainly for #GtkRange subclasses. * @@ -1030,7 +1030,7 @@ gtk_range_set_min_slider_size (GtkRange *range, * * See gtk_range_set_min_slider_size(). * - * Return value: The minimum size of the range's slider. + * Return value: The minimum size of the range’s slider. * * Since: 2.20 **/ @@ -1047,7 +1047,7 @@ gtk_range_get_min_slider_size (GtkRange *range) * @range: a #GtkRange * @range_rect: (out): return location for the range rectangle * - * This function returns the area that contains the range's trough + * This function returns the area that contains the range’s trough * and its steppers, in widget->window coordinates. * * This function is useful mainly for #GtkRange subclasses. @@ -1108,10 +1108,10 @@ gtk_range_get_slider_range (GtkRange *range, /** * gtk_range_set_lower_stepper_sensitivity: * @range: a #GtkRange - * @sensitivity: the lower stepper's sensitivity policy. + * @sensitivity: the lower stepper’s sensitivity policy. * * Sets the sensitivity policy for the stepper that points to the - * 'lower' end of the GtkRange's adjustment. + * 'lower' end of the GtkRange’s adjustment. * * Since: 2.10 **/ @@ -1142,9 +1142,9 @@ gtk_range_set_lower_stepper_sensitivity (GtkRange *range, * @range: a #GtkRange * * Gets the sensitivity policy for the stepper that points to the - * 'lower' end of the GtkRange's adjustment. + * 'lower' end of the GtkRange’s adjustment. * - * Return value: The lower stepper's sensitivity policy. + * Return value: The lower stepper’s sensitivity policy. * * Since: 2.10 **/ @@ -1159,10 +1159,10 @@ gtk_range_get_lower_stepper_sensitivity (GtkRange *range) /** * gtk_range_set_upper_stepper_sensitivity: * @range: a #GtkRange - * @sensitivity: the upper stepper's sensitivity policy. + * @sensitivity: the upper stepper’s sensitivity policy. * * Sets the sensitivity policy for the stepper that points to the - * 'upper' end of the GtkRange's adjustment. + * 'upper' end of the GtkRange’s adjustment. * * Since: 2.10 **/ @@ -1193,9 +1193,9 @@ gtk_range_set_upper_stepper_sensitivity (GtkRange *range, * @range: a #GtkRange * * Gets the sensitivity policy for the stepper that points to the - * 'upper' end of the GtkRange's adjustment. + * 'upper' end of the GtkRange’s adjustment. * - * Return value: The upper stepper's sensitivity policy. + * Return value: The upper stepper’s sensitivity policy. * * Since: 2.10 **/ @@ -1432,12 +1432,12 @@ gtk_range_get_restrict_to_fill_level (GtkRange *range) * would indicate the current play position, and the fill level would * be the position up to which the file/stream has been downloaded. * - * This amount of prebuffering can be displayed on the range's trough + * This amount of prebuffering can be displayed on the range’s trough * and is themeable separately from the trough. To enable fill level * display, use gtk_range_set_show_fill_level(). The range defaults * to not showing the fill level. * - * Additionally, it's possible to restrict the range's slider position + * Additionally, it’s possible to restrict the range’s slider position * to values which are smaller than the fill level. This is controller * by gtk_range_set_restrict_to_fill_level() and is by default * enabled. diff --git a/gtk/gtkrecentchoosermenu.c b/gtk/gtkrecentchoosermenu.c index f6afd2b9c6..ba512a4047 100644 --- a/gtk/gtkrecentchoosermenu.c +++ b/gtk/gtkrecentchoosermenu.c @@ -1305,7 +1305,7 @@ gtk_recent_chooser_menu_get_show_numbers (GtkRecentChooserMenu *menu) * * Sets whether a number should be added to the items of @menu. The * numbers are shown to provide a unique character for a mnemonic to - * be used inside ten menu item's label. Only the first the items + * be used inside ten menu item’s label. Only the first the items * get a number to avoid clashes. * * Since: 2.10 diff --git a/gtk/gtkrecentmanager.c b/gtk/gtkrecentmanager.c index 3b10ef97aa..2268c57e66 100644 --- a/gtk/gtkrecentmanager.c +++ b/gtk/gtkrecentmanager.c @@ -640,7 +640,7 @@ gtk_recent_manager_set_filename (GtkRecentManager *manager, /* reads the recently used resources file and builds the items list. * we keep the items list inside the parser object, and build the - * RecentInfo object only on user's demand to avoid useless replication. + * RecentInfo object only on user’s demand to avoid useless replication. * this function resets the dirty bit of the manager. */ static void @@ -1641,10 +1641,10 @@ gtk_recent_info_get_mime_type (GtkRecentInfo *info) * gtk_recent_info_get_added: * @info: a #GtkRecentInfo * - * Gets the timestamp (seconds from system's Epoch) when the resource + * Gets the timestamp (seconds from system’s Epoch) when the resource * was added to the recently used resources list. * - * Return value: the number of seconds elapsed from system's Epoch when + * Return value: the number of seconds elapsed from system’s Epoch when * the resource was added to the list, or -1 on failure. * * Since: 2.10 @@ -1661,10 +1661,10 @@ gtk_recent_info_get_added (GtkRecentInfo *info) * gtk_recent_info_get_modified: * @info: a #GtkRecentInfo * - * Gets the timestamp (seconds from system's Epoch) when the meta-data + * Gets the timestamp (seconds from system’s Epoch) when the meta-data * for the resource was last modified. * - * Return value: the number of seconds elapsed from system's Epoch when + * Return value: the number of seconds elapsed from system’s Epoch when * the resource was last modified, or -1 on failure. * * Since: 2.10 @@ -1681,10 +1681,10 @@ gtk_recent_info_get_modified (GtkRecentInfo *info) * gtk_recent_info_get_visited: * @info: a #GtkRecentInfo * - * Gets the timestamp (seconds from system's Epoch) when the meta-data + * Gets the timestamp (seconds from system’s Epoch) when the meta-data * for the resource was last visited. * - * Return value: the number of seconds elapsed from system's Epoch when + * Return value: the number of seconds elapsed from system’s Epoch when * the resource was last visited, or -1 on failure. * * Since: 2.10 @@ -2263,12 +2263,12 @@ gtk_recent_info_get_short_name (GtkRecentInfo *info) * gtk_recent_info_get_uri_display: * @info: a #GtkRecentInfo * - * Gets a displayable version of the resource's URI. If the resource + * Gets a displayable version of the resource’s URI. If the resource * is local, it returns a local path; if the resource is not local, * it returns the UTF-8 encoded content of gtk_recent_info_get_uri(). * * Return value: a newly allocated UTF-8 string containing the - * resource's URI or %NULL. Use g_free() when done using it. + * resource’s URI or %NULL. Use g_free() when done using it. * * Since: 2.10 */ diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c index cf1a39bd6f..5a10401fa1 100644 --- a/gtk/gtkscale.c +++ b/gtk/gtkscale.c @@ -567,7 +567,7 @@ gtk_scale_get_property (GObject *object, /** * gtk_scale_new: - * @orientation: the scale's orientation. + * @orientation: the scale’s orientation. * @adjustment: (allow-none): the #GtkAdjustment which sets the range * of the scale, or %NULL to create a new adjustment. * @@ -592,14 +592,14 @@ gtk_scale_new (GtkOrientation orientation, /** * gtk_scale_new_with_range: - * @orientation: the scale's orientation. + * @orientation: the scale’s orientation. * @min: minimum value * @max: maximum value * @step: step increment (tick size) used with keyboard shortcuts * * Creates a new scale widget with the given orientation 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 + * with the increment @step. @step must be nonzero; it’s the distance * the slider moves when using the arrow keys to adjust the scale * value. * diff --git a/gtk/gtkscalebutton.c b/gtk/gtkscalebutton.c index fd76382a64..187fd14f48 100644 --- a/gtk/gtkscalebutton.c +++ b/gtk/gtkscalebutton.c @@ -621,7 +621,7 @@ gtk_scale_button_set_icons (GtkScaleButton *button, * gtk_scale_button_get_adjustment: * @button: a #GtkScaleButton * - * Gets the #GtkAdjustment associated with the #GtkScaleButton's scale. + * Gets the #GtkAdjustment associated with the #GtkScaleButton’s scale. * See gtk_range_get_adjustment() for details. * * Returns: (transfer none): the adjustment associated with the scale @@ -642,7 +642,7 @@ gtk_scale_button_get_adjustment (GtkScaleButton *button) * @adjustment: a #GtkAdjustment * * Sets the #GtkAdjustment to be used as a model - * for the #GtkScaleButton's scale. + * for the #GtkScaleButton’s scale. * See gtk_range_set_adjustment() for details. * * Since: 2.12 diff --git a/gtk/gtkscrollable.c b/gtk/gtkscrollable.c index 0ed52e785f..0c4f67abb2 100644 --- a/gtk/gtkscrollable.c +++ b/gtk/gtkscrollable.c @@ -30,7 +30,7 @@ * * All scrollable widgets should do the following. * - * - When a parent widget sets the scrollable child widget's adjustments, + * - When a parent widget sets the scrollable child widget’s adjustments, * the widget should populate the adjustments' * #GtkAdjustment:lower, #GtkAdjustment:upper, * #GtkAdjustment:step-increment, #GtkAdjustment:page-increment and diff --git a/gtk/gtkscrollbar.c b/gtk/gtkscrollbar.c index ecd4c7ea17..4fe7c87aea 100644 --- a/gtk/gtkscrollbar.c +++ b/gtk/gtkscrollbar.c @@ -155,7 +155,7 @@ gtk_scrollbar_style_updated (GtkWidget *widget) /** * gtk_scrollbar_new: - * @orientation: the scrollbar's orientation. + * @orientation: the scrollbar’s orientation. * @adjustment: (allow-none): the #GtkAdjustment to use, or %NULL to create a new adjustment. * * Creates a new scrollbar with the given orientation. diff --git a/gtk/gtkscrolledwindow.c b/gtk/gtkscrolledwindow.c index 9ebb1d9211..5d2393015f 100644 --- a/gtk/gtkscrolledwindow.c +++ b/gtk/gtkscrolledwindow.c @@ -49,7 +49,7 @@ * @Title: GtkScrolledWindow * @See_also: #GtkScrollable, #GtkViewport, #GtkAdjustment * - * #GtkScrolledWindow is a #GtkBin subclass: it's a container + * #GtkScrolledWindow is a #GtkBin subclass: it’s a container * the accepts a single child widget. #GtkScrolledWindow adds scrollbars * to the child widget and optionally draws a beveled frame around the * child widget. @@ -82,7 +82,7 @@ * for example the PageDown key). * * If a #GtkScrolledWindow doesn't behave quite as you would like, or - * doesn't have exactly the right layout, it's very possible to set up + * doesn't have exactly the right layout, it’s very possible to set up * your own scrolling with #GtkScrollbar and for example a #GtkGrid. */ @@ -117,8 +117,8 @@ * B) from 1.1) follows: the requisition may be overidden by usize of the scrolled * window (done automatically) or by usize of the child (needs to be checked). * C) from 2) follows: for POLICY_NEVER, the scrolled window simply reports the - * child's dimension. - * D) from 3) follows: the scrolled window child's minimum width and minimum height + * child’s dimension. + * D) from 3) follows: the scrolled window child’s minimum width and minimum height * under A) at least correspond to the space taken up by its scrollbars. */ @@ -594,7 +594,7 @@ gtk_scrolled_window_init (GtkScrolledWindow *scrolled_window) * * Creates a new scrolled window. * - * The two arguments are the scrolled window's adjustments; these will be + * The two arguments are the scrolled window’s adjustments; these will be * shared with the scrollbars and the child widget to keep the bars in sync * with the child. Usually you want to pass %NULL for the adjustments, which * will cause the scrolled window to create them for you. @@ -755,8 +755,8 @@ gtk_scrolled_window_set_vadjustment (GtkScrolledWindow *scrolled_window, * gtk_scrolled_window_get_hadjustment: * @scrolled_window: a #GtkScrolledWindow * - * Returns the horizontal scrollbar's adjustment, used to connect the - * horizontal scrollbar to the child widget's horizontal scroll + * Returns the horizontal scrollbar’s adjustment, used to connect the + * horizontal scrollbar to the child widget’s horizontal scroll * functionality. * * Returns: (transfer none): the horizontal #GtkAdjustment @@ -779,8 +779,8 @@ gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window) * gtk_scrolled_window_get_vadjustment: * @scrolled_window: a #GtkScrolledWindow * - * Returns the vertical scrollbar's adjustment, used to connect the - * vertical scrollbar to the child widget's vertical scroll functionality. + * Returns the vertical scrollbar’s adjustment, used to connect the + * vertical scrollbar to the child widget’s vertical scroll functionality. * * Returns: (transfer none): the vertical #GtkAdjustment */ @@ -3040,7 +3040,7 @@ gtk_scrolled_window_add_with_viewport (GtkScrolledWindow *scrolled_window, * _gtk_scrolled_window_get_spacing: * @scrolled_window: a scrolled window * - * Gets the spacing between the scrolled window's scrollbars and + * Gets the spacing between the scrolled window’s scrollbars and * the scrolled widget. Used by GtkCombo * * Return value: the spacing, in pixels. diff --git a/gtk/gtksearchbar.c b/gtk/gtksearchbar.c index 7bffdf7097..38d26118b5 100644 --- a/gtk/gtksearchbar.c +++ b/gtk/gtksearchbar.c @@ -41,7 +41,7 @@ * #GtkSearchBar is a container made to have a search entry (possibly * with additional connex widgets, such as drop-down menus, or buttons) * built-in. The search bar would appear when a search is started through - * typing on the keyboard, or the application's search mode is toggled on. + * typing on the keyboard, or the application’s search mode is toggled on. * * For keyboard presses to start a search, events will need to be * forwarded from the top-level window that contains the search bar. diff --git a/gtk/gtkselection.c b/gtk/gtkselection.c index 783f1e7341..d3878a78ab 100644 --- a/gtk/gtkselection.c +++ b/gtk/gtkselection.c @@ -17,7 +17,7 @@ /* This file implements most of the work of the ICCCM selection protocol. * The code was written after an intensive study of the equivalent part - * of John Ousterhout's Tk toolkit, and does many things in much the + * of John Ousterhout’s Tk toolkit, and does many things in much the * same way. * * The one thing in the ICCCM that isn't fully supported here (or in Tk) @@ -67,7 +67,7 @@ * #GtkClipboard provides a nicer interface to the same functionality. * * Some of the datatypes defined this section are used in - * the #GtkClipboard and drag-and-drop API's as well. The + * the #GtkClipboard and drag-and-drop API’s as well. The * #GtkTargetEntry and #GtkTargetList objects represent * lists of data types that are supported when sending or * receiving data. The #GtkSelectionData object is used to diff --git a/gtk/gtkseparator.c b/gtk/gtkseparator.c index 663c418b81..de887fb26d 100644 --- a/gtk/gtkseparator.c +++ b/gtk/gtkseparator.c @@ -250,7 +250,7 @@ gtk_separator_draw (GtkWidget *widget, /** * gtk_separator_new: - * @orientation: the separator's orientation. + * @orientation: the separator’s orientation. * * Creates a new #GtkSeparator with the given orientation. * diff --git a/gtk/gtksizerequest.c b/gtk/gtksizerequest.c index cd234407a7..7ac4fa0b82 100644 --- a/gtk/gtksizerequest.c +++ b/gtk/gtksizerequest.c @@ -466,7 +466,7 @@ gtk_widget_get_request_mode (GtkWidget *widget) * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL * @natural_width: (out) (allow-none): location to store the natural width, or %NULL * - * Retrieves a widget's initial minimum and natural width. + * Retrieves a widget’s initial minimum and natural width. * * This call is specific to height-for-width requests. * @@ -501,7 +501,7 @@ gtk_widget_get_preferred_width (GtkWidget *widget, * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL * @natural_height: (out) (allow-none): location to store the natural height, or %NULL * - * Retrieves a widget's initial minimum and natural height. + * Retrieves a widget’s initial minimum and natural height. * * This call is specific to width-for-height requests. * @@ -538,7 +538,7 @@ gtk_widget_get_preferred_height (GtkWidget *widget, * @minimum_width: (out) (allow-none): location for storing the minimum width, or %NULL * @natural_width: (out) (allow-none): location for storing the natural width, or %NULL * - * Retrieves a widget's minimum and natural width if it would be given + * Retrieves a widget’s minimum and natural width if it would be given * the specified @height. * * The returned request will be modified by the @@ -574,7 +574,7 @@ gtk_widget_get_preferred_width_for_height (GtkWidget *widget, * @minimum_height: (out) (allow-none): location for storing the minimum height, or %NULL * @natural_height: (out) (allow-none): location for storing the natural height, or %NULL * - * Retrieves a widget's minimum and natural height if it would be given + * Retrieves a widget’s minimum and natural height if it would be given * the specified @width. * * The returned request will be modified by the @@ -612,7 +612,7 @@ gtk_widget_get_preferred_height_for_width (GtkWidget *widget, * @minimum_baseline: (out) (allow-none): location for storing the baseline for the minimum height, or %NULL * @natural_baseline: (out) (allow-none): location for storing the baseline for the natural height, or %NULL * - * Retrieves a widget's minimum and natural height and the corresponding baselines if it would be given + * Retrieves a widget’s minimum and natural height and the corresponding baselines if it would be given * the specified @width, or the default height if @width is -1. The baselines may be -1 which means * that no baseline is requested for this widget. * @@ -652,7 +652,7 @@ gtk_widget_get_preferred_height_and_baseline_for_width (GtkWidget *widget, * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL * * Retrieves the minimum and natural size and the corresponding baselines of a widget, taking - * into account the widget's preference for height-for-width management. The baselines may + * into account the widget’s preference for height-for-width management. The baselines may * be -1 which means that no baseline is requested for this widget. * * This is used to retrieve a suitable size by container widgets which do @@ -722,7 +722,7 @@ _gtk_widget_get_preferred_size_and_baseline (GtkWidget *widget, * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL * * Retrieves the minimum and natural size of a widget, taking - * into account the widget's preference for height-for-width management. + * into account the widget’s preference for height-for-width management. * * This is used to retrieve a suitable size by container widgets which do * not impose any restrictions on the child placement. It can be used diff --git a/gtk/gtksocket.c b/gtk/gtksocket.c index a8293e43d0..0bd7bc6f1b 100644 --- a/gtk/gtksocket.c +++ b/gtk/gtksocket.c @@ -60,11 +60,11 @@ * Together with #GtkPlug, #GtkSocket provides the ability to embed * widgets from one process into another process in a fashion that * is transparent to the user. One process creates a #GtkSocket widget - * and passes that widget's window ID to the other process, which then + * and passes that widget’s window ID to the other process, which then * creates a #GtkPlug with that window ID. Any widgets contained in the - * #GtkPlug then will appear inside the first application's window. + * #GtkPlug then will appear inside the first application’s window. * - * The socket's window ID is obtained by using gtk_socket_get_id(). + * The socket’s window ID is obtained by using gtk_socket_get_id(). * Before using this function, the socket must have been realized, * and for hence, have been added to its parent. * @@ -1002,7 +1002,7 @@ gtk_socket_forall (GtkContainer *container, * gtk_socket_add_window: * @socket: a #GtkSocket * @xid: the native identifier for a window - * @need_reparent: whether the socket's plug's window needs to be + * @need_reparent: whether the socket’s plug’s window needs to be * reparented to the socket * * Adds a window to a GtkSocket. diff --git a/gtk/gtkspinbutton.c b/gtk/gtkspinbutton.c index 0a2c2b1c68..999ce595d1 100644 --- a/gtk/gtkspinbutton.c +++ b/gtk/gtkspinbutton.c @@ -2155,7 +2155,7 @@ gtk_spin_button_new_with_range (gdouble min, } /* Callback used when the spin button's adjustment changes. - * We need to redraw the arrows when the adjustment's range + * We need to redraw the arrows when the adjustment’s range * changes, and reevaluate our size request. */ static void @@ -2235,7 +2235,7 @@ gtk_spin_button_get_adjustment (GtkSpinButton *spin_button) /** * gtk_spin_button_set_digits: * @spin_button: a #GtkSpinButton - * @digits: the number of digits after the decimal point to be displayed for the spin button's value + * @digits: the number of digits after the decimal point to be displayed for the spin button’s value * * Set the precision to be displayed by @spin_button. Up to 20 digit precision * is allowed. @@ -2284,7 +2284,7 @@ gtk_spin_button_get_digits (GtkSpinButton *spin_button) * @page: increment applied for a button 2 press. * * Sets the step and page increments for spin_button. This affects how - * quickly the value changes when the spin button's arrows are activated. + * quickly the value changes when the spin button’s arrows are activated. **/ void gtk_spin_button_set_increments (GtkSpinButton *spin_button, @@ -2578,7 +2578,7 @@ gtk_spin_button_set_wrap (GtkSpinButton *spin_button, * gtk_spin_button_get_wrap: * @spin_button: a #GtkSpinButton * - * Returns whether the spin button's value wraps around to the + * Returns whether the spin button’s value wraps around to the * opposite limit when the upper or lower limit of the range is * exceeded. See gtk_spin_button_set_wrap(). * @@ -2647,7 +2647,7 @@ gtk_spin_button_get_snap_to_ticks (GtkSpinButton *spin_button) * @direction: a #GtkSpinType indicating the direction to spin * @increment: step increment to apply in the specified direction * - * Increment or decrement a spin button's value in a specified + * Increment or decrement a spin button’s value in a specified * direction by a specified amount. */ void diff --git a/gtk/gtkstatusbar.c b/gtk/gtkstatusbar.c index b7aba0fdb9..eeabaae018 100644 --- a/gtk/gtkstatusbar.c +++ b/gtk/gtkstatusbar.c @@ -50,9 +50,9 @@ * is complete in an FTP client, for example). * * Status bars in GTK+ maintain a stack of messages. The message at - * the top of the each bar's stack is the one that will currently be displayed. + * the top of the each bar’s stack is the one that will currently be displayed. * - * Any messages added to a statusbar's stack must specify a + * Any messages added to a statusbar’s stack must specify a * context id that is used to uniquely identify * the source of a message. This context id can be generated by * gtk_statusbar_get_context_id(), given a message and the statusbar that @@ -66,7 +66,7 @@ * * Status bars are created using gtk_statusbar_new(). * - * Messages are added to the bar's stack with gtk_statusbar_push(). + * Messages are added to the bar’s stack with gtk_statusbar_push(). * * The message at the top of the stack can be removed using * gtk_statusbar_pop(). A message can be removed from anywhere in the @@ -304,11 +304,11 @@ gtk_statusbar_msg_free (GtkStatusbarMsg *msg) /** * gtk_statusbar_push: * @statusbar: a #GtkStatusbar - * @context_id: the message's context id, as returned by + * @context_id: the message’s context id, as returned by * gtk_statusbar_get_context_id() * @text: the message to add to the statusbar * - * Pushes a new message onto a statusbar's stack. + * Pushes a new message onto a statusbar’s stack. * * Returns: a message id that can be used with * gtk_statusbar_remove(). @@ -343,7 +343,7 @@ gtk_statusbar_push (GtkStatusbar *statusbar, * @statusbar: a #GtkStatusbar * @context_id: a context identifier * - * Removes the first message in the #GtkStatusbar's stack + * Removes the first message in the #GtkStatusbar’s stack * with the given context id. * * Note that this may not change the displayed message, if @@ -394,7 +394,7 @@ gtk_statusbar_pop (GtkStatusbar *statusbar, * @context_id: a context identifier * @message_id: a message identifier, as returned by gtk_statusbar_push() * - * Forces the removal of a message from a statusbar's stack. + * Forces the removal of a message from a statusbar’s stack. * The exact @context_id and @message_id must be specified. */ void diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c index 4a63c9e928..c1b51cfc24 100644 --- a/gtk/gtkstylecontext.c +++ b/gtk/gtkstylecontext.c @@ -1511,9 +1511,9 @@ gtk_style_context_get_scale (GtkStyleContext *context) * * If @progress is not %NULL, the animation progress will be returned * there, 0.0 means the state is closest to being unset, while 1.0 means - * it's closest to being set. This means transition animation will + * it’s closest to being set. This means transition animation will * run from 0 to 1 when @state is being set and from 1 to 0 when - * it's being unset. + * it’s being unset. * * Returns: %TRUE if there is a running transition animation for @state. * @@ -4285,7 +4285,7 @@ gtk_render_extension (GtkStyleContext *context, * @height: rectangle height * * Renders a handle (as in #GtkHandleBox, #GtkPaned and - * #GtkWindow<!-- -->'s resize grip), in the rectangle + * #GtkWindow<!-- -->’s resize grip), in the rectangle * determined by @x, @y, @width, @height. * * Handles rendered for the paned and grip classes: diff --git a/gtk/gtkstylecontext.h b/gtk/gtkstylecontext.h index 870d9c1ce1..55540b0992 100644 --- a/gtk/gtkstylecontext.h +++ b/gtk/gtkstylecontext.h @@ -86,9 +86,9 @@ struct _GtkStyleContextClass /** * GTK_STYLE_PROPERTY_PADDING: * - * A property holding the rendered element's padding as a #GtkBorder. The + * A property holding the rendered element’s padding as a #GtkBorder. The * padding is defined as the spacing between the inner part of the element border - * and its child. It's the innermost spacing property of the padding/border/margin + * and its child. It’s the innermost spacing property of the padding/border/margin * series. */ #define GTK_STYLE_PROPERTY_PADDING "padding" @@ -96,7 +96,7 @@ struct _GtkStyleContextClass /** * GTK_STYLE_PROPERTY_BORDER_WIDTH: * - * A property holding the rendered element's border width in pixels as + * A property holding the rendered element’s border width in pixels as * a #GtkBorder. The border is the intermediary spacing property of the * padding/border/margin series. * @@ -109,7 +109,7 @@ struct _GtkStyleContextClass /** * GTK_STYLE_PROPERTY_MARGIN: * - * A property holding the rendered element's margin as a #GtkBorder. The + * A property holding the rendered element’s margin as a #GtkBorder. The * margin is defined as the spacing between the border of the element * and its surrounding elements. It is external to #GtkWidget<!-- -->s's * size allocations, and the most external spacing property of the @@ -120,28 +120,28 @@ struct _GtkStyleContextClass /** * GTK_STYLE_PROPERTY_BORDER_RADIUS: * - * A property holding the rendered element's border radius in pixels as a #gint. + * A property holding the rendered element’s border radius in pixels as a #gint. */ #define GTK_STYLE_PROPERTY_BORDER_RADIUS "border-radius" /** * GTK_STYLE_PROPERTY_BORDER_STYLE: * - * A property holding the element's border style as a #GtkBorderStyle. + * A property holding the element’s border style as a #GtkBorderStyle. */ #define GTK_STYLE_PROPERTY_BORDER_STYLE "border-style" /** * GTK_STYLE_PROPERTY_BORDER_COLOR: * - * A property holding the element's border color as a #GdkRGBA. + * A property holding the element’s border color as a #GdkRGBA. */ #define GTK_STYLE_PROPERTY_BORDER_COLOR "border-color" /** * GTK_STYLE_PROPERTY_BACKGROUND_IMAGE: * - * A property holding the element's background as a #cairo_pattern_t. + * A property holding the element’s background as a #cairo_pattern_t. */ #define GTK_STYLE_PROPERTY_BACKGROUND_IMAGE "background-image" diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c index 5fe60b74ad..e07a14d896 100644 --- a/gtk/gtktestutils.c +++ b/gtk/gtktestutils.c @@ -53,7 +53,7 @@ * * It will in turn call g_test_init() and gtk_init() to properly * initialize the testing framework and graphical toolkit. It'll - * also set the program's locale to “C” and prevent loading of rc + * also set the program’s locale to “C” and prevent loading of rc * files and Gtk+ modules. This is done to make tets program * environments as deterministic as possible. * @@ -236,7 +236,7 @@ gtk_test_widget_click (GtkWidget *widget, * * This function will generate a @button click in the upwards or downwards * spin button arrow areas, usually leading to an increase or decrease of - * spin button's value. + * spin button’s value. * * Returns: whether all actions neccessary for the button click simulation were carried out successfully. * diff --git a/gtk/gtktextattributes.h b/gtk/gtktextattributes.h index b64e0e7b31..0e2f85b0b8 100644 --- a/gtk/gtktextattributes.h +++ b/gtk/gtktextattributes.h @@ -76,7 +76,7 @@ typedef struct _GtkTextAppearance GtkTextAppearance; * @strikethrough: Strikethrough style * @draw_bg: Whether to use background-related values; this is * irrelevant for the values struct when in a tag, but is used for - * the composite values struct; it's true if any of the tags being + * the composite values struct; it’s true if any of the tags being * composited had background stuff set. * @inside_selection: This are only used when we are actually laying * out and rendering a paragraph; not when a #GtkTextAppearance is @@ -157,7 +157,7 @@ struct _GtkTextAppearance * @editable: Can edit this text. * * Using #GtkTextAttributes directly should rarely be necessary. - * It's primarily useful with gtk_text_iter_get_attributes(). + * It’s primarily useful with gtk_text_iter_get_attributes(). * As with most GTK+ structs, the fields in this struct should only * be read, never modified directly. */ diff --git a/gtk/gtktextbtree.c b/gtk/gtktextbtree.c index 2757c8ca40..bce15e369c 100644 --- a/gtk/gtktextbtree.c +++ b/gtk/gtktextbtree.c @@ -6159,7 +6159,7 @@ recompute_level_nonzero_counts (GtkTextBTreeNode *node) * This procedure is called to recompute all the counts in a GtkTextBTreeNode * (tags, child information, etc.) by scanning the information in * its descendants. This procedure is called during rebalancing - * when a GtkTextBTreeNode's child structure has changed. + * when a GtkTextBTreeNode’s child structure has changed. * * Results: * None. diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c index 8919e11e61..af7b6830c3 100644 --- a/gtk/gtktextbuffer.c +++ b/gtk/gtktextbuffer.c @@ -837,7 +837,7 @@ _gtk_text_buffer_get_btree (GtkTextBuffer *buffer) * * Get the #GtkTextTagTable associated with this buffer. * - * Return value: (transfer none): the buffer's tag table + * Return value: (transfer none): the buffer’s tag table **/ GtkTextTagTable* gtk_text_buffer_get_tag_table (GtkTextBuffer *buffer) @@ -2100,7 +2100,7 @@ gtk_text_buffer_set_mark (GtkTextBuffer *buffer, * Creates a mark at position @where. If @mark_name is %NULL, the mark * is anonymous; otherwise, the mark can be retrieved by name using * gtk_text_buffer_get_mark(). If a mark has left gravity, and text is - * inserted at the mark's current location, the mark will be moved to + * inserted at the mark’s current location, the mark will be moved to * the left of the newly-inserted text. If the mark has right gravity * (@left_gravity = %FALSE), the mark will end up on the right of * newly-inserted text. The standard left-to-right cursor is a mark @@ -2215,7 +2215,7 @@ gtk_text_buffer_get_iter_at_mark (GtkTextBuffer *buffer, * @buffer: a #GtkTextBuffer * @mark: a #GtkTextMark in @buffer * - * Deletes @mark, so that it's no longer located anywhere in the + * Deletes @mark, so that it’s no longer located anywhere in the * buffer. Removes the reference the buffer holds to the mark, so if * you haven't called g_object_ref() on the mark, it will be freed. Even * if the mark isn't freed, most operations on @mark become @@ -2362,7 +2362,7 @@ gtk_text_buffer_get_insert (GtkTextBuffer *buffer) * “selection_bound” and “insert” marks. If “selection_bound” and * “insert” are in the same place, then there is no current selection. * gtk_text_buffer_get_selection_bounds() is another convenient function - * for handling the selection, if you just want to know whether there's a + * for handling the selection, if you just want to know whether there’s a * selection and what its bounds are. * * Return value: (transfer none): selection bound mark @@ -2467,8 +2467,8 @@ gtk_text_buffer_select_range (GtkTextBuffer *buffer, * * Creates a tag and adds it to the tag table for @buffer. * Equivalent to calling gtk_text_tag_new() and then adding the - * tag to the buffer's tag table. The returned tag is owned by - * the buffer's tag table, so the ref count will be equal to one. + * tag to the buffer’s tag table. The returned tag is owned by + * the buffer’s tag table, so the ref count will be equal to one. * * If @tag_name is %NULL, the tag is anonymous. * @@ -2661,7 +2661,7 @@ gtk_text_buffer_remove_tag (GtkTextBuffer *buffer, * @start: one bound of range to be tagged * @end: other bound of range to be tagged * - * Calls gtk_text_tag_table_lookup() on the buffer's tag table to + * Calls gtk_text_tag_table_lookup() on the buffer’s tag table to * get a #GtkTextTag, then calls gtk_text_buffer_apply_tag(). **/ void @@ -2698,7 +2698,7 @@ gtk_text_buffer_apply_tag_by_name (GtkTextBuffer *buffer, * @start: one bound of range to be untagged * @end: other bound of range to be untagged * - * Calls gtk_text_tag_table_lookup() on the buffer's tag table to + * Calls gtk_text_tag_table_lookup() on the buffer’s tag table to * get a #GtkTextTag, then calls gtk_text_buffer_remove_tag(). **/ void @@ -4028,7 +4028,7 @@ cut_or_copy (GtkTextBuffer *buffer, * @default_editable: default editability of the buffer * * Copies the currently-selected text to a clipboard, then deletes - * said text if it's editable. + * said text if it’s editable. **/ void gtk_text_buffer_cut_clipboard (GtkTextBuffer *buffer, diff --git a/gtk/gtktextbufferrichtext.c b/gtk/gtktextbufferrichtext.c index 996d6247f9..cd4e87ac05 100644 --- a/gtk/gtktextbufferrichtext.c +++ b/gtk/gtktextbufferrichtext.c @@ -56,16 +56,16 @@ static GQuark deserialize_quark (void); /** * gtk_text_buffer_register_serialize_format: * @buffer: a #GtkTextBuffer - * @mime_type: the format's mime-type + * @mime_type: the format’s mime-type * @function: the serialize function to register - * @user_data: @function's user_data + * @user_data: @function’s user_data * @user_data_destroy: a function to call when @user_data is no longer needed * * This function registers a rich text serialization @function along with * its @mime_type with the passed @buffer. * * Return value: (transfer none): the #GdkAtom that corresponds to the - * newly registered format's mime-type. + * newly registered format’s mime-type. * * Since: 2.10 **/ @@ -103,10 +103,10 @@ gtk_text_buffer_register_serialize_format (GtkTextBuffer *buffer, * @buffer: a #GtkTextBuffer * @tagset_name: (allow-none): an optional tagset name, on %NULL * - * This function registers GTK+'s internal rich text serialization + * This function registers GTK+’s internal rich text serialization * format with the passed @buffer. The internal format does not comply * to any standard rich text format and only works between #GtkTextBuffer - * instances. It is capable of serializing all of a text buffer's tags + * instances. It is capable of serializing all of a text buffer’s tags * and embedded pixbufs. * * This function is just a wrapper around @@ -122,7 +122,7 @@ gtk_text_buffer_register_serialize_format (GtkTextBuffer *buffer, * receiving buffer to deal with with pasting of arbitrary tags. * * Return value: (transfer none): the #GdkAtom that corresponds to the - * newly registered format's mime-type. + * newly registered format’s mime-type. * * Since: 2.10 **/ @@ -154,16 +154,16 @@ gtk_text_buffer_register_serialize_tagset (GtkTextBuffer *buffer, /** * gtk_text_buffer_register_deserialize_format: * @buffer: a #GtkTextBuffer - * @mime_type: the format's mime-type + * @mime_type: the format’s mime-type * @function: the deserialize function to register - * @user_data: @function's user_data + * @user_data: @function’s user_data * @user_data_destroy: a function to call when @user_data is no longer needed * * This function registers a rich text deserialization @function along with * its @mime_type with the passed @buffer. * * Return value: (transfer none): the #GdkAtom that corresponds to the - * newly registered format's mime-type. + * newly registered format’s mime-type. * * Since: 2.10 **/ @@ -201,12 +201,12 @@ gtk_text_buffer_register_deserialize_format (GtkTextBuffer *buffe * @buffer: a #GtkTextBuffer * @tagset_name: (allow-none): an optional tagset name, on %NULL * - * This function registers GTK+'s internal rich text serialization + * This function registers GTK+’s internal rich text serialization * format with the passed @buffer. See * gtk_text_buffer_register_serialize_tagset() for details. * * Return value: (transfer none): the #GdkAtom that corresponds to the - * newly registered format's mime-type. + * newly registered format’s mime-type. * * Since: 2.10 **/ @@ -315,7 +315,7 @@ gtk_text_buffer_unregister_deserialize_format (GtkTextBuffer *buffer, * * You should allow creation of tags only if you know what you are * doing, e.g. if you defined a tagset name for your application - * suite's text buffers and you know that it's fine to receive new + * suite’s text buffers and you know that it’s fine to receive new * tags from these buffers, because you know that your application can * handle the newly created tags. * diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c index b3a7f2a0d8..e03337976e 100644 --- a/gtk/gtktextiter.c +++ b/gtk/gtktextiter.c @@ -1492,7 +1492,7 @@ gtk_text_iter_get_language (const GtkTextIter *iter) * i.e. if gtk_text_iter_get_line_offset () would return 0. * However this function is potentially more efficient than * gtk_text_iter_get_line_offset () because it doesn't have to compute - * the offset, it just has to see whether it's 0. + * the offset, it just has to see whether it’s 0. * * Return value: whether @iter begins a line **/ @@ -1792,7 +1792,7 @@ gtk_text_iter_get_attributes (const GtkTextIter *iter, * (MOVEMENT OCCURRED && NEW ITER IS DEREFERENCEABLE) * * This function will not change the iterator if - * it's already on the last (end iter) line, i.e. it + * it’s already on the last (end iter) line, i.e. it * won't move to the end of the last line. */ static gboolean @@ -1840,7 +1840,7 @@ forward_line_leaving_caches_unmodified (GtkTextRealIter *real) * (MOVEMENT OCCURRED && NEW ITER IS DEREFERENCEABLE) * * This function is currently unused, thus it is #if-0-ed. It is - * left here, since it's non-trivial code that might be useful in + * left here, since it’s non-trivial code that might be useful in * the future. */ static gboolean @@ -2452,7 +2452,7 @@ gtk_text_iter_backward_chars (GtkTextIter *iter, gint count) #if 0 /* These two can't be implemented efficiently (always have to use - * a linear scan, since that's the only way to find all the non-text + * a linear scan, since that’s the only way to find all the non-text * segments) */ @@ -3765,7 +3765,7 @@ gtk_text_iter_is_cursor_position (const GtkTextIter *iter) /** * gtk_text_iter_set_line_offset: * @iter: a #GtkTextIter - * @char_on_line: a character offset relative to the start of @iter's current line + * @char_on_line: a character offset relative to the start of @iter’s current line * * Moves @iter within a line, to a new character * (not byte) offset. The given character offset must be less than or @@ -3806,7 +3806,7 @@ gtk_text_iter_set_line_offset (GtkTextIter *iter, /** * gtk_text_iter_set_line_index: * @iter: a #GtkTextIter - * @byte_on_line: a byte index relative to the start of @iter's current line + * @byte_on_line: a byte index relative to the start of @iter’s current line * * Same as gtk_text_iter_set_line_offset(), but works with a * byte index. The given byte index must be at @@ -5338,7 +5338,7 @@ gtk_text_iter_backward_search (const GtkTextIter *iter, * Tests whether two iterators are equal, using the fastest possible * mechanism. This function is very fast; you can expect it to perform * better than e.g. getting the character offset for each iterator and - * comparing the offsets yourself. Also, it's a bit faster than + * comparing the offsets yourself. Also, it’s a bit faster than * gtk_text_iter_compare(). * * Return value: %TRUE if the iterators point to the same place in the buffer @@ -5475,7 +5475,7 @@ gtk_text_iter_in_range (const GtkTextIter *iter, * Swaps the value of @first and @second if @second comes before * @first in the buffer. That is, ensures that @first and @second are * in sequence. Most text buffer functions that take a range call this - * automatically on your behalf, so there's no real reason to call it yourself + * automatically on your behalf, so there’s no real reason to call it yourself * in those cases. There are some exceptions, such as gtk_text_iter_in_range(), * that expect a pre-sorted range. * diff --git a/gtk/gtktextlayout.c b/gtk/gtktextlayout.c index 0e18e82875..0426b0fb3e 100644 --- a/gtk/gtktextlayout.c +++ b/gtk/gtktextlayout.c @@ -971,7 +971,7 @@ gtk_text_layout_real_free_line_data (GtkTextLayout *layout, * gtk_text_layout_is_valid: * @layout: a #GtkTextLayout * - * Check if there are any invalid regions in a #GtkTextLayout's buffer + * Check if there are any invalid regions in a #GtkTextLayout’s buffer * * Return value: %TRUE if any invalid regions were found */ @@ -1681,8 +1681,8 @@ add_child_attrs (GtkTextLayout *layout, * @layout: a #GtkTextLayout * @display: a #GtkTextLineDisplay * @insert_iter: iter pointing to the cursor location - * @insert_index: cursor offset in the @display's layout, it may - * be different from @insert_iter's offset in case when preedit + * @insert_index: cursor offset in the @display’s layout, it may + * be different from @insert_iter’s offset in case when preedit * string is present. * @pos: location to store cursor position * @cursor_at_line_end: whether cursor is at the end of line @@ -1963,7 +1963,7 @@ add_preedit_attrs (GtkTextLayout *layout, } /* Iterate over the line and fill in display->cursors. - * It's a stripped copy of gtk_text_layout_get_line_display() */ + * It’s a stripped copy of gtk_text_layout_get_line_display() */ static void update_text_display_cursors (GtkTextLayout *layout, GtkTextLine *line, diff --git a/gtk/gtktextlayout.h b/gtk/gtktextlayout.h index b6379bc2fb..d113f88bca 100644 --- a/gtk/gtktextlayout.h +++ b/gtk/gtktextlayout.h @@ -80,7 +80,7 @@ /* This is a "semi-private" header; it is intended for * use by the text widget, and the text canvas item, - * but that's all. We may have to install it so the + * but that’s all. We may have to install it so the * canvas item can use it, but users are not supposed * to use it. */ diff --git a/gtk/gtktextmark.c b/gtk/gtktextmark.c index 919b5c9c5b..0f502fd556 100644 --- a/gtk/gtktextmark.c +++ b/gtk/gtktextmark.c @@ -231,7 +231,7 @@ gtk_text_mark_get_property (GObject *object, * Creates a text mark. Add it to a buffer using gtk_text_buffer_add_mark(). * If @name is %NULL, the mark is anonymous; otherwise, the mark can be * retrieved by name using gtk_text_buffer_get_mark(). If a mark has left - * gravity, and text is inserted at the mark's current location, the mark + * gravity, and text is inserted at the mark’s current location, the mark * will be moved to the left of the newly-inserted text. If the mark has * right gravity (@left_gravity = %FALSE), the mark will end up on the * right of newly-inserted text. The standard left-to-right cursor is a @@ -321,7 +321,7 @@ gtk_text_mark_get_deleted (GtkTextMark *mark) * Gets the buffer this mark is located inside, * or %NULL if the mark is deleted. * - * Return value: (transfer none): the mark's #GtkTextBuffer + * Return value: (transfer none): the mark’s #GtkTextBuffer **/ GtkTextBuffer* gtk_text_mark_get_buffer (GtkTextMark *mark) diff --git a/gtk/gtktextsegment.c b/gtk/gtktextsegment.c index d1493d69a4..aef42dbcc3 100644 --- a/gtk/gtktextsegment.c +++ b/gtk/gtktextsegment.c @@ -450,7 +450,7 @@ _gtk_toggle_segment_new (GtkTextTagInfo *info, gboolean on) * unless the entire B-tree is going away. * * Side effects: - * If the tree is going away then the toggle's memory is + * If the tree is going away then the toggle’s memory is * freed; otherwise the toggle counts in GtkTextBTreeNodes above the * segment get updated. * @@ -489,7 +489,7 @@ toggle_segment_delete_func (GtkTextLineSegment *segPtr, GtkTextLine *line, int t * toggle_segment_cleanup_func -- * * This procedure is called when a toggle is part of a line that's - * been modified in some way. It's invoked after the + * been modified in some way. It’s invoked after the * modifications are complete. * * Arguments: diff --git a/gtk/gtktextsegment.h b/gtk/gtktextsegment.h index 82ea6b2704..ea5f90423c 100644 --- a/gtk/gtktextsegment.h +++ b/gtk/gtktextsegment.h @@ -84,7 +84,7 @@ typedef GtkTextLineSegment* (*GtkTextSegCleanupFunc) (GtkTextLineSegment *seg /* Called when a segment moves from one line to another. CleanupFunc is also * called in that case, so many segments just use CleanupFunc, I'm not sure - * what's up with that (this function may not be needed...) + * what’s up with that (this function may not be needed...) */ typedef void (*GtkTextSegLineChangeFunc) (GtkTextLineSegment *seg, GtkTextLine *line); diff --git a/gtk/gtktexttag.c b/gtk/gtktexttag.c index 9718a9c762..e9ee74a856 100644 --- a/gtk/gtktexttag.c +++ b/gtk/gtktexttag.c @@ -1894,7 +1894,7 @@ delta_priority_foreach (GtkTextTag *tag, gpointer user_data) * * Get the tag priority. * - * Return value: The tag's priority. + * Return value: The tag’s priority. **/ gint gtk_text_tag_get_priority (GtkTextTag *tag) @@ -1918,7 +1918,7 @@ gtk_text_tag_get_priority (GtkTextTag *tag) * a tag to a tag table, it will be assigned the highest priority in * the table by default; so normally the precedence of a set of tags * is the order in which they were added to the table, or created with - * gtk_text_buffer_create_tag(), which adds the tag to the buffer's table + * gtk_text_buffer_create_tag(), which adds the tag to the buffer’s table * automatically. **/ void diff --git a/gtk/gtktexttagtable.c b/gtk/gtktexttagtable.c index fdf9cfebb3..062a71f213 100644 --- a/gtk/gtktexttagtable.c +++ b/gtk/gtktexttagtable.c @@ -308,7 +308,7 @@ gtk_text_tag_table_lookup (GtkTextTagTable *table, * @tag: a #GtkTextTag * * Remove a tag from the table. If a #GtkTextBuffer has @table as its tag table, - * the tag is removed from the buffer. The table's reference to the tag is + * the tag is removed from the buffer. The table’s reference to the tag is * removed, so the tag will end up destroyed if you don't have a reference to * it. **/ diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c index daa7a3b31a..a4efa7e215 100644 --- a/gtk/gtktextview.c +++ b/gtk/gtktextview.c @@ -1801,7 +1801,7 @@ gtk_text_view_get_buffer (GtkTextView *text_view) * Note that if @iter happens to be the actual cursor position, and * there is currently an IM preedit sequence being entered, the * returned locations will be adjusted to account for the preedit - * cursor's offset within the preedit sequence. + * cursor’s offset within the preedit sequence. * * The rectangle position is in buffer coordinates; use * gtk_text_view_buffer_to_window_coords() to convert these @@ -2002,7 +2002,7 @@ gtk_text_view_get_line_at_y (GtkTextView *text_view, * * Note that this function uses the currently-computed height of the * lines in the text buffer. Line heights are computed in an idle - * handler; so this function may not have the desired effect if it's + * handler; so this function may not have the desired effect if it’s * called before the height computations. To avoid oddness, consider * using gtk_text_view_scroll_to_mark() which saves a point to be * scrolled to after line validation. @@ -2587,7 +2587,7 @@ gtk_text_view_get_wrap_mode (GtkTextView *text_view) /** * gtk_text_view_set_editable: * @text_view: a #GtkTextView - * @setting: whether it's editable + * @setting: whether it’s editable * * Sets the default editability of the #GtkTextView. You can override * this default setting with tags in the buffer, using the “editable” @@ -2702,7 +2702,7 @@ gtk_text_view_get_pixels_above_lines (GtkTextView *text_view) * * Sets the default number of pixels of blank space * to put below paragraphs in @text_view. May be overridden - * by tags applied to @text_view's buffer. + * by tags applied to @text_view’s buffer. **/ void gtk_text_view_set_pixels_below_lines (GtkTextView *text_view, @@ -2751,7 +2751,7 @@ gtk_text_view_get_pixels_below_lines (GtkTextView *text_view) * * Sets the default number of pixels of blank space to leave between * display/wrapped lines within a paragraph. May be overridden by - * tags in @text_view's buffer. + * tags in @text_view’s buffer. **/ void gtk_text_view_set_pixels_inside_wrap (GtkTextView *text_view, @@ -2799,7 +2799,7 @@ gtk_text_view_get_pixels_inside_wrap (GtkTextView *text_view) * @justification: justification * * Sets the default justification of text in @text_view. - * Tags in the view's buffer may override the default. + * Tags in the view’s buffer may override the default. * **/ void @@ -2976,7 +2976,7 @@ gtk_text_view_set_indent (GtkTextView *text_view, * @text_view: a #GtkTextView * * Gets the default indentation of paragraphs in @text_view. - * Tags in the view's buffer may override the default. + * Tags in the view’s buffer may override the default. * The indentation may be negative. * * Return value: number of pixels of indentation @@ -10227,7 +10227,7 @@ gtk_text_view_move_child (GtkTextView *text_view, * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since - * they depend on the view's width; paragraphs are the same in all + * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Return value: %TRUE if @iter was moved and is not on the end iterator @@ -10255,7 +10255,7 @@ gtk_text_view_forward_display_line (GtkTextView *text_view, * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since - * they depend on the view's width; paragraphs are the same in all + * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Return value: %TRUE if @iter was moved and is not on the end iterator @@ -10283,7 +10283,7 @@ gtk_text_view_backward_display_line (GtkTextView *text_view, * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since - * they depend on the view's width; paragraphs are the same in all + * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Return value: %TRUE if @iter was moved and is not on the end iterator @@ -10311,7 +10311,7 @@ gtk_text_view_forward_display_line_end (GtkTextView *text_view, * Display lines are created by line-wrapping a paragraph. If * wrapping is turned off, display lines and paragraphs will be the * same. Display lines are divided differently for each view, since - * they depend on the view's width; paragraphs are the same in all + * they depend on the view’s width; paragraphs are the same in all * views, since they depend on the contents of the #GtkTextBuffer. * * Return value: %TRUE if @iter was moved and is not on the end iterator diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c index d6e40dc086..2ecd22c72c 100644 --- a/gtk/gtkthemingengine.c +++ b/gtk/gtkthemingengine.c @@ -60,7 +60,7 @@ * * #GtkThemingEngine<!-- -->s have limited access to the object they are * rendering, the #GtkThemingEngine API has read-only accessors to the - * style information contained in the rendered object's #GtkStyleContext. + * style information contained in the rendered object’s #GtkStyleContext. */ enum { @@ -470,7 +470,7 @@ gtk_theming_engine_get_style_property (GtkThemingEngine *engine, * @args: va_list of property name/return location pairs, followed by %NULL * * Retrieves several widget style properties from @engine according to the - * currently rendered content's style. + * currently rendered content’s style. * * Since: 3.0 **/ @@ -492,7 +492,7 @@ gtk_theming_engine_get_style_valist (GtkThemingEngine *engine, * @...: property name /return value pairs, followed by %NULL * * Retrieves several widget style properties from @engine according - * to the currently rendered content's style. + * to the currently rendered content’s style. * * Since: 3.0 **/ @@ -518,7 +518,7 @@ gtk_theming_engine_get_style (GtkThemingEngine *engine, * @color_name: color name to lookup * @color: (out): Return location for the looked up color * - * Looks up and resolves a color name in the current style's color map. + * Looks up and resolves a color name in the current style’s color map. * * Returns: %TRUE if @color_name was found and resolved, %FALSE otherwise **/ @@ -568,9 +568,9 @@ gtk_theming_engine_get_state (GtkThemingEngine *engine) * * If @progress is not %NULL, the animation progress will be returned * there, 0.0 means the state is closest to being %FALSE, while 1.0 means - * it's closest to being %TRUE. This means transition animations will + * it’s closest to being %TRUE. This means transition animations will * run from 0 to 1 when @state is being set to %TRUE and from 1 to 0 when - * it's being set to %FALSE. + * it’s being set to %FALSE. * * Returns: %TRUE if there is a running transition animation for @state. * diff --git a/gtk/gtktogglebutton.c b/gtk/gtktogglebutton.c index 3bbaccd2aa..4e54a8a5ff 100644 --- a/gtk/gtktogglebutton.c +++ b/gtk/gtktogglebutton.c @@ -50,7 +50,7 @@ * A toggle button is created by calling either gtk_toggle_button_new() or * gtk_toggle_button_new_with_label(). If using the former, it is advisable to * pack a widget, (such as a #GtkLabel and/or a #GtkImage), into the toggle - * button's container. (See #GtkButton for more information). + * button’s container. (See #GtkButton for more information). * * The state of a #GtkToggleButton can be set specifically using * gtk_toggle_button_set_active(), and retrieved using diff --git a/gtk/gtktoggletoolbutton.c b/gtk/gtktoggletoolbutton.c index eb74549fca..eb82ef9b50 100644 --- a/gtk/gtktoggletoolbutton.c +++ b/gtk/gtktoggletoolbutton.c @@ -274,7 +274,7 @@ gtk_toggle_tool_button_create_menu_proxy (GtkToolItem *item) * * If a widget is activated and the state of the tool button is the same as * the new state of the activated widget, then the other widget was the one - * that was activated by the user and updated the tool button's state. + * that was activated by the user and updated the tool button’s state. * * If the state of the tool button is not the same as the new state of the * activated widget, then the activation was activated by the user, and the diff --git a/gtk/gtktooltip.c b/gtk/gtktooltip.c index 47ae1cb3d2..e2bb4cc241 100644 --- a/gtk/gtktooltip.c +++ b/gtk/gtktooltip.c @@ -62,7 +62,7 @@ * to the signal handler is a GtkTooltip object. This is the object that we * are about to display as a tooltip, and can be manipulated in your callback * using functions like gtk_tooltip_set_icon(). There are functions for setting - * the tooltip's markup, setting an image from a named icon, or even putting in + * the tooltip’s markup, setting an image from a named icon, or even putting in * a custom widget. * * Return %TRUE from your query-tooltip handler. This causes the tooltip to be diff --git a/gtk/gtktreednd.c b/gtk/gtktreednd.c index d65cdc0973..0c6bf7a7e6 100644 --- a/gtk/gtktreednd.c +++ b/gtk/gtktreednd.c @@ -311,7 +311,7 @@ gtk_tree_set_row_drag_data (GtkSelectionData *selection_data, * Obtains a @tree_model and @path from selection data of target type * %GTK_TREE_MODEL_ROW. Normally called from a drag_data_received handler. * This function can only be used if @selection_data originates from the same - * process that's calling this function, because a pointer to the tree model + * process that’s calling this function, because a pointer to the tree model * is being passed around. If you aren't in the same process, then you'll * get memory corruption. In the #GtkTreeDragDest drag_data_received handler, * you can assume that selection data of type %GTK_TREE_MODEL_ROW is diff --git a/gtk/gtktreemenu.c b/gtk/gtktreemenu.c index cc025070a5..67d2c5ccf0 100644 --- a/gtk/gtktreemenu.c +++ b/gtk/gtktreemenu.c @@ -1644,7 +1644,7 @@ _gtk_tree_menu_set_model (GtkTreeMenu *menu, * Gets the @model currently used for the menu heirarhcy. * * Return value: (transfer none): the #GtkTreeModel which is used - * for @menu's hierarchy. + * for @menu’s hierarchy. * * Since: 3.0 */ @@ -1665,7 +1665,7 @@ _gtk_tree_menu_get_model (GtkTreeMenu *menu) * @menu: a #GtkTreeMenu * @path: (allow-none): the #GtkTreePath which is the root of @menu, or %NULL. * - * Sets the root of a @menu's hierarchy to be @path. @menu must already + * Sets the root of a @menu’s hierarchy to be @path. @menu must already * have a model set and @path must point to a valid path inside the model. * * Since: 3.0 @@ -1696,7 +1696,7 @@ _gtk_tree_menu_set_root (GtkTreeMenu *menu, * _gtk_tree_menu_get_root: * @menu: a #GtkTreeMenu * - * Gets the @root path for @menu's hierarchy, or returns %NULL if @menu + * Gets the @root path for @menu’s hierarchy, or returns %NULL if @menu * has no model or is building a heirarchy for the entire model. * * * Return value: (transfer full) (allow-none): A newly created #GtkTreePath @@ -1832,7 +1832,7 @@ _gtk_tree_menu_set_wrap_width (GtkTreeMenu *menu, * The row span column contains integers which indicate how many rows * a menu item should span. * - * Return value: the column in @menu's model containing row span information, or -1. + * Return value: the column in @menu’s model containing row span information, or -1. * * Since: 3.0 */ @@ -1888,7 +1888,7 @@ _gtk_tree_menu_set_row_span_column (GtkTreeMenu *menu, * The column span column contains integers which indicate how many columns * a menu item should span. * - * Return value: the column in @menu's model containing column span information, or -1. + * Return value: the column in @menu’s model containing column span information, or -1. * * Since: 3.0 */ diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c index 1312d645e9..635ecddff6 100644 --- a/gtk/gtktreemodel.c +++ b/gtk/gtktreemodel.c @@ -98,7 +98,7 @@ * Iterators are expected to always be valid for as long as the model * is unchanged (and doesn't emit a signal). The model is considered * to own all outstanding iterators and nothing needs to be done to - * free them from the user's point of view. Additionally, some models + * free them from the user’s point of view. Additionally, some models * guarantee that an iterator is valid for as long as the node it refers * to is valid (most notably the #GtkTreeStore and #GtkListStore). * Although generally uninteresting, as one always has to allow for @@ -2456,7 +2456,7 @@ gtk_tree_row_reference_copy (GtkTreeRowReference *reference) * gtk_tree_row_reference_free: * @reference: (allow-none): a #GtkTreeRowReference, or %NULL * - * Free's @reference. @reference may be %NULL + * Free’s @reference. @reference may be %NULL */ void gtk_tree_row_reference_free (GtkTreeRowReference *reference) diff --git a/gtk/gtktreemodelfilter.c b/gtk/gtktreemodelfilter.c index 04012356e8..ec966f81dc 100644 --- a/gtk/gtktreemodelfilter.c +++ b/gtk/gtktreemodelfilter.c @@ -75,8 +75,8 @@ * of its child nodes is a frequently occurring use case. Therefore, * #GtkTreeModelFilter explicitly supports this. For example, when a node * does not have any children, you might not want the node to be visible. - * As soon as the first row is added to the node's child level (or the - * last row removed), the node's visibility should be updated. + * As soon as the first row is added to the node’s child level (or the + * last row removed), the node’s visibility should be updated. * * This introduces a dependency from the node on its child nodes. In order * to accommodate this, #GtkTreeModelFilter must make sure the necessary @@ -90,7 +90,7 @@ * * Beware, however, that this explicit support is limited to these two * cases. For example, if you want a node to be visible only if two nodes - * in a child's child level (2 levels deeper) are visible, you are on your + * in a child’s child level (2 levels deeper) are visible, you are on your * own. In this case, either rely on #GtkTreeStore to emit all signals * because it does not implement reference counting, or for models that * do implement reference counting, obtain references on these child levels @@ -116,7 +116,7 @@ * similar data structures, many assumptions made in the GtkTreeModelSort * code do *not* apply in the GtkTreeModelFilter case. Reference counting * in particular is more complicated in GtkTreeModelFilter, because - * we explicitly support reliance on the state of a node's children as + * we explicitly support reliance on the state of a node’s children as * outlined in the public API documentation. Because of these differences, * you are strongly recommended to first read through these notes before * making any modification to the code. @@ -192,7 +192,7 @@ * rule 1 in the GtkTreeModel documentation. * * A second case is required to support visible functions which depend on - * the state of a node's children (see the public API documentation for + * the state of a node’s children (see the public API documentation for * GtkTreeModelFilter above). We build the child level of each node that * could be visible in the client (i.e. the level has an ext_ref_count > 0; * not the elt, because the elt might be invisible and thus unreferenced diff --git a/gtk/gtktreemodelfilter.h b/gtk/gtktreemodelfilter.h index 9d51997425..df2e37aeff 100644 --- a/gtk/gtktreemodelfilter.h +++ b/gtk/gtktreemodelfilter.h @@ -62,7 +62,7 @@ typedef gboolean (* GtkTreeModelFilterVisibleFunc) (GtkTreeModel *model, * It must fill @value with the display value for the column @column in the * row indicated by @iter. * - * Since this function is called for each data access, it's not a + * Since this function is called for each data access, it’s not a * particularly efficient operation. */ diff --git a/gtk/gtktreeselection.c b/gtk/gtktreeselection.c index 0b14d0e599..f9cd68afba 100644 --- a/gtk/gtktreeselection.c +++ b/gtk/gtktreeselection.c @@ -377,7 +377,7 @@ gtk_tree_selection_get_mode (GtkTreeSelection *selection) * gtk_tree_selection_set_select_function: * @selection: A #GtkTreeSelection. * @func: The selection function. May be %NULL - * @data: The selection function's data. May be %NULL + * @data: The selection function’s data. May be %NULL * @destroy: The destroy function for user data. May be %NULL * * Sets the selection function. diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c index 8bfdd8ee62..95f7765e1b 100644 --- a/gtk/gtktreestore.c +++ b/gtk/gtktreestore.c @@ -1325,7 +1325,7 @@ gtk_tree_store_insert (GtkTreeStore *tree_store, * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL * * Inserts a new row before @sibling. If @sibling is %NULL, then the row will - * be appended to @parent 's children. If @parent and @sibling are %NULL, then + * be appended to @parent ’s children. If @parent and @sibling are %NULL, then * the row will be appended to the toplevel. If both @sibling and @parent are * set, then @parent must be the parent of @sibling. When @sibling is set, * @parent is optional. @@ -1406,7 +1406,7 @@ gtk_tree_store_insert_before (GtkTreeStore *tree_store, * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL * * Inserts a new row after @sibling. If @sibling is %NULL, then the row will be - * prepended to @parent 's children. If @parent and @sibling are %NULL, then + * prepended to @parent ’s children. If @parent and @sibling are %NULL, then * the row will be prepended to the toplevel. If both @sibling and @parent are * set, then @parent must be the parent of @sibling. When @sibling is set, * @parent is optional. diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c index 201df03c40..512e4b843f 100644 --- a/gtk/gtktreeview.c +++ b/gtk/gtktreeview.c @@ -4759,7 +4759,7 @@ gtk_tree_view_draw_grid_lines (GtkTreeView *tree_view, * Modify at your own risk * * KEEP IN SYNC WITH gtk_tree_view_create_row_drag_icon()! - * FIXME: It's not... + * FIXME: It’s not... */ static gboolean gtk_tree_view_bin_draw (GtkWidget *widget, @@ -6934,7 +6934,7 @@ gtk_tree_view_set_top_row (GtkTreeView *tree_view, } /* Always call this iff dy is in the visible range. If the tree is empty, then - * it's set to be NULL, and top_row_dy is 0; + * it’s set to be NULL, and top_row_dy is 0; */ static void gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view) @@ -8412,7 +8412,7 @@ gtk_tree_view_header_focus (GtkTreeView *tree_view, } /* This function returns in 'path' the first focusable path, if the given path - * is already focusable, it's the returned one. + * is already focusable, it’s the returned one. */ static gboolean search_first_focusable_path (GtkTreeView *tree_view, @@ -9534,7 +9534,7 @@ _gtk_tree_path_new_from_rbtree (GtkRBTree *tree, } /* Returns TRUE if we ran out of tree before finding the path. If the path is - * invalid (ie. points to a node that's not in the tree), *tree and *node are + * invalid (ie. points to a node that’s not in the tree), *tree and *node are * both set to NULL. */ gboolean @@ -11734,7 +11734,7 @@ gtk_tree_view_get_headers_clickable (GtkTreeView *tree_view) * application requires users to read across tree rows and associate * cells with one another. By default, GTK+ will then render the tree * with alternating row colors. Do not use it - * just because you prefer the appearance of the ruled tree; that's a + * just because you prefer the appearance of the ruled tree; that’s a * question for the theme. Some themes will draw tree rows in * alternating colors even when rules are turned off, and users who * prefer that appearance all the time can choose those themes. You @@ -13052,7 +13052,7 @@ gtk_tree_view_get_reorderable (GtkTreeView *tree_view) * #GtkTreeDragDestIface. Both #GtkTreeStore and #GtkListStore support * these. If @reorderable is %TRUE, then the user can reorder the * model by dragging and dropping rows. The developer can listen to - * these changes by connecting to the model's row_inserted and + * these changes by connecting to the model’s row_inserted and * row_deleted signals. The reordering is implemented by setting up * the tree view as a drag source and destination. Therefore, drag and * drop can not be used in a reorderable view for any other purpose. @@ -13227,7 +13227,7 @@ gtk_tree_view_get_cursor (GtkTreeView *tree_view, * @start_editing: %TRUE if the specified cell should start being edited. * * Sets the current keyboard focus to be at @path, and selects it. This is - * useful when you want to focus the user's attention on a particular row. If + * useful when you want to focus the user’s attention on a particular row. If * @focus_column is not %NULL, then focus is given to the column specified by * it. Additionally, if @focus_column is specified, and @start_editing is * %TRUE, then editing should be started in the specified cell. @@ -13257,7 +13257,7 @@ gtk_tree_view_set_cursor (GtkTreeView *tree_view, * @start_editing: %TRUE if the specified cell should start being edited. * * Sets the current keyboard focus to be at @path, and selects it. This is - * useful when you want to focus the user's attention on a particular row. If + * useful when you want to focus the user’s attention on a particular row. If * @focus_column is not %NULL, then focus is given to the column specified by * it. If @focus_column and @focus_cell are not %NULL, and @focus_column * contains 2 or more editable or activatable cells, then focus is given to @@ -16246,7 +16246,7 @@ gtk_tree_view_set_tooltip_cell (GtkTreeView *tree_view, * tooltips the row returned will be the cursor row. When %TRUE, then any of * @model, @path and @iter which have been provided will be set to point to * that row and the corresponding model. @x and @y will always be converted - * to be relative to @tree_view's bin_window if @keyboard_tooltip is %FALSE. + * to be relative to @tree_view’s bin_window if @keyboard_tooltip is %FALSE. * * Return value: whether or not the given tooltip context points to a row. * @@ -16355,11 +16355,11 @@ gtk_tree_view_set_tooltip_query_cb (GtkWidget *widget, /** * gtk_tree_view_set_tooltip_column: * @tree_view: a #GtkTreeView - * @column: an integer, which is a valid column number for @tree_view's model + * @column: an integer, which is a valid column number for @tree_view’s model * * If you only plan to have simple (text-only) tooltips on full rows, you * can use this function to have #GtkTreeView handle these automatically - * for you. @column should be set to the column in @tree_view's model + * for you. @column should be set to the column in @tree_view’s model * containing the tooltip texts, or -1 to disable this feature. * * When enabled, #GtkWidget:has-tooltip will be set to %TRUE and @@ -16404,8 +16404,8 @@ gtk_tree_view_set_tooltip_column (GtkTreeView *tree_view, * gtk_tree_view_get_tooltip_column: * @tree_view: a #GtkTreeView * - * Returns the column of @tree_view's model which is being used for - * displaying tooltips on @tree_view's rows. + * Returns the column of @tree_view’s model which is being used for + * displaying tooltips on @tree_view’s rows. * * Return value: the index of the tooltip column that is currently being * used, or -1 if this is disabled. diff --git a/gtk/gtktreeview.h b/gtk/gtktreeview.h index 5ccc300342..121e10a205 100644 --- a/gtk/gtktreeview.h +++ b/gtk/gtktreeview.h @@ -149,7 +149,7 @@ typedef gboolean (* GtkTreeViewColumnDropFunc) (GtkTreeView *tree_vi /** * GtkTreeViewMappingFunc: * @tree_view: A #GtkTreeView - * @path: The path that's expanded + * @path: The path that’s expanded * @user_data: user data * * Function used for gtk_tree_view_map_expanded_rows(). diff --git a/gtk/gtktreeviewcolumn.c b/gtk/gtktreeviewcolumn.c index 26225f2fbd..963af15006 100644 --- a/gtk/gtktreeviewcolumn.c +++ b/gtk/gtktreeviewcolumn.c @@ -1652,7 +1652,7 @@ gtk_tree_view_column_new_with_area (GtkCellArea *area) * gtk_tree_view_column_pack_start(), and * gtk_tree_view_column_set_attributes() on the newly created #GtkTreeViewColumn. * - * Here's a simple example: + * Here’s a simple example: * |[<!-- language="C" --> * enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS }; * ... @@ -2302,7 +2302,7 @@ gtk_tree_view_column_get_min_width (GtkTreeViewColumn *tree_column) * * Sets the maximum width of the @tree_column. If @max_width is -1, then the * maximum width is unset. Note, the column can actually be wider than max - * width if it's the last column in a view. In this case, the column expands to + * width if it’s the last column in a view. In this case, the column expands to * fill any extra space. **/ void @@ -2839,7 +2839,7 @@ gtk_tree_view_column_get_sort_order (GtkTreeViewColumn *tree_column) * gtk_tree_view_column_cell_set_cell_data: * @tree_column: A #GtkTreeViewColumn. * @tree_model: The #GtkTreeModel to to get the cell renderers attributes from. - * @iter: The #GtkTreeIter to to get the cell renderer's attributes from. + * @iter: The #GtkTreeIter to to get the cell renderer’s attributes from. * @is_expander: %TRUE, if the row has children * @is_expanded: %TRUE, if the row has visible children * diff --git a/gtk/gtkviewport.c b/gtk/gtkviewport.c index 1176cf75a3..51b6e3a216 100644 --- a/gtk/gtkviewport.c +++ b/gtk/gtkviewport.c @@ -55,7 +55,7 @@ * ignore the presence of the viewport. * * The #GtkViewport will start scrolling content only if allocated less - * than the child widget's minimum size in a given orientation. + * than the child widget’s minimum size in a given orientation. */ struct _GtkViewportPrivate diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index e882bb2b88..9e565ea748 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -121,7 +121,7 @@ * After the toplevel window has initially requested its size in both * dimensions it can go on to allocate itself a reasonable size (or a size * previously specified with gtk_window_set_default_size()). During the - * recursive allocation process it's important to note that request cycles + * recursive allocation process it’s important to note that request cycles * will be recursively executed while container widgets allocate their children. * Each container widget, once allocated a size, will go on to first share the * space in one orientation among its children and then request each child's @@ -133,7 +133,7 @@ * to avoid re-querying for the same sizes in one allocation cycle. * * See - * [GtkContainer's geometry management section][container-geometry-management] + * [GtkContainer’s geometry management section][container-geometry-management] * to learn more about how height-for-width allocations are performed * by container widgets. * @@ -4060,7 +4060,7 @@ gtk_widget_freeze_child_notify (GtkWidget *widget) * gtk_widget_child_notify: * @widget: a #GtkWidget * @child_property: the name of a child property installed on the - * class of @widget<!-- -->'s parent + * class of @widget<!-- -->’s parent * * Emits a #GtkWidget::child-notify signal for the * [child property][child-properties] @child_property @@ -4307,7 +4307,7 @@ gtk_widget_destroy (GtkWidget *widget) * @widget_pointer: (inout) (transfer none): address of a variable that contains @widget * * This function sets *@widget_pointer to %NULL if @widget_pointer != - * %NULL. It's intended to be used as a callback connected to the + * %NULL. It’s intended to be used as a callback connected to the * “destroy” signal of a widget. You connect gtk_widget_destroyed() * as a signal handler, and pass the address of your widget variable * as user data. Then when the widget is destroyed, the variable will @@ -4332,7 +4332,7 @@ gtk_widget_destroyed (GtkWidget *widget, * * Flags a widget to be displayed. Any widget that isn't shown will * not appear on the screen. If you want to show all the widgets in a - * container, it's easier to call gtk_widget_show_all() on the + * container, it’s easier to call gtk_widget_show_all() on the * container, instead of individually showing the widgets. * * Remember that you have to show the containers containing a widget, @@ -4575,7 +4575,7 @@ gtk_widget_map (GtkWidget *widget) * @widget: a #GtkWidget * * This function is only for use in widget implementations. Causes - * a widget to be unmapped if it's currently mapped. + * a widget to be unmapped if it’s currently mapped. **/ void gtk_widget_unmap (GtkWidget *widget) @@ -4975,8 +4975,8 @@ gtk_widget_disconnect_frame_clock (GtkWidget *widget, * realized and mapped automatically. * * Realizing a widget requires all - * the widget's parent widgets to be realized; calling - * gtk_widget_realize() realizes the widget's parents in addition to + * the widget’s parent widgets to be realized; calling + * gtk_widget_realize() realizes the widget’s parents in addition to * @widget itself. If a widget is not yet inside a toplevel window * when you realize it, bad things will happen. * @@ -5119,7 +5119,7 @@ gtk_widget_real_queue_draw_region (GtkWidget *widget, * @region: region to draw * * Invalidates the area of @widget defined by @region by calling - * gdk_window_invalidate_region() on the widget's window and all its + * gdk_window_invalidate_region() on the widget’s window and all its * child windows. Once the main loop becomes idle (after the current * batch of events has been processed, roughly), the window will * receive expose events for the union of all regions that have been @@ -5221,7 +5221,7 @@ gtk_widget_queue_draw (GtkWidget *widget) * Flags a widget to have its size renegotiated; should * be called when a widget for some reason has a new size request. * For example, when you change the text in a #GtkLabel, #GtkLabel - * queues a resize to ensure there's enough space for the new text. + * queues a resize to ensure there’s enough space for the new text. * * Note that you cannot call gtk_widget_queue_resize() on a widget * from inside its implementation of the GtkWidgetClass::size_allocate @@ -5276,9 +5276,9 @@ gtk_widget_queue_resize_no_redraw (GtkWidget *widget) * frame). gtk_widget_queue_draw() will also end up requesting a frame * on the appropriate frame clock. * - * A widget's frame clock will not change while the widget is + * A widget’s frame clock will not change while the widget is * mapped. Reparenting a widget (which implies a temporary unmap) can - * change the widget's frame clock. + * change the widget’s frame clock. * * Unrealized widgets do not have a frame clock. * @@ -5425,7 +5425,7 @@ gtk_widget_invalidate_widget_windows (GtkWidget *widget, * adjust_size_allocation virtual and adjust_baseline_allocation * methods on the child will be used to adjust the allocation and * baseline. Standard adjustments include removing the widget's - * margins, and applying the widget's #GtkWidget:halign and + * margins, and applying the widget’s #GtkWidget:halign and * #GtkWidget:valign properties. * * If the child widget does not have a valign of %GTK_ALIGN_BASELINE the @@ -5646,8 +5646,8 @@ out: * In this function, the allocation may be adjusted. It will be forced * to a 1x1 minimum size, and the adjust_size_allocation virtual * method on the child will be used to adjust the allocation. Standard - * adjustments include removing the widget's margins, and applying the - * widget's #GtkWidget:halign and #GtkWidget:valign properties. + * adjustments include removing the widget’s margins, and applying the + * widget’s #GtkWidget:halign and #GtkWidget:valign properties. * * For baseline support in containers you need to use gtk_widget_size_allocate_with_baseline() * instead. @@ -5727,8 +5727,8 @@ gtk_widget_common_ancestor (GtkWidget *widget_a, * @dest_x: (out): location to store X position relative to @dest_widget * @dest_y: (out): location to store Y position relative to @dest_widget * - * Translate coordinates relative to @src_widget's allocation to coordinates - * relative to @dest_widget's allocations. In order to perform this + * Translate coordinates relative to @src_widget’s allocation to coordinates + * relative to @dest_widget’s allocations. In order to perform this * operation, both widgets must be realized, and must share a common * toplevel. * @@ -6082,7 +6082,7 @@ widget_new_accel_closure (GtkWidget *widget, * * Installs an accelerator for this @widget in @accel_group that causes * @accel_signal to be emitted if the accelerator is activated. - * The @accel_group needs to be added to the widget's toplevel via + * The @accel_group needs to be added to the widget’s toplevel via * gtk_window_add_accel_group(), and the signal must be of type %G_SIGNAL_ACTION. * Accelerators added through this function are not user changeable during * runtime. If you want to support accelerators that can be changed by the @@ -6699,7 +6699,7 @@ _gtk_widget_draw (GtkWidget *widget, * example changing the operator using cairo_set_operator() or the * line width using cairo_set_line_width() might have unwanted side * effects. - * You may however change the context's transform matrix - like with + * You may however change the context’s transform matrix - like with * cairo_scale(), cairo_translate() or cairo_set_matrix() and clip * region with cairo_clip() prior to calling this function. Also, it * is fine to modify the context with cairo_save() and @@ -6964,7 +6964,7 @@ _gtk_widget_get_translation_to_window (GtkWidget *widget, * * Transforms the given cairo context @cr that from @widget-relative * coordinates to @window-relative coordinates. - * If the @widget's window is not an ancestor of @window, no + * If the @widget’s window is not an ancestor of @window, no * modification will be applied. * * This is the inverse to the transformation GTK applies when @@ -7211,7 +7211,7 @@ gtk_widget_event_internal (GtkWidget *widget, /** * gtk_widget_activate: - * @widget: a #GtkWidget that's activatable + * @widget: a #GtkWidget that’s activatable * * For widgets that can be “activated” (buttons, menu items, etc.) * this function activates them. Activation is what happens when you @@ -7366,7 +7366,7 @@ gtk_widget_reparent (GtkWidget *widget, * @area: a rectangle * @intersection: rectangle to store intersection of @widget and @area * - * Computes the intersection of a @widget's area and @area, storing + * Computes the intersection of a @widget’s area and @area, storing * the intersection in @intersection, and returns %TRUE if there was * an intersection. @intersection may be %NULL if you're only * interested in whether there was an intersection. @@ -7412,7 +7412,7 @@ gtk_widget_intersect (GtkWidget *widget, * for %NO_WINDOW widgets; relative to the parent window * of @widget->window for widgets with their own window. * - * Computes the intersection of a @widget's area and @region, returning + * Computes the intersection of a @widget’s area and @region, returning * the intersection. The result may be empty, use cairo_region_is_empty() to * check. * @@ -8331,7 +8331,7 @@ gtk_widget_set_state (GtkWidget *widget, * gtk_widget_get_state: * @widget: a #GtkWidget * - * Returns the widget's state. See gtk_widget_set_state(). + * Returns the widget’s state. See gtk_widget_set_state(). * * Returns: the state of @widget. * @@ -8412,7 +8412,7 @@ _gtk_widget_set_visible_flag (GtkWidget *widget, * @widget: a #GtkWidget * * Determines whether the widget is visible. If you want to - * take into account whether the widget's parent is also marked as + * take into account whether the widget’s parent is also marked as * visible, use gtk_widget_is_visible() instead. * * This function does not check if the widget is obscured in any way. @@ -8472,7 +8472,7 @@ gtk_widget_is_visible (GtkWidget *widget) * Specifies whether @widget has a #GdkWindow of its own. Note that * all realized widgets have a non-%NULL “window” pointer * (gtk_widget_get_window() never returns a %NULL window when a widget - * is realized), but for many of them it's actually the #GdkWindow of + * is realized), but for many of them it’s actually the #GdkWindow of * one of its parent widgets. Widgets that do not create a %window for * themselves in #GtkWidget::realize must announce this by * calling this function with @has_window = %FALSE. @@ -8844,11 +8844,11 @@ gtk_widget_set_sensitive (GtkWidget *widget, * gtk_widget_get_sensitive: * @widget: a #GtkWidget * - * Returns the widget's sensitivity (in the sense of returning + * Returns the widget’s sensitivity (in the sense of returning * the value that has been set using gtk_widget_set_sensitive()). * * The effective sensitivity of a widget is however determined by both its - * own and its parent widget's sensitivity. See gtk_widget_is_sensitive(). + * own and its parent widget’s sensitivity. See gtk_widget_is_sensitive(). * * Returns: %TRUE if the widget is sensitive * @@ -8866,7 +8866,7 @@ gtk_widget_get_sensitive (GtkWidget *widget) * gtk_widget_is_sensitive: * @widget: a #GtkWidget * - * Returns the widget's effective sensitivity, which means + * Returns the widget’s effective sensitivity, which means * it is sensitive itself and also its parent widget is sensitive * * Returns: %TRUE if the widget is effectively sensitive @@ -9061,7 +9061,7 @@ _gtk_widget_get_modifier_properties (GtkWidget *widget) * This way, your widget library can install a #GtkCssProvider * with the %GTK_STYLE_PROVIDER_PRIORITY_FALLBACK priority in order * to provide a default styling for those widgets that need so, and - * this theming may fully overridden by the user's theme. + * this theming may fully overridden by the user’s theme. * * Note that for complex widgets this may bring in undesired * results (such as uniform background color everywhere), in @@ -9346,7 +9346,7 @@ gtk_widget_propagate_screen_changed_recurse (GtkWidget *widget, * * Whether @widget can rely on having its alpha channel * drawn correctly. On X11 this function returns whether a - * compositing manager is running for @widget's screen. + * compositing manager is running for @widget’s screen. * * Please note that the semantics of this call will change * in the future if used on a widget that has a composited @@ -9645,7 +9645,7 @@ gtk_widget_peek_pango_context (GtkWidget *widget) * by gtk_widget_create_pango_context(), this context is owned by * the widget (it can be used until the screen for the widget changes * or the widget is removed from its toplevel), and will be updated to - * match any changes to the widget's attributes. This can be tracked + * match any changes to the widget’s attributes. This can be tracked * by using the #GtkWidget::screen-changed signal on the widget. * * Return value: (transfer none): the #PangoContext for the widget. @@ -9884,7 +9884,7 @@ gtk_widget_set_parent_window (GtkWidget *widget, * gtk_widget_get_parent_window: * @widget: a #GtkWidget. * - * Gets @widget's parent window. + * Gets @widget’s parent window. * * Returns: (transfer none): the parent window of @widget. **/ @@ -10240,7 +10240,7 @@ gtk_widget_child_focus (GtkWidget *widget, * * When %FALSE is returned, the caller should continue with keyboard * navigation outside the widget, e.g. by calling - * gtk_widget_child_focus() on the widget's toplevel. + * gtk_widget_child_focus() on the widget’s toplevel. * * The default ::keynav-failed handler returns %TRUE for * %GTK_DIR_TAB_FORWARD and %GTK_DIR_TAB_BACKWARD. For the other @@ -10358,7 +10358,7 @@ gtk_widget_set_usize_internal (GtkWidget *widget, * @width: width @widget should request, or -1 to unset * @height: height @widget should request, or -1 to unset * - * Sets the minimum size of a widget; that is, the widget's size + * Sets the minimum size of a widget; that is, the widget’s size * request will be at least @width by @height. You can use this * function to force a widget to be larger than it normally would be. * @@ -10449,7 +10449,7 @@ gtk_widget_get_size_request (GtkWidget *widget, * * Temporarily establishes a forced minimum size for a widget; this * is used by GtkWindow when calculating the size to add to the - * window's geometry widget. Cached sizes for the widget and its + * window’s geometry widget. Cached sizes for the widget and its * parents are invalidated, so that subsequent calls to the size * negotiation machinery produce the overriden result, but the * widget is not queued for relayout or redraw. The old size must @@ -10493,7 +10493,7 @@ _gtk_widget_restore_size_request (GtkWidget *widget, * Sets the event mask (see #GdkEventMask) for a widget. The event * mask determines which events a widget will receive. Keep in mind * that different widgets have different default event masks, and by - * changing the event mask you may disrupt a widget's functionality, + * changing the event mask you may disrupt a widget’s functionality, * so be careful. This function must be called while a widget is * unrealized. Consider gtk_widget_add_events() for widgets that are * already realized, or if you want to preserve the existing event @@ -10523,7 +10523,7 @@ gtk_widget_set_events (GtkWidget *widget, * Sets the device event mask (see #GdkEventMask) for a widget. The event * mask determines which events a widget will receive from @device. Keep * in mind that different widgets have different default event masks, and by - * changing the event mask you may disrupt a widget's functionality, + * changing the event mask you may disrupt a widget’s functionality, * so be careful. This function must be called while a widget is * unrealized. Consider gtk_widget_add_device_events() for widgets that are * already realized, or if you want to preserve the existing event @@ -10766,7 +10766,7 @@ gtk_widget_add_device_events (GtkWidget *widget, * ]| * * Return value: (transfer none): the topmost ancestor of @widget, or @widget itself - * if there's no ancestor. + * if there’s no ancestor. **/ GtkWidget* gtk_widget_get_toplevel (GtkWidget *widget) @@ -10786,7 +10786,7 @@ gtk_widget_get_toplevel (GtkWidget *widget) * * Gets the first ancestor of @widget with type @widget_type. For example, * `gtk_widget_get_ancestor (widget, GTK_TYPE_BOX)` gets - * the first #GtkBox that's an ancestor of @widget. No reference will be + * the first #GtkBox that’s an ancestor of @widget. No reference will be * added to the returned widget; it should not be unreferenced. See note * about checking for a toplevel #GtkWindow in the docs for * gtk_widget_get_toplevel(). @@ -11086,8 +11086,8 @@ gtk_widget_get_composite_name (GtkWidget *widget) * Makes all newly-created widgets as composite children until * the corresponding gtk_widget_pop_composite_child() call. * - * A composite child is a child that's an implementation detail of the - * container it's inside and should not be visible to people using the + * A composite child is a child that’s an implementation detail of the + * container it’s inside and should not be visible to people using the * container. Composite children aren't treated differently by GTK (but * see gtk_container_foreach() vs. gtk_container_forall()), but e.g. GUI * builders might want to treat them in a different way. @@ -11739,10 +11739,10 @@ gtk_widget_real_adjust_baseline_request (GtkWidget *widget, /** * _gtk_widget_peek_request_cache: * - * Returns the address of the widget's request cache (strictly for + * Returns the address of the widget’s request cache (strictly for * internal use in gtksizerequest.c) * - * Return value: the address of @widget's size request cache. + * Return value: the address of @widget’s size request cache. **/ gpointer _gtk_widget_peek_request_cache (GtkWidget *widget) @@ -12256,7 +12256,7 @@ gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info) * @widget: a #GtkWidget * @region: (allow-none): shape to be added, or %NULL to remove an existing shape * - * Sets a shape for this widget's GDK window. This allows for + * Sets a shape for this widget’s GDK window. This allows for * transparent windows etc., see gdk_window_shape_combine_region() * for more information. * @@ -12304,7 +12304,7 @@ gtk_widget_shape_combine_region (GtkWidget *widget, * @widget: a #GtkWidget * @region: (allow-none): shape to be added, or %NULL to remove an existing shape * - * Sets an input shape for this widget's GDK window. This allows for + * Sets an input shape for this widget’s GDK window. This allows for * windows which react to mouse click in a nonrectangular region, see * gdk_window_input_shape_combine_region() for more information. * @@ -12690,7 +12690,7 @@ gtk_widget_class_set_accessible_type (GtkWidgetClass *widget_class, * instead. * * If @role is #ATK_ROLE_INVALID, the default role will not be changed - * and the accessible's default role will be used instead. + * and the accessible’s default role will be used instead. * * This function should only be called from class init functions of widgets. * @@ -12714,7 +12714,7 @@ gtk_widget_class_set_accessible_role (GtkWidgetClass *widget_class, * @widget: a #GtkWidget * * Gets the accessible for @widget, if it has been created yet. - * Otherwise, this function returns %NULL. If the @widget's implementation + * Otherwise, this function returns %NULL. If the @widget’s implementation * does not use the default way to create accessibles, %NULL will always be * returned. * @@ -12820,8 +12820,8 @@ gtk_widget_real_get_accessible (GtkWidget *widget) } /* - * Initialize a AtkImplementorIface instance's virtual pointers as - * appropriate to this implementor's class (GtkWidget). + * Initialize a AtkImplementorIface instance’s virtual pointers as + * appropriate to this implementor’s class (GtkWidget). */ static void gtk_widget_accessible_interface_init (AtkImplementorIface *iface) @@ -13078,7 +13078,7 @@ gtk_widget_set_expand_set (GtkWidget *widget, * has the expand flag set. If any child of a widget wants to * expand, the parent may ask to expand also. * - * This function only looks at the widget's own hexpand flag, rather + * This function only looks at the widget’s own hexpand flag, rather * than computing whether the entire widget tree rooted at this widget * wants to expand. * @@ -13120,7 +13120,7 @@ gtk_widget_get_hexpand (GtkWidget *widget) * This function forces the widget to expand or not to expand, * regardless of children. The override occurs because * gtk_widget_set_hexpand() sets the hexpand-set property (see - * gtk_widget_set_hexpand_set()) which causes the widget's hexpand + * gtk_widget_set_hexpand_set()) which causes the widget’s hexpand * value to be used, rather than looking at children and widget state. */ void @@ -13144,7 +13144,7 @@ gtk_widget_set_hexpand (GtkWidget *widget, * set, then the expand value depends on whether any * children of the widget would like to expand. * - * There are few reasons to use this function, but it's here + * There are few reasons to use this function, but it’s here * for completeness and consistency. * * Return value: whether hexpand has been explicitly set @@ -13175,7 +13175,7 @@ gtk_widget_get_hexpand_set (GtkWidget *widget) * set, then the expand value depends on whether any * children of the widget would like to expand. * - * There are few reasons to use this function, but it's here + * There are few reasons to use this function, but it’s here * for completeness and consistency. */ void @@ -14838,10 +14838,10 @@ gtk_widget_get_has_tooltip (GtkWidget *widget) * @widget: a #GtkWidget * @allocation: (out): a pointer to a #GtkAllocation to copy to * - * Retrieves the widget's allocation. + * Retrieves the widget’s allocation. * - * Note, when implementing a #GtkContainer: a widget's allocation will - * be its “adjusted” allocation, that is, the widget's parent + * Note, when implementing a #GtkContainer: a widget’s allocation will + * be its “adjusted” allocation, that is, the widget’s parent * container typically calls gtk_widget_size_allocate() with an * allocation, and that allocation is then adjusted (to handle margin * and alignment for example) before assignment to the widget. @@ -14876,8 +14876,8 @@ gtk_widget_get_allocation (GtkWidget *widget, * @widget: a #GtkWidget * @allocation: a pointer to a #GtkAllocation to copy from * - * Sets the widget's allocation. This should not be used - * directly, but from within a widget's size_allocate method. + * Sets the widget’s allocation. This should not be used + * directly, but from within a widget’s size_allocate method. * * The allocation set should be the “adjusted” or actual * allocation. If you're implementing a #GtkContainer, you want to use @@ -14965,10 +14965,10 @@ gtk_widget_get_allocated_baseline (GtkWidget *widget) * @widget: a #GtkWidget * @requisition: (out): a pointer to a #GtkRequisition to copy to * - * Retrieves the widget's requisition. + * Retrieves the widget’s requisition. * * This function should only be used by widget implementations in - * order to figure whether the widget's requisition has actually + * order to figure whether the widget’s requisition has actually * changed after some internal state change (so that they can call * gtk_widget_queue_resize() instead of gtk_widget_queue_draw()). * @@ -14995,15 +14995,15 @@ gtk_widget_get_requisition (GtkWidget *widget, * @widget: a #GtkWidget * @window: (transfer full): a #GdkWindow * - * Sets a widget's window. This function should only be used in a - * widget's #GtkWidget::realize implementation. The %window passed is + * Sets a widget’s window. This function should only be used in a + * widget’s #GtkWidget::realize implementation. The %window passed is * usually either new window created with gdk_window_new(), or the * window of its parent widget as returned by * gtk_widget_get_parent_window(). * * Widgets must indicate whether they will create their own #GdkWindow * by calling gtk_widget_set_has_window(). This is usually done in the - * widget's init() function. + * widget’s init() function. * * Note that this function does not add any reference to @window. * @@ -15096,9 +15096,9 @@ gtk_widget_unregister_window (GtkWidget *widget, * gtk_widget_get_window: * @widget: a #GtkWidget * - * Returns the widget's window if it is realized, %NULL otherwise + * Returns the widget’s window if it is realized, %NULL otherwise * - * Return value: (transfer none): @widget's window. + * Return value: (transfer none): @widget’s window. * * Since: 2.14 */ @@ -15210,7 +15210,7 @@ gtk_widget_update_alpha (GtkWidget *widget) * For toplevel widgets this depends on the capabilities of the windowing * system. On X11 this has any effect only on X screens with a compositing manager * running. See gtk_widget_is_composited(). On Windows it should work - * always, although setting a window's opacity after the window has been + * always, although setting a window’s opacity after the window has been * shown causes it to flicker once on Windows. * * For child widgets it doesn't work if any affected widget has a native window, or @@ -15283,7 +15283,7 @@ _gtk_widget_set_has_focus (GtkWidget *widget, * This function is not meant to be used by applications. The only time it * should be used is when it is necessary for a #GtkWidget to assign focus * to a widget that is semantically owned by the first widget even though - * it's not a direct child - for instance, a search entry in a floating + * it’s not a direct child - for instance, a search entry in a floating * window similar to the quick search in #GtkTreeView. * * An example of its usage is: @@ -15631,7 +15631,7 @@ _gtk_widget_invalidate_style_context (GtkWidget *widget, * @widget: a #GtkWidget * @intent: the use case for the modifier mask * - * Returns the modifier mask the @widget's windowing system backend + * Returns the modifier mask the @widget’s windowing system backend * uses for a particular purpose. * * See gdk_keymap_get_modifier_mask(). @@ -15897,7 +15897,7 @@ setup_template_child (GtkWidgetTemplate *template_data, * initializers. * * Another reason is that when calling g_object_new() on a widget with - * composite templates, it's important to build the composite widgets + * composite templates, it’s important to build the composite widgets * before the construct properties are set. Properties passed to g_object_new() * should take precedence over properties set in the private template XML. * @@ -15997,7 +15997,7 @@ gtk_widget_init_template (GtkWidget *widget) * For convenience, gtk_widget_class_set_template_from_resource() is also provided. * * Note that any class that installs templates must call gtk_widget_init_template() - * in the widget's instance initializer. + * in the widget’s instance initializer. * * Since: 3.10 */ @@ -16021,7 +16021,7 @@ gtk_widget_class_set_template (GtkWidgetClass *widget_class, * A convenience function to call gtk_widget_class_set_template(). * * Note that any class that installs templates must call gtk_widget_init_template() - * in the widget's instance initializer. + * in the widget’s instance initializer. * * Since: 3.10 */ @@ -16095,7 +16095,7 @@ gtk_widget_class_bind_template_callback_full (GtkWidgetClass *widget_class, * class finalization time, when no classes of type @widget_type are in use anymore. * * For use in lanuage bindings, this will override the default #GtkBuilderConnectFunc to be - * used when parsing GtkBuilder xml from this class's template data. + * used when parsing GtkBuilder xml from this class’s template data. * * Note that this must be called from a composite widget classes class * initializer after calling gtk_widget_class_set_template(). @@ -16127,17 +16127,17 @@ gtk_widget_class_set_connect_func (GtkWidgetClass *widget_class, * @name: The “id” of the child defined in the template XML * @internal_child: Whether the child should be accessible as an “internal-child” * when this class is used in GtkBuilder XML - * @struct_offset: The structure offset into the composite widget's instance public or private structure + * @struct_offset: The structure offset into the composite widget’s instance public or private structure * where the automated child pointer should be set, or 0 to not assign the pointer. * * Automatically assign an object declared in the class template XML to be set to a location - * on a freshly built instance's private data, or alternatively accessible via gtk_widget_get_template_child(). + * on a freshly built instance’s private data, or alternatively accessible via gtk_widget_get_template_child(). * * The struct can point either into the public instance, then you should use G_STRUCT_OFFSET(WidgetType, member) * for @struct_offset, or in the private struct, then you should use G_PRIVATE_OFFSET(WidgetType, member). * * An explicit strong reference will be held automatically for the duration of your - * instance's life cycle, it will be released automatically when #GObjectClass.dispose() runs + * instance’s life cycle, it will be released automatically when #GObjectClass.dispose() runs * on your instance and if a @struct_offset that is != 0 is specified, then the automatic location * in your instance public or private data will be set to %NULL. You can however access an automated child * pointer the first time your classes #GObjectClass.dispose() runs, or alternatively in diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index 31a0a5195f..7649054454 100644 --- a/gtk/gtkwidget.h +++ b/gtk/gtkwidget.h @@ -41,7 +41,7 @@ G_BEGIN_DECLS /** * GtkWidgetHelpType: * @GTK_WIDGET_HELP_TOOLTIP: Tooltip. - * @GTK_WIDGET_HELP_WHATS_THIS: What's this. + * @GTK_WIDGET_HELP_WHATS_THIS: What’s this. * * Kinds of widget-specific help. Used by the ::show-help signal. */ @@ -70,15 +70,15 @@ typedef struct _GtkWidgetAuxInfo GtkWidgetAuxInfo; /** * GtkAllocation: - * @x: the X position of the widget's area relative to its parents allocation. - * @y: the Y position of the widget's area relative to its parents allocation. - * @width: the width of the widget's allocated area. - * @height: the height of the widget's allocated area. + * @x: the X position of the widget’s area relative to its parents allocation. + * @y: the Y position of the widget’s area relative to its parents allocation. + * @width: the width of the widget’s allocated area. + * @height: the height of the widget’s allocated area. * * A #GtkAllocation-struct of a widget represents region * which has been allocated to the widget by its parent. It is a subregion * of its parents allocation. See - * [GtkWidget's geometry management section][geometry-management] for + * [GtkWidget’s geometry management section][geometry-management] for * more information. */ typedef GdkRectangle GtkAllocation; @@ -113,11 +113,11 @@ typedef gboolean (*GtkTickCallback) (GtkWidget *widget, /** * GtkRequisition: - * @width: the widget's desired width - * @height: the widget's desired height + * @width: the widget’s desired width + * @height: the widget’s desired height * * A #GtkRequisition-struct represents the desired size of a widget. See - * [GtkWidget's geometry management section][geometry-management] for + * [GtkWidget’s geometry management section][geometry-management] for * more information. */ struct _GtkRequisition @@ -196,7 +196,7 @@ struct _GtkWidget * %GTK_SIZE_REQUEST_CONSTANT_SIZE disables any height-for-width or * width-for-height geometry management for a said widget and is the * default return. - * It's important to note (as described below) that any widget + * It’s important to note (as described below) that any widget * which trades height-for-width or width-for-height must respond properly * to both of the virtual methods #GtkWidgetClass.get_preferred_height_for_width() * and #GtkWidgetClass.get_preferred_width_for_height() since it might be @@ -208,14 +208,14 @@ struct _GtkWidget * #GtkWidgetClass.get_preferred_height()). * @get_preferred_width_for_height: This is analogous to * #GtkWidgetClass.get_preferred_height_for_width() except that it - * operates in the oposite orientation. It's rare that a widget actually + * operates in the oposite orientation. It’s rare that a widget actually * does %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT requests but this can happen * when, for example, a widget or container gets additional columns to * compensate for a smaller allocated height. * @get_preferred_width: This is called by containers to obtain the minimum * and natural width of a widget. A widget will never be allocated a width * less than its minimum and will only ever be allocated a width greater - * than the natural width once all of the said widget's siblings have + * than the natural width once all of the said widget’s siblings have * received their natural widths. * Furthermore, a widget will only ever be allocated a width greater than * its natural width if it was configured to receive extra expand space @@ -228,7 +228,7 @@ struct _GtkWidget * @mnemonic_activate: Activates the @widget if @group_cycling is * %FALSE, and just grabs the focus if @group_cycling is %TRUE. * @grab_focus: Causes @widget to have the keyboard focus for the - * #GtkWindow it's inside. + * #GtkWindow it’s inside. * @focus: * @move_focus: Signal emitted when a change of focus is requested * @keynav_failed: Signal emitted if keyboard navigation fails. @@ -244,36 +244,36 @@ struct _GtkWidget * @scroll_event: Signal emitted when a button in the 4 to 7 range is * pressed. * @motion_notify_event: Signal emitted when the pointer moves over - * the widget's #GdkWindow. + * the widget’s #GdkWindow. * @delete_event: Signal emitted if a user requests that a toplevel * window is closed. * @destroy_event: Signal is emitted when a #GdkWindow is destroyed. * @key_press_event: Signal emitted when a key is pressed. * @key_release_event: Signal is emitted when a key is released. * @enter_notify_event: Signal event will be emitted when the pointer - * enters the widget's window. + * enters the widget’s window. * @leave_notify_event: Will be emitted when the pointer leaves the - * widget's window. + * widget’s window. * @configure_event: Signal will be emitted when the size, position or - * stacking of the widget's window has changed. + * stacking of the widget’s window has changed. * @focus_in_event: Signal emitted when the keyboard focus enters the - * widget's window. + * widget’s window. * @focus_out_event: Signal emitted when the keyboard focus leaves the - * widget's window. - * @map_event: Signal emitted when the widget's window is mapped. - * @unmap_event: Signal will be emitted when the widget's window is + * widget’s window. + * @map_event: Signal emitted when the widget’s window is mapped. + * @unmap_event: Signal will be emitted when the widget’s window is * unmapped. * @property_notify_event: Signal will be emitted when a property on - * the widget's window has been changed or deleted. + * the widget’s window has been changed or deleted. * @selection_clear_event: Signal will be emitted when the the - * widget's window has lost ownership of a selection. + * widget’s window has lost ownership of a selection. * @selection_request_event: Signal will be emitted when another * client requests ownership of the selection owned by the widget's * window. * @selection_notify_event: * @proximity_in_event: * @proximity_out_event: - * @visibility_notify_event: Signal emitted when the widget's window is + * @visibility_notify_event: Signal emitted when the widget’s window is * obscured or unobscured. * @window_state_event: Signal emitted when the state of the toplevel * window associated to the widget changes. @@ -329,14 +329,14 @@ struct _GtkWidget * greater than -1, it is the proposed allocation in the opposing * orientation that we need the request for. Implementations of * adjust_size_request should chain up to the default implementation, - * which applies #GtkWidget's margin properties and imposes any values + * which applies #GtkWidget’s margin properties and imposes any values * from gtk_widget_set_size_request(). Chaining up should be last, * after your subclass adjusts the request, so * #GtkWidget can apply constraints and add the margin properly. * @adjust_size_allocation: Convert an initial size allocation assigned * by a #GtkContainer using gtk_widget_size_allocate(), into an actual * size allocation to be used by the widget. adjust_size_allocation - * adjusts to a child widget's actual allocation + * adjusts to a child widget’s actual allocation * from what a parent container computed for the * child. The adjusted allocation must be entirely within the original * allocation. In any custom implementation, chain up to the default @@ -609,11 +609,11 @@ struct _GtkWidgetClass /** * GtkWidgetAuxInfo: - * @width: the widget's width - * @height: the widget's height - * @halign: the widget's horizontal alignment - * @valign: the widget's horizontal alignment - * @margin: the widget's #GtkBorder margins + * @width: the widget’s width + * @height: the widget’s height + * @halign: the widget’s horizontal alignment + * @valign: the widget’s horizontal alignment + * @margin: the widget’s #GtkBorder margins * */ struct _GtkWidgetAuxInfo diff --git a/gtk/gtkwin32embed.h b/gtk/gtkwin32embed.h index 6694a6044b..da08dfd875 100644 --- a/gtk/gtkwin32embed.h +++ b/gtk/gtkwin32embed.h @@ -37,7 +37,7 @@ G_BEGIN_DECLS * So far all the window messages are posted to the other * process. Maybe some later enhancement will add also messages that * are sent, i.e. where the sending process waits for the receiving - * process's window procedure to handle the message. + * process’s window procedure to handle the message. */ typedef enum { /* send or post? */ diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index 960784e220..462ac7f86e 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -1903,7 +1903,7 @@ gtk_window_set_title_internal (GtkWindow *window, * displayed in its title bar; on the X Window System, the title bar * is rendered by the [window manager][gtk-X11-arch], * so exactly how the title appears to users may vary - * according to a user's exact configuration. The title should help a + * according to a user’s exact configuration. The title should help a * user distinguish this window from other windows they may have * open. A good title might include the application name and current * document filename, for example. @@ -1983,7 +1983,7 @@ gtk_window_set_wmclass (GtkWindow *window, * In combination with the window title, the window role allows a * [window manager][gtk-X11-arch] to identify "the * same" window when an application is restarted. So for example you - * might set the “toolbox” role on your app's toolbox window, so that + * might set the “toolbox” role on your app’s toolbox window, so that * when the user restarts their session, the window manager can put * the toolbox back in the same place. * @@ -2170,10 +2170,10 @@ _gtk_window_internal_set_focus (GtkWindow *window, * @default_widget: (allow-none): widget to be the default, or %NULL to unset the * default widget for the toplevel. * - * The default widget is the widget that's activated when the user + * The default widget is the widget that’s activated when the user * presses Enter in a dialog (for example). This function sets or * unsets the default widget for a #GtkWindow about. When setting - * (rather than unsetting) the default widget it's generally easier to + * (rather than unsetting) the default widget it’s generally easier to * call gtk_widget_grab_focus() on the widget. Before making a widget * the default widget, you must call gtk_widget_set_can_default() on the * widget you'd like to make the default. @@ -2962,7 +2962,7 @@ gtk_window_get_attached_to (GtkWindow *window) * running. See gtk_widget_is_composited(). On Windows it should work * always. * - * Note that setting a window's opacity after the window has been + * Note that setting a window’s opacity after the window has been * shown causes it to flicker once on Windows. * * Since: 2.12 @@ -3438,7 +3438,7 @@ gtk_window_get_destroy_with_parent (GtkWindow *window) * @window: a #GtkWindow * @setting: whether to hide the titlebar when @window is maximized * - * If @setting is %TRUE, then @window will request that it's titlebar + * If @setting is %TRUE, then @window will request that it’s titlebar * should be hidden when maximized. * This is useful for windows that don't convey any information other * than the application name in the titlebar, to put the available @@ -3761,7 +3761,7 @@ _gtk_window_titlebar_shows_app_menu (GtkWindow *window) * function may not have any effect when called on a window that is * already visible, so you should call it before calling gtk_widget_show(). * - * On Windows, this function always works, since there's no window manager + * On Windows, this function always works, since there’s no window manager * policy involved. * **/ @@ -3835,7 +3835,7 @@ gtk_window_get_decorated (GtkWindow *window) * function may not have any effect when called on a window that is * already visible, so you should call it before calling gtk_widget_show(). * - * On Windows, this function always works, since there's no window manager + * On Windows, this function always works, since there’s no window manager * policy involved. * * Since: 2.10 @@ -4166,7 +4166,7 @@ gtk_window_unrealize_icon (GtkWindow *window) * * Note that transient windows (those who have been set transient for another * window using gtk_window_set_transient_for()) will inherit their - * icon from their transient parent. So there's no need to explicitly + * icon from their transient parent. So there’s no need to explicitly * set the icon on transient windows. **/ void @@ -4210,7 +4210,7 @@ gtk_window_set_icon_list (GtkWindow *window, * The list is copied, but the reference count on each * member won't be incremented. * - * Return value: (element-type GdkPixbuf) (transfer container): copy of window's icon list + * Return value: (element-type GdkPixbuf) (transfer container): copy of window’s icon list **/ GList* gtk_window_get_icon_list (GtkWindow *window) @@ -4670,7 +4670,7 @@ gtk_window_set_default_size_internal (GtkWindow *window, * @width: width in pixels, or -1 to unset the default width * @height: height in pixels, or -1 to unset the default height * - * Sets the default size of a window. If the window's “natural” size + * Sets the default size of a window. If the window’s “natural” size * (its size request) is larger than the default, the default will be * ignored. More generally, if the default size does not obey the * geometry hints for the window (gtk_window_set_geometry_hints() can @@ -4684,7 +4684,7 @@ gtk_window_set_default_size_internal (GtkWindow *window, * again as they normally would. Setting a default size of -1 means to * use the “natural” default size (the size request of the window). * - * For more control over a window's initial size and how resizing works, + * For more control over a window’s initial size and how resizing works, * investigate gtk_window_set_geometry_hints(). * * For some uses, gtk_window_resize() is a more appropriate function. @@ -4871,7 +4871,7 @@ gtk_window_resize_to_geometry (GtkWindow *window, * * Note 3: If you are getting a window size in order to position * the window onscreen, there may be a better way. The preferred - * way is to simply set the window's semantic type with + * way is to simply set the window’s semantic type with * gtk_window_set_type_hint(), which allows the window manager to * e.g. center dialogs. Also, if you set the transient parent of * dialogs with gtk_window_set_transient_for() window managers @@ -4884,7 +4884,7 @@ gtk_window_resize_to_geometry (GtkWindow *window, * application cannot. * * In any case, if you insist on application-specified window - * positioning, there's still a better way than + * positioning, there’s still a better way than * doing it yourself - gtk_window_set_position() will frequently * handle the details for you. * @@ -5059,8 +5059,8 @@ gtk_window_move (GtkWindow *window, * gravity to do things like place a window in a corner of the screen, * because static gravity ignores the window manager decorations. * - * If you are saving and restoring your application's window - * positions, you should know that it's impossible for applications to + * If you are saving and restoring your application’s window + * positions, you should know that it’s impossible for applications to * do this without getting it somewhat wrong because applications do * not have sufficient knowledge of window manager state. The Correct * Mechanism is to support the session management protocol (see the @@ -7449,7 +7449,7 @@ gtk_window_get_has_resize_grip (GtkWindow *window) * If a window has a resize grip, this will retrieve the grip * position, width and height into the specified #GdkRectangle. * - * Returns: %TRUE if the resize grip's area was retrieved + * Returns: %TRUE if the resize grip’s area was retrieved * * Since: 3.0 */ @@ -9936,13 +9936,13 @@ gtk_window_draw (GtkWidget *widget, * Presents a window to the user. This may mean raising the window * in the stacking order, deiconifying it, moving it to the current * desktop, and/or giving it the keyboard focus, possibly dependent - * on the user's platform, window manager, and preferences. + * on the user’s platform, window manager, and preferences. * * If @window is hidden, this function calls gtk_widget_show() * as well. * * This function should be used when the user tries to open a window - * that's already open. Say for example the preferences dialog is + * that’s already open. Say for example the preferences dialog is * currently open, and the user chooses Preferences from the menu * a second time; use gtk_window_present() to move the already-open dialog * where the user can see it. @@ -10027,7 +10027,7 @@ gtk_window_present_with_time (GtkWindow *window, * iconification isn't possible, etc. But normally the window will end * up iconified. Just don't write code that crashes if not. * - * It's permitted to call this function before showing a window, + * It’s permitted to call this function before showing a window, * in which case the window will be iconified before it ever appears * onscreen. * @@ -10100,7 +10100,7 @@ gtk_window_deiconify (GtkWindow *window) * windows. But normally the window will end up stuck. Just don't * write code that crashes if not. * - * It's permitted to call this function before showing a window. + * It’s permitted to call this function before showing a window. * * You can track stickiness via the “window-state-event” signal * on #GtkWidget. @@ -10131,7 +10131,7 @@ gtk_window_stick (GtkWindow *window) * @window: a #GtkWindow * * Asks to unstick @window, which means that it will appear on only - * one of the user's desktops. Note that you shouldn't assume the + * one of the user’s desktops. Note that you shouldn't assume the * window is definitely unstuck afterward, because other entities * (e.g. the user or [window manager][gtk-X11-arch]) could * stick it again. But normally the window will @@ -10173,7 +10173,7 @@ gtk_window_unstick (GtkWindow *window) * normally the window will end up maximized. Just don't write code * that crashes if not. * - * It's permitted to call this function before showing a window, + * It’s permitted to call this function before showing a window, * in which case the window will be maximized when it appears onscreen * initially. * @@ -10324,7 +10324,7 @@ gtk_window_unfullscreen (GtkWindow *window) * normally the window will end kept above. Just don't write code * that crashes if not. * - * It's permitted to call this function before showing a window, + * It’s permitted to call this function before showing a window, * in which case the window will be kept above when it appears onscreen * initially. * @@ -10375,7 +10375,7 @@ gtk_window_set_keep_above (GtkWindow *window, * normally the window will be kept below. Just don't write code * that crashes if not. * - * It's permitted to call this function before showing a window, + * It’s permitted to call this function before showing a window, * in which case the window will be kept below when it appears onscreen * initially. * @@ -11821,7 +11821,7 @@ _gtk_window_set_is_active (GtkWindow *window, * in-process, parented GtkPlug) * * Internal function used by #GtkPlug when it gets parented/unparented by a - * #GtkSocket. This keeps the @window's #GTK_WINDOW_TOPLEVEL flag in sync + * #GtkSocket. This keeps the @window’s #GTK_WINDOW_TOPLEVEL flag in sync * with the global list of toplevel windows. */ void |