Document gtk_{menu_item,widget}_set_accel_path() as the recommended API.

	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
	gtk_{menu_item,widget}_set_accel_path() as the recommended API.
	(#69244)

ChangeLog

+2002-03-11  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
+	gtk_{menu_item,widget}_set_accel_path() as the recommended API.  
+	(#69244)
+
 2002-03-11  James Henstridge  <james@daa.com.au>
 	* configure.in: set CCAS and CCASFLAGS to get automake 1.6

ChangeLog.pre-2-0

+2002-03-11  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
+	gtk_{menu_item,widget}_set_accel_path() as the recommended API.  
+	(#69244)
+
 2002-03-11  James Henstridge  <james@daa.com.au>
 	* configure.in: set CCAS and CCASFLAGS to get automake 1.6

ChangeLog.pre-2-10

+2002-03-11  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
+	gtk_{menu_item,widget}_set_accel_path() as the recommended API.  
+	(#69244)
+
 2002-03-11  James Henstridge  <james@daa.com.au>
 	* configure.in: set CCAS and CCASFLAGS to get automake 1.6

ChangeLog.pre-2-2

+2002-03-11  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
+	gtk_{menu_item,widget}_set_accel_path() as the recommended API.  
+	(#69244)
+
 2002-03-11  James Henstridge  <james@daa.com.au>
 	* configure.in: set CCAS and CCASFLAGS to get automake 1.6

ChangeLog.pre-2-4

+2002-03-11  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
+	gtk_{menu_item,widget}_set_accel_path() as the recommended API.  
+	(#69244)
+
 2002-03-11  James Henstridge  <james@daa.com.au>
 	* configure.in: set CCAS and CCASFLAGS to get automake 1.6

ChangeLog.pre-2-6

+2002-03-11  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
+	gtk_{menu_item,widget}_set_accel_path() as the recommended API.  
+	(#69244)
+
 2002-03-11  James Henstridge  <james@daa.com.au>
 	* configure.in: set CCAS and CCASFLAGS to get automake 1.6

ChangeLog.pre-2-8

+2002-03-11  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkitemfactory.c (gtk_item_factory_add_foreign): Document
+	gtk_{menu_item,widget}_set_accel_path() as the recommended API.  
+	(#69244)
+
 2002-03-11  James Henstridge  <james@daa.com.au>
 	* configure.in: set CCAS and CCASFLAGS to get automake 1.6

gtk/gtkitemfactory.c

@@ -257,7 +257,10 @@ gtk_item_factory_item_remove_widget (GtkWidget		*widget,
  * This function can be used to make widgets participate in the accel
  * saving/restoring functionality provided by gtk_accel_map_save() and
  * gtk_accel_map_load(), even if they haven't been created by an item
- * factory. 
+ * factory. The recommended API for this purpose are the functions 
+ * gtk_menu_item_set_accel_path() and gtk_widget_set_accel_path(); don't 
+ * use gtk_item_factory_add_foreign() in new code, since it is likely to
+ * be removed in the future.
  */
 void
 gtk_item_factory_add_foreign (GtkWidget      *accel_widget,