[gimp] pdb, libgimp: fix some annotations in gimp.c and gimp_pdb.c.

[Jehan <jehanp src gnome org>]

commit b687f111f6dbcc02b4ded92e6fffbab3611e2ca1
Author: Jehan <jehan girinstud io>
Date:   Tue Jul 30 20:02:12 2019 +0200

    pdb, libgimp: fix some annotations in gimp.c and gimp_pdb.c.

 app/pdb/gimp-cmds.c |  2 +-
 libgimp/gimp.c      | 13 ++++++++-----
 libgimp/gimp_pdb.c  |  5 +++--
 pdb/groups/gimp.pdb |  2 +-
 4 files changed, 13 insertions(+), 9 deletions(-)
---
diff --git a/app/pdb/gimp-cmds.c b/app/pdb/gimp-cmds.c
index 66c20ee811..234b918c57 100644
--- a/app/pdb/gimp-cmds.c
+++ b/app/pdb/gimp-cmds.c
@@ -406,7 +406,7 @@ register_gimp_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("parasites",
                                                                  "parasites",
-                                                                 "The names of currently attached parasites",
+                                                                 "(array length=num_parasites) (element-type 
gchar) (transfer full): The names of currently attached parasites",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/libgimp/gimp.c b/libgimp/gimp.c
index c710cf2820..91c7f14bcb 100644
--- a/libgimp/gimp.c
+++ b/libgimp/gimp.c
@@ -1130,9 +1130,12 @@ gimp_install_procedure (const gchar        *name,
  * @type:          the type of the procedure.
  * @n_params:      the number of parameters the procedure takes.
  * @n_return_vals: the number of return values the procedure returns.
- * @params:        the procedure's parameters.
- * @return_vals:   the procedure's return values.
- * @run_proc:      the function to call for executing the procedure.
+ * @params: (array length=n_params):
+                   the procedure's parameters.
+ * @return_vals: (array length=n_return_vals):
+                   the procedure's return values.
+ * @run_proc: (closure) (scope async):
+                   the function to call for executing the procedure.
  *
  * Installs a new temporary procedure with the PDB (procedural database).
  *
@@ -1221,7 +1224,7 @@ gimp_uninstall_temp_proc (const gchar *name)
 }
 
 /**
- * gimp_run_procedure:
+ * gimp_run_procedure: (skip)
  * @name:          the name of the procedure to run
  * @n_return_vals: return location for the number of return values
  * @...:           list of procedure parameters
@@ -1449,7 +1452,7 @@ gimp_read_expect_msg (GimpWireMessage *msg,
 }
 
 /**
- * gimp_run_procedure2:
+ * gimp_run_procedure2: (rename-to gimp_run_procedure)
  * @name:          the name of the procedure to run
  * @n_return_vals: return location for the number of return values
  * @n_params:      the number of parameters the procedure takes.
diff --git a/libgimp/gimp_pdb.c b/libgimp/gimp_pdb.c
index 74beecef96..5cbfde10eb 100644
--- a/libgimp/gimp_pdb.c
+++ b/libgimp/gimp_pdb.c
@@ -209,8 +209,9 @@ gimp_get_parasite (const gchar *name)
  *
  * Returns a list of all currently attached global parasites.
  *
- * Returns: The names of currently attached parasites. The returned
- * value must be freed with g_strfreev().
+ * Returns: (array length=num_parasites) (element-type gchar) (transfer
+ * full): The names of currently attached parasites. The returned value
+ * must be freed with g_strfreev().
  *
  * Since: 2.8
  **/
diff --git a/pdb/groups/gimp.pdb b/pdb/groups/gimp.pdb
index 30492e1721..aea797008e 100644
--- a/pdb/groups/gimp.pdb
+++ b/pdb/groups/gimp.pdb
@@ -177,7 +177,7 @@ sub get_parasite_list {
 
     @outargs = (
        { name => 'parasites', type => 'stringarray',
-         desc => 'The names of currently attached parasites',
+         desc => '(array length=num_parasites) (element-type gchar) (transfer full): The names of currently 
attached parasites',
          array => { desc => 'The number of attached parasites' } }
     );