[gtk/ebassi/gidocgen: 77/501] textview: Convert docs
- From: Emmanuele Bassi <ebassi src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk/ebassi/gidocgen: 77/501] textview: Convert docs
- Date: Fri, 5 Mar 2021 15:53:28 +0000 (UTC)
commit 36cd790c24f907f37115e69b446ddfda73309869
Author: Matthias Clasen <mclasen redhat com>
Date: Fri Feb 19 23:32:14 2021 -0500
textview: Convert docs
Change link syntax, add an example image, generally clean things up.
gtk/gtktextview.c | 932 ++++++++++++++++++++++++++++++------------------------
1 file changed, 525 insertions(+), 407 deletions(-)
---
diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c
index 45f1514cbd..a450599e52 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -61,14 +61,15 @@
* SECTION:gtktextview
* @Short_description: Widget that displays a GtkTextBuffer
* @Title: GtkTextView
- * @See_also: #GtkTextBuffer, #GtkTextIter
+ * @See_also: `GtkTextBuffer`, `GtkTextIter`
*
* A widget that displays the contents of a [class@Gtk.TextBuffer].
*
- * 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.
+ * ![An example GtkTextview](multiline-text.png)
+ *
+ * You may wish to begin by reading the [conceptual overview](section-text-widget.html),
+ * which gives an overview of all the objects and data types related to the
+ * text widget and how they work together.
*
* ## CSS nodes
*
@@ -83,7 +84,7 @@
* ╰── [window.popup]
* ]|
*
- * GtkTextView has a main css node with name textview and style class .view,
+ * `GtkTextView` has a main css node with name textview and style class .view,
* and subnodes for each of the border windows, and the main text area,
* with names border and text, respectively. The border nodes each get
* one of the style classes .left, .right, .top or .bottom.
@@ -95,7 +96,7 @@
*
* ## Accessibility
*
- * GtkTextView uses the #GTK_ACCESSIBLE_ROLE_TEXT_BOX role.
+ * `GtkTextView` uses the #GTK_ACCESSIBLE_ROLE_TEXT_BOX role.
*/
/* How scrolling, validation, exposes, etc. work.
@@ -834,7 +835,12 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
/*
* Properties
*/
-
+
+ /**
+ * GtkTextview:pixels-above-lines:
+ *
+ * Pixels of blank space above paragraphs.
+ */
g_object_class_install_property (gobject_class,
PROP_PIXELS_ABOVE_LINES,
g_param_spec_int ("pixels-above-lines",
@@ -842,7 +848,12 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
P_("Pixels of blank space above paragraphs"),
0, G_MAXINT, 0,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
-
+
+ /**
+ * GtkTextview:pixels-below-lines:
+ *
+ * Pixels of blank space below paragraphs.
+ */
g_object_class_install_property (gobject_class,
PROP_PIXELS_BELOW_LINES,
g_param_spec_int ("pixels-below-lines",
@@ -850,7 +861,12 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
P_("Pixels of blank space below paragraphs"),
0, G_MAXINT, 0,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
-
+
+ /**
+ * GtkTextview:pixels-inside-wrap:
+ *
+ * Pixels of blank space between wrapped lines in a paragraph.
+ */
g_object_class_install_property (gobject_class,
PROP_PIXELS_INSIDE_WRAP,
g_param_spec_int ("pixels-inside-wrap",
@@ -859,6 +875,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
0, G_MAXINT, 0,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
+ /**
+ * GtkTextview:editable:
+ *
+ * Whether the text can be modified by the user.
+ */
g_object_class_install_property (gobject_class,
PROP_EDITABLE,
g_param_spec_boolean ("editable",
@@ -867,6 +888,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
TRUE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
+ /**
+ * GtkTextview:wrap-mode:
+ *
+ * Whether to wrap lines never, at word boundaries, or at character boundaries.
+ */
g_object_class_install_property (gobject_class,
PROP_WRAP_MODE,
g_param_spec_enum ("wrap-mode",
@@ -875,7 +901,12 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
GTK_TYPE_WRAP_MODE,
GTK_WRAP_NONE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
-
+
+ /**
+ * GtkTextview:wrap-mode:
+ *
+ * Left, right, or center justification.
+ */
g_object_class_install_property (gobject_class,
PROP_JUSTIFICATION,
g_param_spec_enum ("justification",
@@ -889,6 +920,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView:left-margin:
*
* The default left margin for text in the text view.
+ *
* Tags in the buffer may override the default.
*
* Note that this property is confusingly named. In CSS terms,
@@ -907,6 +939,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView:right-margin:
*
* The default right margin for text in the text view.
+ *
* Tags in the buffer may override the default.
*
* Note that this property is confusingly named. In CSS terms,
@@ -930,7 +963,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* the value set here is padding, and it is applied in addition
* to the padding from the theme.
*
- * Don't confuse this property with #GtkWidget:margin-top.
+ * Don't confuse this property with [property@Gtk.Widget:margin-top].
*/
g_object_class_install_property (gobject_class,
PROP_TOP_MARGIN,
@@ -949,7 +982,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* the value set here is padding, and it is applied in addition
* to the padding from the theme.
*
- * Don't confuse this property with #GtkWidget:margin-bottom.
+ * Don't confuse this property with [property@Gtk.Widget:margin-bottom].
*/
g_object_class_install_property (gobject_class,
PROP_BOTTOM_MARGIN,
@@ -959,6 +992,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
0, G_MAXINT, 0,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
+ /**
+ * GtkTextView:indent:
+ *
+ * Amount to indent the paragraph, in pixels.
+ */
g_object_class_install_property (gobject_class,
PROP_INDENT,
g_param_spec_int ("indent",
@@ -967,6 +1005,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
G_MININT, G_MAXINT, 0,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
+ /**
+ * GtkTextview:tabs:
+ *
+ * Custom tabs for this text.
+ */
g_object_class_install_property (gobject_class,
PROP_TABS,
g_param_spec_boxed ("tabs",
@@ -975,6 +1018,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
PANGO_TYPE_TAB_ARRAY,
GTK_PARAM_READWRITE));
+ /**
+ * GtkTextView:cursor-visible:
+ *
+ * If the insertion cursor is shown.
+ */
g_object_class_install_property (gobject_class,
PROP_CURSOR_VISIBLE,
g_param_spec_boolean ("cursor-visible",
@@ -983,6 +1031,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
TRUE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
+ /**
+ * GtkTextView:buffer:
+ *
+ * The buffer which is displayed.
+ */
g_object_class_install_property (gobject_class,
PROP_BUFFER,
g_param_spec_object ("buffer",
@@ -991,6 +1044,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
GTK_TYPE_TEXT_BUFFER,
GTK_PARAM_READWRITE));
+ /**
+ * GtkTextView:overwrite:
+ *
+ * Whether entered text overwrites existing contents.
+ */
g_object_class_install_property (gobject_class,
PROP_OVERWRITE,
g_param_spec_boolean ("overwrite",
@@ -999,6 +1057,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
FALSE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
+ /**
+ * GtkTextView:accepts-tab:
+ *
+ * Whether Tab will result in a tab character being entered.
+ */
g_object_class_install_property (gobject_class,
PROP_ACCEPTS_TAB,
g_param_spec_boolean ("accepts-tab",
@@ -1006,16 +1069,16 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
P_("Whether Tab will result in a tab character
being entered"),
TRUE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
-
+
/**
* GtkTextView:im-module:
*
- * Which IM (input method) module should be used for this text_view.
- * See #GtkIMContext.
+ * Which IM (input method) module should be used for this text_view.
+ *
+ * See [class@Gtk.IMContext].
*
- * Setting this to a non-%NULL value overrides the
- * system-wide IM module setting. See the GtkSettings
- * #GtkSettings:gtk-im-module property.
+ * Setting this to a non-%NULL value overrides the system-wide IM module
+ * setting. See the GtkSettings [property@Gtk.Settings:gtk-im-module] property.
*/
g_object_class_install_property (gobject_class,
PROP_IM_MODULE,
@@ -1046,8 +1109,8 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
/**
* GtkTextView:input-hints:
*
- * Additional hints (beyond #GtkTextView:input-purpose) that
- * allow input methods to fine-tune their behaviour.
+ * Additional hints (beyond [property@Gtk.TextView:input-purpose])
+ * that allow input methods to fine-tune their behaviour.
*/
g_object_class_install_property (gobject_class,
PROP_INPUT_HINTS,
@@ -1062,6 +1125,8 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
/**
* GtkTextView:monospace:
*
+ * Whether text should be displayed in a monospace font.
+ *
* If %TRUE, set the .monospace style class on the
* text view to indicate that a monospace font is desired.
*/
@@ -1073,6 +1138,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
FALSE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
+ /**
+ * GtkTextView:extra-menu:
+ *
+ * A menu model whose contents will be appended to the context menu.
+ */
g_object_class_install_property (gobject_class,
PROP_EXTRA_MENU,
g_param_spec_object ("extra-menu",
@@ -1092,19 +1162,19 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
*/
/**
- * GtkTextView::move-cursor:
+ * GtkTextView::move-cursor:
* @text_view: the object which received the signal
* @step: the granularity of the move, as a #GtkMovementStep
* @count: the number of @step units to move
* @extend_selection: %TRUE if the move should extend the selection
- *
- * The ::move-cursor signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted when the user initiates a cursor movement.
+ *
+ * Gets emitted when the user initiates a cursor movement.
+ *
+ * The ::move-cursor signal is a [keybinding signal](class.SignalAction.html).
* If the cursor is not visible in @text_view, this signal causes
* the viewport to be moved instead.
*
- * Applications should not connect to it, but may emit it with
+ * Applications should not connect to it, but may emit it with
* g_signal_emit_by_name() if they need to control the cursor
* programmatically.
*
@@ -1139,11 +1209,12 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @step: the granularity of the movement, as a #GtkScrollStep
* @count: the number of @step units to move
*
- * The ::move-viewport signal is a
- * [keybinding signal][GtkSignalAction]
- * 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.
+ * Gets emitted to move the viewport.
+ *
+ * The ::move-viewport signal is a [keybinding signal](class.SignalAction.html),
+ * 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.
*
* There are no default bindings for this signal.
*/
@@ -1165,14 +1236,15 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::set-anchor:
* @text_view: the object which received the signal
*
- * The ::set-anchor signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted when the user initiates setting the "anchor"
+ * Gets emitted when the user initiates settings the "anchor" mark.
+ *
+ * The ::set-anchor signal is a [keybinding signal](class.SignalAction.html)
+ * which gets emitted when the user initiates setting the "anchor"
* mark. The "anchor" mark gets placed at the same position as the
* "insert" mark.
*
* This signal has no default bindings.
- */
+ */
signals[SET_ANCHOR] =
g_signal_new (I_("set-anchor"),
G_OBJECT_CLASS_TYPE (gobject_class),
@@ -1187,11 +1259,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
* @string: the string to insert
*
- * The ::insert-at-cursor signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted when the user initiates the insertion of a
+ * Gets emitted when the user initiates the insertion of a
* fixed string at the cursor.
*
+ * The ::insert-at-cursor signal is a [keybinding signal](class.SignalAction.html).
+ *
* This signal has no default bindings.
*/
signals[INSERT_AT_CURSOR] =
@@ -1210,18 +1282,17 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @type: the granularity of the deletion, as a #GtkDeleteType
* @count: the number of @type units to delete
*
- * The ::delete-from-cursor signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted when the user initiates a text deletion.
+ * Gets emitted when the user initiates a text deletion.
+ *
+ * The ::delete-from-cursor signal is a [keybinding signal](class.SignalAction.html).
*
* If the @type is %GTK_DELETE_CHARS, GTK deletes the selection
* if there is one, otherwise it deletes the requested number
* of characters.
*
- * The default bindings for this signal are
- * Delete for deleting a character, Ctrl-Delete for
- * deleting a word and Ctrl-Backspace for deleting a word
- * backwards.
+ * The default bindings for this signal are Delete for deleting a
+ * character, Ctrl-Delete for deleting a word and Ctrl-Backspace
+ * for deleting a word backwards.
*/
signals[DELETE_FROM_CURSOR] =
g_signal_new (I_("delete-from-cursor"),
@@ -1241,10 +1312,10 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::backspace:
* @text_view: the object which received the signal
*
- * The ::backspace signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted when the user asks for it.
- *
+ * Gets emitted when the user asks for it.
+ *
+ * The ::backspace signal is a [keybinding signal](class.SignalAction.html).
+ *
* The default bindings for this signal are
* Backspace and Shift-Backspace.
*/
@@ -1261,10 +1332,10 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::cut-clipboard:
* @text_view: the object which received the signal
*
- * The ::cut-clipboard signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted to cut the selection to the clipboard.
- *
+ * Gets emitted to cut the selection to the clipboard.
+ *
+ * The ::cut-clipboard signal is a [keybinding signal](class.SignalAction.html).
+ *
* The default bindings for this signal are
* Ctrl-x and Shift-Delete.
*/
@@ -1281,10 +1352,10 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::copy-clipboard:
* @text_view: the object which received the signal
*
- * The ::copy-clipboard signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted to copy the selection to the clipboard.
- *
+ * Gets emitted to copy the selection to the clipboard.
+ *
+ * The ::copy-clipboard signal is a [keybinding signal](class.SignalAction.html).
+ *
* The default bindings for this signal are
* Ctrl-c and Ctrl-Insert.
*/
@@ -1301,11 +1372,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::paste-clipboard:
* @text_view: the object which received the signal
*
- * The ::paste-clipboard signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted to paste the contents of the clipboard
+ * Gets emitted to paste the contents of the clipboard
* into the text view.
- *
+ *
+ * The ::paste-clipboard signal is a [keybinding signal](class.SignalAction.html).
+ *
* The default bindings for this signal are
* Ctrl-v and Shift-Insert.
*/
@@ -1322,12 +1393,12 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::toggle-overwrite:
* @text_view: the object which received the signal
*
- * The ::toggle-overwrite signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted to toggle the overwrite mode of the text view.
- *
+ * Gets emitted to toggle the overwrite mode of the text view.
+ *
+ * The ::toggle-overwrite signal is a [keybinding signal](class.SignalAction.html).
+ *
* The default bindings for this signal is Insert.
- */
+ */
signals[TOGGLE_OVERWRITE] =
g_signal_new (I_("toggle-overwrite"),
G_OBJECT_CLASS_TYPE (gobject_class),
@@ -1342,12 +1413,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
* @select: %TRUE to select, %FALSE to unselect
*
- * The ::select-all signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted to select or unselect the complete
- * contents of the text view.
+ * Gets emitted to select or unselect the complete contents of the text view.
*
- * The default bindings for this signal are Ctrl-a and Ctrl-/
+ * The ::select-all signal is a [keybinding signal](class.SignalAction.html).
+ *
+ * The default bindings for this signal are Ctrl-a and Ctrl-/
* for selecting and Shift-Ctrl-a and Ctrl-\ for unselecting.
*/
signals[SELECT_ALL] =
@@ -1363,13 +1433,13 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::toggle-cursor-visible:
* @text_view: the object which received the signal
*
+ * Gets emitted to toggle the `cursor-visible` property.
+ *
* The ::toggle-cursor-visible signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted to toggle the #GtkTextView:cursor-visible
- * property.
+ * [keybinding signal](class.SignalAction.html).
*
* The default binding for this signal is F7.
- */
+ */
signals[TOGGLE_CURSOR_VISIBLE] =
g_signal_new_class_handler (I_("toggle-cursor-visible"),
G_OBJECT_CLASS_TYPE (gobject_class),
@@ -1384,6 +1454,8 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @text_view: the object which received the signal
* @preedit: the current preedit string
*
+ * Emitted when preedit text of the active IM changes.
+ *
* If an input method is used, the typed text will not immediately
* be committed to the buffer. So if you are interested in the text,
* connect to this signal.
@@ -1409,8 +1481,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* @start: where the selection should start
* @end: where the selection should end
*
- * The ::extend-selection signal is emitted when the selection needs to be
- * extended at @location.
+ * Emitted when the selection needs to be extended at @location.
*
* Returns: %GDK_EVENT_STOP to stop other handlers from being invoked for the
* event. %GDK_EVENT_PROPAGATE to propagate the event further.
@@ -1435,9 +1506,9 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* GtkTextView::insert-emoji:
* @text_view: the object which received the signal
*
- * The ::insert-emoji signal is a
- * [keybinding signal][GtkSignalAction]
- * which gets emitted to present the Emoji chooser for the @text_view.
+ * Gets emitted to present the Emoji chooser for the @text_view.
+ *
+ * The ::insert-emoji signal is a [keybinding signal](class.SignalAction.html).
*
* The default bindings for this signal are Ctrl-. and Ctrl-;
*/
@@ -1989,13 +2060,15 @@ _gtk_text_view_ensure_magnifier (GtkTextView *text_view)
/**
* gtk_text_view_new:
*
- * Creates a new #GtkTextView. If you don’t call gtk_text_view_set_buffer()
- * before using the text view, an empty default buffer will be created
- * for you. Get the buffer with gtk_text_view_get_buffer(). If you want
- * to specify your own buffer, consider gtk_text_view_new_with_buffer().
+ * Creates a new `GtkTextView`.
+ *
+ * If you don’t call [method@Gtk.TextView.set_buffer] before using the
+ * text view, an empty default buffer will be created for you. Get the
+ * buffer with [method@Gtk.TextView.get_buffer]. If you want to specify
+ * your own buffer, consider [ctor@Gtk.TextView.new_with_buffer].
*
- * Returns: a new #GtkTextView
- **/
+ * Returns: a new `GtkTextView`
+ */
GtkWidget*
gtk_text_view_new (void)
{
@@ -2004,17 +2077,17 @@ gtk_text_view_new (void)
/**
* gtk_text_view_new_with_buffer:
- * @buffer: a #GtkTextBuffer
+ * @buffer: a `GtkTextBuffer`
+ *
+ * Creates a new `GtkTextView` widget displaying the buffer @buffer.
*
- * Creates a new #GtkTextView widget displaying the buffer
- * @buffer. One buffer can be shared among many widgets.
- * @buffer may be %NULL to create a default buffer, in which case
- * this function is equivalent to gtk_text_view_new(). The
- * text view adds its own reference count to the buffer; it does not
- * take over an existing reference.
+ * One buffer can be shared among many widgets. @buffer may be %NULL
+ * to create a default buffer, in which case this function is equivalent
+ * to [ctor Gtk TextView new]. The text view adds its own reference count
+ * to the buffer; it does not take over an existing reference.
*
- * Returns: a new #GtkTextView.
- **/
+ * Returns: a new `GtkTextView`.
+ */
GtkWidget*
gtk_text_view_new_with_buffer (GtkTextBuffer *buffer)
{
@@ -2029,15 +2102,16 @@ gtk_text_view_new_with_buffer (GtkTextBuffer *buffer)
/**
* gtk_text_view_set_buffer:
- * @text_view: a #GtkTextView
- * @buffer: (allow-none): a #GtkTextBuffer
- *
- * Sets @buffer as the buffer being displayed by @text_view. The previous
- * buffer displayed by the text view is unreferenced, and a reference is
- * added to @buffer. If you owned a reference to @buffer before passing it
- * to this function, you must remove that reference yourself; #GtkTextView
- * will not “adopt” it.
- **/
+ * @text_view: a `GtkTextView`
+ * @buffer: (allow-none): a `GtkTextBuffer`
+ *
+ * Sets @buffer as the buffer being displayed by @text_view.
+ *
+ * The previous buffer displayed by the text view is unreferenced, and
+ * a reference is added to @buffer. If you owned a reference to @buffer
+ * before passing it to this function, you must remove that reference
+ * yourself; `GtkTextView` will not “adopt” it.
+ */
void
gtk_text_view_set_buffer (GtkTextView *text_view,
GtkTextBuffer *buffer)
@@ -2171,14 +2245,15 @@ gtk_text_view_create_buffer (GtkTextView *text_view)
/**
* gtk_text_view_get_buffer:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
+ *
+ * Returns the `GtkTextBuffer` being displayed by this text view.
*
- * Returns the #GtkTextBuffer being displayed by this text view.
* The reference count on the buffer is not incremented; the caller
* of this function won’t own a new reference.
*
- * Returns: (transfer none): a #GtkTextBuffer
- **/
+ * Returns: (transfer none): a `GtkTextBuffer`
+ */
GtkTextBuffer*
gtk_text_view_get_buffer (GtkTextView *text_view)
{
@@ -2189,21 +2264,22 @@ gtk_text_view_get_buffer (GtkTextView *text_view)
/**
* gtk_text_view_get_cursor_locations:
- * @text_view: a #GtkTextView
- * @iter: (allow-none): a #GtkTextIter
+ * @text_view: a `GtkTextView`
+ * @iter: (allow-none): a `GtkTextIter`
* @strong: (out) (allow-none): location to store the strong
* cursor position (may be %NULL)
* @weak: (out) (allow-none): location to store the weak
* cursor position (may be %NULL)
*
- * Given an @iter within a text layout, determine the positions of the
- * strong and weak cursors if the insertion point is at that
- * iterator. The position of each cursor is stored as a zero-width
- * rectangle. The strong cursor location is the location where
- * characters of the directionality equal to the base direction of the
- * paragraph are inserted. The weak cursor location is the location
- * where characters of the directionality opposite to the base
- * direction of the paragraph are inserted.
+ * Determine the positions of the strong and weak cursors if the
+ * insertion point is at @iter.
+ *
+ * The position of each cursor is stored as a zero-width rectangle.
+ * The strong cursor location is the location where characters of
+ * the directionality equal to the base direction of the paragraph
+ * are inserted. The weak cursor location is the location where
+ * characters of the directionality opposite to the base direction
+ * of the paragraph are inserted.
*
* If @iter is %NULL, the actual cursor position is used.
*
@@ -2213,9 +2289,9 @@ gtk_text_view_get_buffer (GtkTextView *text_view)
* cursor’s offset within the preedit sequence.
*
* The rectangle position is in buffer coordinates; use
- * gtk_text_view_buffer_to_window_coords() to convert these
+ * [method@Gtk.TextView.buffer_to_window_coords] to convert these
* coordinates to coordinates for one of the windows in the text view.
- **/
+ */
void
gtk_text_view_get_cursor_locations (GtkTextView *text_view,
const GtkTextIter *iter,
@@ -2242,16 +2318,17 @@ gtk_text_view_get_cursor_locations (GtkTextView *text_view,
/**
* gtk_text_view_get_iter_at_location:
- * @text_view: a #GtkTextView
- * @iter: (out): a #GtkTextIter
+ * @text_view: a `GtkTextView`
+ * @iter: (out): a `GtkTextIter`
* @x: x position, in buffer coordinates
* @y: y position, in buffer coordinates
*
- * Retrieves the iterator at buffer coordinates @x and @y. Buffer
- * coordinates are coordinates for the entire buffer, not just the
- * currently-displayed portion. If you have coordinates from an
+ * Retrieves the iterator at buffer coordinates @x and @y.
+ *
+ * Buffer coordinates are coordinates for the entire buffer, not just
+ * the currently-displayed portion. If you have coordinates from an
* event, you have to convert those to buffer coordinates with
- * gtk_text_view_window_to_buffer_coords().
+ * [method@Gtk.TextView.window_to_buffer_coords].
*
* Returns: %TRUE if the position is over text
*/
@@ -2271,28 +2348,28 @@ gtk_text_view_get_iter_at_location (GtkTextView *text_view,
/**
* gtk_text_view_get_iter_at_position:
- * @text_view: a #GtkTextView
- * @iter: (out): a #GtkTextIter
- * @trailing: (out) (allow-none): if non-%NULL, location to store an integer indicating where
- * in the grapheme the user clicked. It will either be
- * zero, or the number of characters in the grapheme.
+ * @text_view: a `GtkTextView`
+ * @iter: (out): a `GtkTextIter`
+ * @trailing: (out) (allow-none): if non-%NULL, location to store
+ * an integer indicating where in the grapheme the user clicked.
+ * It will either be zero, or the number of characters in the grapheme.
* 0 represents the trailing edge of the grapheme.
* @x: x position, in buffer coordinates
* @y: y position, in buffer coordinates
*
* Retrieves the iterator pointing to the character at buffer
- * coordinates @x and @y. Buffer coordinates are coordinates for
- * the entire buffer, not just the currently-displayed portion.
- * If you have coordinates from an event, you have to convert
- * those to buffer coordinates with
- * gtk_text_view_window_to_buffer_coords().
+ * coordinates @x and @y.
+ *
+ * Buffer coordinates are coordinates for the entire buffer, not just
+ * the currently-displayed portion. If you have coordinates from an event,
+ * you have to convert those to buffer coordinates with
+ * [method@Gtk.TextView.window_to_buffer_coords].
*
- * Note that this is different from gtk_text_view_get_iter_at_location(),
- * which returns cursor locations, i.e. positions between
- * characters.
+ * Note that this is different from [method@Gtk.TextView.get_iter_at_location],
+ * which returns cursor locations, i.e. positions between characters.
*
* Returns: %TRUE if the position is over text
- **/
+ */
gboolean
gtk_text_view_get_iter_at_position (GtkTextView *text_view,
GtkTextIter *iter,
@@ -2310,15 +2387,16 @@ gtk_text_view_get_iter_at_position (GtkTextView *text_view,
/**
* gtk_text_view_get_iter_location:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
* @location: (out): bounds of the character at @iter
*
* Gets a rectangle which roughly contains the character at @iter.
+ *
* The rectangle position is in buffer coordinates; use
- * gtk_text_view_buffer_to_window_coords() to convert these
+ * [method@Gtk.TextView.buffer_to_window_coords] to convert these
* coordinates to coordinates for one of the windows in the text view.
- **/
+ */
void
gtk_text_view_get_iter_location (GtkTextView *text_view,
const GtkTextIter *iter,
@@ -2334,15 +2412,17 @@ gtk_text_view_get_iter_location (GtkTextView *text_view,
/**
* gtk_text_view_get_line_yrange:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
* @y: (out): return location for a y coordinate
* @height: (out): return location for a height
*
* Gets the y coordinate of the top of the line containing @iter,
- * and the height of the line. The coordinate is a buffer coordinate;
- * convert to window coordinates with gtk_text_view_buffer_to_window_coords().
- **/
+ * and the height of the line.
+ *
+ * The coordinate is a buffer coordinate; convert to window
+ * coordinates with [method@Gtk.TextView.buffer_to_window_coords].
+ */
void
gtk_text_view_get_line_yrange (GtkTextView *text_view,
const GtkTextIter *iter,
@@ -2362,17 +2442,19 @@ gtk_text_view_get_line_yrange (GtkTextView *text_view,
/**
* gtk_text_view_get_line_at_y:
- * @text_view: a #GtkTextView
- * @target_iter: (out): a #GtkTextIter
+ * @text_view: a `GtkTextView`
+ * @target_iter: (out): a `GtkTextIter`
* @y: a y coordinate
* @line_top: (out): return location for top coordinate of the line
*
- * Gets the #GtkTextIter at the start of the line containing
- * the coordinate @y. @y is in buffer coordinates, convert from
- * window coordinates with gtk_text_view_window_to_buffer_coords().
- * If non-%NULL, @line_top will be filled with the coordinate of the top
- * edge of the line.
- **/
+ * Gets the `GtkTextIter` at the start of the line containing
+ * the coordinate @y.
+ *
+ * @y is in buffer coordinates, convert from window coordinates with
+ * [method@Gtk.TextView.window_to_buffer_coords]. If non-%NULL,
+ * @line_top will be filled with the coordinate of the top edge
+ * of the line.
+ */
void
gtk_text_view_get_line_at_y (GtkTextView *text_view,
GtkTextIter *target_iter,
@@ -2607,8 +2689,8 @@ _gtk_text_view_scroll_to_iter (GtkTextView *text_view,
/**
* gtk_text_view_scroll_to_iter:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
* @within_margin: margin as a [0.0,0.5) fraction of screen size
* @use_align: whether to use alignment arguments (if %FALSE,
* just get the mark onscreen)
@@ -2616,22 +2698,23 @@ _gtk_text_view_scroll_to_iter (GtkTextView *text_view,
* @yalign: vertical alignment of mark within visible area
*
* Scrolls @text_view so that @iter is on the screen in the position
- * indicated by @xalign and @yalign. An alignment of 0.0 indicates
- * left or top, 1.0 indicates right or bottom, 0.5 means center.
- * If @use_align is %FALSE, the text scrolls the minimal distance to
- * get the mark onscreen, possibly not scrolling at all. The effective
- * screen for purposes of this function is reduced by a margin of size
- * @within_margin.
+ * indicated by @xalign and @yalign.
+ *
+ * An alignment of 0.0 indicates left or top, 1.0 indicates right or
+ * bottom, 0.5 means center. If @use_align is %FALSE, the text scrolls
+ * the minimal distance to get the mark onscreen, possibly not scrolling
+ * at all. The effective screen for purposes of this function is reduced
+ * by a margin of size @within_margin.
*
* Note that this function uses the currently-computed height of the
* lines in the text buffer. Line heights are computed in an idle
* handler; so this function may not have the desired effect if it’s
* called before the height computations. To avoid oddness, consider
- * using gtk_text_view_scroll_to_mark() which saves a point to be
+ * using [method@Gtk.TextView.scroll_to_mark] which saves a point to be
* scrolled to after line validation.
*
* Returns: %TRUE if scrolling occurred
- **/
+ */
gboolean
gtk_text_view_scroll_to_iter (GtkTextView *text_view,
GtkTextIter *iter,
@@ -2869,22 +2952,23 @@ flush_update_im_spot_location (GtkTextView *text_view)
/**
* gtk_text_view_scroll_to_mark:
- * @text_view: a #GtkTextView
- * @mark: a #GtkTextMark
+ * @text_view: a `GtkTextView`
+ * @mark: a `GtkTextMark`
* @within_margin: margin as a [0.0,0.5) fraction of screen size
- * @use_align: whether to use alignment arguments (if %FALSE, just
+ * @use_align: whether to use alignment arguments (if %FALSE, just
* get the mark onscreen)
* @xalign: horizontal alignment of mark within visible area
* @yalign: vertical alignment of mark within visible area
*
* Scrolls @text_view so that @mark is on the screen in the position
- * indicated by @xalign and @yalign. An alignment of 0.0 indicates
- * left or top, 1.0 indicates right or bottom, 0.5 means center.
- * If @use_align is %FALSE, the text scrolls the minimal distance to
- * get the mark onscreen, possibly not scrolling at all. The effective
- * screen for purposes of this function is reduced by a margin of size
- * @within_margin.
- **/
+ * indicated by @xalign and @yalign.
+ *
+ * An alignment of 0.0 indicates left or top, 1.0 indicates right or
+ * bottom, 0.5 means center. If @use_align is %FALSE, the text scrolls
+ * the minimal distance to get the mark onscreen, possibly not scrolling
+ * at all. The effective screen for purposes of this function is reduced
+ * by a margin of size @within_margin.
+ */
void
gtk_text_view_scroll_to_mark (GtkTextView *text_view,
GtkTextMark *mark,
@@ -2920,12 +3004,12 @@ gtk_text_view_scroll_to_mark (GtkTextView *text_view,
/**
* gtk_text_view_scroll_mark_onscreen:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @mark: a mark in the buffer for @text_view
- *
+ *
* Scrolls @text_view the minimum distance such that @mark is contained
* within the visible area of the widget.
- **/
+ */
void
gtk_text_view_scroll_mark_onscreen (GtkTextView *text_view,
GtkTextMark *mark)
@@ -2954,14 +3038,14 @@ clamp_iter_onscreen (GtkTextView *text_view, GtkTextIter *iter)
/**
* gtk_text_view_move_mark_onscreen:
- * @text_view: a #GtkTextView
- * @mark: a #GtkTextMark
+ * @text_view: a `GtkTextView`
+ * @mark: a `GtkTextMark`
*
* Moves a mark within the buffer so that it's
* located within the currently-visible text area.
*
* Returns: %TRUE if the mark moved (wasn’t already onscreen)
- **/
+ */
gboolean
gtk_text_view_move_mark_onscreen (GtkTextView *text_view,
GtkTextMark *mark)
@@ -2984,13 +3068,15 @@ gtk_text_view_move_mark_onscreen (GtkTextView *text_view,
/**
* gtk_text_view_get_visible_rect:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @visible_rect: (out): rectangle to fill
*
* Fills @visible_rect with the currently-visible
- * region of the buffer, in buffer coordinates. Convert to window coordinates
- * with gtk_text_view_buffer_to_window_coords().
- **/
+ * region of the buffer, in buffer coordinates.
+ *
+ * Convert to window coordinates with
+ * [method@Gtk.TextView.buffer_to_window_coords].
+ */
void
gtk_text_view_get_visible_rect (GtkTextView *text_view,
GdkRectangle *visible_rect)
@@ -3018,11 +3104,11 @@ gtk_text_view_get_visible_rect (GtkTextView *text_view,
/**
* gtk_text_view_set_wrap_mode:
- * @text_view: a #GtkTextView
- * @wrap_mode: a #GtkWrapMode
+ * @text_view: a `GtkTextView`
+ * @wrap_mode: a `GtkWrapMode`
*
* Sets the line wrapping for the view.
- **/
+ */
void
gtk_text_view_set_wrap_mode (GtkTextView *text_view,
GtkWrapMode wrap_mode)
@@ -3048,12 +3134,12 @@ gtk_text_view_set_wrap_mode (GtkTextView *text_view,
/**
* gtk_text_view_get_wrap_mode:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
* Gets the line wrapping for the view.
*
* Returns: the line wrap setting
- **/
+ */
GtkWrapMode
gtk_text_view_get_wrap_mode (GtkTextView *text_view)
{
@@ -3064,13 +3150,14 @@ gtk_text_view_get_wrap_mode (GtkTextView *text_view)
/**
* gtk_text_view_set_editable:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @setting: whether it’s editable
*
- * Sets the default editability of the #GtkTextView. You can override
- * this default setting with tags in the buffer, using the “editable”
- * attribute of tags.
- **/
+ * Sets the default editability of the `GtkTextView`.
+ *
+ * You can override this default setting with tags in the buffer,
+ * using the “editable” attribute of tags.
+ */
void
gtk_text_view_set_editable (GtkTextView *text_view,
gboolean setting)
@@ -3118,13 +3205,14 @@ gtk_text_view_set_editable (GtkTextView *text_view,
/**
* gtk_text_view_get_editable:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
- * Returns the default editability of the #GtkTextView. Tags in the
- * buffer may override this setting for some ranges of text.
+ * Returns the default editability of the `GtkTextView`.
+ *
+ * Tags in the buffer may override this setting for some ranges of text.
*
* Returns: whether text is editable by default
- **/
+ */
gboolean
gtk_text_view_get_editable (GtkTextView *text_view)
{
@@ -3135,12 +3223,13 @@ gtk_text_view_get_editable (GtkTextView *text_view)
/**
* gtk_text_view_set_pixels_above_lines:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @pixels_above_lines: pixels above paragraphs
- *
+ *
* Sets the default number of blank pixels above paragraphs in @text_view.
+ *
* Tags in the buffer for @text_view may override the defaults.
- **/
+ */
void
gtk_text_view_set_pixels_above_lines (GtkTextView *text_view,
int pixels_above_lines)
@@ -3167,14 +3256,15 @@ gtk_text_view_set_pixels_above_lines (GtkTextView *text_view,
/**
* gtk_text_view_get_pixels_above_lines:
- * @text_view: a #GtkTextView
- *
+ * @text_view: a `GtkTextView`
+ *
* Gets the default number of pixels to put above paragraphs.
- * Adding this function with gtk_text_view_get_pixels_below_lines()
+ *
+ * Adding this function with [method@Gtk.TextView.get_pixels_below_lines]
* is equal to the line space between each paragraph.
- *
+ *
* Returns: default number of pixels above paragraphs
- **/
+ */
int
gtk_text_view_get_pixels_above_lines (GtkTextView *text_view)
{
@@ -3185,13 +3275,14 @@ gtk_text_view_get_pixels_above_lines (GtkTextView *text_view)
/**
* gtk_text_view_set_pixels_below_lines:
- * @text_view: a #GtkTextView
- * @pixels_below_lines: pixels below paragraphs
+ * @text_view: a `GtkTextView`
+ * @pixels_below_lines: pixels below paragraphs
*
* Sets the default number of pixels of blank space
- * to put below paragraphs in @text_view. May be overridden
- * by tags applied to @text_view’s buffer.
- **/
+ * to put below paragraphs in @text_view.
+ *
+ * May be overridden by tags applied to @text_view’s buffer.
+ */
void
gtk_text_view_set_pixels_below_lines (GtkTextView *text_view,
int pixels_below_lines)
@@ -3218,15 +3309,15 @@ gtk_text_view_set_pixels_below_lines (GtkTextView *text_view,
/**
* gtk_text_view_get_pixels_below_lines:
- * @text_view: a #GtkTextView
- *
- * Gets the value set by gtk_text_view_set_pixels_below_lines().
+ * @text_view: a `GtkTextView`
*
- * The line space is the sum of the value returned by this function and the
- * value returned by gtk_text_view_get_pixels_above_lines().
+ * Gets the default number of pixels to put below paragraphs.
+ *
+ * The line space is the sum of the value returned by this function and
+ * the value returned by [method@Gtk.TextView.get_pixels_above_lines].
*
* Returns: default number of blank pixels below paragraphs
- **/
+ */
int
gtk_text_view_get_pixels_below_lines (GtkTextView *text_view)
{
@@ -3237,13 +3328,14 @@ gtk_text_view_get_pixels_below_lines (GtkTextView *text_view)
/**
* gtk_text_view_set_pixels_inside_wrap:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @pixels_inside_wrap: default number of pixels between wrapped lines
*
* Sets the default number of pixels of blank space to leave between
- * display/wrapped lines within a paragraph. May be overridden by
- * tags in @text_view’s buffer.
- **/
+ * display/wrapped lines within a paragraph.
+ *
+ * May be overridden by tags in @text_view’s buffer.
+ */
void
gtk_text_view_set_pixels_inside_wrap (GtkTextView *text_view,
int pixels_inside_wrap)
@@ -3270,12 +3362,13 @@ gtk_text_view_set_pixels_inside_wrap (GtkTextView *text_view,
/**
* gtk_text_view_get_pixels_inside_wrap:
- * @text_view: a #GtkTextView
- *
- * Gets the value set by gtk_text_view_set_pixels_inside_wrap().
- *
+ * @text_view: a `GtkTextView`
+ *
+ * Gets the default number of pixels to put between wrapped lines
+ * inside a paragraph.
+ *
* Returns: default number of pixels of blank space between wrapped lines
- **/
+ */
int
gtk_text_view_get_pixels_inside_wrap (GtkTextView *text_view)
{
@@ -3286,13 +3379,13 @@ gtk_text_view_get_pixels_inside_wrap (GtkTextView *text_view)
/**
* gtk_text_view_set_justification:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @justification: justification
*
* Sets the default justification of text in @text_view.
+ *
* Tags in the view’s buffer may override the default.
- *
- **/
+ */
void
gtk_text_view_set_justification (GtkTextView *text_view,
GtkJustification justification)
@@ -3319,13 +3412,14 @@ gtk_text_view_set_justification (GtkTextView *text_view,
/**
* gtk_text_view_get_justification:
- * @text_view: a #GtkTextView
- *
+ * @text_view: a `GtkTextView`
+ *
* Gets the default justification of paragraphs in @text_view.
+ *
* Tags in the buffer may override the default.
- *
+ *
* Returns: default justification
- **/
+ */
GtkJustification
gtk_text_view_get_justification (GtkTextView *text_view)
{
@@ -3336,10 +3430,11 @@ gtk_text_view_get_justification (GtkTextView *text_view)
/**
* gtk_text_view_set_left_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @left_margin: left margin in pixels
*
* Sets the default left margin for text in @text_view.
+ *
* Tags in the buffer may override the default.
*
* Note that this function is confusingly named.
@@ -3370,9 +3465,10 @@ gtk_text_view_set_left_margin (GtkTextView *text_view,
/**
* gtk_text_view_get_left_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
* Gets the default left margin size of paragraphs in the @text_view.
+ *
* Tags in the buffer may override the default.
*
* Returns: left margin in pixels
@@ -3387,10 +3483,11 @@ gtk_text_view_get_left_margin (GtkTextView *text_view)
/**
* gtk_text_view_set_right_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @right_margin: right margin in pixels
*
* Sets the default right margin for text in the text view.
+ *
* Tags in the buffer may override the default.
*
* Note that this function is confusingly named.
@@ -3421,10 +3518,11 @@ gtk_text_view_set_right_margin (GtkTextView *text_view,
/**
* gtk_text_view_get_right_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
+ *
+ * Gets the default right margin for text in @text_view.
*
- * Gets the default right margin for text in @text_view. Tags
- * in the buffer may override the default.
+ * Tags in the buffer may override the default.
*
* Returns: right margin in pixels
*/
@@ -3438,7 +3536,7 @@ gtk_text_view_get_right_margin (GtkTextView *text_view)
/**
* gtk_text_view_set_top_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @top_margin: top margin in pixels
*
* Sets the top margin for text in @text_view.
@@ -3472,12 +3570,12 @@ gtk_text_view_set_top_margin (GtkTextView *text_view,
/**
* gtk_text_view_get_top_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
* Gets the top margin for text in the @text_view.
*
* Returns: top margin in pixels
- **/
+ */
int
gtk_text_view_get_top_margin (GtkTextView *text_view)
{
@@ -3488,7 +3586,7 @@ gtk_text_view_get_top_margin (GtkTextView *text_view)
/**
* gtk_text_view_set_bottom_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @bottom_margin: bottom margin in pixels
*
* Sets the bottom margin for text in @text_view.
@@ -3518,7 +3616,7 @@ gtk_text_view_set_bottom_margin (GtkTextView *text_view,
/**
* gtk_text_view_get_bottom_margin:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
* Gets the bottom margin for text in the @text_view.
*
@@ -3534,12 +3632,13 @@ gtk_text_view_get_bottom_margin (GtkTextView *text_view)
/**
* gtk_text_view_set_indent:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @indent: indentation in pixels
*
* Sets the default indentation for paragraphs in @text_view.
+ *
* Tags in the buffer may override the default.
- **/
+ */
void
gtk_text_view_set_indent (GtkTextView *text_view,
int indent)
@@ -3566,14 +3665,15 @@ gtk_text_view_set_indent (GtkTextView *text_view,
/**
* gtk_text_view_get_indent:
- * @text_view: a #GtkTextView
- *
+ * @text_view: a `GtkTextView`
+ *
* Gets the default indentation of paragraphs in @text_view.
+ *
* Tags in the view’s buffer may override the default.
* The indentation may be negative.
- *
+ *
* Returns: number of pixels of indentation
- **/
+ */
int
gtk_text_view_get_indent (GtkTextView *text_view)
{
@@ -3584,12 +3684,13 @@ gtk_text_view_get_indent (GtkTextView *text_view)
/**
* gtk_text_view_set_tabs:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @tabs: tabs as a #PangoTabArray
*
* Sets the default tab stops for paragraphs in @text_view.
+ *
* Tags in the buffer may override the default.
- **/
+ */
void
gtk_text_view_set_tabs (GtkTextView *text_view,
PangoTabArray *tabs)
@@ -3622,16 +3723,18 @@ gtk_text_view_set_tabs (GtkTextView *text_view,
/**
* gtk_text_view_get_tabs:
- * @text_view: a #GtkTextView
- *
- * Gets the default tabs for @text_view. Tags in the buffer may
- * override the defaults. The returned array will be %NULL if
- * “standard” (8-space) tabs are used. Free the return value
- * with pango_tab_array_free().
- *
- * Returns: (nullable) (transfer full): copy of default tab array, or %NULL if
- * “standard" tabs are used; must be freed with pango_tab_array_free().
- **/
+ * @text_view: a `GtkTextView`
+ *
+ * Gets the default tabs for @text_view.
+ *
+ * Tags in the buffer may override the defaults. The returned array
+ * will be %NULL if “standard” (8-space) tabs are used. Free the
+ * return value with [method Pango TabArray free].
+ *
+ * Returns: (nullable) (transfer full): copy of default tab array,
+ * or %NULL if standard tabs are used; must be freed with
+ * [method Pango TabArray free].
+ */
PangoTabArray*
gtk_text_view_get_tabs (GtkTextView *text_view)
{
@@ -3648,15 +3751,16 @@ gtk_text_view_toggle_cursor_visible (GtkTextView *text_view)
/**
* gtk_text_view_set_cursor_visible:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @setting: whether to show the insertion cursor
*
- * Toggles whether the insertion point should be displayed. A buffer with
- * no editable text probably shouldn’t have a visible cursor, so you may
- * want to turn the cursor off.
+ * Toggles whether the insertion point should be displayed.
+ *
+ * A buffer with no editable text probably shouldn’t have a visible
+ * cursor, so you may want to turn the cursor off.
*
* Note that this property may be overridden by the
- * #GtkSettings:gtk-keynav-use-caret settings.
+ * [property@GtkSettings:gtk-keynav-use-caret] setting.
*/
void
gtk_text_view_set_cursor_visible (GtkTextView *text_view,
@@ -3688,7 +3792,7 @@ gtk_text_view_set_cursor_visible (GtkTextView *text_view,
/**
* gtk_text_view_get_cursor_visible:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
* Find out whether the cursor should be displayed.
*
@@ -3704,10 +3808,11 @@ gtk_text_view_get_cursor_visible (GtkTextView *text_view)
/**
* gtk_text_view_reset_cursor_blink:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
+ *
+ * Ensures that the cursor is shown.
*
- * Ensures that the cursor is shown (i.e. not in an 'off' blink
- * interval) and resets the time that it will stay blinking (or
+ * This also resets the time that it will stay blinking (or
* visible, in case blinking is disabled).
*
* This function should be called in response to user input
@@ -3725,13 +3830,13 @@ gtk_text_view_reset_cursor_blink (GtkTextView *text_view)
/**
* gtk_text_view_place_cursor_onscreen:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
* Moves the cursor to the currently visible region of the
- * buffer, if it isn’t there already.
+ * buffer.
*
* Returns: %TRUE if the cursor had to be moved.
- **/
+ */
gboolean
gtk_text_view_place_cursor_onscreen (GtkTextView *text_view)
{
@@ -4331,16 +4436,17 @@ find_child_for_window_type (GtkTextView *text_view,
/**
* gtk_text_view_get_gutter:
- * @text_view: a #GtkTextView
- * @win: a #GtkTextWindowType
+ * @text_view: a `GtkTextView`
+ * @win: a `GtkTextWindowType`
+ *
+ * Gets a `GtkWidget` that has previously been set as gutter.
*
- * Gets a #GtkWidget that has previously been set with
- * gtk_text_view_set_gutter().
+ * See [method@Gtk.TextView.set_gutter].
*
* @win must be one of %GTK_TEXT_WINDOW_LEFT, %GTK_TEXT_WINDOW_RIGHT,
* %GTK_TEXT_WINDOW_TOP, or %GTK_TEXT_WINDOW_BOTTOM.
*
- * Returns: (transfer none) (nullable): a #GtkWidget or %NULL
+ * Returns: (transfer none) (nullable): a `GtkWidget` or %NULL
*/
GtkWidget *
gtk_text_view_get_gutter (GtkTextView *text_view,
@@ -4364,9 +4470,9 @@ gtk_text_view_get_gutter (GtkTextView *text_view,
/**
* gtk_text_view_set_gutter:
- * @text_view: a #GtkTextView
- * @win: a #GtkTextWindowType
- * @widget: (nullable): a #GtkWidget or %NULL
+ * @text_view: a `GtkTextView`
+ * @win: a `GtkTextWindowType`
+ * @widget: (nullable): a `GtkWidget` or %NULL
*
* Places @widget into the gutter specified by @win.
*
@@ -5742,12 +5848,11 @@ gtk_text_view_snapshot (GtkWidget *widget,
/**
* gtk_text_view_remove:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @child: the child to remove
*
* Removes a child widget from @text_view.
*/
-
void
gtk_text_view_remove (GtkTextView *text_view,
GtkWidget *child)
@@ -6895,12 +7000,12 @@ gtk_text_view_toggle_overwrite (GtkTextView *text_view)
/**
* gtk_text_view_get_overwrite:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
- * Returns whether the #GtkTextView is in overwrite mode or not.
+ * Returns whether the `GtkTextView` is in overwrite mode or not.
*
* Returns: whether @text_view is in overwrite mode or not.
- **/
+ */
gboolean
gtk_text_view_get_overwrite (GtkTextView *text_view)
{
@@ -6911,11 +7016,11 @@ gtk_text_view_get_overwrite (GtkTextView *text_view)
/**
* gtk_text_view_set_overwrite:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @overwrite: %TRUE to turn on overwrite mode, %FALSE to turn it off
*
- * Changes the #GtkTextView overwrite mode.
- **/
+ * Changes the `GtkTextView` overwrite mode.
+ */
void
gtk_text_view_set_overwrite (GtkTextView *text_view,
gboolean overwrite)
@@ -6929,16 +7034,17 @@ gtk_text_view_set_overwrite (GtkTextView *text_view,
/**
* gtk_text_view_set_accepts_tab:
- * @text_view: A #GtkTextView
- * @accepts_tab: %TRUE if pressing the Tab key should insert a tab
- * character, %FALSE, if pressing the Tab key should move the
+ * @text_view: A `GtkTextView`
+ * @accepts_tab: %TRUE if pressing the Tab key should insert a tab
+ * character, %FALSE, if pressing the Tab key should move the
* keyboard focus.
- *
- * Sets the behavior of the text widget when the Tab key is pressed.
- * If @accepts_tab is %TRUE, a tab character is inserted. If @accepts_tab
- * is %FALSE the keyboard focus is moved to the next widget in the focus
+ *
+ * Sets the behavior of the text widget when the Tab key is pressed.
+ *
+ * If @accepts_tab is %TRUE, a tab character is inserted. If @accepts_tab
+ * is %FALSE the keyboard focus is moved to the next widget in the focus
* chain.
- **/
+ */
void
gtk_text_view_set_accepts_tab (GtkTextView *text_view,
gboolean accepts_tab)
@@ -6957,14 +7063,15 @@ gtk_text_view_set_accepts_tab (GtkTextView *text_view,
/**
* gtk_text_view_get_accepts_tab:
- * @text_view: A #GtkTextView
- *
+ * @text_view: A `GtkTextView`
+ *
* Returns whether pressing the Tab key inserts a tab characters.
- * gtk_text_view_set_accepts_tab().
- *
- * Returns: %TRUE if pressing the Tab key inserts a tab character,
+ *
+ * See [method@Gtk.TextView.set_accepts_tab].
+ *
+ * Returns: %TRUE if pressing the Tab key inserts a tab character,
* %FALSE if pressing the Tab key moves the keyboard focus.
- **/
+ */
gboolean
gtk_text_view_get_accepts_tab (GtkTextView *text_view)
{
@@ -7705,7 +7812,7 @@ gtk_text_view_destroy_layout (GtkTextView *text_view)
/**
* gtk_text_view_reset_im_context:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
* Reset the input method context of the text view if needed.
*
@@ -7726,26 +7833,27 @@ gtk_text_view_reset_im_context (GtkTextView *text_view)
/**
* gtk_text_view_im_context_filter_keypress:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @event: the key event
*
- * Allow the #GtkTextView input method to internally handle key press
- * and release events. If this function returns %TRUE, then no further
- * processing should be done for this key event. See
- * gtk_im_context_filter_keypress().
+ * Allow the `GtkTextView` input method to internally handle key press
+ * and release events.
+ *
+ * If this function returns %TRUE, then no further processing should be
+ * done for this key event. See [method@Gtk.IMContext.filter_keypress].
*
* Note that you are expected to call this function from your handler
* when overriding key event handling. This is needed in the case when
* you need to insert your own key handling between the input method
- * and the default key event handling of the #GtkTextView.
+ * and the default key event handling of the `GtkTextView`.
*
- * |[<!-- language="C" -->
+ * ```c
* static gboolean
* gtk_foo_bar_key_press_event (GtkWidget *widget,
* GdkEvent *event)
* {
* guint keyval;
- *
+ *
* gdk_event_get_keyval ((GdkEvent*)event, &keyval);
*
* if (keyval == GDK_KEY_Return || keyval == GDK_KEY_KP_Enter)
@@ -7758,7 +7866,7 @@ gtk_text_view_reset_im_context (GtkTextView *text_view)
*
* return GTK_WIDGET_CLASS (gtk_foo_bar_parent_class)->key_press_event (widget, event);
* }
- * ]|
+ * ```
*
* Returns: %TRUE if the input method handled the key event.
*/
@@ -9066,16 +9174,15 @@ text_window_get_height (GtkTextWindow *win)
/**
* gtk_text_view_buffer_to_window_coords:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @win: a #GtkTextWindowType
* @buffer_x: buffer x coordinate
* @buffer_y: buffer y coordinate
* @window_x: (out) (allow-none): window x coordinate return location or %NULL
* @window_y: (out) (allow-none): window y coordinate return location or %NULL
*
- * Converts coordinate (@buffer_x, @buffer_y) to coordinates for the window
- * @win, and stores the result in (@window_x, @window_y).
- **/
+ * Converts buffer coordinates to window coordinates.
+ */
void
gtk_text_view_buffer_to_window_coords (GtkTextView *text_view,
GtkTextWindowType win,
@@ -9130,7 +9237,7 @@ gtk_text_view_buffer_to_window_coords (GtkTextView *text_view,
/**
* gtk_text_view_window_to_buffer_coords:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @win: a #GtkTextWindowType
* @window_x: window x coordinate
* @window_y: window y coordinate
@@ -9138,8 +9245,8 @@ gtk_text_view_buffer_to_window_coords (GtkTextView *text_view,
* @buffer_y: (out) (allow-none): buffer y coordinate return location or %NULL
*
* Converts coordinates on the window identified by @win to buffer
- * coordinates, storing the result in (@buffer_x,@buffer_y).
- **/
+ * coordinates.
+ */
void
gtk_text_view_window_to_buffer_coords (GtkTextView *text_view,
GtkTextWindowType win,
@@ -9244,12 +9351,12 @@ add_child (GtkTextView *text_view,
/**
* gtk_text_view_add_child_at_anchor:
- * @text_view: a #GtkTextView
- * @child: a #GtkWidget
- * @anchor: a #GtkTextChildAnchor in the #GtkTextBuffer for @text_view
- *
+ * @text_view: a `GtkTextView`
+ * @child: a `GtkWidget`
+ * @anchor: a `GtkTextChildAnchor` in the `GtkTextBuffer` for @text_view
+ *
* Adds a child widget in the text buffer, at the given @anchor.
- **/
+ */
void
gtk_text_view_add_child_at_anchor (GtkTextView *text_view,
GtkWidget *child,
@@ -9293,19 +9400,21 @@ ensure_child (GtkTextView *text_view,
/**
* gtk_text_view_add_overlay:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @child: a #GtkWidget
* @xpos: X position of child in window coordinates
* @ypos: Y position of child in window coordinates
*
- * Adds @child at a fixed coordinate in the #GtkTextView's text window. The
- * @xpos and @ypos must be in buffer coordinates (see
- * gtk_text_view_get_iter_location() to convert to buffer coordinates).
+ * Adds @child at a fixed coordinate in the `GtkTextView`'s text window.
+ *
+ * The @xpos and @ypos must be in buffer coordinates (see
+ * [method@Gtk.TextView.get_iter_location] to convert to
+ * buffer coordinates).
*
* @child will scroll with the text view.
*
- * If instead you want a widget that will not move with the #GtkTextView
- * contents see #GtkOverlay.
+ * If instead you want a widget that will not move with the
+ * `GtkTextView` contents see #GtkOverlay.
*/
void
gtk_text_view_add_overlay (GtkTextView *text_view,
@@ -9327,13 +9436,15 @@ gtk_text_view_add_overlay (GtkTextView *text_view,
/**
* gtk_text_view_move_overlay:
- * @text_view: a #GtkTextView
- * @child: a widget already added with gtk_text_view_add_overlay()
+ * @text_view: a `GtkTextView`
+ * @child: a widget already added with [method@Gtk.TextView.add_overlay]
* @xpos: new X position in buffer coordinates
* @ypos: new Y position in buffer coordinates
*
- * Updates the position of a child, as for gtk_text_view_add_overlay().
- **/
+ * Updates the position of a child.
+ *
+ * See [method@Gtk.TextView.add_overlay].
+ */
void
gtk_text_view_move_overlay (GtkTextView *text_view,
GtkWidget *child,
@@ -9354,20 +9465,21 @@ gtk_text_view_move_overlay (GtkTextView *text_view,
/**
* gtk_text_view_forward_display_line:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
- *
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
+ *
* Moves the given @iter forward by one display (wrapped) line.
+ *
* A display line is different from a paragraph. Paragraphs are
* separated by newlines or other paragraph separator characters.
* Display lines are created by line-wrapping a paragraph. If
* wrapping is turned off, display lines and paragraphs will be the
* same. Display lines are divided differently for each view, since
* they depend on the view’s width; paragraphs are the same in all
- * views, since they depend on the contents of the #GtkTextBuffer.
- *
+ * views, since they depend on the contents of the `GtkTextBuffer`.
+ *
* Returns: %TRUE if @iter was moved and is not on the end iterator
- **/
+ */
gboolean
gtk_text_view_forward_display_line (GtkTextView *text_view,
GtkTextIter *iter)
@@ -9382,20 +9494,21 @@ gtk_text_view_forward_display_line (GtkTextView *text_view,
/**
* gtk_text_view_backward_display_line:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
- *
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
+ *
* Moves the given @iter backward by one display (wrapped) line.
+ *
* A display line is different from a paragraph. Paragraphs are
* separated by newlines or other paragraph separator characters.
* Display lines are created by line-wrapping a paragraph. If
* wrapping is turned off, display lines and paragraphs will be the
* same. Display lines are divided differently for each view, since
* they depend on the view’s width; paragraphs are the same in all
- * views, since they depend on the contents of the #GtkTextBuffer.
- *
+ * views, since they depend on the contents of the `GtkTextBuffer`.
+ *
* Returns: %TRUE if @iter was moved and is not on the end iterator
- **/
+ */
gboolean
gtk_text_view_backward_display_line (GtkTextView *text_view,
GtkTextIter *iter)
@@ -9410,20 +9523,21 @@ gtk_text_view_backward_display_line (GtkTextView *text_view,
/**
* gtk_text_view_forward_display_line_end:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
- *
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
+ *
* Moves the given @iter forward to the next display line end.
+ *
* A display line is different from a paragraph. Paragraphs are
* separated by newlines or other paragraph separator characters.
* Display lines are created by line-wrapping a paragraph. If
* wrapping is turned off, display lines and paragraphs will be the
* same. Display lines are divided differently for each view, since
* they depend on the view’s width; paragraphs are the same in all
- * views, since they depend on the contents of the #GtkTextBuffer.
- *
+ * views, since they depend on the contents of the `GtkTextBuffer`.
+ *
* Returns: %TRUE if @iter was moved and is not on the end iterator
- **/
+ */
gboolean
gtk_text_view_forward_display_line_end (GtkTextView *text_view,
GtkTextIter *iter)
@@ -9438,20 +9552,21 @@ gtk_text_view_forward_display_line_end (GtkTextView *text_view,
/**
* gtk_text_view_backward_display_line_start:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
- *
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
+ *
* Moves the given @iter backward to the next display line start.
+ *
* A display line is different from a paragraph. Paragraphs are
* separated by newlines or other paragraph separator characters.
* Display lines are created by line-wrapping a paragraph. If
* wrapping is turned off, display lines and paragraphs will be the
* same. Display lines are divided differently for each view, since
* they depend on the view’s width; paragraphs are the same in all
- * views, since they depend on the contents of the #GtkTextBuffer.
- *
+ * views, since they depend on the contents of the `GtkTextBuffer`.
+ *
* Returns: %TRUE if @iter was moved and is not on the end iterator
- **/
+ */
gboolean
gtk_text_view_backward_display_line_start (GtkTextView *text_view,
GtkTextIter *iter)
@@ -9466,15 +9581,16 @@ gtk_text_view_backward_display_line_start (GtkTextView *text_view,
/**
* gtk_text_view_starts_display_line:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
- *
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
+ *
* Determines whether @iter is at the start of a display line.
- * See gtk_text_view_forward_display_line() for an explanation of
- * display lines vs. paragraphs.
- *
+ *
+ * See [method@Gtk.TextView.forward_display_line] for an
+ * explanation of display lines vs. paragraphs.
+ *
* Returns: %TRUE if @iter begins a wrapped line
- **/
+ */
gboolean
gtk_text_view_starts_display_line (GtkTextView *text_view,
const GtkTextIter *iter)
@@ -9489,25 +9605,26 @@ gtk_text_view_starts_display_line (GtkTextView *text_view,
/**
* gtk_text_view_move_visually:
- * @text_view: a #GtkTextView
- * @iter: a #GtkTextIter
- * @count: number of characters to move (negative moves left,
+ * @text_view: a `GtkTextView`
+ * @iter: a `GtkTextIter`
+ * @count: number of characters to move (negative moves left,
* positive moves right)
*
* Move the iterator a given number of characters visually, treating
- * it as the strong cursor position. If @count is positive, then the
- * new strong cursor position will be @count positions to the right of
- * the old cursor position. If @count is negative then the new strong
- * cursor position will be @count positions to the left of the old
- * cursor position.
+ * it as the strong cursor position.
+ *
+ * If @count is positive, then the new strong cursor position will
+ * be @count positions to the right of the old cursor position.
+ * If @count is negative then the new strong cursor position will
+ * be @count positions to the left of the old cursor position.
*
* In the presence of bi-directional text, the correspondence
* between logical and visual order will depend on the direction
* of the current run, and there may be jumps when the cursor
* is moved off of the end of a run.
- *
+ *
* Returns: %TRUE if @iter moved and is not on the end iterator
- **/
+ */
gboolean
gtk_text_view_move_visually (GtkTextView *text_view,
GtkTextIter *iter,
@@ -9523,14 +9640,14 @@ gtk_text_view_move_visually (GtkTextView *text_view,
/**
* gtk_text_view_set_input_purpose:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @purpose: the purpose
*
- * Sets the #GtkTextView:input-purpose property which
- * can be used by on-screen keyboards and other input
- * methods to adjust their behaviour.
+ * Sets the `input-purpose` of the `GtkTextView`.
+ *
+ * The `input-purpose` can be used by on-screen keyboards
+ * and other input methods to adjust their behaviour.
*/
-
void
gtk_text_view_set_input_purpose (GtkTextView *text_view,
GtkInputPurpose purpose)
@@ -9550,9 +9667,9 @@ gtk_text_view_set_input_purpose (GtkTextView *text_view,
/**
* gtk_text_view_get_input_purpose:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
- * Gets the value of the #GtkTextView:input-purpose property.
+ * Gets the `input-purpose` of the `GtkTextView`.
*/
GtkInputPurpose
gtk_text_view_get_input_purpose (GtkTextView *text_view)
@@ -9570,13 +9687,14 @@ gtk_text_view_get_input_purpose (GtkTextView *text_view)
/**
* gtk_text_view_set_input_hints:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @hints: the hints
*
- * Sets the #GtkTextView:input-hints property, which
- * allows input methods to fine-tune their behaviour.
+ * Sets the `input-hints` of the `GtkTextView`.
+ *
+ * The `input-hints` allow input methods to fine-tune
+ * their behaviour.
*/
-
void
gtk_text_view_set_input_hints (GtkTextView *text_view,
GtkInputHints hints)
@@ -9597,9 +9715,9 @@ gtk_text_view_set_input_hints (GtkTextView *text_view,
/**
* gtk_text_view_get_input_hints:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
- * Gets the value of the #GtkTextView:input-hints property.
+ * Gets the `input-hints` of the `GtkTextView`.
*/
GtkInputHints
gtk_text_view_get_input_hints (GtkTextView *text_view)
@@ -9617,12 +9735,11 @@ gtk_text_view_get_input_hints (GtkTextView *text_view)
/**
* gtk_text_view_set_monospace:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
* @monospace: %TRUE to request monospace styling
*
- * Sets the #GtkTextView:monospace property, which
- * indicates that the text view should use monospace
- * fonts.
+ * Sets whether the `GtkTextView` should display text in
+ * monospace styling.
*/
void
gtk_text_view_set_monospace (GtkTextView *text_view,
@@ -9647,9 +9764,9 @@ gtk_text_view_set_monospace (GtkTextView *text_view,
/**
* gtk_text_view_get_monospace:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
- * Gets the value of the #GtkTextView:monospace property.
+ * Gets whether the `GtkTextView` uses monospace styling.
*
* Return: %TRUE if monospace fonts are desired
*/
@@ -9728,12 +9845,13 @@ gtk_text_view_insert_emoji (GtkTextView *text_view)
/**
* gtk_text_view_set_extra_menu:
- * @text_view: a #GtkTextView
- * @model: (allow-none): a #GMenuModel
+ * @text_view: a `GtkTextView`
+ * @model: (allow-none): a `GMenuModel`
+ *
+ * Sets a menu model to add when constructing the context
+ * menu for @text_view.
*
- * Sets a menu model to add when constructing
- * the context menu for @text_view. You can pass
- * %NULL to remove a previously set extra menu.
+ * You can pass %NULL to remove a previously set extra menu.
*/
void
gtk_text_view_set_extra_menu (GtkTextView *text_view,
@@ -9752,9 +9870,9 @@ gtk_text_view_set_extra_menu (GtkTextView *text_view,
/**
* gtk_text_view_get_extra_menu:
- * @text_view: a #GtkTextView
+ * @text_view: a `GtkTextView`
*
- * Gets the menu model set with gtk_text_view_set_extra_menu()
+ * Gets the menu model that gets added to the context menu
* or %NULL if none has been set.
*
* Returns: (transfer none): the menu model
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]