From: Daniel Boles Date: Wed, 9 Aug 2023 14:34:50 +0000 (+0100) Subject: docs: Add/fix some links; avoid pluralisation X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2^2~39 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=efb3477dc96083e59e18e9160ef489cee12704bc;p=gtk4.git docs: Add/fix some links; avoid pluralisation Appending `s` breaks the [type@NS.Object] notation, so fix that in ListHeader. Add links to ListItem and Overlay, and avoid appending `s` after `backtick`s just for consistency with the [type@NS.Object] issue. --- diff --git a/gtk/gtklistheader.c b/gtk/gtklistheader.c index 62cfd5b4c9..14f0c6ffcb 100644 --- a/gtk/gtklistheader.c +++ b/gtk/gtklistheader.c @@ -27,9 +27,9 @@ * `GtkListHeader` is used by list widgets to represent the headers they * display. * - * The `GtkListHeader`s are managed just like [class@gtk.ListItem]s via - * their factory, but provide a different set of properties suitable for - * managing the header instead of individual items. + * `GtkListHeader` objects are managed just like [class@Gtk.ListItem] + * objects via their factory, but provide a different set of properties suitable + * for managing the header instead of individual items. * * Since: 4.12 */ diff --git a/gtk/gtklistitem.c b/gtk/gtklistitem.c index a06a43a28d..bb07c1f832 100644 --- a/gtk/gtklistitem.c +++ b/gtk/gtklistitem.c @@ -27,13 +27,14 @@ /** * GtkListItem: * - * `GtkListItem` is used by list widgets to represent items in a `GListModel`. + * `GtkListItem` is used by list widgets to represent items in a + * [iface@Gio.ListModel]. * - * The `GtkListItem`s are managed by the list widget (with its factory) + * `GtkListItem` objects are managed by the list widget (with its factory) * and cannot be created by applications, but they need to be populated * by application code. This is done by calling [method@Gtk.ListItem.set_child]. * - * `GtkListItem`s exist in 2 stages: + * `GtkListItem` objects exist in 2 stages: * * 1. The unbound stage where the listitem is not currently connected to * an item in the list. In that case, the [property@Gtk.ListItem:item] diff --git a/gtk/gtkoverlaylayout.c b/gtk/gtkoverlaylayout.c index 33f8de7a20..176e9d5a7a 100644 --- a/gtk/gtkoverlaylayout.c +++ b/gtk/gtkoverlaylayout.c @@ -33,12 +33,12 @@ /** * GtkOverlayLayout: * - * `GtkOverlayLayout` is the layout manager used by `GtkOverlay`. + * `GtkOverlayLayout` is the layout manager used by [class@Gtk.Overlay]. * * It places widgets as overlays on top of the main child. * * This is not a reusable layout manager, since it expects its widget - * to be a `GtkOverlay`. It only listed here so that its layout + * to be a `GtkOverlay`. It is only listed here so that its layout * properties get documented. */