From dc8ee5a992eb421dc73ca32c9c8ee48b93b2886f Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sun, 21 Feb 2021 19:43:00 -0500
Subject: [PATCH] volumebutton: Convert docs

Change link syntax, add an example image, generally clean things up.
---
 gtk/gtkvolumebutton.c | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/gtk/gtkvolumebutton.c b/gtk/gtkvolumebutton.c
index feae0ca790..5d9c494a29 100644
--- a/gtk/gtkvolumebutton.c
+++ b/gtk/gtkvolumebutton.c
@@ -36,13 +36,12 @@
 
 
 /**
- * SECTION:gtkvolumebutton
- * @Short_description: A button which pops up a volume control
- * @Title: GtkVolumeButton
+ * GtkVolumeButton:
  *
- * #GtkVolumeButton is a subclass of #GtkScaleButton that has
- * been tailored for use as a volume control widget with suitable
- * icons, tooltips and accessible labels.
+ * `GtkVolumeButton` is a `GtkScaleButton` subclass tailored for
+ * volume control.
+ *
+ * ![An example GtkVolumeButton](volumebutton.png)
  */
 
 typedef struct _GtkVolumeButtonClass  GtkVolumeButtonClass;
@@ -163,10 +162,10 @@ gtk_volume_button_class_init (GtkVolumeButtonClass *klass)
   /**
    * GtkVolumeButton:use-symbolic:
    *
-   * Whether to use symbolic icons as the icons. Note that
-   * if the symbolic icons are not available in your installed
-   * theme, then the normal (potentially colorful) icons will
-   * be used.
+   * Whether to use symbolic icons as the icons.
+   *
+   * Note that if the symbolic icons are not available in your installed
+   * theme, then the normal (potentially colorful) icons will be used.
    */
   g_object_class_install_property (gobject_class,
                                    PROP_SYMBOLIC,
@@ -194,11 +193,13 @@ gtk_volume_button_init (GtkVolumeButton *button)
 /**
  * gtk_volume_button_new:
  *
- * Creates a #GtkVolumeButton, with a range between 0.0 and 1.0, with
- * a stepping of 0.02. Volume values can be obtained and modified using
- * the functions from #GtkScaleButton.
+ * Creates a `GtkVolumeButton`.
  *
- * Returns: a new #GtkVolumeButton
+ * The button has a range between 0.0 and 1.0, with a stepping of 0.02.
+ * Volume values can be obtained and modified using the functions from
+ * [class@Gtk.ScaleButton].
+ *
+ * Returns: a new `GtkVolumeButton`
  */
 GtkWidget *
 gtk_volume_button_new (void)