nativedialog: Add more docs

Emphasize that native dialogs aren't widgets, and are not
kept alive by GTK.

diff --git a/gtk/gtkfilechoosernative.c b/gtk/gtkfilechoosernative.c
index 597deb5256194cc0e2964a03f8cb87400ae149e7..067d2b19f644cabb08105964a890fc9a5f998d8b 100644 (file)
--- a/gtk/gtkfilechoosernative.c
+++ b/gtk/gtkfilechoosernative.c
@@ -60,6 +60,11 @@
  * Showing, hiding and running the dialog is handled by the #GtkNativeDialog
  * functions.
  *
+ * Note that unlike #GtkFileChooserDialog, #GtkFileChooserNative objects are
+ * not toplevel widgets, and GTK does not keep them alive. It is your
+ * responsibility to keep a reference until you are done with the
+ * object.
+
  * ## Typical usage ## {#gtkfilechoosernative-typical-usage}
  *
  * In the simplest of cases, you can the following code to use

diff --git a/gtk/gtknativedialog.c b/gtk/gtknativedialog.c
index 4b28a4204109f2e752c62eef48ab34654f667b70..73ad13ea3a67f2f4d4a1fc7bac05dc139762e9d9 100644 (file)
--- a/gtk/gtknativedialog.c
+++ b/gtk/gtknativedialog.c
@@ -52,6 +52,11 @@
  * various common properties on the dialog, as well as show and hide
  * it and get a #GtkNativeDialog::response signal when the user finished
  * with the dialog.
+ *
+ * Note that unlike #GtkDialog, #GtkNativeDialog objects are not
+ * toplevel widgets, and GTK does not keep them alive. It is your
+ * responsibility to keep a reference until you are done with the
+ * object.
  */
 
 typedef struct _GtkNativeDialogPrivate GtkNativeDialogPrivate;