[gimp] app, pdb, libgimp: fix annotations of some PDB functions.

[Jehan <jehanp src gnome org>]

commit 6b442a1ba321117ccfc18f2956f294755dc68d63
Author: Jehan <jehan girinstud io>
Date:   Sun Jul 28 17:54:03 2019 +0200

    app, pdb, libgimp: fix annotations of some PDB functions.
    
    These are used in the first port of a Python plug-in which I am doing
    right now.

 app/pdb/context-cmds.c    | 2 +-
 app/pdb/palette-cmds.c    | 4 ++--
 libgimp/gimpcontext_pdb.c | 2 +-
 libgimp/gimppalette_pdb.c | 4 ++--
 pdb/groups/context.pdb    | 2 +-
 pdb/groups/palette.pdb    | 4 ++--
 6 files changed, 9 insertions(+), 9 deletions(-)
---
diff --git a/app/pdb/context-cmds.c b/app/pdb/context-cmds.c
index 277b8069e2..5f7c51cd82 100644
--- a/app/pdb/context-cmds.c
+++ b/app/pdb/context-cmds.c
@@ -4576,7 +4576,7 @@ register_context_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string ("name",
                                                            "name",
-                                                           "The name of the active palette",
+                                                           "(transfer full): The name of the active palette",
                                                            FALSE, FALSE, FALSE,
                                                            NULL,
                                                            GIMP_PARAM_READWRITE));
diff --git a/app/pdb/palette-cmds.c b/app/pdb/palette-cmds.c
index ae1a31f11f..84aaad3dc9 100644
--- a/app/pdb/palette-cmds.c
+++ b/app/pdb/palette-cmds.c
@@ -782,7 +782,7 @@ register_palette_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_int32 ("num-colors",
                                                           "num colors",
-                                                          "The number of colors in the palette",
+                                                          "(out): The number of colors in the palette",
                                                           G_MININT32, G_MAXINT32, 0,
                                                           GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
@@ -987,7 +987,7 @@ register_palette_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_rgb ("color",
                                                         "color",
-                                                        "The color requested",
+                                                        "(out): The color requested",
                                                         FALSE,
                                                         NULL,
                                                         GIMP_PARAM_READWRITE));
diff --git a/libgimp/gimpcontext_pdb.c b/libgimp/gimpcontext_pdb.c
index 8e409f2004..a61e9b686d 100644
--- a/libgimp/gimpcontext_pdb.c
+++ b/libgimp/gimpcontext_pdb.c
@@ -2232,7 +2232,7 @@ gimp_context_set_gradient_reverse (gboolean reverse)
  *
  * This procedure returns the name of the the currently active palette.
  *
- * Returns: The name of the active palette.
+ * Returns: (transfer full): The name of the active palette.
  *
  * Since: 2.2
  **/
diff --git a/libgimp/gimppalette_pdb.c b/libgimp/gimppalette_pdb.c
index 926ef30afd..b82375482a 100644
--- a/libgimp/gimppalette_pdb.c
+++ b/libgimp/gimppalette_pdb.c
@@ -201,7 +201,7 @@ gimp_palette_is_editable (const gchar *name)
 /**
  * gimp_palette_get_info:
  * @name: The palette name.
- * @num_colors: The number of colors in the palette.
+ * @num_colors: (out): The number of colors in the palette.
  *
  * Retrieve information about the specified palette.
  *
@@ -432,7 +432,7 @@ gimp_palette_delete_entry (const gchar *name,
  * gimp_palette_entry_get_color:
  * @name: The palette name.
  * @entry_num: The entry to retrieve.
- * @color: The color requested.
+ * @color: (out): The color requested.
  *
  * Gets the specified palette entry from the specified palette.
  *
diff --git a/pdb/groups/context.pdb b/pdb/groups/context.pdb
index 352520dd5e..c24d3d5b7f 100644
--- a/pdb/groups/context.pdb
+++ b/pdb/groups/context.pdb
@@ -1965,7 +1965,7 @@ HELP
 
     @outargs = (
        { name  => 'name', type  => 'string',
-         desc  => 'The name of the active palette' }
+         desc  => '(transfer full): The name of the active palette' }
     );
 
     %invoke = (
diff --git a/pdb/groups/palette.pdb b/pdb/groups/palette.pdb
index da3c7fc533..116fe21d9b 100644
--- a/pdb/groups/palette.pdb
+++ b/pdb/groups/palette.pdb
@@ -195,7 +195,7 @@ HELP
 
     @outargs = (
         { name => 'num_colors', type => 'int32', void_ret => 1,
-          desc => 'The number of colors in the palette' }
+          desc => '(out): The number of colors in the palette' }
     );
 
     %invoke = (
@@ -425,7 +425,7 @@ HELP
 
     @outargs = (
         { name => 'color', type => 'color', void_ret => 1,
-          desc => 'The color requested' }
+          desc => '(out): The color requested' }
     );
 
     %invoke = (