include glib-object.h rather than gobject/gobject.h
[platform/upstream/glib.git] / docs / Changes-2.0.txt
1 * The event loop functionality GMain has extensively been revised to 
2   support multiple separate main loops in separate threads. All sources
3   (timeouts, idle functions, etc.) are associated with a GMainContext.
4
5   Compatibility functions exist so that most application code dealing with
6   the main loop will continue to work. However, code that creates
7   new custom types of sources will require modification.
8
9   The main changes here are:
10
11    - Sources are now exposed as GSource *, rather than simply as numeric
12      IDS.
13
14    - New types of sources are created by structure "derivation" from GSource,
15      so the source_data parameter to the GSource vfuncs has been
16      replaced with a GSource *.
17
18    - Sources are first created, then later added to a specific GMainContext
19
20    - Dispatching has been modified so both the callback and data are passed
21      in to the ->dispatch() vfunc.
22
23   To go along with this change, the vtable for GIOChannel has changed and
24   add_watch() has been replaced by create_watch().
25
26 * g_list_foreach() and g_slist_foreach() have been changed so they
27   are now safe against removal of the current item, not the next item.
28
29   It's not recommended to mutate the list in the callback to these
30   functions in any case.
31
32 * GDate now works in UTF-8, not in the current locale. If you
33   want to use it with the encoding of the locale, you need
34   to convert strings using g_locale_to_utf8 first.
35
36 * g_strsplit() has been fixed to:
37
38   - include trailing empty tokens, rather than stripping them
39   - split into a maximum of @max_tokens tokens, rather than 
40     @max_tokens + 1
41
42   Code depending on either of these bugs will need to be fixed.
43
44 * deprecated functions that got removed:
45   g_set_error_handler(), g_set_warning_handler(),
46   g_set_message_handler(), use g_log_set_handler() instead.
47