[libadwaita/wip/sophie-h/pref-row-markup] Add docs to set_(sub)title

[Sophie Herold <sophieherold src gnome org>]

commit 85187dd859814833fa2d8b93d48381480ff169c2
Author: Sophie Herold <sophie hemio de>
Date:   Mon Apr 4 18:49:18 2022 +0200

    Add docs to set_(sub)title

 src/adw-action-row.c         | 3 +++
 src/adw-expander-row.c       | 3 +++
 src/adw-preferences-row.c    | 4 ++++
 src/adw-preferences-window.c | 1 +
 4 files changed, 11 insertions(+)
---
diff --git a/src/adw-action-row.c b/src/adw-action-row.c
index 2954b17f..da52c28a 100644
--- a/src/adw-action-row.c
+++ b/src/adw-action-row.c
@@ -423,6 +423,9 @@ adw_action_row_get_subtitle (AdwActionRow *self)
  *
  * Sets the subtitle for @self.
  *
+ * The subtitle is interpreted as [pango markup](func@Pango.parse_markup) unless
+ * [property@PreferencesRow:use-markup] is set to `FALSE`.
+ *
  * Since: 1.0
  */
 void
diff --git a/src/adw-expander-row.c b/src/adw-expander-row.c
index 0f53ad06..b4ac4ac3 100644
--- a/src/adw-expander-row.c
+++ b/src/adw-expander-row.c
@@ -358,6 +358,9 @@ adw_expander_row_get_subtitle (AdwExpanderRow *self)
  *
  * Sets the subtitle for @self.
  *
+ * The subtitle is interpreted as [pango markup](func@Pango.parse_markup) unless
+ * [property@PreferencesRow:use-markup] is set to `FALSE`.
+ *
  * Since: 1.0
  */
 void
diff --git a/src/adw-preferences-row.c b/src/adw-preferences-row.c
index d1d525ab..9f7ccf65 100644
--- a/src/adw-preferences-row.c
+++ b/src/adw-preferences-row.c
@@ -231,6 +231,10 @@ adw_preferences_row_get_title (AdwPreferencesRow *self)
  *
  * Sets the title of the preference represented by @self.
  *
+ * The title is interpreted as [pango markup](func@Pango.parse_markup) unless
+ * [property@PreferencesRow:use-markup] is set to `FALSE`.
+ *
+ *
  * Since: 1.0
  */
 void
diff --git a/src/adw-preferences-window.c b/src/adw-preferences-window.c
index cc061e24..d8750e84 100644
--- a/src/adw-preferences-window.c
+++ b/src/adw-preferences-window.c
@@ -129,6 +129,7 @@ strip_mnemonic (const char *src)
   return new_str;
 }
 
+// Make lowercase, remove mnemonic and markup if applicable
 static char *
 make_comparable (const char        *src,
                  AdwPreferencesRow *row,