[libadwaita/wip/exalm/gi-docgen: 2/24] main: Convert docs

[Alexander Mikhaylenko <alexm src gnome org>]

commit fd957e9087aaf5e5ccc913fdd22779187f03ada3
Author: Alexander Mikhaylenko <alexm gnome org>
Date:   Tue May 11 15:05:21 2021 +0500

    main: Convert docs

 src/adw-main.c | 30 ++++++------------------------
 1 file changed, 6 insertions(+), 24 deletions(-)
---
diff --git a/src/adw-main.c b/src/adw-main.c
index f5778967..2c9e3a5a 100644
--- a/src/adw-main.c
+++ b/src/adw-main.c
@@ -11,19 +11,6 @@
 
 static int adw_initialized = FALSE;
 
-/**
- * SECTION:adwmain
- * @short_description: Library initialization.
- * @Title: adw-main
- *
- * Before using the Adwaita library you should initialize it by calling the
- * adw_init() function.
- * This makes sure translations, types, themes, and icons for the Adwaita
- * library are set up properly.
- *
- * Since: 1.0
- */
-
 static gboolean
 is_high_contrast (void)
 {
@@ -106,14 +93,6 @@ adw_style_init (void)
   g_once_init_leave (&guard, 1);
 }
 
-/**
- * adw_icons_init:
- *
- * Initializes the embedded icons. This must be called once GTK has been
- * initialized.
- *
- * Since: 1.0
- */
 static void
 adw_icons_init (void)
 {
@@ -131,10 +110,13 @@ adw_icons_init (void)
 /**
  * adw_init:
  *
+ * Initializes Libadwaita.
+ *
  * Call this function just after initializing GTK, if you are using
- * #GtkApplication it means it must be called when the #GApplication::startup
- * signal is emitted. If libadwaita has already been initialized, the function
- * will simply return.
+ * [class@Gtk.Application] it means it must be called when the
+ * `GApplication::startup` signal is emitted.
+ *
+ * If Libadwaita has already been initialized, the function will simply return.
  *
  * This makes sure translations, types, themes, and icons for the Adwaita
  * library are set up properly.