font dialog button: Add missing docs
diff --git a/gtk/gtkfontdialogbutton.h b/gtk/gtkfontdialogbutton.h
index c4d846f..47e891b 100644
--- a/gtk/gtkfontdialogbutton.h
+++ b/gtk/gtkfontdialogbutton.h
@@ -33,14 +33,6 @@
GDK_AVAILABLE_IN_4_10
G_DECLARE_FINAL_TYPE (GtkFontDialogButton, gtk_font_dialog_button, GTK, FONT_DIALOG_BUTTON, GtkWidget)
-typedef enum
-{
- GTK_FONT_LEVEL_FAMILY,
- GTK_FONT_LEVEL_FACE,
- GTK_FONT_LEVEL_FONT,
- GTK_FONT_LEVEL_FEATURES
-} GtkFontLevel;
-
GDK_AVAILABLE_IN_4_10
GtkWidget * gtk_font_dialog_button_new (GtkFontDialog *dialog);
@@ -51,6 +43,27 @@
void gtk_font_dialog_button_set_dialog (GtkFontDialogButton *self,
GtkFontDialog *dialog);
+/**
+ * GtkFontLevel:
+ * @GTK_FONT_LEVEL_FAMILY: Select a font family
+ * @GTK_FONT_LEVEL_FACE: Select a font face (i.e. a family and a style)
+ * @GTK_FONT_LEVEL_FONT: Select a font (i.e. a face with a size, and possibly font variations)
+ * @GTK_FONT_LEVEL_FEATURES: Select a font and font features
+ *
+ * The level of granularity for the font selection.
+ *
+ * Depending on this value, the `PangoFontDescription` that
+ * is returned by [method@Gtk.FontDialogButton.get_font_desc]
+ * will have more or less fields set.
+ */
+typedef enum
+{
+ GTK_FONT_LEVEL_FAMILY,
+ GTK_FONT_LEVEL_FACE,
+ GTK_FONT_LEVEL_FONT,
+ GTK_FONT_LEVEL_FEATURES
+} GtkFontLevel;
+
GDK_AVAILABLE_IN_4_10
GtkFontLevel gtk_font_dialog_button_get_level (GtkFontDialogButton *self);