[gimp] pdb: finally deprecate gimp-color-balance

[Michael Natterer <mitch src gnome org>]

commit db227148f01a772dd1e9dbd69703a229311003d0
Author: Michael Natterer <mitch gimp org>
Date:   Mon Apr 23 18:18:51 2018 +0200

    pdb: finally deprecate gimp-color-balance
    
    Since nobody can tell me how the new gimp-drawable-color-balance can
    be improved, it's going to be identical, just with a namespace.

 app/pdb/color-cmds.c    |    6 ++++--
 libgimp/gimpcolor_pdb.c |    2 ++
 libgimp/gimpcolor_pdb.h |    1 +
 pdb/groups/color.pdb    |    1 +
 4 files changed, 8 insertions(+), 2 deletions(-)
---
diff --git a/app/pdb/color-cmds.c b/app/pdb/color-cmds.c
index 5019c7c..7d7ed9b 100644
--- a/app/pdb/color-cmds.c
+++ b/app/pdb/color-cmds.c
@@ -1162,11 +1162,13 @@ register_color_procs (GimpPDB *pdb)
   gimp_procedure_set_static_strings (procedure,
                                      "gimp-color-balance",
                                      "Modify the color balance of the specified drawable.",
-                                     "Modify the color balance of the specified drawable. There are three 
axis which can be modified: cyan-red, magenta-green, and yellow-blue. Negative values increase the amount of 
the former, positive values increase the amount of the latter. Color balance can be controlled with the 
'transfer_mode' setting, which allows shadows, mid-tones, and highlights in an image to be affected 
differently. The 'preserve-lum' parameter, if TRUE, ensures that the luminosity of each pixel remains fixed.",
+                                     "Modify the color balance of the specified drawable. There are three 
axis which can be modified: cyan-red, magenta-green, and yellow-blue. Negative values increase the amount of 
the former, positive values increase the amount of the latter. Color balance can be controlled with the 
'transfer_mode' setting, which allows shadows, mid-tones, and highlights in an image to be affected 
differently. The 'preserve-lum' parameter, if TRUE, ensures that the luminosity of each pixel remains 
fixed.\n"
+                                     "\n"
+                                     "Deprecated: Use 'gimp-drawable-color-color-balance' instead.",
                                      "Spencer Kimball & Peter Mattis",
                                      "Spencer Kimball & Peter Mattis",
                                      "1997",
-                                     NULL);
+                                     "gimp-drawable-color-color-balance");
   gimp_procedure_add_argument (procedure,
                                gimp_param_spec_drawable_id ("drawable",
                                                             "drawable",
diff --git a/libgimp/gimpcolor_pdb.c b/libgimp/gimpcolor_pdb.c
index 0da6f52..cb518aa 100644
--- a/libgimp/gimpcolor_pdb.c
+++ b/libgimp/gimpcolor_pdb.c
@@ -404,6 +404,8 @@ gimp_curves_explicit (gint32                drawable_ID,
  * differently. The 'preserve-lum' parameter, if TRUE, ensures that the
  * luminosity of each pixel remains fixed.
  *
+ * Deprecated: Use gimp_drawable_color_color_balance() instead.
+ *
  * Returns: TRUE on success.
  **/
 gboolean
diff --git a/libgimp/gimpcolor_pdb.h b/libgimp/gimpcolor_pdb.h
index f939272..ddf0886 100644
--- a/libgimp/gimpcolor_pdb.h
+++ b/libgimp/gimpcolor_pdb.h
@@ -71,6 +71,7 @@ gboolean gimp_curves_explicit     (gint32                drawable_ID,
                                    GimpHistogramChannel  channel,
                                    gint                  num_bytes,
                                    const guint8         *curve);
+GIMP_DEPRECATED_FOR(gimp_drawable_color_color_balance)
 gboolean gimp_color_balance       (gint32                drawable_ID,
                                    GimpTransferMode      transfer_mode,
                                    gboolean              preserve_lum,
diff --git a/pdb/groups/color.pdb b/pdb/groups/color.pdb
index 176e4b2..17bb32c 100644
--- a/pdb/groups/color.pdb
+++ b/pdb/groups/color.pdb
@@ -428,6 +428,7 @@ HELP
 
     &std_pdb_misc;
     $date = '1997';
+    $deprecated = 'gimp-drawable-color-color-balance';
 
     @inargs = (
        { name => 'drawable', type => 'drawable',