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

docs: use ` instead of <literal>

Browse Source
This commit is contained in:
William Jon McCann 2014-02-04 18:21:13 -05:00
parent 76447c3512
commit a22358c0c0
52 changed files with 277 additions and 277 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
gdk/gdk.c
View File

@ -434,7 +434,7 @@ gdk_init_check (int *argc,
* *
* Initializes the GDK library and connects to the windowing system. * Initializes the GDK library and connects to the windowing system.
* If initialization fails, a warning message is output and the application * If initialization fails, a warning message is output and the application
* terminates with a call to <literal>exit(1)</literal>. * terminates with a call to `exit(1)`.
* *
* Any arguments used by GDK are removed from the array and @argc and @argv * Any arguments used by GDK are removed from the array and @argc and @argv
* are updated accordingly. * are updated accordingly.
@ -1115,7 +1115,7 @@ gdk_get_program_class (void)
* @program_class: a string. * @program_class: a string.
* *
* Sets the program class. The X11 backend uses the program class to set * Sets the program class. The X11 backend uses the program class to set
* the class name part of the <literal>WM_CLASS</literal> property on * the class name part of the `WM_CLASS` property on
* toplevel windows; see the ICCCM. * toplevel windows; see the ICCCM.
*/ */
void void

4
gdk/gdkcolor.c
View File

@ -164,8 +164,8 @@ gdk_color_parse (const gchar *spec,
* @color: a #GdkColor * @color: a #GdkColor
* *
* Returns a textual specification of @color in the hexadecimal form * Returns a textual specification of @color in the hexadecimal form
* <literal>&num;rrrrggggbbbb</literal>, where <literal>r</literal>, * `&num;rrrrggggbbbb`, where `r`,
* <literal>g</literal> and <literal>b</literal> are hex digits * `g` and `b` are hex digits
* representing the red, green and blue components respectively. * representing the red, green and blue components respectively.
* *
* The returned string can be parsed by gdk_color_parse(). * The returned string can be parsed by gdk_color_parse().

4
gdk/gdkcursor.c
View File

@ -296,9 +296,9 @@ gdk_cursor_new_from_name (GdkDisplay *display,
* gdk_display_get_maximal_cursor_size() give information about * gdk_display_get_maximal_cursor_size() give information about
* cursor sizes. * cursor sizes.
* *
* If @x or @y are <literal>-1</literal>, the pixbuf must have * 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 <literal>0</literal> and the width resp. height of * integer values between `0` and the width resp. height of
* the pixbuf. (Since: 3.0) * the pixbuf. (Since: 3.0)
* *
* On the X backend, support for RGBA cursors requires a * On the X backend, support for RGBA cursors requires a

4
gdk/gdkdisplaymanager.c
View File

@ -328,8 +328,8 @@ gdk_display_manager_get_default_display (GdkDisplayManager *manager)
* gdk_display_get_default: * gdk_display_get_default:
* *
* Gets the default #GdkDisplay. This is a convenience * Gets the default #GdkDisplay. This is a convenience
* function for * function for:
* <literal>gdk_display_manager_get_default_display (gdk_display_manager_get ())</literal>. * `gdk_display_manager_get_default_display (gdk_display_manager_get ())`.
* *
* Returns: (transfer none): a #GdkDisplay, or %NULL if there is no default * Returns: (transfer none): a #GdkDisplay, or %NULL if there is no default
* display. * display.

6
gdk/gdkevents.c
View File

@ -1914,12 +1914,12 @@ gdk_event_set_screen (GdkEvent *event,
* @event: a #GdkEvent * @event: a #GdkEvent
* *
* Returns the screen for the event. The screen is * Returns the screen for the event. The screen is
* typically the screen for <literal>event->any.window</literal>, but * typically the screen for `event->any.window`, but
* for events such as mouse events, it is the screen * for events such as mouse events, it is the screen
* where the pointer was when the event occurs - * where the pointer was when the event occurs -
* that is, the screen which has the root window * that is, the screen which has the root window
* to which <literal>event->motion.x_root</literal> and * to which `event->motion.x_root` and
* <literal>event->motion.y_root</literal> are relative. * `event->motion.y_root` are relative.
* *
* Return value: (transfer none): the screen for the event * Return value: (transfer none): the screen for the event
* *

6
gdk/gdkevents.h
View File

@ -176,7 +176,7 @@ typedef void GdkXEvent; /* Can be cast to window system specific
* GdkFilterReturn: * GdkFilterReturn:
* @GDK_FILTER_CONTINUE: event not handled, continue processing. * @GDK_FILTER_CONTINUE: event not handled, continue processing.
* @GDK_FILTER_TRANSLATE: native event translated into a GDK event and stored * @GDK_FILTER_TRANSLATE: native event translated into a GDK event and stored
* in the <literal>event</literal> structure that was passed in. * in the `event` structure that was passed in.
* @GDK_FILTER_REMOVE: event handled, terminate processing. * @GDK_FILTER_REMOVE: event handled, terminate processing.
* *
* Specifies the result of applying a #GdkFilterFunc to a native event. * Specifies the result of applying a #GdkFilterFunc to a native event.
@ -199,7 +199,7 @@ typedef enum {
* converted to GDK events. * converted to GDK events.
* *
* When a filter is called, @event is unpopulated, except for * When a filter is called, @event is unpopulated, except for
* <literal>event->window</literal>. The filter may translate the native * `event->window`. The filter may translate the native
* event to a GDK event and store the result in @event, or handle it without * event to a GDK event and store the result in @event, or handle it without
* translation. If the filter translates the event and processing should * translation. If the filter translates the event and processing should
* continue, it should return %GDK_FILTER_TRANSLATE. * continue, it should return %GDK_FILTER_TRANSLATE.
@ -285,7 +285,7 @@ typedef GdkFilterReturn (*GdkFilterFunc) (GdkXEvent *xevent,
* *
* In some language bindings, the values %GDK_2BUTTON_PRESS and * In some language bindings, the values %GDK_2BUTTON_PRESS and
* %GDK_3BUTTON_PRESS would translate into something syntactically * %GDK_3BUTTON_PRESS would translate into something syntactically
* invalid (eg <literal>Gdk.EventType.2ButtonPress</literal>, where a * invalid (eg `Gdk.EventType.2ButtonPress`, where a
* symbol is not allowed to start with a number). In that case, the * symbol is not allowed to start with a number). In that case, the
* aliases %GDK_DOUBLE_BUTTON_PRESS and %GDK_TRIPLE_BUTTON_PRESS can * aliases %GDK_DOUBLE_BUTTON_PRESS and %GDK_TRIPLE_BUTTON_PRESS can
* be used instead. * be used instead.

12
gdk/gdkkeys.c
View File

@ -497,9 +497,9 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* *
* @consumed_modifiers gives modifiers that should be masked out * @consumed_modifiers gives modifiers that should be masked out
* from @state when comparing this key press to a hot key. For * from @state when comparing this key press to a hot key. For
* instance, on a US keyboard, the <literal>plus</literal> * instance, on a US keyboard, the `plus`
* symbol is shifted, so when comparing a key press to a * symbol is shifted, so when comparing a key press to a
* <literal>&lt;Control&gt;plus</literal> accelerator &lt;Shift&gt; should * `&lt;Control&gt;plus` accelerator &lt;Shift&gt; should
* be masked out. * be masked out.
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
@ -525,16 +525,16 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* ]| * ]|
* *
* However, this did not work if multi-modifier combinations were * However, this did not work if multi-modifier combinations were
* used in the keymap, since, for instance, <literal>&lt;Control&gt;</literal> * used in the keymap, since, for instance, `&lt;Control&gt;`
* would be masked out even if only <literal>&lt;Control&gt;&lt;Alt&gt;</literal> * would be masked out even if only `&lt;Control&gt;&lt;Alt&gt;`
* was used in the keymap. To support this usage as well as well as * was used in the keymap. To support this usage as well as well as
* possible, all single modifier combinations * possible, all single modifier combinations
* that could affect the key for any combination of modifiers will * that could affect the key for any combination of modifiers will
* be returned in @consumed_modifiers; multi-modifier combinations * be returned in @consumed_modifiers; multi-modifier combinations
* are returned only when actually found in @state. When you store * are returned only when actually found in @state. When you store
* accelerators, you should always store them with consumed modifiers * accelerators, you should always store them with consumed modifiers
* removed. Store <literal>&lt;Control&gt;plus</literal>, * removed. Store `&lt;Control&gt;plus`,
* not <literal>&lt;Control&gt;&lt;Shift&gt;plus</literal>, * not `&lt;Control&gt;&lt;Shift&gt;plus`,
* *
* Return value: %TRUE if there was a keyval bound to the keycode/state/group * Return value: %TRUE if there was a keyval bound to the keycode/state/group
**/ **/

4
gdk/gdkrgba.c
View File

@ -330,8 +330,8 @@ gdk_rgba_equal (gconstpointer p1,
* @rgba: a #GdkRGBA * @rgba: a #GdkRGBA
* *
* Returns a textual specification of @rgba in the form * Returns a textual specification of @rgba in the form
* <literal>rgb (r, g, b)</literal> or * `rgb (r, g, b)` or
* <literal>rgba (r, g, b, a)</literal>, * `rgba (r, g, b, a)`,
* where 'r', 'g', 'b' and 'a' represent the red, green, * where 'r', 'g', 'b' and 'a' represent the red, green,
* blue and alpha values respectively. r, g, and b are * blue and alpha values respectively. r, g, and b are
* represented as integers in the range 0 to 255, and a * represented as integers in the range 0 to 255, and a

6
gdk/gdkselection.c
View File

@ -40,12 +40,12 @@
* a named clipboard, identified by a string interned as a #GdkAtom. By * a named clipboard, identified by a string interned as a #GdkAtom. By
* claiming ownership of a selection, an application indicates that it will * claiming ownership of a selection, an application indicates that it will
* be responsible for supplying its contents. The most common selections are * be responsible for supplying its contents. The most common selections are
* <literal>PRIMARY</literal> and <literal>CLIPBOARD</literal>. * `PRIMARY` and `CLIPBOARD`.
* *
* The contents of a selection can be represented in a number of formats, * The contents of a selection can be represented in a number of formats,
* called “targets”. Each target is identified by an atom. * called “targets”. Each target is identified by an atom.
* A list of all possible targets supported by the selection owner can be * A list of all possible targets supported by the selection owner can be
* retrieved by requesting the special target <literal>TARGETS</literal>. When * retrieved by requesting the special target `TARGETS`. When
* a selection is retrieved, the data is accompanied by a type (an atom), and * a selection is retrieved, the data is accompanied by a type (an atom), and
* a format (an integer, representing the number of bits per item). * a format (an integer, representing the number of bits per item).
* See <link linkend="gdk3-Properties-and-Atoms">Properties and Atoms</link> * See <link linkend="gdk3-Properties-and-Atoms">Properties and Atoms</link>
@ -54,7 +54,7 @@
* The functions in this section only contain the lowlevel parts of the * The functions in this section only contain the lowlevel parts of the
* selection protocol. A considerably more complicated implementation is needed * selection protocol. A considerably more complicated implementation is needed
* on top of this. GTK+ contains such an implementation in the functions in * on top of this. GTK+ contains such an implementation in the functions in
* <literal>gtkselection.h</literal> and programmers should use those functions * `gtkselection.h` and programmers should use those functions
* instead of the ones presented here. If you plan to implement selection * instead of the ones presented here. If you plan to implement selection
* handling directly on top of the functions here, you should refer to the * handling directly on top of the functions here, you should refer to the
* X Inter-client Communication Conventions Manual (ICCCM). * X Inter-client Communication Conventions Manual (ICCCM).

32
gdk/gdkselection.h
View File

@ -40,112 +40,112 @@ G_BEGIN_DECLS
/** /**
* GDK_SELECTION_PRIMARY: * GDK_SELECTION_PRIMARY:
* *
* A #GdkAtom representing the <literal>PRIMARY</literal> selection. * A #GdkAtom representing the `PRIMARY` selection.
*/ */
#define GDK_SELECTION_PRIMARY _GDK_MAKE_ATOM (1) #define GDK_SELECTION_PRIMARY _GDK_MAKE_ATOM (1)
/** /**
* GDK_SELECTION_SECONDARY: * GDK_SELECTION_SECONDARY:
* *
* A #GdkAtom representing the <literal>SECONDARY</literal> selection. * A #GdkAtom representing the `SECONDARY` selection.
*/ */
#define GDK_SELECTION_SECONDARY _GDK_MAKE_ATOM (2) #define GDK_SELECTION_SECONDARY _GDK_MAKE_ATOM (2)
/** /**
* GDK_SELECTION_CLIPBOARD: * GDK_SELECTION_CLIPBOARD:
* *
* A #GdkAtom representing the <literal>CLIPBOARD</literal> selection. * A #GdkAtom representing the `CLIPBOARD` selection.
*/ */
#define GDK_SELECTION_CLIPBOARD _GDK_MAKE_ATOM (69) #define GDK_SELECTION_CLIPBOARD _GDK_MAKE_ATOM (69)
/** /**
* GDK_TARGET_BITMAP: * GDK_TARGET_BITMAP:
* *
* A #GdkAtom representing the <literal>BITMAP</literal> selection target. * A #GdkAtom representing the `BITMAP` selection target.
*/ */
#define GDK_TARGET_BITMAP _GDK_MAKE_ATOM (5) #define GDK_TARGET_BITMAP _GDK_MAKE_ATOM (5)
/** /**
* GDK_TARGET_COLORMAP: * GDK_TARGET_COLORMAP:
* *
* A #GdkAtom representing the <literal>COLORMAP</literal> selection target. * A #GdkAtom representing the `COLORMAP` selection target.
*/ */
#define GDK_TARGET_COLORMAP _GDK_MAKE_ATOM (7) #define GDK_TARGET_COLORMAP _GDK_MAKE_ATOM (7)
/** /**
* GDK_TARGET_DRAWABLE: * GDK_TARGET_DRAWABLE:
* *
* A #GdkAtom representing the <literal>DRAWABLE</literal> selection target. * A #GdkAtom representing the `DRAWABLE` selection target.
*/ */
#define GDK_TARGET_DRAWABLE _GDK_MAKE_ATOM (17) #define GDK_TARGET_DRAWABLE _GDK_MAKE_ATOM (17)
/** /**
* GDK_TARGET_PIXMAP: * GDK_TARGET_PIXMAP:
* *
* A #GdkAtom representing the <literal>PIXMAP</literal> selection target. * A #GdkAtom representing the `PIXMAP` selection target.
*/ */
#define GDK_TARGET_PIXMAP _GDK_MAKE_ATOM (20) #define GDK_TARGET_PIXMAP _GDK_MAKE_ATOM (20)
/** /**
* GDK_TARGET_STRING: * GDK_TARGET_STRING:
* *
* A #GdkAtom representing the <literal>STRING</literal> selection target. * A #GdkAtom representing the `STRING` selection target.
*/ */
#define GDK_TARGET_STRING _GDK_MAKE_ATOM (31) #define GDK_TARGET_STRING _GDK_MAKE_ATOM (31)
/** /**
* GDK_SELECTION_TYPE_ATOM: * GDK_SELECTION_TYPE_ATOM:
* *
* A #GdkAtom representing the <literal>ATOM</literal> selection type. * A #GdkAtom representing the `ATOM` selection type.
*/ */
#define GDK_SELECTION_TYPE_ATOM _GDK_MAKE_ATOM (4) #define GDK_SELECTION_TYPE_ATOM _GDK_MAKE_ATOM (4)
/** /**
* GDK_SELECTION_TYPE_BITMAP: * GDK_SELECTION_TYPE_BITMAP:
* *
* A #GdkAtom representing the <literal>BITMAP</literal> selection type. * A #GdkAtom representing the `BITMAP` selection type.
*/ */
#define GDK_SELECTION_TYPE_BITMAP _GDK_MAKE_ATOM (5) #define GDK_SELECTION_TYPE_BITMAP _GDK_MAKE_ATOM (5)
/** /**
* GDK_SELECTION_TYPE_COLORMAP: * GDK_SELECTION_TYPE_COLORMAP:
* *
* A #GdkAtom representing the <literal>COLORMAP</literal> selection type. * A #GdkAtom representing the `COLORMAP` selection type.
*/ */
#define GDK_SELECTION_TYPE_COLORMAP _GDK_MAKE_ATOM (7) #define GDK_SELECTION_TYPE_COLORMAP _GDK_MAKE_ATOM (7)
/** /**
* GDK_SELECTION_TYPE_DRAWABLE: * GDK_SELECTION_TYPE_DRAWABLE:
* *
* A #GdkAtom representing the <literal>DRAWABLE</literal> selection type. * A #GdkAtom representing the `DRAWABLE` selection type.
*/ */
#define GDK_SELECTION_TYPE_DRAWABLE _GDK_MAKE_ATOM (17) #define GDK_SELECTION_TYPE_DRAWABLE _GDK_MAKE_ATOM (17)
/** /**
* GDK_SELECTION_TYPE_INTEGER: * GDK_SELECTION_TYPE_INTEGER:
* *
* A #GdkAtom representing the <literal>INTEGER</literal> selection type. * A #GdkAtom representing the `INTEGER` selection type.
*/ */
#define GDK_SELECTION_TYPE_INTEGER _GDK_MAKE_ATOM (19) #define GDK_SELECTION_TYPE_INTEGER _GDK_MAKE_ATOM (19)
/** /**
* GDK_SELECTION_TYPE_PIXMAP: * GDK_SELECTION_TYPE_PIXMAP:
* *
* A #GdkAtom representing the <literal>PIXMAP</literal> selection type. * A #GdkAtom representing the `PIXMAP` selection type.
*/ */
#define GDK_SELECTION_TYPE_PIXMAP _GDK_MAKE_ATOM (20) #define GDK_SELECTION_TYPE_PIXMAP _GDK_MAKE_ATOM (20)
/** /**
* GDK_SELECTION_TYPE_WINDOW: * GDK_SELECTION_TYPE_WINDOW:
* *
* A #GdkAtom representing the <literal>WINDOW</literal> selection type. * A #GdkAtom representing the `WINDOW` selection type.
*/ */
#define GDK_SELECTION_TYPE_WINDOW _GDK_MAKE_ATOM (33) #define GDK_SELECTION_TYPE_WINDOW _GDK_MAKE_ATOM (33)
/** /**
* GDK_SELECTION_TYPE_STRING: * GDK_SELECTION_TYPE_STRING:
* *
* A #GdkAtom representing the <literal>STRING</literal> selection type. * A #GdkAtom representing the `STRING` selection type.
*/ */
#define GDK_SELECTION_TYPE_STRING _GDK_MAKE_ATOM (31) #define GDK_SELECTION_TYPE_STRING _GDK_MAKE_ATOM (31)

2
gdk/gdktypes.h
View File

@ -108,7 +108,7 @@ typedef struct _GdkAtom *GdkAtom;
* GDK_NONE: * GDK_NONE:
* *
* A null value for #GdkAtom, used in a similar way as * A null value for #GdkAtom, used in a similar way as
* <literal>None</literal> in the Xlib API. * `None` in the Xlib API.
*/ */
#define GDK_NONE _GDK_MAKE_ATOM (0) #define GDK_NONE _GDK_MAKE_ATOM (0)

6
gdk/gdkwindow.c
View File

@ -10658,9 +10658,9 @@ gdk_property_get (GdkWindow *window,
* must match the existing format or an error will occur. * must match the existing format or an error will occur.
* @mode: a value describing how the new data is to be combined * @mode: a value describing how the new data is to be combined
* with the current data. * with the current data.
* @data: the data (a <literal>guchar *</literal> * @data: the data (a `guchar *`
* <literal>gushort *</literal>, or <literal>gulong *</literal>, * `gushort *`, or `gulong *`,
* depending on @format), cast to a <literal>guchar *</literal>. * depending on @format), cast to a `guchar *`.
* @nelements: the number of elements of size determined by the format, * @nelements: the number of elements of size determined by the format,
* contained in @data. * contained in @data.
* *

6
gdk/wayland/gdkdisplay-wayland.c
View File

@ -40,10 +40,10 @@
* @Title: Wayland Interaction * @Title: Wayland Interaction
* *
* The functions in this section are specific to the GDK Wayland backend. * The functions in this section are specific to the GDK Wayland backend.
* To use them, you need to include the <literal>&lt;gdk/gdkwayland.h&gt;</literal> * To use them, you need to include the `&lt;gdk/gdkwayland.h&gt;`
* header and use the Wayland-specific pkg-config files to build your * header and use the Wayland-specific pkg-config files to build your
* application (either <literal>gdk-wayland-3.0</literal> or * application (either `gdk-wayland-3.0` or
* <literal>gtk+-wayland-3.0</literal>). * `gtk+-wayland-3.0`).
* *
* To make your code compile with other GDK backends, guard backend-specific * To make your code compile with other GDK backends, guard backend-specific
* calls by an ifdef as follows. Since GDK may be built with multiple * calls by an ifdef as follows. Since GDK may be built with multiple

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

@ -2441,7 +2441,7 @@ gdk_x11_display_list_devices (GdkDisplay *display)
* @n_events: number of event type codes to register * @n_events: number of event type codes to register
* *
* Registers interest in receiving extension events with type codes * Registers interest in receiving extension events with type codes
* between @event_base and <literal>event_base + n_events - 1</literal>. * between @event_base and `event_base + n_events - 1`.
* The registered events must have the window field in the same place * The registered events must have the window field in the same place
* as core X events (this is not the case for e.g. XKB extension events). * as core X events (this is not the case for e.g. XKB extension events).
* *
@ -2788,7 +2788,7 @@ gdk_x11_display_error_trap_pop_ignored (GdkDisplay *display)
* @sm_client_id: the client id assigned by the session manager when the * @sm_client_id: the client id assigned by the session manager when the
* connection was opened, or %NULL to remove the property. * connection was opened, or %NULL to remove the property.
* *
* Sets the <literal>SM_CLIENT_ID</literal> property on the application's leader window so that * 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 * the window manager can save the application's state using the X11R6 ICCCM
* session management protocol. * session management protocol.
* *

6
gdk/x11/gdkmain-x11.c
View File

@ -52,10 +52,10 @@
* @Title: X Window System Interaction * @Title: X Window System Interaction
* *
* The functions in this section are specific to the GDK X11 backend. * The functions in this section are specific to the GDK X11 backend.
* To use them, you need to include the <literal>&lt;gdk/gdkx.h&gt;</literal> * To use them, you need to include the `&lt;gdk/gdkx.h&gt;`
* header and use the X11-specific pkg-config files to build your * header and use the X11-specific pkg-config files to build your
* application (either <literal>gdk-x11-3.0</literal> or * application (either `gdk-x11-3.0` or
* <literal>gtk+-x11-3.0</literal>). * `gtk+-x11-3.0`).
* *
* To make your code compile with other GDK backends, guard backend-specific * To make your code compile with other GDK backends, guard backend-specific
* calls by an ifdef as follows. Since GDK may be built with multiple * calls by an ifdef as follows. Since GDK may be built with multiple

12
gtk/deprecated/gtkactiongroup.c
View File

@ -48,7 +48,7 @@
* *
* Accelerators are handled by the GTK+ accelerator map. All actions are * Accelerators are handled by the GTK+ accelerator map. All actions are
* assigned an accelerator path (which normally has the form * assigned an accelerator path (which normally has the form
* <literal>&lt;Actions&gt;/group-name/action-name</literal>) * `&lt;Actions&gt;/group-name/action-name`)
* and a shortcut is associated with this accelerator path. All menuitems * and a shortcut is associated with this accelerator path. All menuitems
* and toolitems take on this accelerator path. The GTK+ accelerator map * and toolitems take on this accelerator path. The GTK+ accelerator map
* code makes sure that the correct shortcut is displayed next to the menu * code makes sure that the correct shortcut is displayed next to the menu
@ -918,7 +918,7 @@ check_unique_action (GtkActionGroup *action_group,
* if a user tries to modify the accelerator of a menuitem associated with * if a user tries to modify the accelerator of a menuitem associated with
* the action. Therefore you must either set the accel path yourself with * the action. Therefore you must either set the accel path yourself with
* gtk_action_set_accel_path(), or use * gtk_action_set_accel_path(), or use
* <literal>gtk_action_group_add_action_with_accel (..., NULL)</literal>. * `gtk_action_group_add_action_with_accel (..., NULL)`.
* *
* Since: 2.4 * Since: 2.4
* *
@ -965,7 +965,7 @@ gtk_action_group_add_action (GtkActionGroup *action_group,
* with the stock_id of the action. * with the stock_id of the action.
* *
* Accel paths are set to * Accel paths are set to
* <literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.
* *
* Since: 2.4 * Since: 2.4
* *
@ -1110,7 +1110,7 @@ gtk_action_group_list_actions (GtkActionGroup *action_group)
* *
* The "activate" signals of the actions are connected to the callbacks and * The "activate" signals of the actions are connected to the callbacks and
* their accel paths are set to * their accel paths are set to
* <literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.
* *
* Since: 2.4 * Since: 2.4
* *
@ -1245,7 +1245,7 @@ gtk_action_group_add_actions_full (GtkActionGroup *action_group,
* *
* The "activate" signals of the actions are connected to the callbacks and * The "activate" signals of the actions are connected to the callbacks and
* their accel paths are set to * their accel paths are set to
* <literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.
* *
* Since: 2.4 * Since: 2.4
* *
@ -1365,7 +1365,7 @@ gtk_action_group_add_toggle_actions_full (GtkActionGroup *action_gro
* *
* The "changed" signal of the first radio action is connected to the * The "changed" signal of the first radio action is connected to the
* @on_change callback and the accel paths of the actions are set to * @on_change callback and the accel paths of the actions are set to
* <literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. * `&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable>`.
* *
* Since: 2.4 * Since: 2.4
* *

256
gtk/deprecated/gtkrc.c
View File

@ -100,7 +100,7 @@
* <anchor id="locale-specific-rc"/> * <anchor id="locale-specific-rc"/>
* For each RC file, in addition to the file itself, GTK+ will look for * For each RC file, in addition to the file itself, GTK+ will look for
* a locale-specific file that will be parsed after the main file. * a locale-specific file that will be parsed after the main file.
* For instance, if `LANG` is set to <literal>ja_JP.ujis</literal>, * For instance, if `LANG` is set to `ja_JP.ujis`,
* when loading the default file `~/.gtkrc` then GTK+ looks * when loading the default file `~/.gtkrc` then GTK+ looks
* for `~/.gtkrc.ja_JP` and `~/.gtkrc.ja`, * for `~/.gtkrc.ja_JP` and `~/.gtkrc.ja`,
* and parses the first of those that exists. * and parses the first of those that exists.
@ -109,44 +109,44 @@
* *
* A resource file defines a number of styles and key bindings and * A resource file defines a number of styles and key bindings and
* attaches them to particular widgets. The attachment is done * attaches them to particular widgets. The attachment is done
* by the <literal>widget</literal>, <literal>widget_class</literal>, * by the `widget`, `widget_class`,
* and <literal>class</literal> declarations. As an example * and `class` declarations. As an example
* of such a statement: * of such a statement:
* *
* |[ * |[
* widget "mywindow.*.GtkEntry" style "my-entry-class" * widget "mywindow.*.GtkEntry" style "my-entry-class"
* ]| * ]|
* *
* attaches the style <literal>"my-entry-class"</literal> to all * attaches the style `"my-entry-class"` to all
* widgets whose “widget path” matches the * widgets whose “widget path” matches the
* “pattern” <literal>"mywindow.*.GtkEntry"</literal>. * “pattern” `"mywindow.*.GtkEntry"`.
* That is, all #GtkEntry widgets which are part of a #GtkWindow named * That is, all #GtkEntry widgets which are part of a #GtkWindow named
* <literal>"mywindow"</literal>. * `"mywindow"`.
* *
* The patterns here are given in the standard shell glob syntax. * The patterns here are given in the standard shell glob syntax.
* The <literal>"?"</literal> wildcard matches any character, while * The `"?"` wildcard matches any character, while
* <literal>"*"</literal> matches zero or more of any character. * `"*"` matches zero or more of any character.
* The three types of matching are against the widget path, the * The three types of matching are against the widget path, the
* “class path” and the class hierarchy. Both the * “class path” and the class hierarchy. Both the
* widget path and the class path consist of a <literal>"."</literal> * widget path and the class path consist of a `"."`
* separated list of all the parents of the widget and the widget itself * separated list of all the parents of the widget and the widget itself
* from outermost to innermost. The difference is that in the widget path, * from outermost to innermost. The difference is that in the widget path,
* the name assigned by gtk_widget_set_name() is used if present, otherwise * the name assigned by gtk_widget_set_name() is used if present, otherwise
* the class name of the widget, while for the class path, the class name is * the class name of the widget, while for the class path, the class name is
* always used. * always used.
* *
* Since GTK+ 2.10, <literal>widget_class</literal> paths can also contain * Since GTK+ 2.10, `widget_class` paths can also contain
* <literal>&lt;classname&gt;</literal> substrings, which are matching * `&lt;classname&gt;` substrings, which are matching
* the class with the given name and any derived classes. For instance, * the class with the given name and any derived classes. For instance,
* |[ * |[
* widget_class "*&lt;GtkMenuItem&gt;.GtkLabel" style "my-style" * widget_class "*&lt;GtkMenuItem&gt;.GtkLabel" style "my-style"
* ]| * ]|
* will match #GtkLabel widgets which are contained in any kind of menu item. * will match #GtkLabel widgets which are contained in any kind of menu item.
* *
* So, if you have a #GtkEntry named <literal>"myentry"</literal>, inside of a * So, if you have a #GtkEntry named `"myentry"`, inside of a
* horizontal box in a window named <literal>"mywindow"</literal>, then the * horizontal box in a window named `"mywindow"`, then the
* widget path is: <literal>"mywindow.GtkHBox.myentry"</literal> * widget path is: `"mywindow.GtkHBox.myentry"`
* while the class path is: <literal>"GtkWindow.GtkHBox.GtkEntry"</literal>. * while the class path is: `"GtkWindow.GtkHBox.GtkEntry"`.
* *
* Matching against class is a little different. The pattern match is done * Matching against class is a little different. The pattern match is done
* against all class names in the widgets class hierarchy (not the layout * against all class names in the widgets class hierarchy (not the layout
@ -162,24 +162,24 @@
* by order of specification (later overrides earlier). The priorities * by order of specification (later overrides earlier). The priorities
* that can be specified are (highest to lowest): * that can be specified are (highest to lowest):
* *
* - <literal>highest</literal> * - `highest`
* *
* - <literal>rc</literal> * - `rc`
* *
* - <literal>theme</literal> * - `theme`
* *
* - <literal>application</literal> * - `application`
* *
* - <literal>gtk</literal> * - `gtk`
* *
* - <literal>lowest</literal> * - `lowest`
* *
* <literal>rc</literal> is the default for styles * `rc` is the default for styles
* read from an RC file, <literal>theme</literal> * read from an RC file, `theme`
* is the default for styles read from theme RC files, * is the default for styles read from theme RC files,
* <literal>application</literal> * `application`
* should be used for styles an application sets * should be used for styles an application sets
* up, and <literal>gtk</literal> is used for styles * up, and `gtk` is used for styles
* that GTK+ creates internally. * that GTK+ creates internally.
* *
* # Theme gtkrc files # * # Theme gtkrc files #
@ -230,46 +230,46 @@
* match to a single integer comparison in most cases. * match to a single integer comparison in most cases.
* *
* 4. To avoid complex recursive matching, specification of full class names * 4. To avoid complex recursive matching, specification of full class names
* (for <literal>class</literal> matches) or full path names (for * (for `class` matches) or full path names (for
* <literal>widget</literal> and <literal>widget_class</literal> matches) * `widget` and `widget_class` matches)
* is to be preferred over shortened names * is to be preferred over shortened names
* containing <literal>"*"</literal> or <literal>"?"</literal>. * containing `"*"` or `"?"`.
* *
* 5. If at all necessary, wildcards should only be used at the tail or head * 5. If at all necessary, wildcards should only be used at the tail or head
* of a pattern. This reduces the match complexity to a string comparison * of a pattern. This reduces the match complexity to a string comparison
* per RC style. * per RC style.
* *
* 6. When using wildcards, use of <literal>"?"</literal> should be preferred * 6. When using wildcards, use of `"?"` should be preferred
* over <literal>"*"</literal>. This can reduce the matching complexity from * over `"*"`. This can reduce the matching complexity from
* O(n^2) to O(n). For example <literal>"Gtk*Box"</literal> can be turned into * O(n^2) to O(n). For example `"Gtk*Box"` can be turned into
* <literal>"Gtk?Box"</literal> and will still match #GtkHBox and #GtkVBox. * `"Gtk?Box"` and will still match #GtkHBox and #GtkVBox.
* *
* 7. The use of <literal>"*"</literal> wildcards should be restricted as much * 7. The use of `"*"` wildcards should be restricted as much
* as possible, because matching <literal>"A*B*C*RestString"</literal> can * as possible, because matching `"A*B*C*RestString"` can
* result in matching complexities of O(n^2) worst case. * result in matching complexities of O(n^2) worst case.
* *
* # Toplevel declarations # * # Toplevel declarations #
* *
* An RC file is a text file which is composed of a sequence * An RC file is a text file which is composed of a sequence
* of declarations. <literal>'#'</literal> characters delimit comments and * of declarations. `'#'` characters delimit comments and
* the portion of a line after a <literal>'#'</literal> is ignored when parsing * the portion of a line after a `'#'` is ignored when parsing
* an RC file. * an RC file.
* *
* The possible toplevel declarations are: * The possible toplevel declarations are:
* *
* * <literal>binding <replaceable>name</replaceable> * * `binding <replaceable>name</replaceable>
* { ... }</literal> * { ... }`
* *
* Declares a binding set. * Declares a binding set.
* *
* * <literal>class <replaceable>pattern</replaceable> * * `class <replaceable>pattern</replaceable>
* [ style | binding ][ : <replaceable>priority</replaceable> ] * [ style | binding ][ : <replaceable>priority</replaceable> ]
* <replaceable>name</replaceable></literal> * <replaceable>name</replaceable>`
* *
* Specifies a style or binding set for a particular * Specifies a style or binding set for a particular
* branch of the inheritance hierarchy. * branch of the inheritance hierarchy.
* *
* * <literal>include <replaceable>filename</replaceable></literal> * * `include <replaceable>filename</replaceable>`
* *
* Parses another file at this point. If * Parses another file at this point. If
* <replaceable>filename</replaceable> is not an absolute filename, * <replaceable>filename</replaceable> is not an absolute filename,
@ -279,39 +279,39 @@
* <link linkend="locale-specific-rc">locale-specific variant</link> of * <link linkend="locale-specific-rc">locale-specific variant</link> of
* the included file. * the included file.
* *
* * <literal>module_path <replaceable>path</replaceable></literal> * * `module_path <replaceable>path</replaceable>`
* *
* Sets a path (a list of directories separated * Sets a path (a list of directories separated
* by colons) that will be searched for theme engines referenced in * by colons) that will be searched for theme engines referenced in
* RC files. * RC files.
* *
* * <literal>pixmap_path <replaceable>path</replaceable></literal> * * `pixmap_path <replaceable>path</replaceable>`
* *
* Sets a path (a list of directories separated * Sets a path (a list of directories separated
* by colons) that will be searched for pixmaps referenced in * by colons) that will be searched for pixmaps referenced in
* RC files. * RC files.
* *
* * <literal>im_module_file <replaceable>pathname</replaceable></literal> * * `im_module_file <replaceable>pathname</replaceable>`
* *
* Sets the pathname for the IM modules file. Setting this from RC files * Sets the pathname for the IM modules file. Setting this from RC files
* is deprecated; you should use the environment variable `GTK_IM_MODULE_FILE` * is deprecated; you should use the environment variable `GTK_IM_MODULE_FILE`
* instead. * instead.
* *
* * <literal>style <replaceable>name</replaceable> [ = * * `style <replaceable>name</replaceable> [ =
* <replaceable>parent</replaceable> ] { ... }</literal> * <replaceable>parent</replaceable> ] { ... }`
* *
* Declares a style. * Declares a style.
* *
* * <literal>widget <replaceable>pattern</replaceable> * * `widget <replaceable>pattern</replaceable>
* [ style | binding ][ : <replaceable>priority</replaceable> ] * [ style | binding ][ : <replaceable>priority</replaceable> ]
* <replaceable>name</replaceable></literal> * <replaceable>name</replaceable>`
* *
* Specifies a style or binding set for a particular * Specifies a style or binding set for a particular
* group of widgets by matching on the widget pathname. * group of widgets by matching on the widget pathname.
* *
* * <literal>widget_class <replaceable>pattern</replaceable> * * `widget_class <replaceable>pattern</replaceable>
* [ style | binding ][ : <replaceable>priority</replaceable> ] * [ style | binding ][ : <replaceable>priority</replaceable> ]
* <replaceable>name</replaceable></literal> * <replaceable>name</replaceable>`
* *
* Specifies a style or binding set for a particular * Specifies a style or binding set for a particular
* group of widgets by matching on the class pathname. * group of widgets by matching on the class pathname.
@ -324,127 +324,127 @@
* *
* # Styles # * # Styles #
* *
* A RC style is specified by a <literal>style</literal> * A RC style is specified by a `style`
* declaration in a RC file, and then bound to widgets * declaration in a RC file, and then bound to widgets
* with a <literal>widget</literal>, <literal>widget_class</literal>, * with a `widget`, `widget_class`,
* or <literal>class</literal> declaration. All styles * or `class` declaration. All styles
* applying to a particular widget are composited together * applying to a particular widget are composited together
* with <literal>widget</literal> declarations overriding * with `widget` declarations overriding
* <literal>widget_class</literal> declarations which, in * `widget_class` declarations which, in
* turn, override <literal>class</literal> declarations. * turn, override `class` declarations.
* Within each type of declaration, later declarations override * Within each type of declaration, later declarations override
* earlier ones. * earlier ones.
* *
* Within a <literal>style</literal> declaration, the possible * Within a `style` declaration, the possible
* elements are: * elements are:
* *
* * <literal>bg[<replaceable>state</replaceable>] = <replaceable>color</replaceable></literal> * * `bg[<replaceable>state</replaceable>] = <replaceable>color</replaceable>`
* *
* Sets the color used for the background of most widgets. * Sets the color used for the background of most widgets.
* *
* * <literal>fg[<replaceable>state</replaceable>] = <replaceable>color</replaceable></literal> * * `fg[<replaceable>state</replaceable>] = <replaceable>color</replaceable>`
* *
* Sets the color used for the foreground of most widgets. * Sets the color used for the foreground of most widgets.
* *
* * <literal>base[<replaceable>state</replaceable>] = <replaceable>color</replaceable></literal> * * `base[<replaceable>state</replaceable>] = <replaceable>color</replaceable>`
* *
* Sets the color used for the background of widgets displaying * Sets the color used for the background of widgets displaying
* editable text. This color is used for the background * editable text. This color is used for the background
* of, among others, #GtkText, #GtkEntry, #GtkList, and #GtkCList. * of, among others, #GtkText, #GtkEntry, #GtkList, and #GtkCList.
* *
* * <literal>text[<replaceable>state</replaceable>] = * * `text[<replaceable>state</replaceable>] =
* <replaceable>color</replaceable></literal> * <replaceable>color</replaceable>`
* *
* Sets the color used for foreground of widgets using * Sets the color used for foreground of widgets using
* <literal>base</literal> for the background color. * `base` for the background color.
* *
* * <literal>xthickness = * * `xthickness =
* <replaceable>number</replaceable></literal> * <replaceable>number</replaceable>`
* *
* Sets the xthickness, which is used for various horizontal padding * Sets the xthickness, which is used for various horizontal padding
* values in GTK+. * values in GTK+.
* *
* * <literal>ythickness = * * `ythickness =
* <replaceable>number</replaceable></literal> * <replaceable>number</replaceable>`
* *
* Sets the ythickness, which is used for various vertical padding * Sets the ythickness, which is used for various vertical padding
* values in GTK+. * values in GTK+.
* *
* * <literal>bg_pixmap[<replaceable>state</replaceable>] = * * `bg_pixmap[<replaceable>state</replaceable>] =
* <replaceable>pixmap</replaceable></literal> * <replaceable>pixmap</replaceable>`
* *
* Sets a background pixmap to be used in place of * Sets a background pixmap to be used in place of
* the <literal>bg</literal> color (or for #GtkText, * the `bg` color (or for #GtkText,
* in place of the <literal>base</literal> color. The special * in place of the `base` color. The special
* value <literal>"&lt;parent&gt;"</literal> may be used to indicate that the widget should * value `"&lt;parent&gt;"` may be used to indicate that the widget should
* use the same background pixmap as its parent. The special value * use the same background pixmap as its parent. The special value
* <literal>"&lt;none&gt;"</literal> may be used to indicate no background pixmap. * `"&lt;none&gt;"` may be used to indicate no background pixmap.
* * <literal>font = <replaceable>font</replaceable></literal> * * `font = <replaceable>font</replaceable>`
* *
* Starting with GTK+ 2.0, the "font" and "fontset" * Starting with GTK+ 2.0, the "font" and "fontset"
* declarations are ignored; use "font_name" declarations instead. * declarations are ignored; use "font_name" declarations instead.
* *
* * <literal>fontset = <replaceable>font</replaceable></literal> * * `fontset = <replaceable>font</replaceable>`
* *
* Starting with GTK+ 2.0, the "font" and "fontset" * Starting with GTK+ 2.0, the "font" and "fontset"
* declarations are ignored; use "font_name" declarations instead. * declarations are ignored; use "font_name" declarations instead.
* *
* * <literal>font_name = <replaceable>font</replaceable></literal> * * `font_name = <replaceable>font</replaceable>`
* *
* Sets the font for a widget. <replaceable>font</replaceable> must be * Sets the font for a widget. <replaceable>font</replaceable> must be
* a Pango font name, e.g. <literal>"Sans Italic 10"</literal>. * a Pango font name, e.g. `"Sans Italic 10"`.
* For details about Pango font names, see * For details about Pango font names, see
* pango_font_description_from_string(). * pango_font_description_from_string().
* *
* * <literal>stock[<replaceable>"stock-id"</replaceable>] = { <replaceable>icon source specifications</replaceable> }</literal> * * `stock[<replaceable>"stock-id"</replaceable>] = { <replaceable>icon source specifications</replaceable> }`
* *
* Defines the icon for a stock item. * Defines the icon for a stock item.
* *
* * <literal>color[<replaceable>"color-name"</replaceable>] = <replaceable>color specification</replaceable></literal> * * `color[<replaceable>"color-name"</replaceable>] = <replaceable>color specification</replaceable>`
* *
* Since 2.10, this element can be used to defines symbolic colors. See below for * Since 2.10, this element can be used to defines symbolic colors. See below for
* the syntax of color specifications. * the syntax of color specifications.
* *
* * <literal>engine <replaceable>"engine"</replaceable> { <replaceable>engine-specific * * `engine <replaceable>"engine"</replaceable> { <replaceable>engine-specific
* settings</replaceable> }</literal> * settings</replaceable> }`
* *
* Defines the engine to be used when drawing with this style. * Defines the engine to be used when drawing with this style.
* *
* * <literal><replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable></literal> * * `<replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable>`
* *
* Sets a <link linkend="style-properties">style property</link> for a widget class. * Sets a <link linkend="style-properties">style property</link> for a widget class.
* *
* The colors and background pixmaps are specified as a function of the * The colors and background pixmaps are specified as a function of the
* state of the widget. The states are: * state of the widget. The states are:
* *
* * <literal>NORMAL</literal> * * `NORMAL`
* *
* A color used for a widget in its normal state. * A color used for a widget in its normal state.
* *
* * <literal>ACTIVE</literal> * * `ACTIVE`
* *
* A variant of the <literal>NORMAL</literal> color used when the * A variant of the `NORMAL` color used when the
* widget is in the %GTK_STATE_ACTIVE state, and also for * widget is in the %GTK_STATE_ACTIVE state, and also for
* the trough of a ScrollBar, tabs of a NoteBook * the trough of a ScrollBar, tabs of a NoteBook
* other than the current tab and similar areas. * other than the current tab and similar areas.
* Frequently, this should be a darker variant * Frequently, this should be a darker variant
* of the <literal>NORMAL</literal> color. * of the `NORMAL` color.
* *
* * <literal>PRELIGHT</literal> * * `PRELIGHT`
* *
* A color used for widgets in the %GTK_STATE_PRELIGHT state. This * A color used for widgets in the %GTK_STATE_PRELIGHT state. This
* state is the used for Buttons and MenuItems * state is the used for Buttons and MenuItems
* that have the mouse cursor over them, and for * that have the mouse cursor over them, and for
* their children. * their children.
* *
* * <literal>SELECTED</literal> * * `SELECTED`
* *
* A color used to highlight data selected by the user. * A color used to highlight data selected by the user.
* for instance, the selected items in a list widget, and the * for instance, the selected items in a list widget, and the
* selection in an editable widget. * selection in an editable widget.
* *
* * <literal>INSENSITIVE</literal> * * `INSENSITIVE`
* *
* A color used for the background of widgets that have * A color used for the background of widgets that have
* been set insensitive with gtk_widget_set_sensitive(). * been set insensitive with gtk_widget_set_sensitive().
@ -452,18 +452,18 @@
* <anchor id="color-format"/> * <anchor id="color-format"/>
* Colors can be specified as a string containing a color name (GTK+ knows * Colors can be specified as a string containing a color name (GTK+ knows
* all names from the X color database `/usr/lib/X11/rgb.txt`), * all names from the X color database `/usr/lib/X11/rgb.txt`),
* in one of the hexadecimal forms <literal>#rrrrggggbbbb</literal>, * in one of the hexadecimal forms `#rrrrggggbbbb`,
* <literal>#rrrgggbbb</literal>, <literal>#rrggbb</literal>, * `#rrrgggbbb`, `#rrggbb`,
* or <literal>#rgb</literal>, where <literal>r</literal>, * or `#rgb`, where `r`,
* <literal>g</literal> and <literal>b</literal> are * `g` and `b` are
* hex digits, or they can be specified as a triplet * hex digits, or they can be specified as a triplet
* <literal>{ <replaceable>r</replaceable>, <replaceable>g</replaceable>, * `{ <replaceable>r</replaceable>, <replaceable>g</replaceable>,
* <replaceable>b</replaceable>}</literal>, where <literal>r</literal>, * <replaceable>b</replaceable>}`, where `r`,
* <literal>g</literal> and <literal>b</literal> are either integers in * `g` and `b` are either integers in
* the range 0-65535 or floats in the range 0.0-1.0. * the range 0-65535 or floats in the range 0.0-1.0.
* *
* Since 2.10, colors can also be specified by refering to a symbolic color, as * Since 2.10, colors can also be specified by refering to a symbolic color, as
* follows: <literal>@<!-- -->color-name</literal>, or by using expressions to combine * follows: `@<!-- -->color-name`, or by using expressions to combine
* colors. The following expressions are currently supported: * colors. The following expressions are currently supported:
* *
* * mix (<replaceable>factor</replaceable>, <replaceable>color1</replaceable>, <replaceable>color2</replaceable>) * * mix (<replaceable>factor</replaceable>, <replaceable>color1</replaceable>, <replaceable>color2</replaceable>)
@ -483,12 +483,12 @@
* * lighter (<replaceable>color</replaceable>) * * lighter (<replaceable>color</replaceable>)
* *
* This is an abbreviation for * This is an abbreviation for
* <literal>shade (1.3, <replaceable>color</replaceable>)</literal>. * `shade (1.3, <replaceable>color</replaceable>)`.
* *
* * darker (<replaceable>color</replaceable>) * * darker (<replaceable>color</replaceable>)
* *
* This is an abbreviation for * This is an abbreviation for
* <literal>shade (0.7, <replaceable>color</replaceable>)</literal>. * `shade (0.7, <replaceable>color</replaceable>)`.
* *
* Here are some examples of color expressions: * Here are some examples of color expressions:
* *
@ -498,16 +498,16 @@
* lighter (@<!-- -->foreground) * lighter (@<!-- -->foreground)
* ]| * ]|
* *
* In a <literal>stock</literal> definition, icon sources are specified as a * In a `stock` definition, icon sources are specified as a
* 4-tuple of image filename or icon name, text direction, widget state, and size, in that * 4-tuple of image filename or icon name, text direction, widget state, and size, in that
* order. Each icon source specifies an image filename or icon name to use with a given * order. Each icon source specifies an image filename or icon name to use with a given
* direction, state, and size. Filenames are specified as a string such * direction, state, and size. Filenames are specified as a string such
* as <literal>"itemltr.png"</literal>, while icon names (looked up * as `"itemltr.png"`, while icon names (looked up
* in the current icon theme), are specified with a leading * in the current icon theme), are specified with a leading
* <literal>@</literal>, such as <literal>@"item-ltr"</literal>. * `@`, such as `@"item-ltr"`.
* The <literal>*</literal> character can be used as a * The `*` character can be used as a
* wildcard, and if direction/state/size are omitted they default to * wildcard, and if direction/state/size are omitted they default to
* <literal>*</literal>. So for example, the following specifies different icons to * `*`. So for example, the following specifies different icons to
* use for left-to-right and right-to-left languages: * use for left-to-right and right-to-left languages:
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
@ -539,9 +539,9 @@
* } * }
* ]| * ]|
* *
* The sizes that come with GTK+ itself are <literal>"gtk-menu"</literal>, * The sizes that come with GTK+ itself are `"gtk-menu"`,
* <literal>"gtk-small-toolbar"</literal>, <literal>"gtk-large-toolbar"</literal>, * `"gtk-small-toolbar"`, `"gtk-large-toolbar"`,
* <literal>"gtk-button"</literal>, <literal>"gtk-dialog"</literal>. Applications * `"gtk-button"`, `"gtk-dialog"`. Applications
* can define other sizes. * 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:
@ -558,7 +558,7 @@
* When selecting an icon source to use, GTK+ will consider text direction most * When selecting an icon source to use, GTK+ will consider text direction most
* important, state second, and size third. It will select the best match based on * important, state second, and size third. It will select the best match based on
* those criteria. If an attribute matches exactly (e.g. you specified * those criteria. If an attribute matches exactly (e.g. you specified
* <literal>PRELIGHT</literal> or specified the size), GTK+ won't modify the image; * `PRELIGHT` or specified the size), GTK+ won't modify the image;
* if the attribute matches with a wildcard, GTK+ will scale or modify the image to * if the attribute matches with a wildcard, GTK+ will scale or modify the image to
* match the state and size the user requested. * match the state and size the user requested.
* *
@ -582,41 +582,41 @@
* series of modifiers followed by the name of a key. The * series of modifiers followed by the name of a key. The
* modifiers can be: * modifiers can be:
* *
* - <literal>&lt;alt&gt;</literal> * - `&lt;alt&gt;`
* *
* - <literal>&lt;ctl&gt;</literal> * - `&lt;ctl&gt;`
* *
* - <literal>&lt;control&gt;</literal> * - `&lt;control&gt;`
* *
* - <literal>&lt;meta&gt;</literal> * - `&lt;meta&gt;`
* *
* - <literal>&lt;hyper&gt;</literal> * - `&lt;hyper&gt;`
* *
* - <literal>&lt;super&gt;</literal> * - `&lt;super&gt;`
* *
* - <literal>&lt;mod1&gt;</literal> * - `&lt;mod1&gt;`
* *
* - <literal>&lt;mod2&gt;</literal> * - `&lt;mod2&gt;`
* *
* - <literal>&lt;mod3&gt;</literal> * - `&lt;mod3&gt;`
* *
* - <literal>&lt;mod4&gt;</literal> * - `&lt;mod4&gt;`
* *
* - <literal>&lt;mod5&gt;</literal> * - `&lt;mod5&gt;`
* *
* - <literal>&lt;release&gt;</literal> * - `&lt;release&gt;`
* *
* - <literal>&lt;shft&gt;</literal> * - `&lt;shft&gt;`
* *
* - <literal>&lt;shift&gt;</literal> * - `&lt;shift&gt;`
* *
* <literal>&lt;shft&gt;</literal> is an alias for * `&lt;shft&gt;` is an alias for
* <literal>&lt;shift&gt;</literal>, * `&lt;shift&gt;`,
* <literal>&lt;ctl&gt;</literal> is an alias for * `&lt;ctl&gt;` is an alias for
* <literal>&lt;control&gt;</literal>, * `&lt;control&gt;`,
* and * and
* <literal>&lt;alt&gt;</literal> is an alias for * `&lt;alt&gt;` is an alias for
* <literal>&lt;mod1&gt;</literal>. * `&lt;mod1&gt;`.
* *
* The action that is bound to the key is a sequence * The action that is bound to the key is a sequence
* of signal names (strings) followed by parameters for * of signal names (strings) followed by parameters for

2
gtk/deprecated/gtkstyle.c
View File

@ -918,7 +918,7 @@ gtk_style_has_context (GtkStyle *style)
* *
* Since this function may return a new object, you have to use it * Since this function may return a new object, you have to use it
* in the following way: * in the following way:
* <literal>style = gtk_style_attach (style, window)</literal> * `style = gtk_style_attach (style, window)`
* *
* Returns: Either @style, or a newly-created #GtkStyle. * Returns: Either @style, or a newly-created #GtkStyle.
* If the style is newly created, the style parameter * If the style is newly created, the style parameter

2
gtk/deprecated/gtktable.c
View File

@ -805,7 +805,7 @@ gtk_table_attach (GtkTable *table,
* As there are many options associated with gtk_table_attach(), this convenience * As there are many options associated with gtk_table_attach(), this convenience
* function provides the programmer with a means to add children to a table with * function provides the programmer with a means to add children to a table with
* identical padding and expansion options. The values used for the #GtkAttachOptions * identical padding and expansion options. The values used for the #GtkAttachOptions
* are <literal>GTK_EXPAND | GTK_FILL</literal>, and the padding is set to 0. * are `GTK_EXPAND | GTK_FILL`, and the padding is set to 0.
* *
* Deprecated: 3.4: Use gtk_grid_attach() with #GtkGrid. Note that the attach * Deprecated: 3.4: Use gtk_grid_attach() with #GtkGrid. Note that the attach
* arguments differ between those two functions. * arguments differ between those two functions.

6
gtk/deprecated/gtkuimanager.c
View File

@ -206,9 +206,9 @@
* Merging is done based on the names of the XML elements. Each element is * Merging is done based on the names of the XML elements. Each element is
* identified by a path which consists of the names of its anchestors, separated * identified by a path which consists of the names of its anchestors, separated
* by slashes. For example, the menuitem named "Left" in the example above * by slashes. For example, the menuitem named "Left" in the example above
* has the path <literal>/ui/menubar/JustifyMenu/Left</literal> and the * has the path `/ui/menubar/JustifyMenu/Left` and the
* toolitem with the same name has path * toolitem with the same name has path
* <literal>/ui/toolbar1/JustifyToolItems/Left</literal>. * `/ui/toolbar1/JustifyToolItems/Left`.
* *
* # Accelerators # * # Accelerators #
* *
@ -227,7 +227,7 @@
* can make it hard or impossible to determine in advance whether a separator * can make it hard or impossible to determine in advance whether a separator
* will end up in such an unfortunate position. * will end up in such an unfortunate position.
* *
* For separators in toolbars, you can set <literal>expand="true"</literal> to * For separators in toolbars, you can set `expand="true"` to
* turn them from a small, visible separator to an expanding, invisible one. * turn them from a small, visible separator to an expanding, invisible one.
* Toolitems following an expanding separator are effectively right-aligned. * Toolitems following an expanding separator are effectively right-aligned.
* *

6
gtk/gtkaboutdialog.c
View File

@ -67,8 +67,8 @@
* a program like its logo, name, copyright, website and license. It is * a program like its logo, name, copyright, website and license. It is
* also possible to give credits to the authors, documenters, translators * also possible to give credits to the authors, documenters, translators
* and artists who have worked on the program. An about dialog is typically * and artists who have worked on the program. An about dialog is typically
* opened when the user selects the <literal>About</literal> option from * opened when the user selects the `About` option from
* the <literal>Help</literal> menu. All parts of the dialog are optional. * the `Help` menu. All parts of the dialog are optional.
* *
* About dialogs often contain links and email addresses. GtkAboutDialog * About dialogs often contain links and email addresses. GtkAboutDialog
* displays these as clickable links. By default, it calls gtk_show_uri() * displays these as clickable links. By default, it calls gtk_show_uri()
@ -79,7 +79,7 @@
* use the function gtk_show_about_dialog() which constructs and shows a dialog * use the function gtk_show_about_dialog() which constructs and shows a dialog
* and keeps it around so that it can be shown again. * and keeps it around so that it can be shown again.
* *
* Note that GTK+ sets a default title of <literal>_("About &percnt;s")</literal> * Note that GTK+ sets a default title of `_("About &percnt;s")`
* on the dialog window (where &percnt;s is replaced by the name of the * on the dialog window (where &percnt;s is replaced by the name of the
* application, but in order to ensure proper translation of the title, * application, but in order to ensure proper translation of the title,
* applications should set the title property explicitly when constructing * applications should set the title property explicitly when constructing

4
gtk/gtkactionable.c
View File

@ -228,8 +228,8 @@ gtk_actionable_set_action_target (GtkActionable *actionable,
* the target is string-valued. * the target is string-valued.
* *
* @detailed_action_name is a string of the form * @detailed_action_name is a string of the form
* <literal>"action::target"</literal> where <literal>action</literal> * `"action::target"` where `action`
* is the action name and <literal>target</literal> is the string to use * is the action name and `target` is the string to use
* as the target. * as the target.
* *
* Since: 3.4 * Since: 3.4

8
gtk/gtkactionmuxer.c
View File

@ -651,11 +651,11 @@ gtk_action_muxer_class_init (GObjectClass *class)
* Adds the actions in @action_group to the list of actions provided by * Adds the actions in @action_group to the list of actions provided by
* @muxer. @prefix is prefixed to each action name, such that for each * @muxer. @prefix is prefixed to each action name, such that for each
* action <varname>x</varname> in @action_group, there is an equivalent * action <varname>x</varname> in @action_group, there is an equivalent
* action @prefix<literal>.</literal><varname>x</varname> in @muxer. * action @prefix`.`<varname>x</varname> in @muxer.
* *
* For example, if @prefix is "<literal>app</literal>" and @action_group * For example, if @prefix is "`app`" and @action_group
* contains an action called "<literal>quit</literal>", then @muxer will * contains an action called "`quit`", then @muxer will
* now contain an action called "<literal>app.quit</literal>". * now contain an action called "`app.quit`".
* *
* If any #GtkActionObservers are registered for actions in the group, * If any #GtkActionObservers are registered for actions in the group,
* "action_added" notifications will be emitted, as appropriate. * "action_added" notifications will be emitted, as appropriate.

4
gtk/gtkadjustment.c
View File

@ -147,7 +147,7 @@ gtk_adjustment_class_init (GtkAdjustmentClass *class)
* *
* The maximum value of the adjustment. * The maximum value of the adjustment.
* Note that values will be restricted by * Note that values will be restricted by
* <literal>upper - page-size</literal> if the page-size * `upper - page-size` if the page-size
* property is nonzero. * property is nonzero.
* *
* Since: 2.4 * Since: 2.4
@ -515,7 +515,7 @@ gtk_adjustment_get_upper (GtkAdjustment *adjustment)
* Sets the maximum value of the adjustment. * Sets the maximum value of the adjustment.
* *
* Note that values will be restricted by * Note that values will be restricted by
* <literal>upper - page-size</literal> if the page-size * `upper - page-size` if the page-size
* property is nonzero. * property is nonzero.
* *
* See gtk_adjustment_set_lower() about how to compress multiple * See gtk_adjustment_set_lower() about how to compress multiple

6
gtk/gtkapplicationwindow.c
View File

@ -121,7 +121,7 @@
* *
* Attribute values can be translated using gettext, like other #GtkBuilder * Attribute values can be translated using gettext, like other #GtkBuilder
* content. `&lt;attribute&gt;` elements can be marked for * content. `&lt;attribute&gt;` elements can be marked for
* translation with a <literal>translatable="yes"</literal> attribute. * translation with a `translatable="yes"` attribute.
* It is also possible to specify message context and translator comments, * It is also possible to specify message context and translator comments,
* using the context and comments attributes. To make use of this, the * using the context and comments attributes. To make use of this, the
* #GtkBuilder must have been given the gettext domain to use. * #GtkBuilder must have been given the gettext domain to use.
@ -909,9 +909,9 @@ gtk_application_window_set_show_menubar (GtkApplicationWindow *window,
* @window: a #GtkApplicationWindow * @window: a #GtkApplicationWindow
* *
* Returns the unique ID of the window. If the window has not yet been added to * Returns the unique ID of the window. If the window has not yet been added to
* a #GtkApplication, returns <literal>0</literal>. * a #GtkApplication, returns `0`.
* *
* Returns: the unique ID for @window, or <literal>0</literal> if the window * Returns: the unique ID for @window, or `0` if the window
* has not yet been added to a #GtkApplication * has not yet been added to a #GtkApplication
* *
* Since: 3.6 * Since: 3.6

4
gtk/gtkclipboard.c
View File

@ -328,8 +328,8 @@ clipboard_display_closed (GdkDisplay *display,
* to the default clipboard, i.e. they copy the selection to what the * to the default clipboard, i.e. they copy the selection to what the
* user sees as the clipboard. * user sees as the clipboard.
* *
* (Passing #GDK_NONE is the same as using <literal>gdk_atom_intern * (Passing #GDK_NONE is the same as using `gdk_atom_intern
* ("CLIPBOARD", FALSE)</literal>. See <ulink * ("CLIPBOARD", FALSE)`. See <ulink
* url="http://www.freedesktop.org/Standards/clipboards-spec"> * url="http://www.freedesktop.org/Standards/clipboards-spec">
* http://www.freedesktop.org/Standards/clipboards-spec</ulink> * http://www.freedesktop.org/Standards/clipboards-spec</ulink>
* for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY" * for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY"

8
gtk/gtkcombobox.c
View File

@ -803,8 +803,8 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
* The item which is currently active. If the model is a non-flat treemodel, * The item which is currently active. If the model is a non-flat treemodel,
* and the active item is not an immediate child of the root of the tree, * and the active item is not an immediate child of the root of the tree,
* this property has the value * this property has the value
* <literal>gtk_tree_path_get_indices (path)[0]</literal>, * `gtk_tree_path_get_indices (path)[0]`,
* where <literal>path</literal> is the #GtkTreePath of the active item. * where `path` is the #GtkTreePath of the active item.
* *
* Since: 2.4 * Since: 2.4
*/ */
@ -4258,8 +4258,8 @@ gtk_combo_box_set_column_span_column (GtkComboBox *combo_box,
* 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 * 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 * is not an immediate child of the root of the tree, this function returns
* <literal>gtk_tree_path_get_indices (path)[0]</literal>, where * `gtk_tree_path_get_indices (path)[0]`, where
* <literal>path</literal> is the #GtkTreePath of the active item. * `path` is the #GtkTreePath of the active item.
* *
* Return value: An integer which is the index of the currently 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.

6
gtk/gtkcssprovider.c
View File

@ -103,16 +103,16 @@
* various ways: * various ways:
* - To require that a widget satisfies several conditions, * - To require that a widget satisfies several conditions,
* combine several selectors into one by concatenating them. E.g. * combine several selectors into one by concatenating them. E.g.
* <literal>GtkButton&num;button1</literal> matches a GtkButton widget * `GtkButton&num;button1` matches a GtkButton widget
* with the name button1. * with the name button1.
* - To only match a widget when it occurs inside some other * - To only match a widget when it occurs inside some other
* widget, write the two selectors after each other, separated by whitespace. * widget, write the two selectors after each other, separated by whitespace.
* E.g. <literal>GtkToolBar GtkButton</literal> matches GtkButton widgets * E.g. `GtkToolBar GtkButton` matches GtkButton widgets
* that occur inside a GtkToolBar. * that occur inside a GtkToolBar.
* - In the previous example, the GtkButton is matched even * - In the previous example, the GtkButton is matched even
* if it occurs deeply nested inside the toolbar. To restrict the match * if it occurs deeply nested inside the toolbar. To restrict the match
* to direct children of the parent widget, insert a '>' character between * to direct children of the parent widget, insert a '>' character between
* the two selectors. E.g. <literal>GtkNotebook > GtkLabel</literal> matches * the two selectors. E.g. `GtkNotebook > GtkLabel` matches
* GtkLabel widgets that are direct children of a GtkNotebook. * GtkLabel widgets that are direct children of a GtkNotebook.
* *
* An example of widget classes and names in selectors: * An example of widget classes and names in selectors:

2
gtk/gtkdialog.c
View File

@ -1044,7 +1044,7 @@ gtk_dialog_add_buttons (GtkDialog *dialog,
* @response_id: a response ID * @response_id: a response ID
* @setting: %TRUE for sensitive * @setting: %TRUE for sensitive
* *
* Calls <literal>gtk_widget_set_sensitive (widget, @setting)</literal> * 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. * A convenient way to sensitize/desensitize dialog buttons.
**/ **/

2
gtk/gtkentrycompletion.h
View File

@ -54,7 +54,7 @@ typedef struct _GtkEntryCompletionPrivate GtkEntryCompletionPrivate;
* Note that @key is normalized and case-folded (see g_utf8_normalize() * Note that @key is normalized and case-folded (see g_utf8_normalize()
* and g_utf8_casefold()). If this is not appropriate, match functions * and g_utf8_casefold()). If this is not appropriate, match functions
* have access to the unmodified key via * have access to the unmodified key via
* <literal>gtk_entry_get_text (GTK_ENTRY (gtk_entry_completion_get_entry (<!-- -->)))</literal>. * `gtk_entry_get_text (GTK_ENTRY (gtk_entry_completion_get_entry (<!-- -->)))`.
* *
* Returns: %TRUE if @iter should be displayed as a possible completion * Returns: %TRUE if @iter should be displayed as a possible completion
* for @key * for @key

2
gtk/gtkfilechooserwidget.c
View File

@ -7178,7 +7178,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* <keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo> * <keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>
* with a @path string of "" (the empty * with a @path string of "" (the empty
* string). It is also bound to <keycap>/</keycap> with a * string). It is also bound to <keycap>/</keycap> with a
* @path string of "<literal>/</literal>" * @path string of "`/`"
* (a slash): this lets you type <keycap>/</keycap> and * (a slash): this lets you type <keycap>/</keycap> and
* immediately type a path name. On Unix systems, this is bound to * immediately type a path name. On Unix systems, this is bound to
* <keycap>~</keycap> (tilde) with a <parameter>path</parameter> string * <keycap>~</keycap> (tilde) with a <parameter>path</parameter> string

2
gtk/gtkicontheme.c
View File

@ -73,7 +73,7 @@
* follows the <ulink * follows the <ulink
* url="http://www.freedesktop.org/Standards/icon-theme-spec">Icon * url="http://www.freedesktop.org/Standards/icon-theme-spec">Icon
* Theme Specification</ulink>. There is a default icon theme, * Theme Specification</ulink>. There is a default icon theme,
* named <literal>hicolor</literal> where applications should install * named `hicolor` where applications should install
* their icons, but more additional application themes can be * their icons, but more additional application themes can be
* installed as operating system vendors and users choose. * installed as operating system vendors and users choose.
* *

4
gtk/gtkiconview.c
View File

@ -2187,8 +2187,8 @@ gtk_icon_view_remove_editable (GtkCellArea *area,
* it. Additionally, if @start_editing is %TRUE, then editing should be * it. Additionally, if @start_editing is %TRUE, then editing should be
* started in the specified cell. * started in the specified cell.
* *
* This function is often followed by <literal>gtk_widget_grab_focus * This function is often followed by `gtk_widget_grab_focus
* (icon_view)</literal> in order to give keyboard focus to the widget. * (icon_view)` in order to give keyboard focus to the widget.
* Please note that editing can only happen when the widget is realized. * Please note that editing can only happen when the widget is realized.
* *
* Since: 2.8 * Since: 2.8

2
gtk/gtklabel.c
View File

@ -95,7 +95,7 @@
* Labels may contain “mnemonics”. Mnemonics are * Labels may contain “mnemonics”. Mnemonics are
* underlined characters in the label, used for keyboard navigation. * underlined characters in the label, used for keyboard navigation.
* Mnemonics are created by providing a string with an underscore before * Mnemonics are created by providing a string with an underscore before
* the mnemonic character, such as <literal>"_File"</literal>, to the * the mnemonic character, such as `"_File"`, to the
* functions gtk_label_new_with_mnemonic() or * functions gtk_label_new_with_mnemonic() or
* gtk_label_set_text_with_mnemonic(). * gtk_label_set_text_with_mnemonic().
* *

2
gtk/gtklevelbar.c
View File

@ -1367,7 +1367,7 @@ gtk_level_bar_remove_offset_value (GtkLevelBar *self,
* Adds a new offset marker on @self at the position specified by @value. * Adds a new offset marker on @self at the position specified by @value.
* When the bar value is in the interval topped by @value (or between @value * When the bar value is in the interval topped by @value (or between @value
* and #GtkLevelBar:max-value in case the offset is the last one on the bar) * and #GtkLevelBar:max-value in case the offset is the last one on the bar)
* a style class named <literal>level-</literal>@name will be applied * a style class named `level-`@name will be applied
* when rendering the level bar fill. * when rendering the level bar fill.
* If another offset marker named @name exists, its value will be * If another offset marker named @name exists, its value will be
* replaced by @value. * replaced by @value.

12
gtk/gtkliststore.c
View File

@ -409,8 +409,8 @@ iter_is_valid (GtkTreeIter *iter,
* in. Note that only types derived from standard GObject fundamental types * in. Note that only types derived from standard GObject fundamental types
* are supported. * are supported.
* *
* As an example, <literal>gtk_list_store_new (3, G_TYPE_INT, G_TYPE_STRING, * As an example, `gtk_list_store_new (3, G_TYPE_INT, G_TYPE_STRING,
* GDK_TYPE_PIXBUF);</literal> will create a new #GtkListStore with three columns, of type * GDK_TYPE_PIXBUF);` will create a new #GtkListStore with three columns, of type
* int, string and #GdkPixbuf respectively. * int, string and #GdkPixbuf respectively.
* *
* Return value: a new #GtkListStore * Return value: a new #GtkListStore
@ -1166,8 +1166,8 @@ gtk_list_store_set_valist (GtkListStore *list_store,
* The variable argument list should contain integer column numbers, * The variable argument list should contain integer column numbers,
* each column number followed by the value to be set. * each column number followed by the value to be set.
* The list is terminated by a -1. For example, to set column 0 with type * The list is terminated by a -1. For example, to set column 0 with type
* %G_TYPE_STRING to "Foo", you would write <literal>gtk_list_store_set (store, iter, * %G_TYPE_STRING to "Foo", you would write `gtk_list_store_set (store, iter,
* 0, "Foo", -1)</literal>. * 0, "Foo", -1)`.
* *
* The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it * The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it
* will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED. * will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED.
@ -1679,7 +1679,7 @@ gtk_list_store_reorder_func (GSequenceIter *a,
* @store: A #GtkListStore. * @store: A #GtkListStore.
* @new_order: (array zero-terminated=1): an array of integers mapping the new * @new_order: (array zero-terminated=1): an array of integers mapping the new
* position of each child to its old position before the re-ordering, * position of each child to its old position before the re-ordering,
* i.e. @new_order<literal>[newpos] = oldpos</literal>. It must have * i.e. @new_order`[newpos] = oldpos`. It must have
* exactly as many items as the list store's length. * exactly as many items as the list store's length.
* *
* Reorders @store to follow the order indicated by @new_order. Note that * Reorders @store to follow the order indicated by @new_order. Note that
@ -2165,7 +2165,7 @@ gtk_list_store_has_default_sort_func (GtkTreeSortable *sortable)
* values given to this function. * values given to this function.
* *
* Calling * Calling
* <literal>gtk_list_store_insert_with_values (list_store, iter, position...)</literal> * `gtk_list_store_insert_with_values (list_store, iter, position...)`
* has the same effect as calling * has the same effect as calling
* |[<!-- language="C" --> * |[<!-- language="C" -->
* gtk_list_store_insert (list_store, iter, position); * gtk_list_store_insert (list_store, iter, position);

6
gtk/gtkmain.c
View File

@ -381,7 +381,7 @@ static gboolean do_setlocale = TRUE;
* *
* Prevents gtk_init(), gtk_init_check(), gtk_init_with_args() and * Prevents gtk_init(), gtk_init_check(), gtk_init_with_args() and
* gtk_parse_args() from automatically * gtk_parse_args() from automatically
* calling <literal>setlocale (LC_ALL, "")</literal>. You would * calling `setlocale (LC_ALL, "")`. You would
* want to use this function if you wanted to set the locale for * want to use this function if you wanted to set the locale for
* your program to something other than the user's locale, or if * your program to something other than the user's locale, or if
* you wanted to set different values for different locale categories. * you wanted to set different values for different locale categories.
@ -841,7 +841,7 @@ gtk_get_option_group (gboolean open_default_display)
* understood by GTK+ are stripped before return. * understood by GTK+ are stripped before return.
* @parameter_string: (allow-none): a string which is displayed in * @parameter_string: (allow-none): a string which is displayed in
* the first line of `--help` output, after * the first line of `--help` output, after
* <literal><replaceable>programname</replaceable> [OPTION...]</literal> * `<replaceable>programname</replaceable> [OPTION...]`
* @entries: (array zero-terminated=1): a %NULL-terminated array * @entries: (array zero-terminated=1): a %NULL-terminated array
* of #GOptionEntrys describing the options of your program * of #GOptionEntrys describing the options of your program
* @translation_domain: a translation domain to use for translating * @translation_domain: a translation domain to use for translating
@ -1015,7 +1015,7 @@ gtk_init_check (int *argc,
* your program to fall back to a textual interface you want to * your program to fall back to a textual interface you want to
* call gtk_init_check() instead. * call gtk_init_check() instead.
* *
* Since 2.18, GTK+ calls <literal>signal (SIGPIPE, SIG_IGN)</literal> * Since 2.18, GTK+ calls `signal (SIGPIPE, SIG_IGN)`
* during initialization, to ignore SIGPIPE signals, since these are * during initialization, to ignore SIGPIPE signals, since these are
* almost never wanted in graphical applications. If you do need to * almost never wanted in graphical applications. If you do need to
* handle SIGPIPE for some reason, reset the handler after gtk_init(), * handle SIGPIPE for some reason, reset the handler after gtk_init(),

4
gtk/gtkmenu.c
View File

@ -2035,9 +2035,9 @@ gtk_menu_real_can_activate_accel (GtkWidget *widget,
* purpose, automatically gets an accel path assigned. * purpose, automatically gets an accel path assigned.
* *
* For example, a menu containing menu items "New" and "Exit", will, after * For example, a menu containing menu items "New" and "Exit", will, after
* <literal>gtk_menu_set_accel_path (menu, "&lt;Gnumeric-Sheet&gt;/File");</literal> * `gtk_menu_set_accel_path (menu, "&lt;Gnumeric-Sheet&gt;/File");`
* has been called, assign its items the accel paths: * has been called, assign its items the accel paths:
* <literal>"&lt;Gnumeric-Sheet&gt;/File/New"</literal> and <literal>"&lt;Gnumeric-Sheet&gt;/File/Exit"</literal>. * `"&lt;Gnumeric-Sheet&gt;/File/New"` and `"&lt;Gnumeric-Sheet&gt;/File/Exit"`.
* *
* Assigning accel paths to menu items then enables the user to change * Assigning accel paths to menu items then enables the user to change
* their accelerators at runtime. More details about accelerator paths * their accelerators at runtime. More details about accelerator paths

4
gtk/gtkpaned.c
View File

@ -1896,7 +1896,7 @@ gtk_paned_new (GtkOrientation orientation)
* *
* Adds a child to the top or left pane with default parameters. This is * Adds a child to the top or left pane with default parameters. This is
* equivalent to * equivalent to
* <literal>gtk_paned_pack1 (paned, child, FALSE, TRUE)</literal>. * `gtk_paned_pack1 (paned, child, FALSE, TRUE)`.
*/ */
void void
gtk_paned_add1 (GtkPaned *paned, gtk_paned_add1 (GtkPaned *paned,
@ -1912,7 +1912,7 @@ gtk_paned_add1 (GtkPaned *paned,
* *
* Adds a child to the bottom or right pane with default parameters. This * Adds a child to the bottom or right pane with default parameters. This
* is equivalent to * is equivalent to
* <literal>gtk_paned_pack2 (paned, child, TRUE, TRUE)</literal>. * `gtk_paned_pack2 (paned, child, TRUE, TRUE)`.
*/ */
void void
gtk_paned_add2 (GtkPaned *paned, gtk_paned_add2 (GtkPaned *paned,

2
gtk/gtkprivate.c
View File

@ -71,7 +71,7 @@ _gtk_get_data_prefix (void)
* *
* Return the Unix-style locale string for the language currently in * Return the Unix-style locale string for the language currently in
* effect. On Unix systems, this is the return value from * effect. On Unix systems, this is the return value from
* <literal>setlocale(LC_CTYPE, NULL)</literal>, and the user can * `setlocale(LC_CTYPE, NULL)`, and the user can
* affect this through the environment variables LC_ALL, LC_CTYPE or * affect this through the environment variables LC_ALL, LC_CTYPE or
* LANG (checked in that order). The locale strings typically is in * LANG (checked in that order). The locale strings typically is in
* the form lang_COUNTRY, where lang is an ISO-639 language code, and * the form lang_COUNTRY, where lang is an ISO-639 language code, and

12
gtk/gtksettings.c
View File

@ -976,8 +976,8 @@ gtk_settings_class_init (GtkSettingsClass *class)
* GtkSettings:gtk-print-preview-command: * GtkSettings:gtk-print-preview-command:
* *
* A command to run for displaying the print preview. The command * A command to run for displaying the print preview. The command
* should contain a <literal>&percnt;f</literal> placeholder, which will get replaced by * should contain a `&percnt;f` placeholder, which will get replaced by
* the path to the pdf file. The command may also contain a <literal>&percnt;s</literal> * the path to the pdf file. The command may also contain a `&percnt;s`
* placeholder, which will get replaced by the path to a file * placeholder, which will get replaced by the path to a file
* containing the print settings in the format produced by * containing the print settings in the format produced by
* gtk_print_settings_to_file(). * gtk_print_settings_to_file().
@ -2336,7 +2336,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
* or gtk_widget_class_install_style_property_parser() which parses a * or gtk_widget_class_install_style_property_parser() which parses a
* color given either by its name or in the form * color given either by its name or in the form
* <literal>{ red, green, blue }</literal> where red, green and * `{ red, green, blue }` where red, green and
* blue are integers between 0 and 65535 or floating-point numbers * blue are integers between 0 and 65535 or floating-point numbers
* between 0 and 1. * between 0 and 1.
* *
@ -2477,7 +2477,7 @@ parse_flags_value (GScanner *scanner,
* *
* Flags can be specified by their name, their nickname or * Flags can be specified by their name, their nickname or
* numerically. Multiple flags can be specified in the form * numerically. Multiple flags can be specified in the form
* <literal>"( flag1 | flag2 | ... )"</literal>. * `"( flag1 | flag2 | ... )"`.
* *
* Return value: %TRUE if @gstring could be parsed and @property_value * Return value: %TRUE if @gstring could be parsed and @property_value
* has been set to the resulting flags value. * has been set to the resulting flags value.
@ -2581,7 +2581,7 @@ get_braced_int (GScanner *scanner,
* A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
* or gtk_widget_class_install_style_property_parser() which parses a * or gtk_widget_class_install_style_property_parser() which parses a
* requisition in the form * requisition in the form
* <literal>"{ width, height }"</literal> for integers %width and %height. * `"{ width, height }"` for integers %width and %height.
* *
* Return value: %TRUE if @gstring could be parsed and @property_value * Return value: %TRUE if @gstring could be parsed and @property_value
* has been set to the resulting #GtkRequisition. * has been set to the resulting #GtkRequisition.
@ -2622,7 +2622,7 @@ gtk_rc_property_parse_requisition (const GParamSpec *pspec,
* A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
* or gtk_widget_class_install_style_property_parser() which parses * or gtk_widget_class_install_style_property_parser() which parses
* borders in the form * borders in the form
* <literal>"{ left, right, top, bottom }"</literal> for integers * `"{ left, right, top, bottom }"` for integers
* left, right, top and bottom. * left, right, top and bottom.
* *
* Return value: %TRUE if @gstring could be parsed and @property_value * Return value: %TRUE if @gstring could be parsed and @property_value

2
gtk/gtksizegroup.c
View File

@ -85,7 +85,7 @@
* ## GtkSizeGroup as GtkBuildable * ## GtkSizeGroup as GtkBuildable
* *
* Size groups can be specified in a UI definition by placing an * Size groups can be specified in a UI definition by placing an
* &lt;object&gt; element with <literal>class="GtkSizeGroup"</literal> * &lt;object&gt; element with `class="GtkSizeGroup"`
* somewhere in the UI definition. The widgets that belong to the * somewhere in the UI definition. The widgets that belong to the
* size group are specified by a &lt;widgets&gt; element that may * size group are specified by a &lt;widgets&gt; element that may
* contain multiple &lt;widget&gt; elements, one for each member * contain multiple &lt;widget&gt; elements, one for each member

2
gtk/gtksocket.c
View File

@ -304,7 +304,7 @@ gtk_socket_new (void)
* client may be in the same process or in a different process. * client may be in the same process or in a different process.
* *
* To embed a #GtkPlug in a #GtkSocket, you can either create the * To embed a #GtkPlug in a #GtkSocket, you can either create the
* #GtkPlug with <literal>gtk_plug_new (0)</literal>, call * #GtkPlug with `gtk_plug_new (0)`, call
* gtk_plug_get_id() to get the window ID of the plug, and then pass that to the * gtk_plug_get_id() to get the window ID of the plug, and then pass that to the
* gtk_socket_add_id(), or you can call gtk_socket_get_id() to get the * gtk_socket_add_id(), or you can call gtk_socket_get_id() to get the
* window ID for the socket, and call gtk_plug_new() passing in that * window ID for the socket, and call gtk_plug_new() passing in that

2
gtk/gtktextbuffer.h
View File

@ -53,7 +53,7 @@ G_BEGIN_DECLS
* lists returned by gtk_text_buffer_get_copy_target_list() and * lists returned by gtk_text_buffer_get_copy_target_list() and
* gtk_text_buffer_get_paste_target_list(). * gtk_text_buffer_get_paste_target_list().
* *
* The values counts down from <literal>-1</literal> to avoid clashes * The values counts down from `-1` to avoid clashes
* with application added drag destinations which usually start at 0. * with application added drag destinations which usually start at 0.
*/ */
typedef enum typedef enum

4
gtk/gtktextiter.c
View File

@ -406,7 +406,7 @@ gtk_text_iter_get_buffer (const GtkTextIter *iter)
* *
* Creates a dynamically-allocated copy of an iterator. This function * Creates a dynamically-allocated copy of an iterator. This function
* is not useful in applications, because iterators can be copied with a * is not useful in applications, because iterators can be copied with a
* simple assignment (<literal>GtkTextIter i = j;</literal>). The * simple assignment (`GtkTextIter i = j;`). The
* function is used by language bindings. * function is used by language bindings.
* *
* Return value: a copy of the @iter, free with gtk_text_iter_free () * Return value: a copy of the @iter, free with gtk_text_iter_free ()
@ -449,7 +449,7 @@ gtk_text_iter_free (GtkTextIter *iter)
* *
* Assigns the value of @other to @iter. This function * Assigns the value of @other to @iter. This function
* is not useful in applications, because iterators can be assigned * is not useful in applications, because iterators can be assigned
* with <literal>GtkTextIter i = j;</literal>. The * with `GtkTextIter i = j;`. The
* function is used by language bindings. * function is used by language bindings.
* *
* Since: 3.2 * Since: 3.2

2
gtk/gtktextview.c
View File

@ -9502,7 +9502,7 @@ gtk_text_view_get_window (GtkTextView *text_view,
* *
* Usually used to find out which window an event corresponds to. * Usually used to find out which window an event corresponds to.
* If you connect to an event signal on @text_view, this function * If you connect to an event signal on @text_view, this function
* should be called on <literal>event-&gt;window</literal> to * should be called on `event-&gt;window` to
* see which window it was. * see which window it was.
* *
* Return value: the window type. * Return value: the window type.

14
gtk/gtktreemodel.c
View File

@ -450,7 +450,7 @@ gtk_tree_model_base_init (gpointer g_class)
* have been reordered, or %NULL if the depth of @path is 0 * have been reordered, or %NULL if the depth of @path is 0
* @new_order: an array of integers mapping the current position * @new_order: an array of integers mapping the current position
* of each child to its old position before the re-ordering, * of each child to its old position before the re-ordering,
* i.e. @new_order<literal>[newpos] = oldpos</literal> * i.e. @new_order`[newpos] = oldpos`
* *
* This signal is emitted when the children of a node in the * This signal is emitted when the children of a node in the
* #GtkTreeModel have been reordered. * #GtkTreeModel have been reordered.
@ -1122,7 +1122,7 @@ gtk_tree_path_down (GtkTreePath *path)
* *
* This function is not intended for use in applications, * This function is not intended for use in applications,
* because you can just copy the structs by value * because you can just copy the structs by value
* (<literal>GtkTreeIter new_iter = iter;</literal>). * (`GtkTreeIter new_iter = iter;`).
* You must free this iter with gtk_tree_iter_free(). * You must free this iter with gtk_tree_iter_free().
* *
* Return value: a newly-allocated copy of @iter * Return value: a newly-allocated copy of @iter
@ -1509,7 +1509,7 @@ gtk_tree_model_iter_previous (GtkTreeModel *tree_model,
* function has been called. * function has been called.
* *
* If @parent is %NULL returns the first node, equivalent to * If @parent is %NULL returns the first node, equivalent to
* <literal>gtk_tree_model_get_iter_first (tree_model, iter);</literal> * `gtk_tree_model_get_iter_first (tree_model, iter);`
* *
* Return value: %TRUE, if @child has been set to the first child * Return value: %TRUE, if @child has been set to the first child
*/ */
@ -1728,8 +1728,8 @@ gtk_tree_model_unref_node (GtkTreeModel *tree_model,
* each column number followed by a place to store the value being * each column number followed by a place to store the value being
* retrieved. The list is terminated by a -1. For example, to get a * retrieved. The list is terminated by a -1. For example, to get a
* value from column 0 with type %G_TYPE_STRING, you would * value from column 0 with type %G_TYPE_STRING, you would
* write: <literal>gtk_tree_model_get (model, iter, 0, &amp;place_string_here, -1)</literal>, * write: `gtk_tree_model_get (model, iter, 0, &amp;place_string_here, -1)`,
* where <literal>place_string_here</literal> is a #gchararray * where `place_string_here` is a #gchararray
* to be filled with the string. * to be filled with the string.
* *
* Returned values with type %G_TYPE_OBJECT have to be unreferenced, * Returned values with type %G_TYPE_OBJECT have to be unreferenced,
@ -1899,7 +1899,7 @@ gtk_tree_model_row_deleted (GtkTreeModel *tree_model,
* have been reordered, or %NULL if the depth of @path is 0 * have been reordered, or %NULL if the depth of @path is 0
* @new_order: an array of integers mapping the current position of * @new_order: an array of integers mapping the current position of
* each child to its old position before the re-ordering, * each child to its old position before the re-ordering,
* i.e. @new_order<literal>[newpos] = oldpos</literal> * i.e. @new_order`[newpos] = oldpos`
* *
* Emits the #GtkTreeModel::rows-reordered signal on @tree_model. * Emits the #GtkTreeModel::rows-reordered signal on @tree_model.
* *
@ -1929,7 +1929,7 @@ gtk_tree_model_rows_reordered (GtkTreeModel *tree_model,
* @new_order: (array length=length): an array of integers * @new_order: (array length=length): an array of integers
* mapping the current position of each child to its old * mapping the current position of each child to its old
* position before the re-ordering, * position before the re-ordering,
* i.e. @new_order<literal>[newpos] = oldpos</literal> * i.e. @new_order`[newpos] = oldpos`
* @length: length of @new_order array * @length: length of @new_order array
* *
* Emits the #GtkTreeModel::rows-reordered signal on @tree_model. * Emits the #GtkTreeModel::rows-reordered signal on @tree_model.

2
gtk/gtktreesortable.h
View File

@ -75,7 +75,7 @@ typedef struct _GtkTreeSortableIface GtkTreeSortableIface;
* *
* For example, if @model is a product catalogue, then a compare function * For example, if @model is a product catalogue, then a compare function
* for the "price" column could be one which returns * for the "price" column could be one which returns
* <literal>price_of(@a) - price_of(@b)</literal>. * `price_of(@a) - price_of(@b)`.
* *
* Returns: a negative integer, zero or a positive integer depending on whether * Returns: a negative integer, zero or a positive integer depending on whether
* @a sorts before, with or after @b * @a sorts before, with or after @b

10
gtk/gtktreestore.c
View File

@ -304,8 +304,8 @@ gtk_tree_store_init (GtkTreeStore *tree_store)
* in. Note that only types derived from standard GObject fundamental types * in. Note that only types derived from standard GObject fundamental types
* are supported. * are supported.
* *
* As an example, <literal>gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING, * As an example, `gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING,
* GDK_TYPE_PIXBUF);</literal> will create a new #GtkTreeStore with three columns, of type * GDK_TYPE_PIXBUF);` will create a new #GtkTreeStore with three columns, of type
* #gint, #gchararray, and #GdkPixbuf respectively. * #gint, #gchararray, and #GdkPixbuf respectively.
* *
* Return value: a new #GtkTreeStore * Return value: a new #GtkTreeStore
@ -1170,7 +1170,7 @@ gtk_tree_store_set_valist (GtkTreeStore *tree_store,
* each column number followed by the value to be set. * each column number followed by the value to be set.
* The list is terminated by a -1. For example, to set column 0 with type * The list is terminated by a -1. For example, to set column 0 with type
* %G_TYPE_STRING to "Foo", you would write * %G_TYPE_STRING to "Foo", you would write
* <literal>gtk_tree_store_set (store, iter, 0, "Foo", -1)</literal>. * `gtk_tree_store_set (store, iter, 0, "Foo", -1)`.
* *
* The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it * The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it
* will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED. * will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED.
@ -1494,7 +1494,7 @@ gtk_tree_store_insert_after (GtkTreeStore *tree_store,
* the values given to this function. * the values given to this function.
* *
* Calling * Calling
* <literal>gtk_tree_store_insert_with_values (tree_store, iter, position, ...)</literal> * `gtk_tree_store_insert_with_values (tree_store, iter, position, ...)`
* has the same effect as calling * has the same effect as calling
* |[<!-- language="C" --> * |[<!-- language="C" -->
* gtk_tree_store_insert (tree_store, iter, position); * gtk_tree_store_insert (tree_store, iter, position);
@ -2252,7 +2252,7 @@ gtk_tree_store_reorder_func (gconstpointer a,
* @parent: A #GtkTreeIter. * @parent: A #GtkTreeIter.
* @new_order: (array): an array of integers mapping the new position of each child * @new_order: (array): an array of integers mapping the new position of each child
* to its old position before the re-ordering, * to its old position before the re-ordering,
* i.e. @new_order<literal>[newpos] = oldpos</literal>. * i.e. @new_order`[newpos] = oldpos`.
* *
* Reorders the children of @parent in @tree_store to follow the order * Reorders the children of @parent in @tree_store to follow the order
* indicated by @new_order. Note that this function only works with * indicated by @new_order. Note that this function only works with

10
gtk/gtktreeview.c
View File

@ -81,7 +81,7 @@
* *
* Coordinate systems in GtkTreeView API: * Coordinate systems in GtkTreeView API:
* *
* - Widget coordinates: Coordinates relative to the widget (usually <literal>widget->window</literal>). * - Widget coordinates: Coordinates relative to the widget (usually `widget->window`).
* *
* - Bin window coordinates: Coordinates relative to the window that GtkTreeView renders to. * - Bin window coordinates: Coordinates relative to the window that GtkTreeView renders to.
* *
@ -13325,7 +13325,7 @@ gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view,
* @tree_view: A #GtkTreeView * @tree_view: A #GtkTreeView
* *
* Returns the window that @tree_view renders to. * Returns the window that @tree_view renders to.
* This is used primarily to compare to <literal>event->window</literal> * This is used primarily to compare to `event->window`
* to confirm that the event on @tree_view is on the right window. * to confirm that the event on @tree_view is on the right window.
* *
* Return value: (transfer none): A #GdkWindow, or %NULL when @tree_view * Return value: (transfer none): A #GdkWindow, or %NULL when @tree_view
@ -13352,8 +13352,8 @@ gtk_tree_view_get_bin_window (GtkTreeView *tree_view)
* Finds the path at the point (@x, @y), relative to bin_window coordinates * Finds the path at the point (@x, @y), relative to bin_window coordinates
* (please see gtk_tree_view_get_bin_window()). * (please see gtk_tree_view_get_bin_window()).
* That is, @x and @y are relative to an events coordinates. @x and @y must * That is, @x and @y are relative to an events coordinates. @x and @y must
* come from an event on the @tree_view only where <literal>event->window == * come from an event on the @tree_view only where `event->window ==
* gtk_tree_view_get_bin_window (<!-- -->)</literal>. It is primarily for * gtk_tree_view_get_bin_window (<!-- -->)`. It is primarily for
* things like popup menus. If @path is non-%NULL, then it will be filled * things like popup menus. If @path is non-%NULL, then it will be filled
* with the #GtkTreePath at that point. This path should be freed with * with the #GtkTreePath at that point. This path should be freed with
* gtk_tree_path_free(). If @column is non-%NULL, then it will be filled * gtk_tree_path_free(). If @column is non-%NULL, then it will be filled
@ -13992,7 +13992,7 @@ gtk_tree_view_get_visible_range (GtkTreeView *tree_view,
* *
* The @x and @y coordinate that are provided must be relative to bin_window * The @x and @y coordinate that are provided must be relative to bin_window
* coordinates. That is, @x and @y must come from an event on @tree_view * coordinates. That is, @x and @y must come from an event on @tree_view
* where <literal>event->window == gtk_tree_view_get_bin_window (<!-- -->)</literal>. * where `event->window == gtk_tree_view_get_bin_window (<!-- -->)`.
* *
* For converting widget coordinates (eg. the ones you get from * For converting widget coordinates (eg. the ones you get from
* GtkWidget::query-tooltip), please see * GtkWidget::query-tooltip), please see

12
gtk/gtkwidget.c
View File

@ -4114,8 +4114,8 @@ gtk_widget_thaw_child_notify (GtkWidget *widget)
* *
* This is a convenience function for creating a widget and setting * This is a convenience function for creating a widget and setting
* its properties in one go. For example you might write: * its properties in one go. For example you might write:
* <literal>gtk_widget_new (GTK_TYPE_LABEL, "label", "Hello World", "xalign", * `gtk_widget_new (GTK_TYPE_LABEL, "label", "Hello World", "xalign",
* 0.0, NULL)</literal> to create a left-aligned label. Equivalent to * 0.0, NULL)` to create a left-aligned label. Equivalent to
* g_object_new(), but returns a widget so you don't have to * g_object_new(), but returns a widget so you don't have to
* cast the object yourself. * cast the object yourself.
* *
@ -10734,7 +10734,7 @@ gtk_widget_add_device_events (GtkWidget *widget,
* returned widget; it should not be unreferenced. * returned widget; it should not be unreferenced.
* *
* Note the difference in behavior vs. gtk_widget_get_ancestor(); * Note the difference in behavior vs. gtk_widget_get_ancestor();
* <literal>gtk_widget_get_ancestor (widget, GTK_TYPE_WINDOW)</literal> * `gtk_widget_get_ancestor (widget, GTK_TYPE_WINDOW)`
* would return * would return
* %NULL if @widget wasn't inside a toplevel window, and if the * %NULL if @widget wasn't inside a toplevel window, and if the
* window was inside a #GtkWindow<!-- -->-derived widget which was in turn * window was inside a #GtkWindow<!-- -->-derived widget which was in turn
@ -10773,7 +10773,7 @@ gtk_widget_get_toplevel (GtkWidget *widget)
* @widget_type: ancestor type * @widget_type: ancestor type
* *
* Gets the first ancestor of @widget with type @widget_type. For example, * Gets the first ancestor of @widget with type @widget_type. For example,
* <literal>gtk_widget_get_ancestor (widget, GTK_TYPE_BOX)</literal> gets * `gtk_widget_get_ancestor (widget, GTK_TYPE_BOX)` gets
* the first #GtkBox that's an ancestor of @widget. No reference will be * the first #GtkBox that's an ancestor of @widget. No reference will be
* added to the returned widget; it should not be unreferenced. See note * added to the returned widget; it should not be unreferenced. See note
* about checking for a toplevel #GtkWindow in the docs for * about checking for a toplevel #GtkWindow in the docs for
@ -14409,8 +14409,8 @@ gtk_widget_get_clipboard (GtkWidget *widget, GdkAtom selection)
* The widgets in the list are not individually referenced. If you * The widgets in the list are not individually referenced. If you
* want to iterate through the list and perform actions involving * want to iterate through the list and perform actions involving
* callbacks that might destroy the widgets, you * callbacks that might destroy the widgets, you
* must call <literal>g_list_foreach (result, * must call `g_list_foreach (result,
* (GFunc)g_object_ref, NULL)</literal> first, and then unref all the * (GFunc)g_object_ref, NULL)` first, and then unref all the
* widgets afterwards. * widgets afterwards.
* Return value: (element-type GtkWidget) (transfer container): the list of * Return value: (element-type GtkWidget) (transfer container): the list of

8
gtk/gtkwindow.c
View File

@ -2511,7 +2511,7 @@ gtk_window_activate_focus (GtkWindow *window)
* Retrieves the current focused widget within the window. * Retrieves the current focused widget within the window.
* Note that this is the widget that would have the focus * Note that this is the widget that would have the focus
* if the toplevel window focused; if the toplevel window * if the toplevel window focused; if the toplevel window
* is not focused then <literal>gtk_widget_has_focus (widget)</literal> will * is not focused then `gtk_widget_has_focus (widget)` will
* not be %TRUE for the widget. * not be %TRUE for the widget.
* *
* Return value: (transfer none): the currently focused widget, or %NULL if there is none. * Return value: (transfer none): the currently focused widget, or %NULL if there is none.
@ -2629,7 +2629,7 @@ gtk_window_get_modal (GtkWindow *window)
* in the list are not individually referenced. If you want * in the list are not individually referenced. If you want
* to iterate through the list and perform actions involving * to iterate through the list and perform actions involving
* callbacks that might destroy the widgets, you must call * callbacks that might destroy the widgets, you must call
* <literal>g_list_foreach (result, (GFunc)g_object_ref, NULL)</literal> first, and * `g_list_foreach (result, (GFunc)g_object_ref, NULL)` first, and
* then unref all the widgets afterwards. * then unref all the widgets afterwards.
* *
* Return value: (element-type GtkWidget) (transfer container): list of toplevel widgets * Return value: (element-type GtkWidget) (transfer container): list of toplevel widgets
@ -4949,8 +4949,8 @@ gtk_window_get_size (GtkWindow *window,
* the bottom-right corner of the window border will be placed at that * the bottom-right corner of the window border will be placed at that
* reference point. So, to place a window in the bottom right corner * reference point. So, to place a window in the bottom right corner
* you would first set gravity to south east, then write: * you would first set gravity to south east, then write:
* <literal>gtk_window_move (window, gdk_screen_width () - window_width, * `gtk_window_move (window, gdk_screen_width () - window_width,
* gdk_screen_height () - window_height)</literal> (note that this * gdk_screen_height () - window_height)` (note that this
* example does not take multi-head scenarios into account). * example does not take multi-head scenarios into account).
* *
* The Extended Window Manager Hints specification at <ulink * The Extended Window Manager Hints specification at <ulink