What's wrong with menu_item callback parameters?

[Tony Denault <denault hawaii edu>]

Just a little sanity check. I am using the menu item.

I create the widget & call back as such:

  menu_item = gtk_menu_item_new_with_label( string );
  gtk_signal_connect_object(GTK_OBJECT(menu_item), "activate",
     GTK_SIGNAL_FUNC(menuitem_cb), (gpointer) inx );
     
on my signal function look like this:

   void bfp_menuitem_cb( gpointer data, GtkMenuItem * menuitem )

   Note data is the 1st parameter, the widget is the 2nd.

Why is the parameter reversed from the normal callback order, ie:
   void normal_cb( GtkWidget *widget, gpointer data )?

The web GTK+ Reference Documentation Project says it should be:

   The "activate" signal
          void        user_function     (GtkMenuItem *menuitem,
                                        gpointer user_data);

Can anyone comment on this? The documentation doesn't match the
code. Was this a little bug that slip out on the menu item widget?
At this stage, I can't see the developer fixing the toolkit.
Too much application will break. Pleae adjust documentation
to avoid confusion.

I am using 1.2.6.

Thanks,

Tony

/-----------------------------------------------------------------------------\
| Tony Denault                        | Internet: denault@irtf.ifa.hawaii.edu |
| NASA IRTF, Institute of Astronomy   |                 Phone: (808) 974-4206 |
| 1175 Manono St., Bldg 393           |                   Fax: (808) 974-4207 |
| Hilo, Hawaii 96720                  |                                       |
\-----------------------------------------------------------------------------/