[gtk/gtk-4-6] docs: Fix links in selection models
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk/gtk-4-6] docs: Fix links in selection models
- Date: Thu, 21 Apr 2022 23:29:07 +0000 (UTC)
commit b024c9a7431328d4fe6b49325012b7dabc1a5bbd
Author: Maximiliano Sandoval R <msandova gnome org>
Date: Fri Apr 1 13:04:14 2022 +0200
docs: Fix links in selection models
gtk/gtkselectionmodel.c | 14 ++++++++------
gtk/gtksingleselection.c | 6 +++---
2 files changed, 11 insertions(+), 9 deletions(-)
---
diff --git a/gtk/gtkselectionmodel.c b/gtk/gtkselectionmodel.c
index 3f78141e58..e9c9dcef3c 100644
--- a/gtk/gtkselectionmodel.c
+++ b/gtk/gtkselectionmodel.c
@@ -43,12 +43,14 @@
* [signal@Gtk.SelectionModel::selection-changed] signal by calling the
* [method@Gtk.SelectionModel.selection_changed] function. The positions given
* in that signal may have their selection state changed, though that is not a
- * requirement. If new items added to the model via the ::items-changed signal
- * are selected or not is up to the implementation.
- *
- * Note that items added via ::items-changed may already be selected and no
- * [Gtk.SelectionModel::selection-changed] will be emitted for them. So to
- * track which items are selected, it is necessary to listen to both signals.
+ * requirement. If new items added to the model via the
+ * [signal@Gio.ListModel::items-changed] signal are selected or not is up to the
+ * implementation.
+ *
+ * Note that items added via [signal@Gio.ListModel::items-changed] may already
+ * be selected and no [signal@Gtk.SelectionModel::selection-changed] will be
+ * emitted for them. So to track which items are selected, it is necessary to
+ * listen to both signals.
*
* Additionally, the interface can expose functionality to select and unselect
* items. If these functions are implemented, GTK's list widgets will allow users
diff --git a/gtk/gtksingleselection.c b/gtk/gtksingleselection.c
index 7b01cb6f19..d0d50c7304 100644
--- a/gtk/gtksingleselection.c
+++ b/gtk/gtksingleselection.c
@@ -32,9 +32,9 @@
* item.
*
* Note that the selection is *persistent* -- if the selected item is removed
- * and re-added in the same ::items-changed emission, it stays selected.
- * In particular, this means that changing the sort order of an underlying sort
- * model will preserve the selection.
+ * and re-added in the same [signal@Gio.ListModel::items-changed] emission, it
+ * stays selected. In particular, this means that changing the sort order of an
+ * underlying sort model will preserve the selection.
*/
struct _GtkSingleSelection
{
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]