upcoming API changes

[Tim Janik <timj gtk org>]

hi folks,

for the upcoming code freeze of Gtk (around december), in order to get
an 1.2 version out, i'm currently going over the header files to sort out
deprecated functions, and similar cruft.
i'm probably going to commit my stuff tomorrow, and since it involves a
bunch of source incompatible changes, i'm announcing the changes in
advance. basically, i've so far removed all functions that were
non-funcitonal anyways, and made deprecated functions issue a message.
apart from that, i'm going to nuke the GTK_BASIC flag, and integrate
the scrolled window issues like discussed a few weeks ago.

functions/macros that got removed:
gtk_container_disable_resize
gtk_container_enable_resize
gtk_widget_basic
gtk_clist_set_policy
GTK_WIDGET_BASIC
GTK_BASIC

deprecated functions, these will issue a message through the next weeks
and will be removed prior to an 1.2 release:
gtk_clist_set_border
gtk_container_block_resize
gtk_container_unblock_resize
gtk_container_need_resize
gtk_object_class_add_user_signal
gtk_spin_button_construct
gtk_scrolled_window_construct

the scrolled window changes will basically remove the viewport
auto-creation hack from gtkscrolledwindow.c, and to ease migration,
the gtk_scrolled_window_add function will issue a message for the
next few weeks:

Gtk-Message: gtk_scrolled_window_add(): cannot add non scrollable widget
use gtk_scrolled_window_add_with_viewport() instead

gtk_scrolled_window_add_with_viewport() is a new convenience function that
will do exactly what it says, add a new widget to a scrolled window and
slide an additional viewport in. you'll need to use this function if
you add widgets to the scrolled window, that are not GtkText, GtkViewport,
GtkLayout, GtkCList or derived widgets.

for those widgets that currently require arguments to their gtk_*_new(),
but don't yet introduce a _construct() fucntion, we will either add the
latter or implement the default creation through gtk_type_new (GTK_TYPE_*)
in a sane way (for an example, that's why gtk_scrolled_window_construct()
becomes deprecated in favour of a new function
gtk_scrolled_window_set_adjustments).

---
ciaoTJ