AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-10 02:40:11 +00:00
Code Issues Projects Releases Wiki Activity

docs: Use markup for links

Browse Source
This commit is contained in:
William Jon McCann 2014-02-06 21:07:03 -05:00
parent 6d3347de63
commit 0ce016650b
65 changed files with 262 additions and 262 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
gdk/gdkcairo.c
View File

@ -28,7 +28,7 @@
* @Short_description: Functions to support using cairo
* @Title: Cairo Interaction
*
* <link href="http://cairographics.org">Cairo</link> is a graphics
* [Cairo](http://cairographics.org) is a graphics
* library that supports vector graphics and image compositing that
* can be used with GDK. GTK+ does all of its drawing using cairo.
*

2
gdk/gdkdevice.h
View File

@ -115,7 +115,7 @@ typedef enum
* @GDK_DEVICE_TYPE_FLOATING: Device is a physical device, currently not attached to
* any virtual device.
*
* Indicates the device type. See <link linkend="GdkDeviceManager.description">above</link>
* Indicates the device type. See [above][GdkDeviceManager.description]
* for more information about the meaning of these device types.
*/
typedef enum {

2
gdk/gdkdnd.c
View File

@ -41,7 +41,7 @@
*
* GTK+ provides a higher level abstraction based on top of these functions,
* and so they are not normally needed in GTK+ applications.
* See the <link linkend="gtk3-Drag-and-Drop">Drag and Drop</link> section of
* See the [Drag and Drop][gtk3-Drag-and-Drop] section of
* the GTK+ documentation for more information.
*/

4
gdk/gdkevents.c
View File

@ -35,7 +35,7 @@
* SECTION:events
* @Short_description: Functions for handling events from the window system
* @Title: Events
* @See_also: <link linkend="gdk3-Event-Structures">Event Structures</link>
* @See_also: [Event Structures][gdk3-Event-Structures]
*
* This section describes functions dealing with events from the window
* system.
@ -43,7 +43,7 @@
* In GTK+ applications the events are handled automatically in
* gtk_main_do_event() and passed on to the appropriate widgets, so these
* functions are rarely needed. Though some of the fields in the
* <link linkend="gdk3-Event-Structures">Event Structures</link> are useful.
* [Event Structures][gdk3-Event-Structures] are useful.
*/

4
gdk/gdkevents.h
View File

@ -56,7 +56,7 @@ G_BEGIN_DECLS
* GDK_PRIORITY_EVENTS:
*
* This is the priority that events from the X server are given in the
* <link linkend="glib-The-Main-Event-Loop">GLib Main Loop</link>.
* [GLib Main Loop][glib-The-Main-Event-Loop].
*/
#define GDK_PRIORITY_EVENTS (G_PRIORITY_DEFAULT)
@ -65,7 +65,7 @@ G_BEGIN_DECLS
*
* This is the priority that the idle handler processing window updates
* is given in the
* <link linkend="glib-The-Main-Event-Loop">GLib Main Loop</link>.
* [GLib Main Loop][glib-The-Main-Event-Loop].
*/
#define GDK_PRIORITY_REDRAW (G_PRIORITY_HIGH_IDLE + 20)

4
gdk/gdkpango.c
View File

@ -44,8 +44,8 @@
* can set the text and attributes of it with Pango functions like
* pango_layout_set_text() and get its size with pango_layout_get_size().
* (Note that Pango uses a fixed point system internally, so converting
* between Pango units and pixels using <link
* linkend="PANGO-SCALE-CAPS">PANGO_SCALE</link> or the PANGO_PIXELS() macro.)
* between Pango units and pixels using [PANGO_SCALE][PANGO-SCALE-CAPS]
* or the PANGO_PIXELS() macro.)
*
* Rendering a Pango layout is done most simply with pango_cairo_show_layout();
* you can also draw pieces of the layout with pango_cairo_show_layout_line().

2
gdk/gdkselection.c
View File

@ -48,7 +48,7 @@
* retrieved by requesting the special target `TARGETS`. When
* 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).
* See <link linkend="gdk3-Properties-and-Atoms">Properties and Atoms</link>
* See [Properties and Atoms][gdk3-Properties-and-Atoms]
* for more information.
*
* The functions in this section only contain the lowlevel parts of the

6
gtk/deprecated/gtkaction.c
View File

@ -63,9 +63,9 @@
*
* - sensitive (enabled/disabled)
*
* Apart from regular actions, there are <link linkend="GtkToggleAction">toggle
* actions</link>, which can be toggled between two states and <link
* linkend="GtkRadioAction">radio actions</link>, of which only one in a group
* Apart from regular actions, there are [toggle actions][GtkToggleAction],
* which can be toggled between two states and
* [radio actions][GtkRadioAction], of which only one in a group
* can be in the “active” state. Other actions can be implemented as #GtkAction
* subclasses.
*

2
gtk/deprecated/gtkactiongroup.c
View File

