From: Matthias Clasen <mclasen@redhat.com>
Date: Wed, 30 Nov 2022 00:59:05 +0000 (-0500)
Subject: fontdialog: Improve docs
X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2~9^2~49^2~4
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=3e11ea9ddfcbb009e9d96ca508fc8fd76ed33760;p=gtk4.git

fontdialog: Improve docs

Be more specific about possible errors.
---

diff --git a/gtk/gtkfontdialog.c b/gtk/gtkfontdialog.c
index db7f24793a..334dcaf93a 100644
--- a/gtk/gtkfontdialog.c
+++ b/gtk/gtkfontdialog.c
@@ -674,7 +674,7 @@ gtk_font_dialog_choose_family (GtkFontDialog        *self,
  * gtk_font_dialog_choose_family_finish:
  * @self: a `GtkFontDialog`
  * @result: a `GAsyncResult`
- * @error: return location for an error
+ * @error: return location for a [enum@Gtk.DialogError] error
  *
  * Finishes the [method@Gtk.FontDialog.choose_family] call
  * and returns the resulting family.
@@ -758,7 +758,7 @@ gtk_font_dialog_choose_face (GtkFontDialog       *self,
  * gtk_font_dialog_choose_face_finish:
  * @self: a `GtkFontDialog`
  * @result: a `GAsyncResult`
- * @error: return location for an error
+ * @error: return location for a [enum@Gtk.DialogError] error
  *
  * Finishes the [method@Gtk.FontDialog.choose_face] call
  * and returns the resulting font face.
@@ -836,7 +836,7 @@ gtk_font_dialog_choose_font (GtkFontDialog        *self,
  * gtk_font_dialog_choose_font_finish:
  * @self: a `GtkFontDialog`
  * @result: a `GAsyncResult`
- * @error: return location for an error
+ * @error: return location for a [enum@Gtk.DialogError] error
  *
  * Finishes the [method@Gtk.FontDialog.choose_font] call
  * and returns the resulting font description.
@@ -919,7 +919,7 @@ gtk_font_dialog_choose_font_and_features (GtkFontDialog        *self,
  * @font_desc: (out caller-allocates): return location for font description
  * @font_features: (out caller-allocates): return location for font features
  * @language: (out caller-allocates): return location for the language
- * @error: return location for an error
+ * @error: return location for a [enum@Gtk.DialogError] error
  *
  * Finishes the [method@Gtk.FontDialog.choose_font_and_features]
  * call and returns the resulting font description and font features.