[gimp/gimp-2-8] Doc that gimp-display-new gives execution error if no GIMP GUI.

[Ed J <edj src gnome org>]

commit b812f513d476c0bc4bb3b2d08581d18fbab5f1a4
Author: Ed J <edj src gnome org>
Date:   Tue May 27 00:55:36 2014 +0100

    Doc that gimp-display-new gives execution error if no GIMP GUI.

 app/pdb/display-cmds.c       |    2 +-
 libgimp/gimpdisplay_pdb.c    |    3 ++-
 tools/pdbgen/pdb/display.pdb |    3 ++-
 3 files changed, 5 insertions(+), 3 deletions(-)
---
diff --git a/app/pdb/display-cmds.c b/app/pdb/display-cmds.c
index 28619e1..074778e 100644
--- a/app/pdb/display-cmds.c
+++ b/app/pdb/display-cmds.c
@@ -239,7 +239,7 @@ register_display_procs (GimpPDB *pdb)
   gimp_procedure_set_static_strings (procedure,
                                      "gimp-display-new",
                                      "Create a new display for the specified image.",
-                                     "Creates a new display for the specified image. If the image already 
has a display, another is added. Multiple displays are handled transparently by GIMP. The newly created 
display is returned and can be subsequently destroyed with a call to 'gimp-display-delete'. This procedure 
only makes sense for use with the GIMP UI.",
+                                     "Creates a new display for the specified image. If the image already 
has a display, another is added. Multiple displays are handled transparently by GIMP. The newly created 
display is returned and can be subsequently destroyed with a call to 'gimp-display-delete'. This procedure 
only makes sense for use with the GIMP UI, and will result in an execution error if called when GIMP has no 
UI.",
                                      "Spencer Kimball & Peter Mattis",
                                      "Spencer Kimball & Peter Mattis",
                                      "1995-1996",
diff --git a/libgimp/gimpdisplay_pdb.c b/libgimp/gimpdisplay_pdb.c
index 7e704b4..1a3c297 100644
--- a/libgimp/gimpdisplay_pdb.c
+++ b/libgimp/gimpdisplay_pdb.c
@@ -77,7 +77,8 @@ gimp_display_is_valid (gint32 display_ID)
  * has a display, another is added. Multiple displays are handled
  * transparently by GIMP. The newly created display is returned and can
  * be subsequently destroyed with a call to gimp_display_delete(). This
- * procedure only makes sense for use with the GIMP UI.
+ * procedure only makes sense for use with the GIMP UI, and will result
+ * in an execution error if called when GIMP has no UI.
  *
  * Returns: The new display.
  **/
diff --git a/tools/pdbgen/pdb/display.pdb b/tools/pdbgen/pdb/display.pdb
index ca0fa6b..f0fac95 100644
--- a/tools/pdbgen/pdb/display.pdb
+++ b/tools/pdbgen/pdb/display.pdb
@@ -53,7 +53,8 @@ Creates a new display for the specified image. If the image already has a
 display, another is added. Multiple displays are handled transparently by
 GIMP. The newly created display is returned and can be subsequently destroyed
 with a call to gimp_display_delete(). This procedure only makes sense for use
-with the GIMP UI.
+with the GIMP UI, and will result in an execution error if called when
+GIMP has no UI.
 HELP
 
     &std_pdb_misc;