Use proper quotes in gdk

This commit is contained in:
William Jon McCann 2014-02-05 14:50:22 -05:00
parent 2a45418b67
commit 47469eb296
15 changed files with 59 additions and 59 deletions

View File

@ -468,7 +468,7 @@ gdk_init (int *argc, char ***argv)
* locked for performance reasons. So e.g. you must coordinate
* accesses to the same #GHashTable from multiple threads.
*
* GTK+ is "thread aware" but not thread safe — it provides a
* GTK+ is thread aware but not thread safe — it provides a
* global lock controlled by gdk_threads_enter()/gdk_threads_leave()
* which protects all use of GTK+. That is, only one thread can use GTK+
* at any given time.

View File

@ -297,7 +297,7 @@ gdk_cursor_new_from_name (GdkDisplay *display,
* cursor sizes.
*
* If @x or @y are `-1`, the pixbuf must have
* options named "x_hot" and "y_hot", resp., containing
* options named x_hot and y_hot, resp., containing
* integer values between `0` and the width resp. height of
* the pixbuf. (Since: 3.0)
*

View File

@ -41,7 +41,7 @@ typedef struct _GdkTimeCoord GdkTimeCoord;
* @GDK_SOURCE_PEN: the device is a stylus of a graphics tablet or similar device.
* @GDK_SOURCE_ERASER: the device is an eraser. Typically, this would be the other end
* of a stylus on a graphics tablet.
* @GDK_SOURCE_CURSOR: the device is a graphics tablet "puck" or similar device.
* @GDK_SOURCE_CURSOR: the device is a graphics tablet puck or similar device.
* @GDK_SOURCE_KEYBOARD: the device is a keyboard.
* @GDK_SOURCE_TOUCHSCREEN: the device is a direct-input touch device, such
* as a touchscreen or tablet. This device type has been added in 3.4.

View File

@ -75,7 +75,7 @@
*
* There may be several virtual devices, and several physical devices could
* be controlling each of these virtual devices. Physical devices may also
* be "floating", which means they are not attached to any virtual device.
* be floating, which means they are not attached to any virtual device.
*
* # Master and slave devices
*

View File

@ -41,7 +41,7 @@
/* When the gdk_quartz_display_open function is removed We can
* immediately include gdkquartzdisplaymanager.h here instead of
* gdkprivate-quartz.h so that we won't have to enable -xobjective-c
* for the "generic" GDK source code.
* for the generic GDK source code.
* #include "quartz/gdkquartzdisplaymanager.h"
*/
#include "quartz/gdkprivate-quartz.h"

View File

@ -911,7 +911,7 @@ gdk_event_get_time (const GdkEvent *event)
* @event: a #GdkEvent or NULL
* @state: (out): return location for state
*
* If the event contains a "state" field, puts that field in @state. Otherwise
* 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
* as if the event had no state field.
@ -1506,7 +1506,7 @@ gdk_event_set_device (GdkEvent *event,
* gdk_event_get_device:
* @event: a #GdkEvent.
*
* If the event contains a "device" field, this function will return
* If the event contains a device field, this function will return
* it, else it will return %NULL.
*
* Returns: (transfer none): a #GdkDevice, or %NULL.

View File

@ -533,7 +533,7 @@ struct _GdkEventAny
* @area: bounding box of @region.
* @region: the region that needs to be redrawn.
* @count: the number of contiguous %GDK_EXPOSE events following this one.
* The only use for this is "exposure compression", i.e. handling all
* The only use for this is exposure compression, i.e. handling all
* contiguous %GDK_EXPOSE events in one go, though GDK performs some
* exposure compression so this is not normally needed.
*

View File

@ -60,7 +60,7 @@
* as g_get_monotonic_time(). The frame time does not advance during
* the time a frame is being painted, and outside of a frame, an attempt
* is made so that all calls to gdk_frame_clock_get_frame_time() that
* are called at a "similar" time get the same value. This means that
* are called at a similar time get the same value. This means that
* if different animations are timed by looking at the difference in
* time between an initial value from gdk_frame_clock_get_frame_time()
* and the value inside the #GdkFrameClock::update signal of the clock,
@ -254,7 +254,7 @@ gdk_frame_clock_init (GdkFrameClock *clock)
* Gets the time that should currently be used for animations. Inside
* 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 time of the conceptual previous frame, which may be either
* the actual previous frame time, or if that's too old, an updated
* time.
*

View File

@ -203,7 +203,7 @@ gdk_frame_timings_get_predicted_presentation_time (GdkFrameTimings *timings)
*
* Gets the natural interval between presentation times for
* the display that this frame was displayed on. Frame presentation
* usually happens during the "vertical blanking interval".
* usually happens during the vertical blanking interval.
*
* Returns: the refresh interval of the display, in microseconds,
* or 0 if the refresh interval is not available.

View File

@ -68,8 +68,8 @@
* this is an identifying number for a physical key. Second, it contains the
* level of the key. The level indicates which symbol on the
* key will be used, in a vertical direction. So on a standard US keyboard, the key
* with the number "1" on it also has the exclamation point ("!") character on
* it. The level indicates whether to use the "1" or the "!" symbol. The letter
* with the number 1 on it also has the exclamation point (!) character on
* it. The level indicates whether to use the 1 or the ! symbol. The letter
* keys are considered to have a lowercase letter at level 0, and an uppercase
* letter at level 1, though only the uppercase letter is printed. Third, the
* #GdkKeymapKey contains a group; groups are not used on standard US keyboards,
@ -87,7 +87,7 @@
* keyboard state -- consisting of hardware keycode pressed, active modifiers, and
* active group -- applies the appropriate rules, and returns the group/level to be
* used to index the keymap, along with the modifiers which did not affect the
* group and level. i.e. it returns "unconsumed modifiers." The keyboard group may
* group and level. i.e. it returns unconsumed modifiers. The keyboard group may
* differ from the effective group used for keymap lookups because some keys don't
* have multiple groups - e.g. the Enter key is always in group 0 regardless of
* keyboard state.
@ -682,7 +682,7 @@ gdk_keymap_get_modifier_mask (GdkKeymap *keymap,
*
* The names are the same as those in the
* `gdk/gdkkeysyms.h` header file
* but without the leading "GDK_KEY_".
* but without the leading GDK_KEY_.
*
* Return value: (transfer none): a string containing the name of the key,
* or %NULL if @keyval is not a valid key. The string should not be
@ -702,7 +702,7 @@ gdk_keyval_name (guint keyval)
*
* The names are the same as those in the
* `gdk/gdkkeysyms.h` header file
* but without the leading "GDK_KEY_".
* but without the leading GDK_KEY_.
*
* Returns: the corresponding key value, or %GDK_KEY_VoidSymbol
* if the key name is not a valid key

View File

@ -46,9 +46,9 @@ typedef struct _GdkKeymapKey GdkKeymapKey;
* characters, and in group 1 it might have two Hebrew characters. The Hebrew
* characters will be printed on the key next to the English characters.
* @level: indicates which symbol on the key will be used, in a vertical direction.
* So on a standard US keyboard, the key with the number "1" on it also has the
* So on a standard US keyboard, the key with the number 1 on it also has the
* exclamation point ("!") character on it. The level indicates whether to use
* the "1" or the "!" symbol. The letter keys are considered to have a lowercase
* the 1 or the ! symbol. The letter keys are considered to have a lowercase
* letter at level 0, and an uppercase letter at level 1, though only the
* uppercase letter is printed.
*

View File

@ -443,7 +443,7 @@ gdk_screen_get_font_options (GdkScreen *screen)
/**
* gdk_screen_set_resolution:
* @screen: a #GdkScreen
* @dpi: the resolution in "dots per inch". (Physical inches aren't actually
* @dpi: the resolution in dots per inch. (Physical inches aren't actually
* involved; the terminology is conventional.)
* Sets the resolution for font handling on the screen. This is a
@ -814,7 +814,7 @@ gdk_screen_get_monitor_geometry (GdkScreen *screen,
* the monitor workarea
*
* Retrieves the #GdkRectangle representing the size and position of
* the "work area" on a monitor within the entire screen area.
* the work area on a monitor within the entire screen area.
*
* The work area should be considered when positioning menus and
* similar popups, to avoid placing them below panels, docks or other

View File

@ -36,13 +36,13 @@
* the way the bits are stored in memory. For example, a piece of display
* hardware might support 24-bit color, 16-bit color, or 8-bit color;
* meaning 24/16/8-bit pixel sizes. For a given pixel size, pixels can
* be in different formats; for example the "red" element of an RGB pixel
* be in different formats; for example the red element of an RGB pixel
* 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.
*
* A number of functions are provided for determining the "best" available
* A number of functions are provided for determining the best available
* visual. For the purposes of making this determination, higher bit depths
* are considered better, and for visuals of the same bit depth,
* %GDK_VISUAL_PSEUDO_COLOR is preferred at 8bpp, otherwise, the visual
@ -111,8 +111,8 @@ gdk_visual_get_system (void)
/**
* gdk_visual_get_best_depth:
*
* Get the best available depth for the default GDK screen. "Best"
* means "largest," i.e. 32 preferred over 24 preferred over 8 bits
* Get the best available depth for the default GDK screen. Best
* means largest, i.e. 32 preferred over 24 preferred over 8 bits
* per pixel.
*
* Return value: best available depth
@ -357,8 +357,8 @@ gdk_visual_get_bits_per_rgb (GdkVisual *visual)
* @precision: (out) (allow-none): A pointer to a #gint to be filled in, or %NULL
*
* Obtains values that are needed to calculate red pixel values in TrueColor
* and DirectColor. The "mask" is the significant bits within the pixel.
* The "shift" is the number of bits left we must shift a primary for it
* and DirectColor. The mask is the significant bits within the pixel.
* The shift is the number of bits left we must shift a primary for it
* to be in position (according to the "mask"). Finally, "precision" refers
* to how much precision the pixel value contains for a particular primary.
*
@ -390,8 +390,8 @@ gdk_visual_get_red_pixel_details (GdkVisual *visual,
* @precision: (out) (allow-none): A pointer to a #gint to be filled in, or %NULL
*
* Obtains values that are needed to calculate green pixel values in TrueColor
* and DirectColor. The "mask" is the significant bits within the pixel.
* The "shift" is the number of bits left we must shift a primary for it
* and DirectColor. The mask is the significant bits within the pixel.
* The shift is the number of bits left we must shift a primary for it
* to be in position (according to the "mask"). Finally, "precision" refers
* to how much precision the pixel value contains for a particular primary.
*
@ -423,8 +423,8 @@ gdk_visual_get_green_pixel_details (GdkVisual *visual,
* @precision: (out) (allow-none): A pointer to a #gint to be filled in, or %NULL
*
* Obtains values that are needed to calculate blue pixel values in TrueColor
* and DirectColor. The "mask" is the significant bits within the pixel.
* The "shift" is the number of bits left we must shift a primary for it
* and DirectColor. The mask is the significant bits within the pixel.
* The shift is the number of bits left we must shift a primary for it
* to be in position (according to the "mask"). Finally, "precision" refers
* to how much precision the pixel value contains for a particular primary.
*

View File

@ -56,7 +56,7 @@
* A #GdkWindow is a (usually) rectangular region on the screen.
* 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
* 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,
* each #GtkButton has a #GdkWindow associated with it.
*
@ -93,15 +93,15 @@
* be it a toplevel window or a child window. In this setup the
* GdkWindow (and other GdkDrawables) were platform independent classes,
* and the actual platform specific implementation was in a delegate
* object available as "impl" in the window object.
* object available as impl in the window object.
*
* With the addition of client side windows and offscreen windows this
* changes a bit. The application-visible GdkWindow object behaves as
* it did before, but not all such windows now have a corresponding native
* window. Instead windows that are "client side" are emulated by the gdk
* window. Instead windows that are client side are emulated by the gdk
* code such that clipping, drawing, moving, events etc work as expected.
*
* For GdkWindows that have a native window the "impl" object is the
* For GdkWindows that have a native window the impl object is the
* same as before. However, for all client side windows the impl object
* is shared with its parent (i.e. all client windows descendants of one
* native window has the same impl.
@ -112,8 +112,8 @@
* windows). Such windows work by allocating a #cairo_surface_t as the backing
* store for drawing operations, which is resized with the window.
*
* GdkWindows have a pointer to the "impl window" they are in, i.e.
* the topmost GdkWindow which have the same "impl" value. This is stored
* GdkWindows have a pointer to the impl window they are in, i.e.
* the topmost GdkWindow which have the same impl value. This is stored
* in impl_window, which is different from the window itself only for client
* side windows.
* All GdkWindows (native or not) track the position of the window in the parent
@ -1052,7 +1052,7 @@ _gdk_window_update_size (GdkWindow *window)
}
/* Find the native window that would be just above "child"
* in the native stacking order if "child" was a native window
* in the native stacking order if child was a native window
* (it doesn't have to be native). If there is no such native
* window inside this native parent then NULL is returned.
* If child is NULL, find lowest native window in parent.
@ -3948,7 +3948,7 @@ gdk_window_invalidate_maybe_recurse_full (GdkWindow *window,
* @user_data: data passed to @child_func
*
* Adds @region to the update area for @window. The update area is the
* region that needs to be redrawn, or "dirty region." The call
* region that needs to be redrawn, or dirty region. The call
* gdk_window_process_updates() sends one or more expose events to the
* window, which together cover the entire update area. An
* application would normally redraw the contents of @window in
@ -3999,7 +3999,7 @@ gdk_window_invalidate_region_full (GdkWindow *window,
* @invalidate_children: %TRUE to also invalidate child windows
*
* Adds @region to the update area for @window. The update area is the
* region that needs to be redrawn, or "dirty region." The call
* region that needs to be redrawn, or dirty region. The call
* gdk_window_process_updates() sends one or more expose events to the
* window, which together cover the entire update area. An
* application would normally redraw the contents of @window in
@ -4033,7 +4033,7 @@ gdk_window_invalidate_region (GdkWindow *window,
* @region: a #cairo_region_t
*
* Adds @region to the update area for @window. The update area is the
* region that needs to be redrawn, or "dirty region." The call
* region that needs to be redrawn, or dirty region. The call
* gdk_window_process_updates() sends one or more expose events to the
* window, which together cover the entire update area. An
* application would normally redraw the contents of @window in
@ -5062,7 +5062,7 @@ gdk_window_restack (GdkWindow *window,
* is gdk_window_hide().
*
* When implementing a #GtkWidget, you should call this function on the widget's
* #GdkWindow as part of the "map" method.
* #GdkWindow as part of the map method.
*/
void
gdk_window_show (GdkWindow *window)
@ -6480,7 +6480,7 @@ gdk_window_merge_child_shapes (GdkWindow *window)
* The alpha channel of the window defines which pixels are
* invisible and allows for nicely antialiased borders,
* and the input shape controls where the window is
* "clickable".
* clickable.
*
* On the X11 platform, this requires version 1.1 of the
* shape extension.
@ -9245,7 +9245,7 @@ _gdk_windowing_got_event (GdkDisplay *display,
* with it.
*
* This function always returns a valid pointer, but it will return a
* pointer to a "nil" surface if @other is already in an error state
* pointer to a nil surface if @other is already in an error state
* or any other error occurs.
*
* Since: 2.22
@ -9320,7 +9320,7 @@ gdk_window_create_similar_surface (GdkWindow * window,
* with it.
*
* This function always returns a valid pointer, but it will return a
* pointer to a "nil" surface if @other is already in an error state
* pointer to a nil surface if @other is already in an error state
* or any other error occurs.
*
* Since: 3.10
@ -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.)
*
@ -9891,7 +9891,7 @@ gdk_window_unstick (GdkWindow *window)
* On X11, asks the window manager to maximize @window, if the window
* manager supports this operation. Not all window managers support
* this, and some deliberately ignore it or don't have a concept of
* "maximized"; so you can't rely on the maximization actually
* maximized; so you can't rely on the maximization actually
* happening. But it will happen with most standard window managers,
* and GDK makes a best effort to get it to happen.
*
@ -9914,7 +9914,7 @@ gdk_window_maximize (GdkWindow *window)
* On X11, asks the window manager to unmaximize @window, if the
* window manager supports this operation. Not all window managers
* support this, and some deliberately ignore it or don't have a
* concept of "maximized"; so you can't rely on the unmaximization
* concept of maximized; so you can't rely on the unmaximization
* actually happening. But it will happen with most standard window
* managers, and GDK makes a best effort to get it to happen.
*
@ -9940,7 +9940,7 @@ gdk_window_unmaximize (GdkWindow *window)
* On X11, asks the window manager to put @window in a fullscreen
* state, if the window manager supports this operation. Not all
* window managers support this, and some deliberately ignore it or
* don't have a concept of "fullscreen"; so you can't rely on the
* don't have a concept of fullscreen; so you can't rely on the
* fullscreenification actually happening. But it will happen with
* most standard window managers, and GDK makes a best effort to get
* it to happen.
@ -10024,7 +10024,7 @@ gdk_window_get_fullscreen_mode (GdkWindow *window)
* On X11, asks the window manager to move @window out of the fullscreen
* state, if the window manager supports this operation. Not all
* window managers support this, and some deliberately ignore it or
* don't have a concept of "fullscreen"; so you can't rely on the
* don't have a concept of fullscreen; so you can't rely on the
* unfullscreenification actually happening. But it will happen with
* most standard window managers, and GDK makes a best effort to get
* it to happen.
@ -10048,7 +10048,7 @@ gdk_window_unfullscreen (GdkWindow *window)
* On X11, asks the window manager to keep @window above, if the window
* manager supports this operation. Not all window managers support
* this, and some deliberately ignore it or don't have a concept of
* "keep above"; so you can't rely on the window being kept above.
* keep above; so you can't rely on the window being kept above.
* But it will happen with most standard window managers,
* and GDK makes a best effort to get it to happen.
*
@ -10072,7 +10072,7 @@ gdk_window_set_keep_above (GdkWindow *window,
* On X11, asks the window manager to keep @window below, if the window
* manager supports this operation. Not all window managers support
* this, and some deliberately ignore it or don't have a concept of
* "keep below"; so you can't rely on the window being kept below.
* keep below; so you can't rely on the window being kept below.
* But it will happen with most standard window managers,
* and GDK makes a best effort to get it to happen.
*
@ -10128,7 +10128,7 @@ gdk_window_set_group (GdkWindow *window,
* @window: a toplevel #GdkWindow
* @decorations: decoration hint mask
*
* "Decorations" are the features the window manager adds to a toplevel #GdkWindow.
* Decorations are the features the window manager adds to a toplevel #GdkWindow.
* This function sets the traditional Motif window manager hints that tell the
* window manager which decorations you would like your window to have.
* Usually you should use gtk_window_set_decorated() on a #GtkWindow instead of
@ -10206,7 +10206,7 @@ gdk_window_set_functions (GdkWindow *window,
* @timestamp: timestamp of mouse click that began the drag (use gdk_event_get_time())
*
* Begins a window resize operation (for a toplevel window).
* You might use this function to implement a "window resize grip," for
* You might use this function to implement a window resize grip, for
* example; in fact #GtkStatusbar uses it. The function works best
* with window managers that support the
* [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
@ -10268,7 +10268,7 @@ gdk_window_begin_resize_drag (GdkWindow *window,
* @timestamp: timestamp of mouse click that began the drag
*
* Begins a window move operation (for a toplevel window).
* You might use this function to implement a "window move grip," for
* You might use this function to implement a window move grip, for
* example. The function works best with window managers that support the
* [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
* but has a fallback implementation for other window managers.

View File

@ -93,8 +93,8 @@ typedef enum
* @GDK_WA_TYPE_HINT: Honor the type_hint field
*
* Used to indicate which fields in the #GdkWindowAttr struct should be honored.
* For example, if you filled in the "cursor" and "x" fields of #GdkWindowAttr,
* pass "@GDK_WA_X | @GDK_WA_CURSOR" to gdk_window_new(). Fields in
* For example, if you filled in the cursor and x fields of #GdkWindowAttr,
* pass @GDK_WA_X | @GDK_WA_CURSOR to gdk_window_new(). Fields in
* #GdkWindowAttr not covered by a bit in this enum are required; for example,
* the @width/@height, @wclass, and @window_type fields are required, they have
* no corresponding flag in #GdkWindowAttributesType.
@ -168,7 +168,7 @@ typedef enum
* @GDK_WINDOW_TYPE_HINT_POPUP_MENU: A menu that does not belong to a menubar,
* e.g. a context menu.
* @GDK_WINDOW_TYPE_HINT_TOOLTIP: A tooltip.
* @GDK_WINDOW_TYPE_HINT_NOTIFICATION: A notification - typically a "bubble"
* @GDK_WINDOW_TYPE_HINT_NOTIFICATION: A notification - typically a bubble
* that belongs to a status icon.
* @GDK_WINDOW_TYPE_HINT_COMBO: A popup from a combo box.
* @GDK_WINDOW_TYPE_HINT_DND: A window that is used to implement a DND cursor.
@ -414,10 +414,10 @@ struct _GdkWindowAttr
* size of one character in the terminal. Finally, the base size should be set
* to the size of one character. The net effect is that the minimum size of the
* terminal will have a 1x1 character terminal area, and only terminal sizes on
* the "character grid" will be allowed.
* the character grid will be allowed.
*
* Here's an example of how the terminal example would be implemented, assuming
* a terminal area widget called "terminal" and a toplevel window "toplevel":
* a terminal area widget called terminal and a toplevel window toplevel:
*
* |[<!-- language="C" -->
* GdkGeometry hints;