[gimp] pdb: update documentation for all pdb functions whose return can be freed with g_strfreev().



commit c9888f2222e6a7fd09a6018810ed6555b6297752
Author: Jehan <jehan girinstud io>
Date:   Tue Dec 4 00:16:08 2012 +0900

    pdb: update documentation for all pdb functions whose return can be freed with g_strfreev().

 app/pdb/brushes-cmds.c             |    2 +-
 app/pdb/buffer-cmds.c              |    2 +-
 app/pdb/context-cmds.c             |    2 +-
 app/pdb/dynamics-cmds.c            |    2 +-
 app/pdb/fonts-cmds.c               |    2 +-
 app/pdb/gimp-cmds.c                |    2 +-
 app/pdb/gradients-cmds.c           |    2 +-
 app/pdb/image-cmds.c               |    2 +-
 app/pdb/item-cmds.c                |    2 +-
 app/pdb/palettes-cmds.c            |    2 +-
 app/pdb/paths-cmds.c               |    2 +-
 app/pdb/patterns-cmds.c            |    2 +-
 app/pdb/procedural-db-cmds.c       |    2 +-
 libgimp/gimp_pdb.c                 |    2 +-
 libgimp/gimpbrushes_pdb.c          |    2 +-
 libgimp/gimpbuffer_pdb.c           |    2 +-
 libgimp/gimpcontext_pdb.c          |    2 +-
 libgimp/gimpdynamics_pdb.c         |    2 +-
 libgimp/gimpfonts_pdb.c            |    2 +-
 libgimp/gimpgradients_pdb.c        |    2 +-
 libgimp/gimpimage_pdb.c            |    2 +-
 libgimp/gimpitem_pdb.c             |    2 +-
 libgimp/gimppalettes_pdb.c         |    2 +-
 libgimp/gimppaths_pdb.c            |    2 +-
 libgimp/gimppatterns_pdb.c         |    2 +-
 libgimp/gimpproceduraldb_pdb.c     |    2 +-
 tools/pdbgen/pdb/brushes.pdb       |    2 +-
 tools/pdbgen/pdb/buffer.pdb        |    2 +-
 tools/pdbgen/pdb/context.pdb       |    2 +-
 tools/pdbgen/pdb/dynamics.pdb      |    2 +-
 tools/pdbgen/pdb/fonts.pdb         |    2 +-
 tools/pdbgen/pdb/gimp.pdb          |    2 +-
 tools/pdbgen/pdb/gradients.pdb     |    2 +-
 tools/pdbgen/pdb/image.pdb         |    2 +-
 tools/pdbgen/pdb/item.pdb          |    2 +-
 tools/pdbgen/pdb/palettes.pdb      |    2 +-
 tools/pdbgen/pdb/paths.pdb         |    2 +-
 tools/pdbgen/pdb/patterns.pdb      |    2 +-
 tools/pdbgen/pdb/procedural_db.pdb |    2 +-
 39 files changed, 39 insertions(+), 39 deletions(-)
