[gtk/ebassi/gidocgen: 288/500] levelbar: Docs tweaks

[Emmanuele Bassi <ebassi src gnome org>]

commit 12f0d963d975bc365759c2615686306278e15280
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Feb 27 18:19:57 2021 -0500

    levelbar: Docs tweaks

 gtk/gtklevelbar.c | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)
---
diff --git a/gtk/gtklevelbar.c b/gtk/gtklevelbar.c
index ed34f2816e..1208297b2c 100644
--- a/gtk/gtklevelbar.c
+++ b/gtk/gtklevelbar.c
@@ -21,17 +21,18 @@
 /**
  * GtkLevelBar:
  *
- * The `GtkLevelBar` is a bar widget that can be used
- * as a level indicator. Typical use cases are displaying the strength
- * of a password, or showing the charge level of a battery.
+ * `GtkLevelBar` is a widget that can be used as a level indicator.
+ *
+ * Typical use cases are displaying the strength of a password, or
+ * showing the charge level of a battery.
  *
  * ![An example GtkLevelBar](levelbar.png)
  *
  * Use [method@Gtk.LevelBar.set_value] to set the current value, and
  * [method@Gtk.LevelBar.add_offset_value] to set the value offsets at which
  * the bar will be considered in a different state. GTK will add a few
- * offsets by default on the level bar: #GTK_LEVEL_BAR_OFFSET_LOW,
- * #GTK_LEVEL_BAR_OFFSET_HIGH and #GTK_LEVEL_BAR_OFFSET_FULL, with
+ * offsets by default on the level bar: %GTK_LEVEL_BAR_OFFSET_LOW,
+ * %GTK_LEVEL_BAR_OFFSET_HIGH and %GTK_LEVEL_BAR_OFFSET_FULL, with
  * values 0.25, 0.75 and 1.0 respectively.
  *
  * Note that it is your responsibility to update preexisting offsets
@@ -94,14 +95,14 @@
  *
  * # CSS nodes
  *
- * |[<!-- language="plain" -->
+ * ```
  * levelbar[.discrete]
  * ╰── trough
  *     ├── block.filled.level-name
  *     ┊
  *     ├── block.empty
  *     ┊
- * ]|
+ * ```
  *
  * `GtkLevelBar` has a main CSS node with name levelbar and one of the style
  * classes .discrete or .continuous and a subnode with name trough. Below the