After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 61942 - mark a few GtkObject functions as deprecated
mark a few GtkObject functions as deprecated
Status: RESOLVED DUPLICATE of bug 62071
Product: gtk+
Classification: Platform
Component: Widget: Other
1.3.x
Other All
: Normal normal
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on:
Blocks:
 
 
Reported: 2001-10-08 14:10 UTC by Vitaly Tishkov
Modified: 2004-12-22 21:47 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Vitaly Tishkov 2001-10-08 14:10:03 UTC
There are a few functions in GtkObject that should be marked deprecated
standard way i.e. the documentation for these functions should contain a
'Warning' table like, say, the documentation for 
gtk_old_editable_claim_selection ().

Below is the list of such functions:
	- gtk_object_ref();
	- gtk_object_unref();
	- gtk_object_weakref();
	- gtk_object_weakunref();
	- gtk_object_get();
	- gtk_object_set();
	- gtk_object_set_data;
	- gtk_object_set_data_full();
	- gtk_object_remove_data();
	- gtk_object_get_data();
	- gtk_object_remove_no_notify ();
	- gtk_object_set_user_data ();
	- gtk_object_get_user_data ();
	- gtk_object_add_arg_type ();
	- gtk_object_set_data_by_id ();
	- gtk_object_set_data_by_id_full ();
	- gtk_object_get_data_by_id ();
	- gtk_object_remove_data_by_id ();
	- gtk_object_remove_no_notify_by_id ().

THe documentation for these functions contains info that the functions are
deprecated. The only thing to add is that 'Warning' table.
Comment 1 Matthias Clasen 2001-10-08 15:09:05 UTC
The 'warning' table is produced automatically be gtk-doc if the
declarations are included in GTK_DISABLE_DEPRECATED guards. 

If the functions are in fact deprecated, the guards should be
added. If not, the documentation should be fixed to not say they 
are.
Comment 2 Vitaly Tishkov 2001-10-08 15:15:37 UTC
See also #58768. Probably, the same thing.
Comment 3 Matthias Clasen 2001-10-08 18:39:16 UTC
Here is a list of all functions/macros for which I found
"deprecated" in the templates, but which are not marked in the#
headers:

gtk_entry_get_text
GTK_PRIORITY_HIGH
GTK_PRIORITY_DEFAULT
GTK_PRIORITY_LOW
gtk_object_data_try_key
gtk_object_data_force_id
Comment 4 Vitaly Tishkov 2001-10-11 10:43:13 UTC
Also

gtk_entry_set_editable ()
Comment 5 Owen Taylor 2001-10-18 15:43:04 UTC

*** This bug has been marked as a duplicate of 62071 ***