AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

docs: use proper apostrophe

Browse Source 
https://wiki.gnome.org/Design/OS/Typography
This commit is contained in:
William Jon McCann 2014-02-07 13:01:26 -05:00
parent f116f0071e
commit 7a208fbbf3
172 changed files with 751 additions and 751 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
gdk/gdkdevice.c
View File

@ -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.

6
gdk/gdkdevice.h
View File

@ -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.
*/

6
gdk/gdkdisplay.c
View File

@ -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

6
gdk/gdkevents.c
View File

@ -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

4
gdk/gdkevents.h
View File

@ -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

4
gdk/gdkframeclock.c
View File

@ -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

4
gdk/gdkframetimings.c
View File

@ -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,

4
gdk/gdkkeys.c
View File

@ -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

8
gdk/gdkpango.c
View File

@ -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
*

2
gdk/gdkpixbuf-drawable.c
View File

@ -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

4
gdk/gdkrectangle.c
View File

@ -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.

2
gdk/gdkrgba.c
View File

@ -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

8
gdk/gdkscreen.c
View File

@ -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

2
gdk/gdktypes.h
View File

@ -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

8
gdk/gdkvisual.c
View File

@ -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.
*

74
gdk/gdkwindow.c
View File

@ -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

10
gdk/gdkwindow.h
View File

@ -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

4
gdk/quartz/gdkeventloop-quartz.c
View File

@ -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.

4
gdk/quartz/gdkwindow-quartz.c
View File

@ -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

4
gdk/win32/gdkdnd-win32.c
View File

@ -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

6
gdk/win32/gdkevents-win32.c
View File

@ -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

2
gdk/win32/gdkmain-win32.c
View File

@ -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 *

2
gdk/x11/gdkcursor-x11.c
View File

@ -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;

10
gdk/x11/gdkdisplay-x11.c
View File

@ -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

4
gdk/x11/gdkkeys-x11.c
View File

@ -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

8
gdk/x11/gdkproperty-x11.c
View File

@ -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,

2
gdk/x11/gdkwindow-x11.c
View File

@ -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)

8
gtk/deprecated/gtkaction.c
View File

@ -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
*

2
gtk/deprecated/gtkactiongroup.c
View File

@ -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}

2
gtk/deprecated/gtkactivatable.c
View File

@ -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

2
gtk/deprecated/gtkactivatable.h
View File

@ -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

2
gtk/deprecated/gtkcolorseldialog.c
View File

@ -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}

2
gtk/deprecated/gtkgradient.c
View File

@ -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.

2
gtk/deprecated/gtkhandlebox.c
View File

@ -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
*

4
gtk/deprecated/gtkhscale.c
View File

@ -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

6
gtk/deprecated/gtkiconfactory.c
View File

@ -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

2
gtk/deprecated/gtkrc.c
View File

@ -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"] =

2
gtk/deprecated/gtkstock.c
View File

@ -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.
*/

20
gtk/deprecated/gtkstyle.c
View File

@ -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

2
gtk/deprecated/gtktable.c
View File

@ -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.

4
gtk/deprecated/gtkvscale.c
View File

@ -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

2
gtk/gtkaboutdialog.c
View File

@ -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.
*

2
gtk/gtkaccelgroup.c
View File

@ -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

2
gtk/gtkaccelmap.c
View File

@ -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: “&lt;Gimp-Toolbox&gt;/File/Dialogs/Tool Options...”.
*

2
gtk/gtkaccessible.c
View File

@ -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.
*

2
gtk/gtkactionable.c
View File

@ -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).

2
gtk/gtkadjustment.c
View File

@ -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.

4
gtk/gtkappchooserwidget.h
View File

@ -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.
*/

6
gtk/gtkassistant.c
View File

@ -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
*

4
gtk/gtkassistant.h
View File

@ -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.
*

2
gtk/gtkbindings.c
View File

@ -130,7 +130,7 @@
* and “&lt;Control&gt;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.
*/

