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)

diff --git a/ChangeLog b/ChangeLog
index a6cbc15772e01809f9150e7117bc94228525a4b1..a70fdc41c7b1c95666272a6cdaaf76d347aee0ab 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+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

diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0
index a6cbc15772e01809f9150e7117bc94228525a4b1..a70fdc41c7b1c95666272a6cdaaf76d347aee0ab 100644 (file)
--- a/ChangeLog.pre-2-0
+++ b/ChangeLog.pre-2-0
@@ -1,3 +1,9 @@
+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

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index a6cbc15772e01809f9150e7117bc94228525a4b1..a70fdc41c7b1c95666272a6cdaaf76d347aee0ab 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,9 @@
+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

diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2
index a6cbc15772e01809f9150e7117bc94228525a4b1..a70fdc41c7b1c95666272a6cdaaf76d347aee0ab 100644 (file)
--- a/ChangeLog.pre-2-2
+++ b/ChangeLog.pre-2-2
@@ -1,3 +1,9 @@
+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

diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index a6cbc15772e01809f9150e7117bc94228525a4b1..a70fdc41c7b1c95666272a6cdaaf76d347aee0ab 100644 (file)
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,9 @@
+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

diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index a6cbc15772e01809f9150e7117bc94228525a4b1..a70fdc41c7b1c95666272a6cdaaf76d347aee0ab 100644 (file)
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,9 @@
+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

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index a6cbc15772e01809f9150e7117bc94228525a4b1..a70fdc41c7b1c95666272a6cdaaf76d347aee0ab 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,9 @@
+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

diff --git a/gtk/gtkitemfactory.c b/gtk/gtkitemfactory.c
index 8f1854748ea5c8d881a67df15e07a0793ba2bbbb..adb7d4ecab0dcea1d5574e2c8424fd3ccf310dd1 100644 (file)
--- a/gtk/gtkitemfactory.c
+++ b/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,