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

@@ -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",

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

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,

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',