From 3df8b243deb8afdf0e8162ec88cdad8a4fa50eb6 Mon Sep 17 00:00:00 2001
From: Sven Neumann <sven@gimp.org>
Date: Wed, 23 Mar 2005 09:58:33 +0000
Subject: [PATCH] added gtk-doc comments explaining what functions to use
 instead of these

2005-03-23  Sven Neumann  <sven@gimp.org>

	* libgimp/gimpmenu.c: added gtk-doc comments explaining what
	functions to use instead of these deprecated ones.
---
 ChangeLog          |  5 +++++
 libgimp/gimpmenu.c | 44 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index ce38681670..b68f51dadc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-03-23  Sven Neumann  <sven@gimp.org>
+
+	* libgimp/gimpmenu.c: added gtk-doc comments explaining what
+	functions to use instead of these deprecated ones.
+
 2005-03-23  Sven Neumann  <sven@gimp.org>
 
 	* app/base/tile-swap.c (tile_swap_init): create the swap directory
diff --git a/libgimp/gimpmenu.c b/libgimp/gimpmenu.c
index 846863ad4a..ba68694319 100644
--- a/libgimp/gimpmenu.c
+++ b/libgimp/gimpmenu.c
@@ -56,6 +56,17 @@ static void        gimp_menu_callback      (GtkWidget          *widget,
 
 /*  public functions  */
 
+/**
+ * gimp_image_menu_new:
+ * @constraint:
+ * @callback:
+ * @data:
+ * @active_image:
+ *
+ * Use gimp_image_combo_box_new() instead.
+ *
+ * Return value:
+ */
 GtkWidget *
 gimp_image_menu_new (GimpConstraintFunc constraint,
 		     GimpMenuCallback   callback,
@@ -110,6 +121,17 @@ gimp_image_menu_new (GimpConstraintFunc constraint,
   return menu;
 }
 
+/**
+ * gimp_layer_menu_new:
+ * @constraint:
+ * @callback:
+ * @data:
+ * @active_layer:
+ *
+ * Use gimp_layer_combo_box_new() instead.
+ *
+ * Return value:
+ */
 GtkWidget *
 gimp_layer_menu_new (GimpConstraintFunc constraint,
 		     GimpMenuCallback   callback,
@@ -176,6 +198,17 @@ gimp_layer_menu_new (GimpConstraintFunc constraint,
   return menu;
 }
 
+/**
+ * gimp_channel_menu_new:
+ * @constraint:
+ * @callback:
+ * @data:
+ * @active_channel:
+ *
+ * Use gimp_channel_combo_box_new() instead.
+ *
+ * Return value:
+ */
 GtkWidget *
 gimp_channel_menu_new (GimpConstraintFunc constraint,
 		       GimpMenuCallback   callback,
@@ -244,6 +277,17 @@ gimp_channel_menu_new (GimpConstraintFunc constraint,
   return menu;
 }
 
+/**
+ * gimp_drawable_menu_new:
+ * @constraint:
+ * @callback:
+ * @data:
+ * @active_drawable:
+ *
+ * Use gimp_drawable_combo_box_new() instead.
+ *
+ * Return value:
+ */
 GtkWidget *
 gimp_drawable_menu_new (GimpConstraintFunc constraint,
 			GimpMenuCallback   callback,