@ -523,7 +523,7 @@ gtk_action_group_buildable_custom_tag_end (GtkBuildable *buildable,
* @name: the name of the action group.
*
* Creates a new #GtkActionGroup object. The name of the action group
* is used when associating <link linkend="Action-Accel">keybindings</link>
* is used when associating [keybindings][Action-Accel]
* with the actions.
*
* Returns: the new #GtkActionGroup

2
gtk/deprecated/gtkgradient.c
View File

@ -33,7 +33,7 @@
*
* GtkGradient is a boxed type that represents a gradient.
* It is the result of parsing a
* <link linkend="gtkcssprovider-gradients">gradient expression</link>.
* [gradient expression][gtkcssprovider-gradients].
* To obtain the gradient represented by a GtkGradient, it has to
* be resolved with gtk_gradient_resolve(), which replaces all
* symbolic color references by the colors they refer to (in a given

6
gtk/deprecated/gtkrc.c
View File

@ -274,7 +274,7 @@
* it is searched in the directories of the currently open RC files.
*
* GTK+ also tries to load a
* <link linkend="locale-specific-rc">locale-specific variant</link> of
* [locale-specific variant][locale-specific-rc] of
* the included file.
*
* * `module_path path`
@ -316,7 +316,7 @@
*
* * setting = value
*
* Specifies a value for a <link linkend="GtkSettings">setting</link>.
* Specifies a value for a [setting][GtkSettings].
* Note that settings in RC files are overwritten by system-wide settings
* (which are managed by an XSettings manager on X11).
*
@ -411,7 +411,7 @@
*
* * `class::property = value`
*
* Sets a <link linkend="style-properties">style property</link> for a widget class.
* Sets a [style property][style-properties] for a widget class.
*
* The colors and background pixmaps are specified as a function of the
* state of the widget. The states are:

3
gtk/deprecated/gtkstock.c
View File

@ -49,8 +49,7 @@ Prebuilt common menu/toolbar items and corresponding icons
* Each stock ID can be associated with a #GtkStockItem, which contains
* the user-visible label, keyboard accelerator, and translation domain
* of the menu or toolbar item; and/or with an icon stored in a
* #GtkIconFactory. See <link
* linkend="gtk3-Themeable-Stock-Images">GtkIconFactory</link> for
* #GtkIconFactory. See [GtkIconFactory][gtk3-Themeable-Stock-Images] for
* more information on stock icons. The connection between a
* #GtkStockItem and stock icons is purely conventional (by virtue of
* using the same stock ID); it's possible to register a stock item but

2
gtk/deprecated/gtksymboliccolor.c
View File

@ -36,7 +36,7 @@
*
* GtkSymbolicColor is a boxed type that represents a symbolic color.
* It is the result of parsing a
* <link linkend="gtkcssprovider-symbolic-colors">color expression</link>.
* [color expression][gtkcssprovider-symbolic-colors].
* To obtain the color represented by a GtkSymbolicColor, it has to
* be resolved with gtk_symbolic_color_resolve(), which replaces all
* symbolic color references by the colors they refer to (in a given

11
gtk/deprecated/gtkuimanager.c
View File

@ -66,8 +66,7 @@
* roughly described by the following DTD.
*
* > Do not confuse the GtkUIManager UI Definitions described here with
* > the similarly named <link linkend="BUILDER-UI">GtkBuilder UI
* > Definitions</link>.
* > the similarly named [GtkBuilder UI Definitions][BUILDER-UI].
*
* |[
* <!ELEMENT ui (menubar|toolbar|popup|accelerator)* >
@ -1933,7 +1932,7 @@ add_ui_from_string (GtkUIManager *manager,
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
* @error: return location for an error
*
* Parses a string containing a <link linkend="XML-UI">UI definition</link> and
* Parses a string containing a [UI definition][XML-UI] and
* merges it with the current contents of @manager. An enclosing &lt;ui&gt;
* element is added if it is missing.
*
@ -1978,7 +1977,7 @@ gtk_ui_manager_add_ui_from_string (GtkUIManager *manager,
* @filename: (type filename): the name of the file to parse
* @error: return location for an error
*
* Parses a file containing a <link linkend="XML-UI">UI definition</link> and
* Parses a file containing a [UI definition][XML-UI] and
* merges it with the current contents of @manager.
*
* Return value: The merge id for the merged UI. The merge id can be used
@ -2015,7 +2014,7 @@ gtk_ui_manager_add_ui_from_file (GtkUIManager *manager,
* @resource_path: the resource path of the file to parse
* @error: return location for an error
*
* Parses a resource file containing a <link linkend="XML-UI">UI definition</link> and
* Parses a resource file containing a [UI definition][XML-UI] and
* merges it with the current contents of @manager.
*
* Return value: The merge id for the merged UI. The merge id can be used
@ -3341,7 +3340,7 @@ gtk_ui_manager_buildable_custom_tag_end (GtkBuildable *buildable,
* gtk_ui_manager_get_ui:
* @manager: a #GtkUIManager
*
* Creates a <link linkend="XML-UI">UI definition</link> of the merged UI.
* Creates a [UI definition][XML-UI] of the merged UI.
*
* Return value: A newly allocated string containing an XML representation of
* the merged UI.

4
gtk/gtkaccelmap.c
View File

@ -65,8 +65,8 @@
* path may look like: “&lt;Gimp-Toolbox&gt;/File/Dialogs/Tool Options...”.
*
* All accelerators are stored inside one global #GtkAccelMap that can
* be obtained using gtk_accel_map_get(). See <link
* linkend="monitoring-changes">Monitoring changes</link> for additional
* be obtained using gtk_accel_map_get(). See
* [Monitoring changes][monitoring-changes] for additional
* details.
*
* # Manipulating accelerators

2
gtk/gtkappchooser.c
View File

@ -66,7 +66,7 @@ gtk_app_chooser_default_init (GtkAppChooserIface *iface)
*
* The content type of the #GtkAppChooser object.
*
* See <link linkend="gio-GContentType">GContentType</link>
* See [GContentType][gio-GContentType]
* for more information about content types.
*/
pspec = g_param_spec_string ("content-type",

6
gtk/gtkassistant.c
View File

@ -32,10 +32,10 @@
*
* The design of GtkAssistant is that it controls what buttons to show
* and to make sensitive, based on what it knows about the page sequence
* and the <link linkend="GtkAssistantPageType">type</link> of each page,
* and the [type][GtkAssistantPageType] of each page,
* in addition to state information like the page
* <link linkend="gtk-assistant-set-page-complete">completion</link>
* and <link linkend="gtk-assistant-commit">committed</link> status.
* [completion][gtk-assistant-set-page-complete]
* and [committed][gtk-assistant-commit] status.
*
* If you have a case that doesn't quite fit in #GtkAssistants way of
* handling buttons, you can use the #GTK_ASSISTANT_PAGE_CUSTOM page

6
gtk/gtkbindings.c
View File

@ -52,12 +52,12 @@
* A CSS file binding consists of a 'binding-set' definition and a match
* statement to apply the binding set to specific widget types. Details
* on the matching mechanism are described under
* <link linkend="gtkcssprovider-selectors">Selectors</link>
* [Selectors][gtkcssprovider-selectors]
* in the #GtkCssProvider documentation. Inside the binding set
* definition, key combinations are bound to one or more specific
* signal emissions on the target widget. Key combinations are strings
* consisting of an optional #GdkModifierType name and
* <link linkend="gdk3-Keyboard-Handling">key names</link>
* [key names][gdk3-Keyboard-Handling]
* such as those defined in `gdk/gdkkeysyms.h`
* or returned from gdk_keyval_name(), they have to be parsable by
* gtk_accelerator_parse(). Specifications of signal emissions consist
@ -87,7 +87,7 @@
* it provides. Because custom bindings set up in CSS files take
* precedence over the default bindings shipped with GTK+, overriding
* existing bindings as demonstrated in
* <link linkend="gtk-bindings-install">Installing a key binding</link>
* [Installing a key binding][gtk-bindings-install]
* works as expected. The same mechanism can not be used to “unbind”
* existing bindings, however.
*

6
gtk/gtkbuildable.c
View File

@ -22,7 +22,7 @@
* @Title: GtkBuildable
*
* GtkBuildable allows objects to extend and customize their deserialization
* from <link linkend="BUILDER-UI">GtkBuilder UI descriptions</link>.
* from [GtkBuilder UI descriptions][BUILDER-UI].
* The interface includes methods for setting names and properties of objects,
* parsing custom tags and constructing child objects.
*
@ -84,7 +84,7 @@ gtk_buildable_set_name (GtkBuildable *buildable,
* Gets the name of the @buildable object.
*
* #GtkBuilder sets the name based on the
* <link linkend="BUILDER-UI">GtkBuilder UI definition</link>
* [GtkBuilder UI definition][BUILDER-UI]
* used to construct the @buildable.
*
* Returns: the name set with gtk_buildable_set_name()
@ -173,7 +173,7 @@ gtk_buildable_set_buildable_property (GtkBuildable *buildable,
* @builder: a #GtkBuilder
*
* Called when the builder finishes the parsing of a
* <link linkend="BUILDER-UI">GtkBuilder UI definition</link>.
* [GtkBuilder UI definition][BUILDER-UI].
* Note that this will be called once for each time
* gtk_builder_add_from_file() or gtk_builder_add_from_string()
* is called on a builder.

38
gtk/gtkbuilder.c
View File

@ -64,7 +64,7 @@
* “GtkBuilder UI definitions” or just
* “UI definitions” if the context is clear.
* Do not confuse GtkBuilder UI Definitions with
* <link linkend="XML-UI">GtkUIManager UI Definitions</link>, which
* [GtkUIManager UI Definitions][XML-UI], which
* are more limited in scope. It is common to use `.ui`
* as the filename extension for files containing GtkBuilder UI
* definitions.
@ -946,11 +946,11 @@ gtk_builder_new (void)
* @filename: the name of the file to parse
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> and merges it with the current contents of @builder.
* Parses a file containing a [GtkBuilder UI definition][BUILDER-UI]
* and merges it with the current contents of @builder.
*
* Most users will probably want to use gtk_builder_new_from_file().
*
*
* Upon errors 0 will be returned and @error will be assigned a
* #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR
* domain.
@ -1015,9 +1015,9 @@ gtk_builder_add_from_file (GtkBuilder *builder,
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> building only the requested objects and merges
* them with the current contents of @builder.
* Parses a file containing a [GtkBuilder UI definition][BUILDER-UI]
* building only the requested objects and merges
* them with the current contents of @builder.
*
* Upon errors 0 will be returned and @error will be assigned a
* #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR
@ -1123,8 +1123,8 @@ _gtk_builder_extend_with_template (GtkBuilder *builder,
* @resource_path: the path of the resource file to parse
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a resource file containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> and merges it with the current contents of @builder.
* Parses a resource file containing a [GtkBuilder UI definition][BUILDER-UI]
* and merges it with the current contents of @builder.
*
* Most users will probably want to use gtk_builder_new_from_resource().
*
@ -1201,8 +1201,8 @@ gtk_builder_add_from_resource (GtkBuilder *builder,
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a resource file containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> building only the requested objects and merges
* Parses a resource file containing a [GtkBuilder UI definition][BUILDER-UI]
* building only the requested objects and merges
* them with the current contents of @builder.
*
* Upon errors 0 will be returned and @error will be assigned a
@ -1279,8 +1279,8 @@ gtk_builder_add_objects_from_resource (GtkBuilder *builder,
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> and merges it with the current contents of @builder.
* Parses a string containing a [GtkBuilder UI definition][BUILDER-UI]
* and merges it with the current contents of @builder.
*
* Most users will probably want to use gtk_builder_new_from_string().
*
@ -1335,8 +1335,8 @@ gtk_builder_add_from_string (GtkBuilder *builder,
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> building only the requested objects and merges
* Parses a string containing a [GtkBuilder UI definition][BUILDER-UI]
* building only the requested objects and merges
* them with the current contents of @builder.
*
* Upon errors 0 will be returned and @error will be assigned a
@ -2394,7 +2394,7 @@ gtk_builder_lookup_callback_symbol (GtkBuilder *builder,
* gtk_builder_new_from_file:
* @filename: filename of user interface description file
*
* Builds the <link linkend="BUILDER-UI">GtkBuilder UI definition</link>
* Builds the [GtkBuilder UI definition][BUILDER-UI]
* in the file @filename.
*
* If there is an error opening the file or parsing the description then
@ -2422,7 +2422,7 @@ gtk_builder_new_from_file (const gchar *filename)
* gtk_builder_new_from_resource:
* @resource_path: a #GResource resource path
*
* Builds the <link linkend="BUILDER-UI">GtkBuilder UI definition</link>
* Builds the [GtkBuilder UI definition][BUILDER-UI]
* at @resource_path.
*
* If there is an error locating the resurce or parsing the description
@ -2450,8 +2450,8 @@ gtk_builder_new_from_resource (const gchar *resource_path)
* @string: a user interface (XML) description
* @length: the length of @string, or -1
*
* Builds the user interface described by @string (in the <link
* linkend="BUILDER-UI">GtkBuilder UI definition</link> format).
* Builds the user interface described by @string (in the
* [GtkBuilder UI definition][BUILDER-UI] format).
*
* If @string is %NULL-terminated then @length should be -1. If @length
* is not -1 then it is the length of @string.

7
gtk/gtkcellarea.c
View File

@ -37,8 +37,9 @@
*
* # Requesting area sizes
*
* As outlined in <link linkend="geometry-management">GtkWidget's
* geometry management section</link>, GTK+ uses a height-for-width
* As outlined in
* [GtkWidget's geometry management section][geometry-management],
* GTK+ uses a height-for-width
* geometry management system to compute the sizes of widgets and user
* interfaces. #GtkCellArea uses the same semantics to calculate the
* size of an area for an arbitrary number of #GtkTreeModel rows.
@ -319,7 +320,7 @@
*
* The #GtkCellArea introduces cell properties for #GtkCellRenderers
* in very much the same way that #GtkContainer introduces
* <link linkend="child-properties">child properties</link>
* [child properties][child-properties]
* for #GtkWidgets. This provides some general interfaces for defining
* the relationship cell areas have with their cells. For instance in a
* #GtkCellAreaBox a cell might “expand” and receive extra space when

2
gtk/gtkcelllayout.c
View File

@ -59,7 +59,7 @@
*
* Furthermore for implementations of GtkCellLayout that use a
* #GtkCellArea to lay out cells (all GtkCellLayouts in GTK+ use
* a GtkCellArea) <link linkend="cell-properties">cell properties</link>
* a GtkCellArea) [cell properties][cell-properties]
* can also be defined in the format by specifying the custom
* &lt;cell-packing&gt; attribute which can contain multiple
* &lt;property&gt; elements defined in the normal way.

3
gtk/gtkcellview.c
View File

@ -1019,8 +1019,7 @@ gtk_cell_view_new_with_text (const gchar *text)
*
* Creates a new #GtkCellView widget, adds a #GtkCellRendererText
* to it, and makes it show @markup. The text can be
* marked up with the <link linkend="PangoMarkupFormat">Pango text
* markup language</link>.
* marked up with the [Pango text markup language][PangoMarkupFormat].
*
* Return value: A newly created #GtkCellView widget.
*

6
gtk/gtkcombobox.c
View File

@ -550,7 +550,7 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
* @scroll_type: a #GtkScrollType
*
* The ::move-active signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to move the active selection.
*
* Since: 2.12
@ -570,7 +570,7 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
* @widget: the object that received the signal
*
* The ::popup signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to popup the combo box list.
*
* The default binding for this signal is Alt+Down.
@ -590,7 +590,7 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
* @button: the object which received the signal
*
* The ::popdown signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to popdown the combo box list.
*
* The default bindings for this signal are Alt+Up and Escape.

4
gtk/gtkcontainer.c
View File

@ -177,7 +177,7 @@
* that the container adds. Then vertical expand space should be added where appropriate and available
* and the container should go on to actually allocating the child widgets.
*
* See <link linkend="geometry-management">GtkWidget's geometry management section</link>
* See [GtkWidget's geometry management section][geometry-management]
* to learn more about implementing height-for-width geometry management for widgets.
*
* # Child properties
@ -802,7 +802,7 @@ gtk_container_child_type (GtkContainer *container)
* the class of @container
*
* Emits a #GtkWidget::child-notify signal for the
* <link linkend="child-properties">child property</link>
* [child property][child-properties]
* @child_property on widget.
*
* This is an analogue of g_object_notify() for child properties.

2
gtk/gtkdialog.c
View File

@ -502,7 +502,7 @@ gtk_dialog_class_init (GtkDialogClass *class)
* GtkDialog::close:
*
* The ::close signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user uses a keybinding to close
* the dialog.
*

2
gtk/gtkdnd.c
View File

@ -61,7 +61,7 @@
*
* As well as the functions listed here, applications
* may need to use some facilities provided for
* <link linkend="gtk3-Selections">Selections</link>.
* [Selections][gtk3-Selections].
* Also, the Drag and Drop API makes use of signals
* in the #GtkWidget class.
*/

4
gtk/gtkdrawingarea.c
View File

@ -99,8 +99,8 @@
* gdk_window_invalidate_rect() are equally good ways to do this.
* You'll then get a draw signal for the invalid region.
*
* The available routines for drawing are documented on the <link
* linkend="gdk3-Cairo-Interaction">GDK Drawing Primitives</link> page
* The available routines for drawing are documented on the
* [GDK Drawing Primitives][gdk3-Cairo-Interaction] page
* and the cairo documentation.
*
* To receive mouse events on a drawing area, you will need to enable

26
gtk/gtkentry.c
View File

@ -1313,8 +1313,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* GtkEntry:primary-icon-tooltip-markup:
*
* The contents of the tooltip on the primary icon, which is marked up
* with the <link linkend="PangoMarkupFormat">Pango text markup
* language</link>.
* with the [Pango text markup language][PangoMarkupFormat].
*
* Also see gtk_entry_set_icon_tooltip_markup().
*
@ -1332,8 +1331,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* GtkEntry:secondary-icon-tooltip-markup:
*
* The contents of the tooltip on the secondary icon, which is marked up
* with the <link linkend="PangoMarkupFormat">Pango text markup
* language</link>.
* with the [Pango text markup language][PangoMarkupFormat].
*
* Also see gtk_entry_set_icon_tooltip_markup().
*
@ -1562,7 +1560,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* the Enter key.
*
* While this signal is used as a
* <link linkend="keybinding-signals">keybinding signal</link>,
* [keybinding signal][keybinding-signals],
* it is also commonly used by applications to intercept
* activation of entries.
*
@ -1586,7 +1584,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @extend_selection: %TRUE if the move should extend the selection
*
* The ::move-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @entry, this signal causes
* the viewport to be moved instead.
@ -1621,7 +1619,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @string: the string to insert
*
* The ::insert-at-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates the insertion of a
* fixed string at the cursor.
*
@ -1644,7 +1642,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @count: the number of @type units to delete
*
* The ::delete-from-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates a text deletion.
*
* If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection
@ -1671,7 +1669,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @entry: the object which received the signal
*
* The ::backspace signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* The default bindings for this signal are
@ -1691,7 +1689,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @entry: the object which received the signal
*
* The ::cut-clipboard signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to cut the selection to the clipboard.
*
* The default bindings for this signal are
@ -1711,7 +1709,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @entry: the object which received the signal
*
* The ::copy-clipboard signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to copy the selection to the clipboard.
*
* The default bindings for this signal are
@ -1731,7 +1729,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @entry: the object which received the signal
*
* The ::paste-clipboard signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to paste the contents of the clipboard
* into the text view.
*
@ -1752,7 +1750,7 @@ gtk_entry_class_init (GtkEntryClass *class)
* @entry: the object which received the signal
*
* The ::toggle-overwrite signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to toggle the overwrite mode of the entry.
*
* The default bindings for this signal is Insert.
@ -9114,7 +9112,7 @@ gtk_entry_get_icon_tooltip_markup (GtkEntry *entry,
*
* Sets @tooltip as the contents of the tooltip for the icon at
* the specified position. @tooltip is assumed to be marked up with
* the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
* the [Pango text markup language][PangoMarkupFormat].
*
* Use %NULL for @tooltip to remove an existing tooltip.
*

6
gtk/gtkentrycompletion.c
View File

@ -415,8 +415,7 @@ gtk_entry_completion_class_init (GtkEntryCompletionClass *klass)
* Determines whether the completions popup window will shown
* for a single possible completion. You probably want to set
* this to %FALSE if you are using
* <link linkend="GtkEntryCompletion--inline-completion">inline
* completion</link>.
* [inline completion][GtkEntryCompletion--inline-completion].
*
* Since: 2.8
*/
@ -2161,8 +2160,7 @@ gtk_entry_completion_get_popup_set_width (GtkEntryCompletion *completion)
*
* Sets whether the completion popup window will appear even if there is
* only a single match. You may want to set this to %FALSE if you
* are using <link linkend="GtkEntryCompletion--inline-completion">inline
* completion</link>.
* are using [inline completion][GtkEntryCompletion--inline-completion].
*
* Since: 2.8
*/

10
gtk/gtkexpander.c
View File

@ -1905,9 +1905,9 @@ gtk_expander_get_use_underline (GtkExpander *expander)
* @expander: a #GtkExpander
* @use_markup: %TRUE if the label's text should be parsed for markup
*
* Sets whether the text of the label contains markup in <link
* linkend="PangoMarkupFormat">Pango's text markup
* language</link>. See gtk_label_set_markup().
* Sets whether the text of the label contains markup in
* [Pango's text markup language][PangoMarkupFormat].
* See gtk_label_set_markup().
*
* Since: 2.4
*/
@ -1939,8 +1939,8 @@ gtk_expander_set_use_markup (GtkExpander *expander,
* @expander: a #GtkExpander
*
* Returns whether the label's text is interpreted as marked up with
* the <link linkend="PangoMarkupFormat">Pango text markup
* language</link>. See gtk_expander_set_use_markup().
* the [Pango text markup language][PangoMarkupFormat].
* See gtk_expander_set_use_markup().
*
* Return value: %TRUE if the label's text will be parsed for markup
*

12
gtk/gtkfilechooser.c
View File

@ -887,9 +887,9 @@ gtk_file_chooser_get_filenames (GtkFileChooser *chooser)
* The user will be shown the full contents of the current folder,
* plus user interface elements for navigating to other folders.
*
* In general, you should not use this function. See the <link
* linkend="gtkfilechooserdialog-setting-up">section on setting up a file
* chooser dialog</link> for the rationale behind this.
* In general, you should not use this function. See the
* [section on setting up a file chooser dialog][gtkfilechooserdialog-setting-up]
* for the rationale behind this.
*
* Return value: Not useful.
*
@ -1232,9 +1232,9 @@ gtk_file_chooser_get_uris (GtkFileChooser *chooser)
* The user will be shown the full contents of the current folder,
* plus user interface elements for navigating to other folders.
*
* In general, you should not use this function. See the <link
* linkend="gtkfilechooserdialog-setting-up">section on setting up a file
* chooser dialog</link> for the rationale behind this.
* In general, you should not use this function. See the
* [section on setting up a file chooser dialog][gtkfilechooserdialog-setting-up]
* for the rationale behind this.
*
* Return value: %TRUE if the folder could be changed successfully, %FALSE
* otherwise.

2
gtk/gtkfilechooserdialog.c
View File

@ -171,7 +171,7 @@
* appropriate.
*
* To summarize, make sure you use a
* <link linkend="gtkfilechooserdialog-responses">stock response code</link>
* [stock response code][gtkfilechooserdialog-responses]
* when you use #GtkFileChooserDialog to ensure proper operation.
*/

22
gtk/gtkfilechooserwidget.c
View File

@ -7167,7 +7167,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* name.
*
* The ::location-popup signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show a "Location"
@ -7198,7 +7198,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::location-popup-on-paste signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show a "Location"
@ -7220,7 +7220,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::location-toggle-popup signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to toggle the visibility of a "Location"
@ -7243,7 +7243,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::up-folder signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser go to the parent of
@ -7265,7 +7265,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::down-folder signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser go to a child of the
@ -7291,7 +7291,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::home-folder signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the user's home
@ -7313,7 +7313,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::desktop-folder signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the user's Desktop
@ -7336,7 +7336,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @bookmark_index: the number of the bookmark to switch to
*
* The ::quick-bookmark signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser switch to the bookmark
@ -7364,7 +7364,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::show-hidden signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser display hidden files.
@ -7385,7 +7385,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::search-shortcut signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the search entry.
@ -7406,7 +7406,7 @@ gtk_file_chooser_widget_class_init (GtkFileChooserWidgetClass *class)
* @widget: the object which received the signal.
*
* The ::recent-shortcut signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the Recent location.

12
gtk/gtkflowbox.c
View File

@ -592,7 +592,7 @@ gtk_flow_box_child_class_init (GtkFlowBoxChildClass *class)
* double-clicking, or by using the Space or Enter key.
*
* While this signal is used as a
* <link linkend="keybinding-signals">keybinding signal</link>,
* [keybinding signal][keybinding-signals],
* it can be used by applications for their own purposes.
*/
child_signals[CHILD_ACTIVATE] =
@ -3792,7 +3792,7 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class)
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::activate-cursor-child signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user activates the @box.
*/
signals[ACTIVATE_CURSOR_CHILD] = g_signal_new ("activate-cursor-child",
@ -3808,7 +3808,7 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class)
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::toggle-cursor-child signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which toggles the selection of the child that has the focus.
*
* The default binding for this signal is Ctrl-Space.
@ -3828,7 +3828,7 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class)
* @count: the number of @step units to move
*
* The ::move-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @text_view, this signal causes
* the viewport to be moved instead.
@ -3858,7 +3858,7 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class)
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::select-all signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to select all children of the box, if
* the selection mode permits it.
*
@ -3877,7 +3877,7 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class)
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::unselect-all signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to unselect all children of the box, if
* the selection mode permits it.
*

2
gtk/gtkgrid.c
View File

@ -38,7 +38,7 @@
* rows and columns. It is a very similar to #GtkTable and #GtkBox,
* but it consistently uses #GtkWidget's #GtkWidget:margin and #GtkWidget:expand
* properties instead of custom child properties, and it fully supports
* <link linkend="geometry-management">height-for-width geometry management</link>.
* [height-for-width geometry management][geometry-management].
*
* Children are added using gtk_grid_attach(). They can span multiple
* rows or columns. It is also possible to add a child next to an

12
gtk/gtkiconview.c
View File

@ -724,7 +724,7 @@ gtk_icon_view_class_init (GtkIconViewClass *klass)
* GtkIconView::select-all:
* @iconview: the object on which the signal is emitted
*
* A <link linkend="keybinding-signals">keybinding signal</link>
* A [keybinding signal][keybinding-signals]
* which gets emitted when the user selects all items.
*
* Applications should not connect to it, but may emit it with
@ -746,7 +746,7 @@ gtk_icon_view_class_init (GtkIconViewClass *klass)
* GtkIconView::unselect-all:
* @iconview: the object on which the signal is emitted
*
* A <link linkend="keybinding-signals">keybinding signal</link>
* A [keybinding signal][keybinding-signals]
* which gets emitted when the user unselects all items.
*
* Applications should not connect to it, but may emit it with
@ -768,7 +768,7 @@ gtk_icon_view_class_init (GtkIconViewClass *klass)
* GtkIconView::select-cursor-item:
* @iconview: the object on which the signal is emitted
*
* A <link linkend="keybinding-signals">keybinding signal</link>
* A [keybinding signal][keybinding-signals]
* which gets emitted when the user selects the item that is currently
* focused.
*
@ -791,7 +791,7 @@ gtk_icon_view_class_init (GtkIconViewClass *klass)
* GtkIconView::toggle-cursor-item:
* @iconview: the object on which the signal is emitted
*
* A <link linkend="keybinding-signals">keybinding signal</link>
* A [keybinding signal][keybinding-signals]
* which gets emitted when the user toggles whether the currently
* focused item is selected or not. The exact effect of this
* depend on the selection mode.
@ -815,7 +815,7 @@ gtk_icon_view_class_init (GtkIconViewClass *klass)
* GtkIconView::activate-cursor-item:
* @iconview: the object on which the signal is emitted
*
* A <link linkend="keybinding-signals">keybinding signal</link>
* A [keybinding signal][keybinding-signals]
* which gets emitted when the user activates the currently
* focused item.
*
@ -841,7 +841,7 @@ gtk_icon_view_class_init (GtkIconViewClass *klass)
* @count: the number of @step units to move
*
* The ::move-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates a cursor movement.
*
* Applications should not connect to it, but may emit it with

2
gtk/gtkimcontext.c
View File

@ -92,7 +92,7 @@
*
* After a new loadable input method module has been installed on the system,
* the configuration file `gtk.immodules` needs to be
* regenerated by <link linkend="gtk-query-immodules-3.0">gtk-query-immodules-3.0</link>,
* regenerated by [gtk-query-immodules-3.0][gtk-query-immodules-3.0],
* in order for the new input method to become available to GTK+ applications.
*/

2
gtk/gtkinfobar.c
View File

@ -481,7 +481,7 @@ gtk_info_bar_class_init (GtkInfoBarClass *klass)
* GtkInfoBar::close:
*
* The ::close signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user uses a keybinding to dismiss
* the info bar.
*

41
gtk/gtklabel.c
View File

@ -134,8 +134,8 @@
* # Markup (styled text)
*
* To make it easy to format text in a label (changing colors,
* fonts, etc.), label text can be provided in a simple <link
* linkend="PangoMarkupFormat">markup format</link>.
* fonts, etc.), label text can be provided in a simple
* [markup format][PangoMarkupFormat].
*
* Here's how to create a label with a small font:
* |[<!-- language="C" -->
@ -143,8 +143,7 @@
* gtk_label_set_markup (GTK_LABEL (label), "<small>Small text</small>");
* ]|
*
* (See <link
* linkend="PangoMarkupFormat">complete documentation</link> of available
* (See [complete documentation][PangoMarkupFormat] of available
* tags in the Pango manual.)
*
* The markup passed to gtk_label_set_markup() must be valid; for example,
@ -194,7 +193,7 @@
*
* Note that the interpretation of #GtkLabel:width-chars and
* #GtkLabel:max-width-chars has changed a bit with the introduction of
* <link linkend="geometry-management">width-for-height geometry management.</link>
* [width-for-height geometry management.][geometry-management]
*
* # Links
*
@ -583,7 +582,7 @@ gtk_label_class_init (GtkLabelClass *class)
* @extend_selection: %TRUE if the move should extend the selection
*
* The ::move-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @entry, this signal causes
* the viewport to be moved instead.
@ -617,7 +616,7 @@ gtk_label_class_init (GtkLabelClass *class)
* @label: the object which received the signal
*
* The ::copy-clipboard signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to copy the selection to the clipboard.
*
* The default binding for this signal is Ctrl-c.
@ -657,7 +656,7 @@ gtk_label_class_init (GtkLabelClass *class)
* GtkLabel::activate-current-link:
* @label: The label on which the signal was emitted
*
* A <link linkend="keybinding-signals">keybinding signal</link>
* A [keybinding signal][keybinding-signals]
* which gets emitted when the user activates a link in the label.
*
* Applications may also emit the signal with g_signal_emit_by_name()
@ -845,7 +844,7 @@ gtk_label_class_init (GtkLabelClass *class)
* The desired width of the label, in characters. If this property is set to
* -1, the width will be calculated automatically.
*
* See the section on <link linkend="label-text-layout">text layout</link>
* See the section on [text layout][label-text-layout]
* for details of how #GtkLabel:width-chars and #GtkLabel:max-width-chars
* determine the width of ellipsized and wrapped labels.
*
@ -906,7 +905,7 @@ gtk_label_class_init (GtkLabelClass *class)
* The desired maximum width of the label, in characters. If this property
* is set to -1, the width will be calculated automatically.
*
* See the section on <link linkend="label-text-layout">text layout</link>
* See the section on [text layout][label-text-layout]
* for details of how #GtkLabel:width-chars and #GtkLabel:max-width-chars
* determine the width of ellipsized and wrapped labels.
*
@ -2593,10 +2592,10 @@ gtk_label_set_markup_internal (GtkLabel *label,
/**
* gtk_label_set_markup:
* @label: a #GtkLabel
* @str: a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
*
* Parses @str which is marked up with the <link
* linkend="PangoMarkupFormat">Pango text markup language</link>, setting the
* @str: a markup string (see [Pango markup format][PangoMarkupFormat])
*
* Parses @str which is marked up with the
* [Pango text markup language][PangoMarkupFormat], setting the
* label's text and attribute list based on the parse results. If the @str is
* external data, you may need to escape it with g_markup_escape_text() or
* g_markup_printf_escaped()<!-- -->:
@ -2629,10 +2628,10 @@ gtk_label_set_markup (GtkLabel *label,
* gtk_label_set_markup_with_mnemonic:
* @label: a #GtkLabel
* @str: a markup string (see
* <link linkend="PangoMarkupFormat">Pango markup format</link>)
* [Pango markup format][PangoMarkupFormat])
*
* Parses @str which is marked up with the
* <link linkend="PangoMarkupFormat">Pango text markup language</link>,
* [Pango text markup language][PangoMarkupFormat],
* setting the label's text and attribute list based on the parse results.
* If characters in @str are preceded by an underscore, they are underlined
* indicating that they represent a keyboard accelerator called a mnemonic.
@ -5574,9 +5573,9 @@ gtk_label_get_layout_offsets (GtkLabel *label,
* @label: a #GtkLabel
* @setting: %TRUE if the label's text should be parsed for markup.
*
* Sets whether the text of the label contains markup in <link
* linkend="PangoMarkupFormat">Pango's text markup
* language</link>. See gtk_label_set_markup().
* Sets whether the text of the label contains markup in
* [Pango's text markup language][PangoMarkupFormat].
* See gtk_label_set_markup().
**/
void
gtk_label_set_use_markup (GtkLabel *label,
@ -5597,8 +5596,8 @@ gtk_label_set_use_markup (GtkLabel *label,
* @label: a #GtkLabel
*
* Returns whether the label's text is interpreted as marked up with
* the <link linkend="PangoMarkupFormat">Pango text markup
* language</link>. See gtk_label_set_use_markup ().
* the [Pango text markup language][PangoMarkupFormat].
* See gtk_label_set_use_markup ().
*
* Return value: %TRUE if the label's text will be parsed for markup.
**/

2
gtk/gtkliststore.c
View File

@ -40,7 +40,7 @@
* can use all of the methods available there. It also implements the
* #GtkTreeSortable interface so it can be sorted by the view.
* Finally, it also implements the tree
* <link linkend="gtk3-GtkTreeView-drag-and-drop">drag and drop</link>
* [drag and drop][gtk3-GtkTreeView-drag-and-drop]
* interfaces.
*
* The #GtkListStore can accept most GObject types as a column type, though

11
gtk/gtkmessagedialog.c
View File

@ -593,7 +593,7 @@ gtk_message_dialog_new (GtkWindow *parent,
*
* Creates a new message dialog, which is a simple dialog with an icon
* indicating the dialog type (error, warning, etc.) and some text which
* is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
* is marked up with the [Pango text markup language][PangoMarkupFormat].
* When the user clicks a button a “response” signal is emitted with
* response IDs from #GtkResponseType. See #GtkDialog for more details.
*
@ -712,11 +712,10 @@ gtk_message_dialog_get_image (GtkMessageDialog *dialog)
/**
* gtk_message_dialog_set_markup:
* @message_dialog: a #GtkMessageDialog
* @str: markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
* @str: markup string (see [Pango markup format][PangoMarkupFormat])
*
* Sets the text of the message dialog to be @str, which is marked
* up with the <link linkend="PangoMarkupFormat">Pango text markup
* language</link>.
* up with the [Pango text markup language][PangoMarkupFormat].
*
* Since: 2.4
**/
@ -784,12 +783,12 @@ gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog,
* gtk_message_dialog_format_secondary_markup:
* @message_dialog: a #GtkMessageDialog
* @message_format: printf()-style markup string (see
<link linkend="PangoMarkupFormat">Pango markup format</link>), or %NULL
[Pango markup format][PangoMarkupFormat]), or %NULL
* @...: arguments for @message_format
*
* Sets the secondary text of the message dialog to be @message_format (with
* printf()-style), which is marked up with the
* <link linkend="PangoMarkupFormat">Pango text markup language</link>.
* [Pango text markup language][PangoMarkupFormat].
*
* Due to an oversight, this function does not escape special XML characters
* like gtk_message_dialog_new_with_markup() does. Thus, if the arguments

4
gtk/gtkpagesetupunixdialog.c
View File

@ -53,8 +53,8 @@
* #GtkPageSetupUnixDialog implements a page setup dialog for platforms
* which don't provide a native page setup dialog, like Unix. It can
* be used very much like any other GTK+ dialog, at the cost of
* the portability offered by the <link
* linkend="gtk3-High-level-Printing-API">high-level printing API</link>
* the portability offered by the
* [high-level printing API][gtk3-High-level-Printing-API]
*
* Printing support was added in GTK+ 2.10.
*/

12
gtk/gtkpaned.c
View File

@ -443,7 +443,7 @@ gtk_paned_class_init (GtkPanedClass *class)
* @reversed: whether cycling backward or forward
*
* The ::cycle-child-focus signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to cycle the focus between the children of the paned.
*
* The default binding is f6.
@ -465,7 +465,7 @@ gtk_paned_class_init (GtkPanedClass *class)
* @widget: the object that received the signal
*
* The ::toggle-handle-focus is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to accept the current position of the handle and then
* move focus to the next widget in the focus chain.
*
@ -488,7 +488,7 @@ gtk_paned_class_init (GtkPanedClass *class)
* @scroll_type: a #GtkScrollType
*
* The ::move-handle signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to move the handle when the user is using key bindings
* to move it.
*
@ -510,7 +510,7 @@ gtk_paned_class_init (GtkPanedClass *class)
* @reversed: whether cycling backward or forward
*
* The ::cycle-handle-focus signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to cycle whether the paned should grab focus to allow
* the user to change position of the handle by using key bindings.
*
@ -533,7 +533,7 @@ gtk_paned_class_init (GtkPanedClass *class)
* @widget: the object that received the signal
*
* The ::accept-position signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to accept the current position of the handle when
* moving it using key bindings.
*
@ -555,7 +555,7 @@ gtk_paned_class_init (GtkPanedClass *class)
* @widget: the object that received the signal
*
* The ::cancel-position signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to cancel moving the position of the handle using key
* bindings. The position of the handle will be reset to the value prior to
* moving it.

2
gtk/gtkpapersize.c
View File

@ -52,7 +52,7 @@
*
* The #GtkPaperSize object stores not only the dimensions (width
* and height) of a paper size and its name, it also provides
* default <link linkend="print-margins">print margins</link>.
* default [print margins][print-margins].
*
* Printing support has been added in GTK+ 2.10.
*/

2
gtk/gtkprintunixdialog.c
View File

@ -68,7 +68,7 @@
* which don't provide a native print dialog, like Unix. It can
* be used very much like any other GTK+ dialog, at the cost of
* the portability offered by the
* <link linkend="gtk3-High-level-Printing-API">high-level printing API</link>
* [high-level printing API][gtk3-High-level-Printing-API]
*
* In order to print something with #GtkPrintUnixDialog, you need
* to use gtk_print_unix_dialog_get_selected_printer() to obtain

2
gtk/gtkscale.c
View File

@ -1580,7 +1580,7 @@ gtk_scale_clear_marks (GtkScale *scale)
* and %GTK_POS_LEFT are drawn above the scale, anything else below.
* For a vertical scale, #GTK_POS_LEFT and %GTK_POS_TOP are drawn to
* the left of the scale, anything else to the right.
* @markup: (allow-none): Text to be shown at the mark, using <link linkend="PangoMarkupFormat">Pango markup</link>, or %NULL
* @markup: (allow-none): Text to be shown at the mark, using [Pango markup][PangoMarkupFormat], or %NULL
*
*
* Adds a mark at @value.

4
gtk/gtkscalebutton.c
View File

@ -269,7 +269,7 @@ gtk_scale_button_class_init (GtkScaleButtonClass *klass)
* @button: the object which received the signal
*
* The ::popup signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to popup the scale widget.
*
* The default bindings for this signal are Space, Enter and Return.
@ -290,7 +290,7 @@ gtk_scale_button_class_init (GtkScaleButtonClass *klass)
* @button: the object which received the signal
*
* The ::popdown signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to popdown the scale widget.
*
* The default binding for this signal is Escape.

6
gtk/gtkscrolledwindow.c
View File

@ -498,7 +498,7 @@ gtk_scrolled_window_class_init (GtkScrolledWindowClass *class)
* horizontally or not
*
* The ::scroll-child signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when a keybinding that scrolls is pressed.
* The horizontal or vertical adjustment is updated which triggers a
* signal that the scrolled windows child may listen to and scroll itself.
@ -520,8 +520,8 @@ gtk_scrolled_window_class_init (GtkScrolledWindowClass *class)
* @direction_type: either %GTK_DIR_TAB_FORWARD or
* %GTK_DIR_TAB_BACKWARD
*
* The ::move-focus-out signal is a <link
* linkend="keybinding-signals">keybinding signal</link> which gets
* The ::move-focus-out signal is a
* [keybinding signal][keybinding-signals] which gets
* emitted when focus is moved away from the scrolled window by a
* keybinding. The #GtkWidget::move-focus signal is emitted with
* @direction_type on this scrolled windows toplevel parent in the

2
gtk/gtksettings.c
View File

@ -722,7 +722,7 @@ gtk_settings_class_init (GtkSettingsClass *class)
* ...
* ]|
* Color names must be acceptable as identifiers in the
* <link linkend="gtk3-Resource-Files">gtkrc</link> syntax, and
* [gtkrc][gtk3-Resource-Files] syntax, and
* color specifications must be in the format accepted by
* gdk_color_parse().
*

6
gtk/gtkstatusicon.c
View File

@ -393,8 +393,8 @@ gtk_status_icon_class_init (GtkStatusIconClass *class)
* GtkStatusIcon:tooltip-markup:
*
* Sets the text of tooltip to be the given string, which is marked up
* with the <link linkend="PangoMarkupFormat">Pango text markup
* language</link>. Also see gtk_tooltip_set_markup().
* with the [Pango text markup language][PangoMarkupFormat].
* Also see gtk_tooltip_set_markup().
*
* This is a convenience property which will take care of getting the
* tooltip shown if the given string is not %NULL.
@ -2530,7 +2530,7 @@ gtk_status_icon_get_tooltip_text (GtkStatusIcon *status_icon)
* @markup: (allow-none): the contents of the tooltip for @status_icon, or %NULL
*
* Sets @markup as the contents of the tooltip, which is marked up with
* the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
* the [Pango text markup language][PangoMarkupFormat].
*
* This function will take care of setting #GtkStatusIcon:has-tooltip to %TRUE
* and of the default handler for the #GtkStatusIcon::query-tooltip signal.

5
gtk/gtktextbuffer.c
View File

@ -47,8 +47,9 @@
* @Title: GtkTextBuffer
* @See_also: #GtkTextView, #GtkTextIter, #GtkTextMark
*
* You may wish to begin by reading the <link linkend="TextWidget">text widget
* conceptual overview</link> which gives an overview of all the objects and data
* You may wish to begin by reading the
* [text widget conceptual overview][TextWidget]
* which gives an overview of all the objects and data
* types related to the text widget and how they work together.
*/

5
gtk/gtktextiter.c
View File

@ -38,8 +38,9 @@
* @Short_description: Text buffer iterator
* @Title: GtkTextIter
*
* You may wish to begin by reading the <link linkend="TextWidget">text widget
* conceptual overview</link> which gives an overview of all the objects and data
* You may wish to begin by reading the
* [text widget conceptual overview][TextWidget]
* which gives an overview of all the objects and data
* types related to the text widget and how they work together.
*/

5
gtk/gtktextmark.c
View File

@ -59,8 +59,9 @@
* @Short_description: A position in the buffer preserved across buffer modifications
* @Title: GtkTextMark
*
* You may wish to begin by reading the <link linkend="TextWidget">text widget
* conceptual overview</link> which gives an overview of all the objects and data
* You may wish to begin by reading the
* [text widget conceptual overview][TextWidget]
* which gives an overview of all the objects and data
* types related to the text widget and how they work together.
*
* A #GtkTextMark is like a bookmark in a text buffer; it preserves a position in

5
gtk/gtktexttag.c
View File

@ -52,8 +52,9 @@
* @Title: GtkTextTag
* @Short_description: A tag that can be applied to text in a GtkTextBuffer
*
* You may wish to begin by reading the <link linkend="TextWidget">text widget
* conceptual overview</link> which gives an overview of all the objects and
* You may wish to begin by reading the
* [text widget conceptual overview][TextWidget]
* which gives an overview of all the objects and
* data types related to the text widget and how they work together.
*
* Tags should be in the #GtkTextTagTable for a given #GtkTextBuffer

5
gtk/gtktexttagtable.c
View File

@ -40,8 +40,9 @@
* @Short_description: Collection of tags that can be used together
* @Title: GtkTextTagTable
*
* You may wish to begin by reading the <link linkend="TextWidget">text widget
* conceptual overview</link> which gives an overview of all the objects and
* You may wish to begin by reading the
* [text widget conceptual overview][TextWidget]
* which gives an overview of all the objects and
* data types related to the text widget and how they work together.
*
* # GtkTextTagTables as GtkBuildable

29
gtk/gtktextview.c
View File

@ -64,8 +64,9 @@
* @Title: GtkTextView
* @See_also: #GtkTextBuffer, #GtkTextIter
*
* You may wish to begin by reading the <link linkend="TextWidget">text widget
* conceptual overview</link> which gives an overview of all the objects and data
* You may wish to begin by reading the
* [text widget conceptual overview][TextWidget]
* which gives an overview of all the objects and data
* types related to the text widget and how they work together.
*/
@ -927,7 +928,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @extend_selection: %TRUE if the move should extend the selection
*
* The ::move-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @text_view, this signal causes
* the viewport to be moved instead.
@ -965,7 +966,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @count: the number of @step units to move
*
* The ::move-viewport signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which can be bound to key combinations to allow the user
* to move the viewport, i.e. change what part of the text view
* is visible in a containing scrolled window.
@ -988,7 +989,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
*
* The ::set-anchor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates setting the "anchor"
* mark. The "anchor" mark gets placed at the same position as the
* "insert" mark.
@ -1010,7 +1011,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @string: the string to insert
*
* The ::insert-at-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates the insertion of a
* fixed string at the cursor.
*
@ -1033,7 +1034,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @count: the number of @type units to delete
*
* The ::delete-from-cursor signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user initiates a text deletion.
*
* If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection
@ -1061,7 +1062,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
*
* The ::backspace signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user asks for it.
*
* The default bindings for this signal are
@ -1081,7 +1082,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
*
* The ::cut-clipboard signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to cut the selection to the clipboard.
*
* The default bindings for this signal are
@ -1101,7 +1102,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
*
* The ::copy-clipboard signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to copy the selection to the clipboard.
*
* The default bindings for this signal are
@ -1121,7 +1122,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
*
* The ::paste-clipboard signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to paste the contents of the clipboard
* into the text view.
*
@ -1142,7 +1143,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
*
* The ::toggle-overwrite signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to toggle the overwrite mode of the text view.
*
* The default bindings for this signal is Insert.
@ -1192,7 +1193,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @select: %TRUE to select, %FALSE to unselect
*
* The ::select-all signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to select or unselect the complete
* contents of the text view.
*
@ -1213,7 +1214,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
*
* The ::toggle-cursor-visible signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted to toggle the visibility of the cursor.
*
* The default binding for this signal is F7.

5
gtk/gtktooltip.c
View File

@ -277,11 +277,10 @@ gtk_tooltip_dispose (GObject *object)
/**
* gtk_tooltip_set_markup:
* @tooltip: a #GtkTooltip
* @markup: (allow-none): a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) or %NULL
* @markup: (allow-none): a markup string (see [Pango markup format][PangoMarkupFormat]) or %NULL
*
* Sets the text of the tooltip to be @markup, which is marked up
* with the <link
* linkend="PangoMarkupFormat">Pango text markup language</link>.
* with the [Pango text markup language][PangoMarkupFormat].
* If @markup is %NULL, the label will be hidden.
*
* Since: 2.12

2
gtk/gtktreemodel.c
View File

@ -32,7 +32,7 @@
* @Title: GtkTreeModel
* @Short_description: The tree interface used by GtkTreeView
* @See_also: #GtkTreeView, #GtkTreeStore, #GtkListStore,
* <link linkend="gtk3-GtkTreeView-drag-and-drop">GtkTreeView drag-and-drop</link>
* [GtkTreeView drag-and-drop][gtk3-GtkTreeView-drag-and-drop]
* #GtkTreeSortable
*
* The #GtkTreeModel interface defines a generic tree interface for

2
gtk/gtktreeselection.c
View File

@ -33,7 +33,7 @@
* @See_also: #GtkTreeView, #GtkTreeViewColumn, #GtkTreeModel,
* #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore,
* #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf,
* #GtkCellRendererText, #GtkCellRendererToggle, <link linkend="gtk3-GtkTreeView-drag-and-drop">GtkTreeView drag-and-drop</link>
* #GtkCellRendererText, #GtkCellRendererToggle, [GtkTreeView drag-and-drop][gtk3-GtkTreeView-drag-and-drop]
*
* The #GtkTreeSelection object is a helper object to manage the selection
* for a #GtkTreeView widget. The #GtkTreeSelection object is

2
gtk/gtktreestore.c
View File

@ -38,7 +38,7 @@
* can use all of the methods available there. It also implements the
* #GtkTreeSortable interface so it can be sorted by the view. Finally,
* it also implements the tree
* <link linkend="gtk3-GtkTreeView-drag-and-drop">drag and drop</link>
* [drag and drop][gtk3-GtkTreeView-drag-and-drop]
* interfaces.
*
* # GtkTreeStore as GtkBuildable

14
gtk/gtktreeview.c
View File

@ -63,15 +63,16 @@
* @Short_description: A widget for displaying both trees and lists
* @Title: GtkTreeView
* @See_also: #GtkTreeViewColumn, #GtkTreeSelection, #GtkTreeModel,
* <link linkend="gtk3-GtkTreeView-drag-and-drop">GtkTreeView drag-and-drop</link>,
* [GtkTreeView drag-and-drop][gtk3-GtkTreeView-drag-and-drop],
* #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore,
* #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf,
* #GtkCellRendererText, #GtkCellRendererToggle
*
* Widget that displays any object that implements the #GtkTreeModel interface.
*
* Please refer to the <link linkend="TreeWidget">tree widget conceptual
* overview</link> for an overview of all the objects and data types related
* Please refer to the
* [tree widget conceptual overview][TreeWidget]
* for an overview of all the objects and data types related
* to the tree widget and how they work together.
*
* Several different coordinate systems are exposed in the GtkTreeView API.
@ -1285,9 +1286,10 @@ gtk_tree_view_class_init (GtkTreeViewClass *class)
* the "activate-on-single-click" property set to %TRUE. It is also
* emitted when a non-editable row is selected and one of the keys:
* Space, Shift+Space, Return or Enter is pressed.
*
* For selection handling refer to the <link linkend="TreeWidget">tree
* widget conceptual overview</link> as well as #GtkTreeSelection.
*
* For selection handling refer to the
* [tree widget conceptual overview][TreeWidget]
* as well as #GtkTreeSelection.
*/
tree_view_signals[ROW_ACTIVATED] =
g_signal_new (I_("row-activated"),

4
gtk/gtktreeviewcolumn.c
View File

@ -45,13 +45,13 @@
* @See_also: #GtkTreeView, #GtkTreeSelection, #GtkTreeModel, #GtkTreeSortable,
* #GtkTreeModelSort, #GtkListStore, #GtkTreeStore, #GtkCellRenderer, #GtkCellEditable,
* #GtkCellRendererPixbuf, #GtkCellRendererText, #GtkCellRendererToggle,
* <link linkend="gtk3-GtkTreeView-drag-and-drop">GtkTreeView drag-and-drop</link>
* [GtkTreeView drag-and-drop][gtk3-GtkTreeView-drag-and-drop]
*
* The GtkTreeViewColumn object represents a visible column in a #GtkTreeView widget.
* It allows to set properties of the column header, and functions as a holding pen for
* the cell renderers which determine how the data in the column is displayed.
*
* Please refer to the <link linkend="TreeWidget">tree widget conceptual overview</link>
* Please refer to the [tree widget conceptual overview][TreeWidget]
* for an overview of all the objects and data types related to the tree widget and how
* they work together.
*/

14
gtk/gtkwidget.c
View File

@ -132,8 +132,8 @@
* requested. For this reason, #GtkWidget caches a small number of results
* to avoid re-querying for the same sizes in one allocation cycle.
*
* See <link linkend="container-geometry-management">GtkContainer's
* geometry management section</link>
* See
* [GtkContainer's geometry management section][container-geometry-management]
* to learn more about how height-for-width allocations are performed
* by container widgets.
*
@ -244,7 +244,7 @@
* #GtkWidget introduces “style
* properties” - these are basically object properties that are stored
* not on the object, but in the style object associated to the widget. Style
* properties are set in <link linkend="gtk3-Resource-Files">resource files</link>.
* properties are set in [resource files][gtk3-Resource-Files].
* This mechanism is used for configuring such things as the location of the
* scrollbar arrows through the theme, giving theme authors more control over the
* look of applications without the need to write a theme engine in C.
@ -1296,7 +1296,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* GtkWidget:tooltip-markup:
*
* Sets the text of tooltip to be the given string, which is marked up
* with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
* with the [Pango text markup language][PangoMarkupFormat].
* Also see gtk_tooltip_set_markup().
*
* This is a convenience property which will take care of getting the
@ -1959,7 +1959,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* @child_property: the #GParamSpec of the changed child property
*
* The ::child-notify signal is emitted for each
* <link linkend="child-properties">child property</link> that has
* [child property][child-properties] that has
* changed on an object. The signal's detail holds the property name.
*/
widget_signals[CHILD_NOTIFY] =
@ -4062,7 +4062,7 @@ gtk_widget_freeze_child_notify (GtkWidget *widget)
* class of @widget<!-- -->'s parent
*
* Emits a #GtkWidget::child-notify signal for the
* <link linkend="child-properties">child property</link> @child_property
* [child property][child-properties] @child_property
* on @widget.
*
* This is the analogue of g_object_notify() for child properties.
@ -14748,7 +14748,7 @@ gtk_widget_get_tooltip_text (GtkWidget *widget)
* @markup: (allow-none): the contents of the tooltip for @widget, or %NULL
*
* Sets @markup as the contents of the tooltip, which is marked up with
* the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
* the [Pango text markup language][PangoMarkupFormat].
*
* This function will take care of setting #GtkWidget:has-tooltip to %TRUE
* and of the default handler for the #GtkWidget::query-tooltip signal.

81
gtk/gtkwindow.c
View File

@ -1170,7 +1170,7 @@ gtk_window_class_init (GtkWindowClass *klass)
* @window: the window which received the signal
*
* The ::activate-focus signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user activates the currently
* focused widget of @window.
*/
@ -1189,7 +1189,7 @@ gtk_window_class_init (GtkWindowClass *klass)
* @window: the window which received the signal
*
* The ::activate-default signal is a
* <link linkend="keybinding-signals">keybinding signal</link>
* [keybinding signal][keybinding-signals]
* which gets emitted when the user activates the default widget
* of @window.
*/
@ -1832,8 +1832,8 @@ gtk_window_buildable_custom_finished (GtkBuildable *buildable,
* you might use #GTK_WINDOW_POPUP. #GTK_WINDOW_POPUP is not for
* dialogs, though in some other toolkits dialogs are called “popups”.
* In GTK+, #GTK_WINDOW_POPUP means a pop-up menu or pop-up tooltip.
* On X11, popup windows are not controlled by the <link
* linkend="gtk-X11-arch">window manager</link>.
* On X11, popup windows are not controlled by the
* [window manager][gtk-X11-arch].
*
* If you simply want an undecorated window (no window borders), use
* gtk_window_set_decorated(), don't use #GTK_WINDOW_POPUP.
@ -1901,8 +1901,8 @@ gtk_window_set_title_internal (GtkWindow *window,
*
* Sets the title of the #GtkWindow. The title of a window will be
* displayed in its title bar; on the X Window System, the title bar
* is rendered by the <link linkend="gtk-X11-arch">window
* manager</link>, so exactly how the title appears to users may vary
* is rendered by the [window manager][gtk-X11-arch],
* so exactly how the title appears to users may vary
* according to a user's exact configuration. The title should help a
* user distinguish this window from other windows they may have
* open. A good title might include the application name and current
@ -1981,7 +1981,7 @@ gtk_window_set_wmclass (GtkWindow *window,
* This function is only useful on X11, not with other GTK+ targets.
*
* In combination with the window title, the window role allows a
* <link linkend="gtk-X11-arch">window manager</link> to identify "the
* [window manager][gtk-X11-arch] to identify "the
* same" window when an application is restarted. So for example you
* might set the “toolbox” role on your app's toolbox window, so that
* when the user restarts their session, the window manager can put
@ -2567,7 +2567,7 @@ gtk_window_activate_default (GtkWindow *window)
* with other windows in the same application. To keep modal dialogs
* on top of main application windows, use
* gtk_window_set_transient_for() to make the dialog transient for the
* parent; most <link linkend="gtk-X11-arch">window managers</link>
* parent; most [window managers][gtk-X11-arch]
* will then disallow lowering the dialog below the parent.
*
*
@ -2786,8 +2786,8 @@ gtk_window_unset_transient_for (GtkWindow *window)
* @parent: (allow-none): parent window, or %NULL
*
* Dialog windows should be set transient for the main application
* window they were spawned from. This allows <link
* linkend="gtk-X11-arch">window managers</link> to e.g. keep the
* window they were spawned from. This allows
* [window managers][gtk-X11-arch] to e.g. keep the
* dialog on top of the main window, or center the dialog over the
* main window. gtk_dialog_new_with_buttons() and other convenience
* functions in GTK+ will sometimes call
@ -3753,8 +3753,8 @@ _gtk_window_titlebar_shows_app_menu (GtkWindow *window)
* @setting: %TRUE to decorate the window
*
* By default, windows are decorated with a title bar, resize
* controls, etc. Some <link linkend="gtk-X11-arch">window
* managers</link> allow GTK+ to disable these decorations, creating a
* controls, etc. Some [window managers][gtk-X11-arch]
* allow GTK+ to disable these decorations, creating a
* borderless window. If you set the decorated property to %FALSE
* using this function, GTK+ will do its best to convince the window
* manager not to decorate the window. Depending on the system, this
@ -3828,7 +3828,7 @@ gtk_window_get_decorated (GtkWindow *window)
* @setting: %TRUE to decorate the window as deletable
*
* By default, windows have a close button in the window frame. Some
* <link linkend="gtk-X11-arch">window managers</link> allow GTK+ to
* [window managers][gtk-X11-arch] allow GTK+ to
* disable this button. If you set the deletable property to %FALSE
* using this function, GTK+ will do its best to convince the window
* manager not to show a close button. Depending on the system, this
@ -4843,8 +4843,9 @@ gtk_window_resize_to_geometry (GtkWindow *window,
* @height: (out) (allow-none): return location for height, or %NULL
*
* Obtains the current size of @window. If @window is not onscreen,
* it returns the size GTK+ will suggest to the <link
* linkend="gtk-X11-arch">window manager</link> for the initial window
* it returns the size GTK+ will suggest to the
* [window manager][gtk-X11-arch]
* for the initial window
* size (but this is not reliably the same as the size the window
* manager will actually select). The size obtained by
* gtk_window_get_size() is the last size received in a
@ -4929,7 +4930,7 @@ gtk_window_get_size (GtkWindow *window,
* @x: X coordinate to move window to
* @y: Y coordinate to move window to
*
* Asks the <link linkend="gtk-X11-arch">window manager</link> to move
* Asks the [window manager][gtk-X11-arch] to move
* @window to the given position. Window managers are free to ignore
* this; most window managers ignore requests for initial window
* positions (instead using a user-defined placement algorithm) and
@ -10020,8 +10021,8 @@ gtk_window_present_with_time (GtkWindow *window,
*
* Asks to iconify (i.e. minimize) the specified @window. Note that
* you shouldn't assume the window is definitely iconified afterward,
* because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could deiconify it
* because other entities (e.g. the user or
* [window manager][gtk-X11-arch]) could deiconify it
* again, or there may not be a window manager in which case
* iconification isn't possible, etc. But normally the window will end
* up iconified. Just don't write code that crashes if not.
@ -10060,8 +10061,8 @@ gtk_window_iconify (GtkWindow *window)
*
* Asks to deiconify (i.e. unminimize) the specified @window. Note
* that you shouldn't assume the window is definitely deiconified
* afterward, because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could iconify it
* afterward, because other entities (e.g. the user or
* [window manager][gtk-X11-arch])) could iconify it
* again before your code which assumes deiconification gets to run.
*
* You can track iconification via the “window-state-event” signal
@ -10093,8 +10094,8 @@ gtk_window_deiconify (GtkWindow *window)
*
* Asks to stick @window, which means that it will appear on all user
* desktops. Note that you shouldn't assume the window is definitely
* stuck afterward, because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could unstick it
* stuck afterward, because other entities (e.g. the user or
* [window manager][gtk-X11-arch] could unstick it
* again, and some window managers do not support sticking
* windows. But normally the window will end up stuck. Just don't
* write code that crashes if not.
@ -10132,8 +10133,8 @@ gtk_window_stick (GtkWindow *window)
* Asks to unstick @window, which means that it will appear on only
* one of the user's desktops. Note that you shouldn't assume the
* window is definitely unstuck afterward, because other entities
* (e.g. the user or <link linkend="gtk-X11-arch">window
* manager</link>) could stick it again. But normally the window will
* (e.g. the user or [window manager][gtk-X11-arch]) could
* stick it again. But normally the window will
* end up stuck. Just don't write code that crashes if not.
*
* You can track stickiness via the “window-state-event” signal
@ -10166,8 +10167,8 @@ gtk_window_unstick (GtkWindow *window)
*
* Asks to maximize @window, so that it becomes full-screen. Note that
* you shouldn't assume the window is definitely maximized afterward,
* because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could unmaximize it
* because other entities (e.g. the user or
* [window manager][gtk-X11-arch]) could unmaximize it
* again, and not all window managers support maximization. But
* normally the window will end up maximized. Just don't write code
* that crashes if not.
@ -10207,8 +10208,8 @@ gtk_window_maximize (GtkWindow *window)
*
* Asks to unmaximize @window. Note that you shouldn't assume the
* window is definitely unmaximized afterward, because other entities
* (e.g. the user or <link linkend="gtk-X11-arch">window
* manager</link>) could maximize it again, and not all window
* (e.g. the user or [window manager][gtk-X11-arch])
* could maximize it again, and not all window
* managers honor requests to unmaximize. But normally the window will
* end up unmaximized. Just don't write code that crashes if not.
*
@ -10242,8 +10243,8 @@ gtk_window_unmaximize (GtkWindow *window)
*
* Asks to place @window in the fullscreen state. Note that you
* shouldn't assume the window is definitely full screen afterward,
* because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could unfullscreen it
* because other entities (e.g. the user or
* [window manager][gtk-X11-arch]) could unfullscreen it
* again, and not all window managers honor requests to fullscreen
* windows. But normally the window will end up fullscreen. Just
* don't write code that crashes if not.
@ -10279,8 +10280,8 @@ gtk_window_fullscreen (GtkWindow *window)
*
* Asks to toggle off the fullscreen state for @window. Note that you
* shouldn't assume the window is definitely not full screen
* afterward, because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could fullscreen it
* afterward, because other entities (e.g. the user or
* [window manager][gtk-X11-arch]) could fullscreen it
* again, and not all window managers honor requests to unfullscreen
* windows. But normally the window will end up restored to its normal
* state. Just don't write code that crashes if not.
@ -10317,8 +10318,8 @@ gtk_window_unfullscreen (GtkWindow *window)
*
* Asks to keep @window above, so that it stays on top. Note that
* you shouldn't assume the window is definitely above afterward,
* because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could not keep it above,
* because other entities (e.g. the user or
* [window manager][gtk-X11-arch]) could not keep it above,
* and not all window managers support keeping windows above. But
* normally the window will end kept above. Just don't write code
* that crashes if not.
@ -10368,8 +10369,8 @@ gtk_window_set_keep_above (GtkWindow *window,
*
* Asks to keep @window below, so that it stays in bottom. Note that
* you shouldn't assume the window is definitely below afterward,
* because other entities (e.g. the user or <link
* linkend="gtk-X11-arch">window manager</link>) could not keep it below,
* because other entities (e.g. the user or
* [window manager][gtk-X11-arch]) could not keep it below,
* and not all window managers support putting windows below. But
* normally the window will be kept below. Just don't write code
* that crashes if not.
@ -10523,8 +10524,8 @@ gtk_window_get_gravity (GtkWindow *window)
*
* Starts resizing a window. This function is used if an application
* has window resizing controls. When GDK can support it, the resize
* will be done using the standard mechanism for the <link
* linkend="gtk-X11-arch">window manager</link> or windowing
* will be done using the standard mechanism for the
* [window manager][gtk-X11-arch] or windowing
* system. Otherwise, GDK will try to emulate window resizing,
* potentially not all that well, depending on the windowing system.
*/
@ -10561,8 +10562,8 @@ gtk_window_begin_resize_drag (GtkWindow *window,
*
* Starts moving a window. This function is used if an application has
* window movement grips. When GDK can support it, the window movement
* will be done using the standard mechanism for the <link
* linkend="gtk-X11-arch">window manager</link> or windowing
* will be done using the standard mechanism for the
* [window manager][gtk-X11-arch] or windowing
* system. Otherwise, GDK will try to emulate window movement,
* potentially not all that well, depending on the windowing system.
*/