[gtk+/gtk-3-22] GtkFileChooserNative: documentation updated

[Matthias Clasen <matthiasc src gnome org>]

commit 2f6c90636d3abae68bc0f772215033287164ca52
Author: Tom Schoonjans <Tom Schoonjans diamond ac uk>
Date:   Sun Jul 9 18:04:06 2017 +0100

    GtkFileChooserNative: documentation updated
    
    https://bugzilla.gnome.org/show_bug.cgi?id=784723

 gtk/gtkfilechoosernative.c |   20 ++++++++++++++++++--
 1 files changed, 18 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtkfilechoosernative.c b/gtk/gtkfilechoosernative.c
index 7314fd6..8476bcd 100644
--- a/gtk/gtkfilechoosernative.c
+++ b/gtk/gtkfilechoosernative.c
@@ -50,8 +50,8 @@
  * #GtkFileChooserNative is an abstraction of a dialog box suitable
  * for use with “File/Open” or “File/Save as” commands. By default, this
  * just uses a #GtkFileChooserDialog to implement the actual dialog.
- * However, on certain platforms, such as Windows, the native platform
- * file chooser is uses instead. When the application is running in a
+ * However, on certain platforms, such as Windows and macOS, the native platform
+ * file chooser is used instead. When the application is running in a
  * sandboxed environment without direct filesystem access (such as Flatpak),
  * #GtkFileChooserNative may call the proper APIs (portals) to let the user
  * choose a file and make it available to the application.
@@ -187,6 +187,22 @@
  * * Use of custom previews by connecting to #GtkFileChooser::update-preview.
  *
  * * Any #GtkFileFilter added with a custom filter.
+ *
+ * ## macOS details ## {#gtkfilechooserdialognative-macos}
+ *
+ * On macOS the NSSavePanel and NSOpenPanel classes are used to provide native
+ * file chooser dialogs. Some features provided by #GtkFileChooserDialog are
+ * not supported:
+ *
+ * * Extra widgets added with gtk_file_chooser_set_extra_widget(), unless the
+ *   widget is an instance of GtkLabel, in which case the label text will be used
+ *   to set the NSSavePanel message instance property.
+ *
+ * * Use of custom previews by connecting to #GtkFileChooser::update-preview.
+ *
+ * * Any #GtkFileFilter added with a custom filter.
+ *
+ * * Shortcut folders.
  */
 
 enum {