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

[Sophie Herold <sophieherold src gnome org>]

commit c2f053e80b2514dd03ee824f751e8afe94a3d1a1
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         | 4 ++++
 src/adw-expander-row.c       | 4 ++++
 src/adw-preferences-row.c    | 5 +++++
 src/adw-preferences-window.c | 1 +
 4 files changed, 14 insertions(+)
---
diff --git a/src/adw-action-row.c b/src/adw-action-row.c
index 2954b17f..c039e7fd 100644
--- a/src/adw-action-row.c
+++ b/src/adw-action-row.c
@@ -423,6 +423,10 @@ adw_action_row_get_subtitle (AdwActionRow *self)
  *
  * Sets the subtitle for @self.
  *
+ * The subtitle is interpreted as [pango markup](func@Pango.parse_markup) unless
+ * the [use-markup](property@Adw.PreferencesRow:use-markup) property is set to
+ * `FALSE`.
+ *
  * Since: 1.0
  */
 void
diff --git a/src/adw-expander-row.c b/src/adw-expander-row.c
index 0f53ad06..32359ec0 100644
--- a/src/adw-expander-row.c
+++ b/src/adw-expander-row.c
@@ -358,6 +358,10 @@ adw_expander_row_get_subtitle (AdwExpanderRow *self)
  *
  * Sets the subtitle for @self.
  *
+ * The subtitle is interpreted as [pango markup](func@Pango.parse_markup) unless
+ * the [use-markup](property@Adw.PreferencesRow:use-markup) property is set to
+ * `FALSE`.
+ *
  * Since: 1.0
  */
 void
diff --git a/src/adw-preferences-row.c b/src/adw-preferences-row.c
index d1d525ab..fdd3a011 100644
--- a/src/adw-preferences-row.c
+++ b/src/adw-preferences-row.c
@@ -231,6 +231,11 @@ 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
+ * the [use-markup](property@Adw.PreferencesRow:use-markup) property 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,