diff --git a/ChangeLog b/ChangeLog
index 8364595912..2a239e469a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2004-06-02  Sven Neumann  <sven@gimp.org>
+
+	* tools/pdbgen/pdb/gradient_edit.pdb
+	* tools/pdbgen/pdb/gradients.pdb: mark new API as new using $since.
+
+	* libgimp/gimpgradientedit_pdb.c
+	* libgimp/gimpgradients_pdb.c: regenerated.
+
 2004-06-02  Michael Natterer  <mitch@gimp.org>
 
 	* tools/pdbgen/pdb/gradient_edit.pdb: forgot two more s/int32/enum/.
diff --git a/libgimp/gimpgradientedit_pdb.c b/libgimp/gimpgradientedit_pdb.c
index a75b8d261a..b78896189f 100644
--- a/libgimp/gimpgradientedit_pdb.c
+++ b/libgimp/gimpgradientedit_pdb.c
@@ -39,6 +39,8 @@
  * segment of the specified gradient.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_get_left_color (const gchar *name,
@@ -85,6 +87,8 @@ gimp_gradient_segment_get_left_color (const gchar *name,
  * segment of the specified gradient.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_set_left_color (const gchar   *name,
@@ -125,6 +129,8 @@ gimp_gradient_segment_set_left_color (const gchar   *name,
  * segment of the specified gradient.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_get_right_color (const gchar *name,
@@ -171,6 +177,8 @@ gimp_gradient_segment_get_right_color (const gchar *name,
  * segment of the specified gradient.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_set_right_color (const gchar   *name,
@@ -210,6 +218,8 @@ gimp_gradient_segment_set_right_color (const gchar   *name,
  * segment of the specified gradient.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_get_left_pos (const gchar *name,
@@ -255,6 +265,8 @@ gimp_gradient_segment_get_left_pos (const gchar *name,
  * position.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_set_left_pos (const gchar *name,
@@ -298,6 +310,8 @@ gimp_gradient_segment_set_left_pos (const gchar *name,
  * segment of the specified gradient.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_get_middle_pos (const gchar *name,
@@ -341,6 +355,8 @@ gimp_gradient_segment_get_middle_pos (const gchar *name,
  * final position.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_set_middle_pos (const gchar *name,
@@ -384,6 +400,8 @@ gimp_gradient_segment_set_middle_pos (const gchar *name,
  * specified segment of the specified gradient.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_get_right_pos (const gchar *name,
@@ -429,6 +447,8 @@ gimp_gradient_segment_get_right_pos (const gchar *name,
  * the final position.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_set_right_pos (const gchar *name,
@@ -471,6 +491,8 @@ gimp_gradient_segment_set_right_pos (const gchar *name,
  * specified gradient name and segment index.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_get_blending_function (const gchar             *name,
@@ -512,6 +534,8 @@ gimp_gradient_segment_get_blending_function (const gchar             *name,
  * the specified blending function.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_set_blending_function (const gchar             *name,
@@ -550,6 +574,8 @@ gimp_gradient_segment_set_blending_function (const gchar             *name,
  * specified gradient name and segment index.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_get_coloring_type (const gchar              *name,
@@ -591,6 +617,8 @@ gimp_gradient_segment_get_coloring_type (const gchar              *name,
  * specified coloring type.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_set_coloring_type (const gchar              *name,
@@ -628,6 +656,8 @@ gimp_gradient_segment_set_coloring_type (const gchar              *name,
  * This function flips a segment range.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_flip (const gchar *name,
@@ -666,6 +696,8 @@ gimp_gradient_segment_range_flip (const gchar *name,
  * of it will appear in equal widths.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_replicate (const gchar *name,
@@ -704,6 +736,8 @@ gimp_gradient_segment_range_replicate (const gchar *name,
  * midpoint.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_split_midpoint (const gchar *name,
@@ -741,6 +775,8 @@ gimp_gradient_segment_range_split_midpoint (const gchar *name,
  * according to the number of times specified by the parameter.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_split_uniform (const gchar *name,
@@ -778,6 +814,8 @@ gimp_gradient_segment_range_split_uniform (const gchar *name,
  * This function deletes a segment range.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_delete (const gchar *name,
@@ -814,6 +852,8 @@ gimp_gradient_segment_range_delete (const gchar *name,
  * range of the specified gradient, so they'll be evenly spaced.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_redistribute_handles (const gchar *name,
@@ -851,6 +891,8 @@ gimp_gradient_segment_range_redistribute_handles (const gchar *name,
  * will be uniform across the range.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_blend_colors (const gchar *name,
@@ -888,6 +930,8 @@ gimp_gradient_segment_range_blend_colors (const gchar *name,
  * will be uniform across the range.
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradient_segment_range_blend_opacity (const gchar *name,
@@ -927,6 +971,8 @@ gimp_gradient_segment_range_blend_opacity (const gchar *name,
  * control points of the neighboring segments.
  *
  * Returns: The final delta by which the range moved.
+ *
+ * Since: GIMP 2.2
  */
 gdouble
 gimp_gradient_segment_range_move (const gchar *name,
diff --git a/libgimp/gimpgradients_pdb.c b/libgimp/gimpgradients_pdb.c
index 83a4f41f9b..9bd62168a4 100644
--- a/libgimp/gimpgradients_pdb.c
+++ b/libgimp/gimpgradients_pdb.c
@@ -310,6 +310,8 @@ gimp_gradients_get_gradient_data (const gchar  *name,
  * This procedure creates a new, uninitialized gradient
  *
  * Returns: The actual new gradient name.
+ *
+ * Since: GIMP 2.2
  */
 gchar *
 gimp_gradients_new (const gchar *name)
@@ -340,6 +342,8 @@ gimp_gradients_new (const gchar *name)
  * This procedure creates an identical gradient by a different name
  *
  * Returns: The name of the gradient's copy.
+ *
+ * Since: GIMP 2.2
  */
 gchar *
 gimp_gradients_duplicate (const gchar *name)
@@ -370,6 +374,8 @@ gimp_gradients_duplicate (const gchar *name)
  * This procedure deletes a gradient
  *
  * Returns: TRUE on success.
+ *
+ * Since: GIMP 2.2
  */
 gboolean
 gimp_gradients_delete (const gchar *name)
@@ -400,6 +406,8 @@ gimp_gradients_delete (const gchar *name)
  * This procedure renames a gradient
  *
  * Returns: The actual new name of the gradient.
+ *
+ * Since: GIMP 2.2
  */
 gchar *
 gimp_gradients_rename (const gchar *name,
diff --git a/tools/pdbgen/pdb/gradient.pdb b/tools/pdbgen/pdb/gradient.pdb
index 258e513879..ec2b3aa298 100644
--- a/tools/pdbgen/pdb/gradient.pdb
+++ b/tools/pdbgen/pdb/gradient.pdb
@@ -17,7 +17,8 @@
 
 sub pdb_misc {
     $author = $copyright = 'Shlomi Fish';
-    $date = '2003';
+    $date   = '2003';
+    $since  = '2.2';
 }
 
 my $_get_gradient_from_name_code = <<'CODE';
diff --git a/tools/pdbgen/pdb/gradient_edit.pdb b/tools/pdbgen/pdb/gradient_edit.pdb
index 258e513879..ec2b3aa298 100644
--- a/tools/pdbgen/pdb/gradient_edit.pdb
+++ b/tools/pdbgen/pdb/gradient_edit.pdb
@@ -17,7 +17,8 @@
 
 sub pdb_misc {
     $author = $copyright = 'Shlomi Fish';
-    $date = '2003';
+    $date   = '2003';
+    $since  = '2.2';
 }
 
 my $_get_gradient_from_name_code = <<'CODE';
diff --git a/tools/pdbgen/pdb/gradients.pdb b/tools/pdbgen/pdb/gradients.pdb
index 3f961bece5..491f4ee572 100644
--- a/tools/pdbgen/pdb/gradients.pdb
+++ b/tools/pdbgen/pdb/gradients.pdb
@@ -344,6 +344,7 @@ sub gradients_new
 {
     $blurb = "Creates a new gradient";
     $help  = "This procedure creates a new, uninitialized gradient";
+    $since = '2.2';
 
     &shlomi_misc;
 
@@ -387,6 +388,7 @@ sub gradients_duplicate
 {
     $blurb = "Duplicates a gradient";
     $help  = "This procedure creates an identical gradient by a different name";
+    $since = '2.2';
 
     &shlomi_misc;
 
@@ -431,6 +433,7 @@ sub gradients_delete
 {
     $blurb = "Deletes a gradient";
     $help  = "This procedure deletes a gradient";
+    $since = '2.2';
 
     &shlomi_misc;
 
@@ -471,6 +474,7 @@ sub gradients_rename
 {
     $blurb = "Rename a gradient";
     $help  = "This procedure renames a gradient";
+    $since = '2.2';
 
     &shlomi_misc;