4
gtk/gtkbox.c
View File

@ -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.

14
gtk/gtkbuilder.c
View File

@ -198,7 +198,7 @@
* respective objects.
*
* Additionally, since 3.10 a special &lt;template&gt; 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.

2
gtk/gtkbuilder.h
View File

@ -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.

4
gtk/gtkbutton.c
View File

@ -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
*/

54
gtk/gtkcellarea.c
View File

@ -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.

2
gtk/gtkcellarea.h
View File

@ -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

4
gtk/gtkcellareacontext.c
View File

@ -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.
*

4
gtk/gtkcellareacontext.h
View File

@ -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
{

2
gtk/gtkcelllayout.h
View File

@ -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,

24
gtk/gtkcellrenderer.c
View File

@ -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
*/

8
gtk/gtkcellrenderer.h
View File

@ -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.

2
gtk/gtkcellview.c
View File

@ -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

2
gtk/gtkcheckmenuitem.c
View File

@ -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,

8
gtk/gtkclipboard.c
View File

@ -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.

14
gtk/gtkcombobox.c
View File

@ -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
*/

2
gtk/gtkcombobox.h
View File

@ -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
{

24
gtk/gtkcontainer.c
View File

@ -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

2
gtk/gtkcontainer.h
View File

@ -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

6
gtk/gtkcssprovider.c
View File

@ -123,7 +123,7 @@
* background-color: #898989
* }
*
* /&ast; Theme notebooks, and anything that's within these &ast;/
* /&ast; Theme notebooks, and anything that’s within these &ast;/
* GtkNotebook {
* background-color: #a939f0
* }
@ -269,7 +269,7 @@
*
* # &commat; Rules
*
* GTK+'s CSS supports the &commat;import rule, in order to load another
* GTK+’s CSS supports the &commat;import rule, in order to load another
* CSS style sheet in addition to the currently parsed one.
*
* An example for using the &commat;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>

2
gtk/gtkcsssection.h
View File

@ -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.
*

2
gtk/gtkcssstyleproperty.c
View File

@ -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

18
gtk/gtkdialog.c
View File

@ -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,

20
gtk/gtkdnd-quartz.c
View File

@ -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)

28
gtk/gtkdnd.c
View File

@ -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

4
gtk/gtkdnd.h
View File

@ -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

6
gtk/gtkdrawingarea.c
View File

@ -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.
*

30
gtk/gtkentry.c
View File

@ -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

2
gtk/gtkentrybuffer.c
View File

@ -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
*/

8
gtk/gtkentrycompletion.c
View File

@ -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
*

4
gtk/gtkenums.h
View File

@ -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.

8
gtk/gtkexpander.c
View File

@ -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
*/

30
gtk/gtkfilechooser.c
View File

@ -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.

4
gtk/gtkfilechooser.h
View File

@ -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

6
gtk/gtkfilechooserbutton.c
View File

@ -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.
*

2
gtk/gtkfilechooserdialog.c
View File

@ -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

6
gtk/gtkfilechooserwidget.c
View File

@ -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)

2
gtk/gtkfilesystemmodel.c
View File

@ -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.
*

4
gtk/gtkflowbox.c
View File

@ -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

10
gtk/gtkframe.c
View File

@ -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

2
gtk/gtkgladecatalog.c
View File

@ -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)

2
gtk/gtkgrid.c
View File

@ -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].
*

10
gtk/gtkicontheme.c
View File

@ -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()

24
gtk/gtkiconview.c
View File

@ -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
*/

4
gtk/gtkimage.c
View File

@ -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

2
gtk/gtkimcontext.c
View File

@ -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.

4
gtk/gtkinfobar.c
View File

@ -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.
*

2
gtk/gtkkeyhash.c
View File

@ -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.

38
gtk/gtklabel.c
View File

@ -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)

6
gtk/gtklayout.c
View File

@ -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

Some files were not shown because too many files have changed in this diff Show More