---
diff --git a/app/pdb/brushes-cmds.c b/app/pdb/brushes-cmds.c
index 2a3ff4a..39a4e0b 100644
--- a/app/pdb/brushes-cmds.c
+++ b/app/pdb/brushes-cmds.c
@@ -297,7 +297,7 @@ register_brushes_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("brush-list",
                                                                  "brush list",
-                                                                 "The list of brush names",
+                                                                 "The list of brush names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/buffer-cmds.c b/app/pdb/buffer-cmds.c
index f77fc71..e834971 100644
--- a/app/pdb/buffer-cmds.c
+++ b/app/pdb/buffer-cmds.c
@@ -317,7 +317,7 @@ register_buffer_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("buffer-list",
                                                                  "buffer list",
-                                                                 "The list of buffer names",
+                                                                 "The list of buffer names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/context-cmds.c b/app/pdb/context-cmds.c
index bcb32cb..73a6088 100644
--- a/app/pdb/context-cmds.c
+++ b/app/pdb/context-cmds.c
@@ -2072,7 +2072,7 @@ register_context_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("paint-methods",
                                                                  "paint methods",
-                                                                 "The names of the available paint methods",
+                                                                 "The names of the available paint methods. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/dynamics-cmds.c b/app/pdb/dynamics-cmds.c
index 8207ce8..65ad7ce 100644
--- a/app/pdb/dynamics-cmds.c
+++ b/app/pdb/dynamics-cmds.c
@@ -137,7 +137,7 @@ register_dynamics_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("dynamics-list",
                                                                  "dynamics list",
-                                                                 "The list of paint dynamics names",
+                                                                 "The list of paint dynamics names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/fonts-cmds.c b/app/pdb/fonts-cmds.c
index d07d245..546cd9c 100644
--- a/app/pdb/fonts-cmds.c
+++ b/app/pdb/fonts-cmds.c
@@ -137,7 +137,7 @@ register_fonts_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("font-list",
                                                                  "font list",
-                                                                 "The list of font names",
+                                                                 "The list of font names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/gimp-cmds.c b/app/pdb/gimp-cmds.c
index a431520..285fa5c 100644
--- a/app/pdb/gimp-cmds.c
+++ b/app/pdb/gimp-cmds.c
@@ -370,7 +370,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",
+                                                                 "The names of currently attached parasites. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/gradients-cmds.c b/app/pdb/gradients-cmds.c
index a6002e7..2a3ed3e 100644
--- a/app/pdb/gradients-cmds.c
+++ b/app/pdb/gradients-cmds.c
@@ -340,7 +340,7 @@ register_gradients_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("gradient-list",
                                                                  "gradient list",
-                                                                 "The list of gradient names",
+                                                                 "The list of gradient names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/image-cmds.c b/app/pdb/image-cmds.c
index b2d0a08..99354dd 100644
--- a/app/pdb/image-cmds.c
+++ b/app/pdb/image-cmds.c
@@ -5749,7 +5749,7 @@ register_image_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("parasites",
                                                                  "parasites",
-                                                                 "The names of currently attached parasites",
+                                                                 "The names of currently attached parasites. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/item-cmds.c b/app/pdb/item-cmds.c
index 0addf69..686ca6e 100644
--- a/app/pdb/item-cmds.c
+++ b/app/pdb/item-cmds.c
@@ -1736,7 +1736,7 @@ register_item_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("parasites",
                                                                  "parasites",
-                                                                 "The names of currently attached parasites",
+                                                                 "The names of currently attached parasites. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/palettes-cmds.c b/app/pdb/palettes-cmds.c
index b179fdf..986312d 100644
--- a/app/pdb/palettes-cmds.c
+++ b/app/pdb/palettes-cmds.c
@@ -237,7 +237,7 @@ register_palettes_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("palette-list",
                                                                  "palette list",
-                                                                 "The list of palette names",
+                                                                 "The list of palette names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/paths-cmds.c b/app/pdb/paths-cmds.c
index 32e1fd6..428b96f 100644
--- a/app/pdb/paths-cmds.c
+++ b/app/pdb/paths-cmds.c
@@ -720,7 +720,7 @@ register_paths_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("path-list",
                                                                  "path list",
-                                                                 "List of the paths belonging to this image.",
+                                                                 "List of the paths belonging to this image. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/patterns-cmds.c b/app/pdb/patterns-cmds.c
index a1864a9..850f016 100644
--- a/app/pdb/patterns-cmds.c
+++ b/app/pdb/patterns-cmds.c
@@ -238,7 +238,7 @@ register_patterns_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("pattern-list",
                                                                  "pattern list",
-                                                                 "The list of pattern names",
+                                                                 "The list of pattern names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/app/pdb/procedural-db-cmds.c b/app/pdb/procedural-db-cmds.c
index e074c09..beff571 100644
--- a/app/pdb/procedural-db-cmds.c
+++ b/app/pdb/procedural-db-cmds.c
@@ -601,7 +601,7 @@ register_procedural_db_procs (GimpPDB *pdb)
   gimp_procedure_add_return_value (procedure,
                                    gimp_param_spec_string_array ("procedure-names",
                                                                  "procedure names",
-                                                                 "The list of procedure names",
+                                                                 "The list of procedure names. The returned value must be freed with g_strfreev()",
                                                                  GIMP_PARAM_READWRITE));
   gimp_pdb_register_procedure (pdb, procedure);
   g_object_unref (procedure);
diff --git a/libgimp/gimp_pdb.c b/libgimp/gimp_pdb.c
index 15432be..3583945 100644
--- a/libgimp/gimp_pdb.c
+++ b/libgimp/gimp_pdb.c
@@ -196,7 +196,7 @@ gimp_get_parasite (const gchar *name)
  *
  * Returns a list of all currently attached global parasites.
  *
- * Returns: The names of currently attached parasites.
+ * Returns: The names of currently attached parasites. The returned value must be freed with g_strfreev().
  *
  * Since: GIMP 2.8
  **/
diff --git a/libgimp/gimpbrushes_pdb.c b/libgimp/gimpbrushes_pdb.c
index e18b901..cc25ef5 100644
--- a/libgimp/gimpbrushes_pdb.c
+++ b/libgimp/gimpbrushes_pdb.c
@@ -75,7 +75,7 @@ gimp_brushes_refresh (void)
  * Each name returned can be used as input to the
  * gimp_context_set_brush() procedure.
  *
- * Returns: The list of brush names.
+ * Returns: The list of brush names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_brushes_get_list (const gchar *filter,
diff --git a/libgimp/gimpbuffer_pdb.c b/libgimp/gimpbuffer_pdb.c
index b28aac4..d212adc 100644
--- a/libgimp/gimpbuffer_pdb.c
+++ b/libgimp/gimpbuffer_pdb.c
@@ -44,7 +44,7 @@
  * This procedure returns a complete listing of available named
  * buffers.
  *
- * Returns: The list of buffer names.
+ * Returns: The list of buffer names. The returned value must be freed with g_strfreev().
  *
  * Since: GIMP 2.4
  **/
diff --git a/libgimp/gimpcontext_pdb.c b/libgimp/gimpcontext_pdb.c
index c60e9ee..6bce4dc 100644
--- a/libgimp/gimpcontext_pdb.c
+++ b/libgimp/gimpcontext_pdb.c
@@ -133,7 +133,7 @@ gimp_context_set_defaults (void)
 /**
  * gimp_context_list_paint_methods:
  * @num_paint_methods: The number of the available paint methods.
- * @paint_methods: The names of the available paint methods.
+ * @paint_methods: The names of the available paint methods. The returned value must be freed with g_strfreev().
  *
  * Lists the available paint methods.
  *
diff --git a/libgimp/gimpdynamics_pdb.c b/libgimp/gimpdynamics_pdb.c
index 1fa8b8b..cd58044 100644
--- a/libgimp/gimpdynamics_pdb.c
+++ b/libgimp/gimpdynamics_pdb.c
@@ -75,7 +75,7 @@ gimp_dynamics_refresh (void)
  * This procedure returns a list of the paint dynamics that are
  * currently available.
  *
- * Returns: The list of paint dynamics names.
+ * Returns: The list of paint dynamics names. The returned value must be freed with g_strfreev().
  *
  * Since: GIMP 2.8
  **/
diff --git a/libgimp/gimpfonts_pdb.c b/libgimp/gimpfonts_pdb.c
index 1e35910..c46953d 100644
--- a/libgimp/gimpfonts_pdb.c
+++ b/libgimp/gimpfonts_pdb.c
@@ -72,7 +72,7 @@ gimp_fonts_refresh (void)
  * This procedure returns a list of the fonts that are currently
  * available.
  *
- * Returns: The list of font names.
+ * Returns: The list of font names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_fonts_get_list (const gchar *filter,
diff --git a/libgimp/gimpgradients_pdb.c b/libgimp/gimpgradients_pdb.c
index 8078435..f50af68 100644
--- a/libgimp/gimpgradients_pdb.c
+++ b/libgimp/gimpgradients_pdb.c
@@ -75,7 +75,7 @@ gimp_gradients_refresh (void)
  * loaded. You can later use the gimp_context_set_gradient() function
  * to set the active gradient.
  *
- * Returns: The list of gradient names.
+ * Returns: The list of gradient names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_gradients_get_list (const gchar *filter,
diff --git a/libgimp/gimpimage_pdb.c b/libgimp/gimpimage_pdb.c
index 18a0cf8..2105919 100644
--- a/libgimp/gimpimage_pdb.c
+++ b/libgimp/gimpimage_pdb.c
@@ -3086,7 +3086,7 @@ gimp_image_get_parasite (gint32       image_ID,
  *
  * Returns a list of all currently attached parasites.
  *
- * Returns: The names of currently attached parasites.
+ * Returns: The names of currently attached parasites. The returned value must be freed with g_strfreev().
  *
  * Since: GIMP 2.8
  **/
diff --git a/libgimp/gimpitem_pdb.c b/libgimp/gimpitem_pdb.c
index efb19db..5e4bac1 100644
--- a/libgimp/gimpitem_pdb.c
+++ b/libgimp/gimpitem_pdb.c
@@ -982,7 +982,7 @@ gimp_item_get_parasite (gint32       item_ID,
  *
  * Returns a list of all parasites currently attached the an item.
  *
- * Returns: The names of currently attached parasites.
+ * Returns: The names of currently attached parasites. The returned value must be freed with g_strfreev().
  *
  * Since: GIMP 2.8
  **/
diff --git a/libgimp/gimppalettes_pdb.c b/libgimp/gimppalettes_pdb.c
index ce76eab..fe00892 100644
--- a/libgimp/gimppalettes_pdb.c
+++ b/libgimp/gimppalettes_pdb.c
@@ -73,7 +73,7 @@ gimp_palettes_refresh (void)
  * Each name returned can be used as input to the command
  * gimp_context_set_palette().
  *
- * Returns: The list of palette names.
+ * Returns: The list of palette names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_palettes_get_list (const gchar *filter,
diff --git a/libgimp/gimppaths_pdb.c b/libgimp/gimppaths_pdb.c
index 6d70752..157d138 100644
--- a/libgimp/gimppaths_pdb.c
+++ b/libgimp/gimppaths_pdb.c
@@ -43,7 +43,7 @@
  *
  * Deprecated: Use gimp_image_get_vectors() instead.
  *
- * Returns: List of the paths belonging to this image.
+ * Returns: List of the paths belonging to this image. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_path_list (gint32  image_ID,
diff --git a/libgimp/gimppatterns_pdb.c b/libgimp/gimppatterns_pdb.c
index 36514b6..ef64d7a 100644
--- a/libgimp/gimppatterns_pdb.c
+++ b/libgimp/gimppatterns_pdb.c
@@ -75,7 +75,7 @@ gimp_patterns_refresh (void)
  * patterns. Each name returned can be used as input to the
  * gimp_context_set_pattern().
  *
- * Returns: The list of pattern names.
+ * Returns: The list of pattern names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_patterns_get_list (const gchar *filter,
diff --git a/libgimp/gimpproceduraldb_pdb.c b/libgimp/gimpproceduraldb_pdb.c
index a7e1d19..22d37ea 100644
--- a/libgimp/gimpproceduraldb_pdb.c
+++ b/libgimp/gimpproceduraldb_pdb.c
@@ -107,7 +107,7 @@ gimp_procedural_db_dump (const gchar *filename)
  * @date: The regex for procedure date.
  * @proc_type: The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-In', 'GIMP Extension', 'Temporary Procedure' }.
  * @num_matches: The number of matching procedures.
- * @procedure_names: The list of procedure names.
+ * @procedure_names: The list of procedure names. The returned value must be freed with g_strfreev().
  *
  * Queries the procedural database for its contents using regular
  * expression matching.
diff --git a/tools/pdbgen/pdb/brushes.pdb b/tools/pdbgen/pdb/brushes.pdb
index 66c2bb7..c709856 100644
--- a/tools/pdbgen/pdb/brushes.pdb
+++ b/tools/pdbgen/pdb/brushes.pdb
@@ -53,7 +53,7 @@ HELP
 
     @outargs = (
 	{ name => 'brush_list', type => 'stringarray',
-	  desc => 'The list of brush names',
+	  desc => 'The list of brush names. The returned value must be freed with g_strfreev()',
 	  array => { name => 'num_brushes',
 		     desc => 'The number of brushes in the brush list' } }
     );
diff --git a/tools/pdbgen/pdb/buffer.pdb b/tools/pdbgen/pdb/buffer.pdb
index b4091b0..2548f60 100644
--- a/tools/pdbgen/pdb/buffer.pdb
+++ b/tools/pdbgen/pdb/buffer.pdb
@@ -32,7 +32,7 @@ HELP
 
     @outargs = (
 	{ name => 'buffer_list', type => 'stringarray',
-	  desc => 'The list of buffer names',
+	  desc => 'The list of buffer names. The returned value must be freed with g_strfreev()',
 	  array => { name => 'num_buffers',
 		     desc => 'The number of buffers' } }
     );
diff --git a/tools/pdbgen/pdb/context.pdb b/tools/pdbgen/pdb/context.pdb
index 7369a31..5d65a22 100644
--- a/tools/pdbgen/pdb/context.pdb
+++ b/tools/pdbgen/pdb/context.pdb
@@ -170,7 +170,7 @@ HELP
 
     @outargs = (
         { name => 'paint_methods', type => 'stringarray', void_ret => 1,
-          desc => 'The names of the available paint methods',
+          desc => 'The names of the available paint methods. The returned value must be freed with g_strfreev()',
           array => { desc => 'The number of the available paint methods' } }
     );
 
diff --git a/tools/pdbgen/pdb/dynamics.pdb b/tools/pdbgen/pdb/dynamics.pdb
index db79881..742ddb9 100644
--- a/tools/pdbgen/pdb/dynamics.pdb
+++ b/tools/pdbgen/pdb/dynamics.pdb
@@ -53,7 +53,7 @@ HELP
 
     @outargs = (
 	{ name => 'dynamics_list', type => 'stringarray',
-	  desc => 'The list of paint dynamics names',
+	  desc => 'The list of paint dynamics names. The returned value must be freed with g_strfreev()',
 	  array => { name => 'num_dynamics',
 		     desc => 'The number of available paint dynamics' } }
     );
diff --git a/tools/pdbgen/pdb/fonts.pdb b/tools/pdbgen/pdb/fonts.pdb
index e4e7772..12905b9 100644
--- a/tools/pdbgen/pdb/fonts.pdb
+++ b/tools/pdbgen/pdb/fonts.pdb
@@ -51,7 +51,7 @@ HELP
 
     @outargs = (
 	{ name => 'font_list', type => 'stringarray',
-	  desc => 'The list of font names',
+	  desc => 'The list of font names. The returned value must be freed with g_strfreev()',
 	  array => { name => 'num_fonts',
 		     desc => 'The number of available fonts' } }
     );
diff --git a/tools/pdbgen/pdb/gimp.pdb b/tools/pdbgen/pdb/gimp.pdb
index 98d6f8f..eaae2fb 100644
--- a/tools/pdbgen/pdb/gimp.pdb
+++ b/tools/pdbgen/pdb/gimp.pdb
@@ -174,7 +174,7 @@ sub get_parasite_list {
 
     @outargs = (
 	{ name => 'parasites', type => 'stringarray',
-	  desc => 'The names of currently attached parasites',
+	  desc => 'The names of currently attached parasites. The returned value must be freed with g_strfreev()',
 	  array => { desc => 'The number of attached parasites' } }
     );
 
diff --git a/tools/pdbgen/pdb/gradients.pdb b/tools/pdbgen/pdb/gradients.pdb
index 336c412..5799101 100644
--- a/tools/pdbgen/pdb/gradients.pdb
+++ b/tools/pdbgen/pdb/gradients.pdb
@@ -53,7 +53,7 @@ HELP
 
     @outargs = (
 	{ name => 'gradient_list', type => 'stringarray',
-	  desc => 'The list of gradient names',
+	  desc => 'The list of gradient names. The returned value must be freed with g_strfreev()',
 	  array => { name => 'num_gradients',
 		     desc => 'The number of loaded gradients' } }
     );
diff --git a/tools/pdbgen/pdb/image.pdb b/tools/pdbgen/pdb/image.pdb
index d81014d..a04e84d 100644
--- a/tools/pdbgen/pdb/image.pdb
+++ b/tools/pdbgen/pdb/image.pdb
@@ -2878,7 +2878,7 @@ sub image_get_parasite_list {
 
     @outargs = (
         { name => 'parasites', type => 'stringarray',
-          desc => 'The names of currently attached parasites',
+          desc => 'The names of currently attached parasites. The returned value must be freed with g_strfreev()',
           array => { desc => 'The number of attached parasites' } }
     );
 
diff --git a/tools/pdbgen/pdb/item.pdb b/tools/pdbgen/pdb/item.pdb
index de868ac..3c7ffec 100644
--- a/tools/pdbgen/pdb/item.pdb
+++ b/tools/pdbgen/pdb/item.pdb
@@ -830,7 +830,7 @@ sub item_get_parasite_list {
 
     @outargs = (
 	{ name => 'parasites', type => 'stringarray',
-	  desc => 'The names of currently attached parasites',
+	  desc => 'The names of currently attached parasites. The returned value must be freed with g_strfreev()',
 	  array => { desc => 'The number of attached parasites' } }
     );
 
diff --git a/tools/pdbgen/pdb/palettes.pdb b/tools/pdbgen/pdb/palettes.pdb
index 6ba01eb..2bd45cd 100644
--- a/tools/pdbgen/pdb/palettes.pdb
+++ b/tools/pdbgen/pdb/palettes.pdb
@@ -52,7 +52,7 @@ HELP
 
     @outargs = (
         { name => 'palette_list', type => 'stringarray',
-          desc => 'The list of palette names',
+          desc => 'The list of palette names. The returned value must be freed with g_strfreev()',
           array => { name => 'num_palettes',
                      desc => 'The number of palettes in the list' } }
     );
diff --git a/tools/pdbgen/pdb/paths.pdb b/tools/pdbgen/pdb/paths.pdb
index a3a10be..90019e4 100644
--- a/tools/pdbgen/pdb/paths.pdb
+++ b/tools/pdbgen/pdb/paths.pdb
@@ -26,7 +26,7 @@ sub path_list {
 
     @outargs = (
 	{ name => 'path_list', type => 'stringarray',
-	  desc => 'List of the paths belonging to this image.',
+	  desc => 'List of the paths belonging to this image. The returned value must be freed with g_strfreev()',
 	  array => { name => 'num_paths',
 		     desc => 'The number of paths returned.' } }
     );
diff --git a/tools/pdbgen/pdb/patterns.pdb b/tools/pdbgen/pdb/patterns.pdb
index 747f275..f2bfc59 100644
--- a/tools/pdbgen/pdb/patterns.pdb
+++ b/tools/pdbgen/pdb/patterns.pdb
@@ -52,7 +52,7 @@ HELP
 
     @outargs = (
 	{ name => 'pattern_list', type => 'stringarray',
-	  desc => 'The list of pattern names',
+	  desc => 'The list of pattern names. The returned value must be freed with g_strfreev()',
 	  array => { name => 'num_patterns',
 		     desc => 'The number of patterns in the pattern list' } }
     );
diff --git a/tools/pdbgen/pdb/procedural_db.pdb b/tools/pdbgen/pdb/procedural_db.pdb
index 308b1da..ef0f409 100644
--- a/tools/pdbgen/pdb/procedural_db.pdb
+++ b/tools/pdbgen/pdb/procedural_db.pdb
@@ -112,7 +112,7 @@ HELP
 
     @outargs = (
 	{ name  => 'procedure_names', type  => 'stringarray', void_ret => 1,
-	  desc  => 'The list of procedure names',
+	  desc  => 'The list of procedure names. The returned value must be freed with g_strfreev()',
 	  array => { name  => 'num_matches',
 		     desc  => 'The number of matching procedures' } }
     );



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]