[gimp] libgimp: Clarify semantics of gimp_export_image() without format_name

[Martin Nordholts <martinn src gnome org>]

commit 9956fb5348596820318cbccaf6aafb6b39efff9e
Author: Martin Nordholts <martinn src gnome org>
Date:   Tue Jul 21 12:44:13 2009 +0200

    libgimp: Clarify semantics of gimp_export_image() without format_name

 libgimp/gimpexport.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/libgimp/gimpexport.c b/libgimp/gimpexport.c
index 78723c1..a63f387 100644
--- a/libgimp/gimpexport.c
+++ b/libgimp/gimpexport.c
@@ -657,6 +657,10 @@ export_dialog (GSList      *actions,
  * user chooses Cancel, GIMP_EXPORT_CANCEL is returned and the
  * save_plugin should quit itself with status #GIMP_PDB_CANCEL.
  *
+ * If @format_name is NULL, no dialogs will be shown and this function
+ * will behave as if the user clicked on the 'Export' button, if a
+ * dialog would have been shown.
+ *
  * Returns: An enum of #GimpExportReturn describing the user_action.
  **/
 GimpExportReturn