Improve docs
[platform/upstream/glib.git] / ChangeLog
1 2008-11-28  Matthias Clasen  <mclasen@redhat.com>
2
3         * glib/gkeyfile.c: Refer to @locale parameters as locale identifier
4         in docs.
5
6 2008-11-28  Matthias Clasen  <mclasen@redhat.com>
7
8         Bug 557603 – carbon check output misplaced
9
10         * configure.in: Call AC_PROG_CPP early to avoid it messing up
11         carbon check output. Fix proposed by Christian Persch
12
13 2008-11-28  Matthias Clasen  <mclasen@redhat.com>
14
15         Bug 559110 – Do not include libintl.h after glibintl.h
16
17         * glib/glibintl.h: Define bind_textdomain_codeset in the DISABLE_NLS
18         branch. Patch by Peter Kjellerstedt.
19
20         * glib/gutil.c: Don't include libintl.h directly.
21
22 2008-11-28  Matthias Clasen  <mclasen@redhat.com>
23
24         Bug 562378 – callback return value not respected for callback option
25         with no arg
26
27         * glib/goption.c (parse_long_option): Return the parse_arg return
28         value even for no-arg callbacks. Patch by Christian Persch
29
30         * glib/tests/option-context.c: Add a test for a callback which
31         returns FALSE.
32
33 2008-11-23  Christian Persch  <chpe@gnome.org>
34
35         Bug 559413 – g_option_group_set_error_hook docs buglet
36
37         * glib/goption.c: Doc fix.
38
39 2008-11-23  Christian Persch  <chpe@gnome.org>
40
41         Bug 560568 – gkeyfile docs buglet
42
43         * glib/gkeyfile.c: Clarify the docs.
44
45 2008-11-23  Christian Persch  <chpe@gnome.org>
46
47         Bug 560569 – gkeyfile doesn't use the set list_separator in some cases
48
49         * glib/gkeyfile.c: (g_key_file_get_locale_string_list),
50         (g_key_file_set_locale_string_list), (g_key_file_set_integer_list),
51         (g_key_file_set_double_list): Use the key file's list separator character,
52         not the default one.
53
54         * glib/tests/keyfile.c: (test_lists), (test_reload_idempotency): Test
55         this.
56
57 2008-11-21  Christophe Fergeau <teuf@gnome.org>
58
59         Bug 561212 – GFileReadMoreCallback API doc refers to non-existant function
60
61         * gio/giotypes.h: fix name of function referred to in
62         GFileReadMoreCallback API documentation
63
64 2008-11-21  Matthias Clasen <mclasen@redhat.com>
65
66         * configure.in: Bump gtk-doc dependency to 1.11 for
67         nicer index-generation.
68
69 2008-11-14  Matthias Clasen <mclasen@redhat.com>
70
71         * NEWS: Updates
72
73 2008-11-04  Christian Dywan  <christian@imendio.com>
74
75         Bug 558672 – NULL key lookup using g_hash_table_lookup_extended()
76
77         * glib/ghash.c:
78         Clarify g_hash_table_lookup_extended
79
80 2008-11-02  Tor Lillqvist  <tml@novell.com>
81
82         * configure.in: Expand also build/win32/vs9/Makefile.
83
84 2008-10-31  Christian Dywan  <christian@imendio.com>
85
86         Bug 558513 – g_warn_if_fail FIXME in gtestutils
87
88         * glib/gtestutils.c (g_test_log_send):
89         Turn g_assert into g_warn_if_fail as advised
90
91 2008-10-31  Grahame Bowland  <grahame@angrygoats.net>
92
93         Bug 558185 – 'parent' variable in g_local_file_get_child_for_display_name() 
94         hits g_object_unref(NULL) assertion
95
96         * gio/glocalfile.c: 
97         - remove unused variable. Patch by Matt Johnston <matt@ucc.asn.au>
98
99 2008-10-29 16:11:14  Tim Janik  <timj@gtk.org>
100
101         * glib/gmacros.h: added G_PASTE() and G_STATIC_ASSERT(), based on
102         patches by Christian Persch and Christian Dywan. Fixes:
103         Bug 558381 - Add support for compile time assertions
104
105 2008-10-27  Joseph Pingenot  <gnomesvn@digitasaru.net>
106
107         * glib/ghash.c: changed "#GHashTableIterator" to "#GHashTableIter"
108         in the documentation-comments above g_hash_table_foreach_remove()
109         and g_hash_table_foreach_steal() to correctly name and link to
110         GHashTableIter.  This affects the GNOME documentation website
111         as well, so further steps are likely necessary beyond this subproject..
112
113 2008-10-23 Matthias Clasen <mclasen@redhat.com>
114
115         Bug 557210 – g_compute_checksum_for_* asserts with less than 2 bytes
116
117         * glib/gchecksum.c (g_compute_checksum_for_data): Accept 
118         lengths < 2. Patch by Tommi Komulainen
119
120         * tests/checksum-test.c: Add a test for this
121
122 2008-10-23 Matthias Clasen <mclasen@redhat.com>
123
124         Bug 556921 – gpoll.h breaks hal compilation
125
126         * glib/gpoll.h: Include gtypes.h. Pointed out by Anis Elleuch
127
128 2008-10-20 Christian Persch <chpe@gnome.org>
129
130         Bug 557087 – mem leak in g_content_types_get_registered
131                 
132         * gio/gcontenttype.c: Plug a mem leak.
133
134 2008-10-19  Michael Natterer  <mitch@imendio.com>
135
136         Bug 556186 – gpoll.h breaks gmain.h inclusion
137
138         * glib/gpoll.h: different fix: disallow direct inclusion
139         unconditionally again but make an exception if included from
140         gmain.h to maintain compatibility.
141
142 2008-10-16  Matthias Clasen <mclasen@redhat.com>
143
144         * configure.in: Bump version to 2.19.1
145
146         * === Released 2.19.0 ===
147
148         * NEWS: Updates
149
150 2008-10-14  Christian Persch <chpe@gnome.org>
151
152         Bug 556186 – gpoll.h breaks gmain.h inclusion
153
154         * glib/gpoll.h: Only disallow direct inclusion when
155         G_DISABLE_SINGLE_INCLUDES is defined.
156
157 2008-10-13  Sven Herzberg  <sven@imendio.com>
158
159         Bug 556101 – static mutex yields warnings with g++
160         Reviewed by Tim Janik
161
162         * configure.in: added an intermediate cast to gpointer
163
164 2008-10-13  Christian Persch <chpe@gnome.org>
165
166         Bug 555311 – format not a string literal and no format arguments
167
168         * glib/gmarkup.c:
169         * glib/gshell.c: Use literal errors where appropriate.
170
171 2008-10-10  Behdad Esfahbod  <behdad@gnome.org>
172
173         Bug 551355 – [PATCH] Make glib build with libtool 2.2
174
175         * autogen.sh: Accept libtool 2.2.   We are moving towards having
176         it working.
177
178 2008-10-10  Behdad Esfahbod  <behdad@gnome.org>
179
180         * configure.in: With libtool 2.x, regenerate libtool early.
181         Based on bug 552107, patch by Patryk Zawadzki
182
183 2008-10-10  Matthias Clasen  <mclasen@redhat.com>
184
185         Bug 554557 – Patch to fix gcc warnings about missing format 
186         specifiers
187
188         * glib/gmarkup.c:
189         * glib/gshell.c:
190         * glib/grel.c: Fix gcc warnings. Patch by Kjartan Maraas
191
192 2008-10-10  Matthias Clasen  <mclasen@redhat.com>
193
194         Bug 552861 – glib-2.0.m4 calls system(3) without storing its result
195
196         * m4macros/glib-2.0.m4: Cosmetic change to make -Werror happy.
197         Patch by Andreas Köhler
198
199 2008-10-08  Christian Persch  <chpe@gnome.org>
200
201         Bug 555313 – GFileAttribute boxed type get_type function should
202         use usual get_type pattern
203
204         * gio/gfileattribute.c (g_file_attribute_info_list_get_type): Use
205         g_once_init_enter/leave.
206
207 2008-10-08  Christian Persch  <chpe@gnome.org>
208
209         Bug 555314 – mem leak in gmarkup
210
211         * glib/gmarkup.c: (g_markup_parse_context_parse): Plug a mem leak.
212
213 2008-10-08  Tor Lillqvist  <tml@novell.com>
214
215         Bug 554790 - g_convert() misbehaves with winiconv versions
216
217         * glib/win_iconv.c (kernel_mbtowc): If converting from ASCII,
218         explicitly check for and reject 8bit chars. MultiByteToWideChar()
219         doesn't, at least not on XP.
220
221 2008-10-06  Matthias Clasen  <mclasen@redhat.com>
222
223         * glib/gtypes.h: Properly include gmacros.h
224
225 2008-10-06  Behdad Esfahbod  <behdad@gnome.org>
226
227         Bug 555309 – giochannel breaks on error
228         Patch from Christian Persch
229
230         * glib/giounix.c (g_io_unix_read), (g_io_unix_write),
231         (g_io_unix_seek), (g_io_unix_close), (g_io_unix_set_flags):
232         Don't shadow err.  Oops!
233
234 2008-10-06  Christophe Fergeau  <teuf@gnome.org>
235
236         Bug 555224 – Improve g_format_size_for_display doc
237         
238         * glib/gfileutils.c: change g_format_size_for_display API doc to
239         explicitly say that the returned string has to be freed. Change
240         spelling of "newly allocated" to "newly-allocated" in g_file_read_link
241         API doc to be more consistent with what is done in that file.
242
243 2008-10-01  David Zeuthen  <davidz@redhat.com>
244
245         * README.in: Add "Notes about glib 2.20" section detailing the
246         ramifications of the patch from bug #528670.
247
248 2008-09-30  Behdad Esfahbod  <behdad@gnome.org>
249
250         Bug 554092 – glib doesn't return G_FILE_ERROR_NOENT et al on OS X
251
252         * glib/giounix.c (g_io_unix_read), (g_io_unix_write),
253         (g_io_unix_seek), (g_io_unix_close), (g_io_unix_set_flags),
254         (g_io_unix_get_flags), (g_io_channel_new_file):
255         Like mclasen says: "well, thats the way errno works...,
256         save it or loose it".  Save errno.
257
258 2008-09-30  Tor Lillqvist  <tml@novell.com>
259
260         * Makefile.decl
261         * glib/tests/Makefile.am: Bypass gtester related stuff on Windows.
262
263 2008-09-30  Tor Lillqvist  <tml@novell.com>
264
265         * glib/gprintf.c
266         * glib/gnulib/vasnprintf.c: Don't define _GNU_SOURCE on Windows,
267         as _GNU_SOURCE has unintended side effects when compiling against
268         newest mingw headers.
269
270 2008-09-26  Dan Winship  <danw@gnome.org>
271
272         Bug 553447 – g_assert_no_error()
273
274         * glib/gtestutils.h (g_assert_no_error, g_assert_error): Macros to
275         assert that a GError is not set, or else is set to a particular
276         error.
277
278         * glib/gtestutils.c (g_assertion_message_error): utility for
279         those macros
280
281         * glib/tests/keyfile.c:
282         * tests/asyncqueue-test.c:
283         * tests/bookmarkfile-test.c:
284         * tests/convert-test.c:
285         * tests/file-test.c: Use g_assert_error/g_assert_no_error
286
287 2008-09-26  Dan Winship  <danw@gnome.org>
288
289         * glib/gthreadpool.c (wakeup_thread_marker): make this a "const
290         gpointer" rather than a gconstpointer to avoid warnings later
291
292         * glib/pcre/pcre_ucp_searchfuncs.c:
293         * glib/pcre/pcre_valid_utf8.c: #include "config.h"
294
295         * glib/tests/printf.c (test_d): fool gcc into not warning about
296         some printf format strings that we know are dubious
297
298 2008-09-26  Matthias Clasen  <mclasen@redhat.com>
299
300         Bug 553857 – gbacktrace.h requires signal.h
301
302         * glib/gbacktrace.h: Include signal.h for raise(). 
303         Pointed out by Sebastien Bacher
304
305 2008-09-26  Matthias Clasen  <mclasen@redhat.com>
306
307         Bug 553724 – python interpretter path not patched in correctly
308
309         * glib/Makefile.am: Fix the sed magic to replace python.
310
311 2008-09-26  Matthias Clasen  <mclasen@redhat.com>
312
313         * glib/gmain.c: Add some more docs.
314
315         * glib/giochannel.c: Move more docs inline, and improve them
316         on the way.
317
318 2008-09-25  Tor Lillqvist  <tml@novell.com>
319
320         Bug 553820 - gpoll.c: undeclared identifier
321
322         * glib/gmain.c
323         * glib/gpoll.c: Make the g_poll() function non-static also on
324         Windows. Prefix an underscore to the g_main_poll_debug variable
325         and make it non-static in gmain.c so that it can be used in
326         gpoll.c. Add back missing variable declaration.
327
328 2008-09-25  Tor Lillqvist  <tml@novell.com>
329
330         * glib/gspawn-win32.c (do_spawn_with_pipes) (do_spawn_directly):
331         Just ignore the child_setup function, never call it. The is no
332         situation in which it could be useful on Windows. Do print a
333         warning, like before.
334
335         * glib/gspawn.c (g_spawn_async_with_pipes): Corresponding change
336         in documentation.
337
338 2008-09-24  Sven Herzberg  <sven@imendio.com>
339
340         Be a little more explcit in the docs. Includes Owen's requested
341         changes.
342
343         * glib/gmain.c: improved documentation for g_source_attach() and
344         g_source_destroy()
345
346 2008-09-23  Michael Natterer  <mitch@imendio.com>
347
348         * glib/glib.h: #include <glib/gpoll.h>
349
350         * glib/gpoll.h: #error out if gpoll.h is included directly.
351
352         * glib/gpoll.c: remove trailing whitespace.
353
354 2008-09-23  Dan Winship  <danw@gnome.org>
355
356         * glib/gpoll.[ch] (g_poll): Move this out of gmain.c and make it part
357         of the public API. (Part of Bug 505361 - gunixinputstream.c assumes
358         poll() available.)
359
360 2008-09-23  Tor Lillqvist  <tml@novell.com>
361
362         * glib/gmain.c (poll_rest) [Win32]: Fix embarrassing bug: I was
363         passing an incorrect third parameter to memmove(), had forgotten
364         to multiply by the size of the table entry. Just use a for loop
365         instead, clearer. Odd I didn't notice when testing this code.
366
367 2008-09-19  Hans Petter Jansson  <hpj@novell.com>
368
369         Rewrite most of GHashTable to use open addressing with quadratic
370         probing instead of chaining. This has the potential to reduce memory
371         fragmentation significantly, while being slightly faster due to
372         better locality and no need to call alloc/free functions for nodes.
373         Benchmarks suggest it also uses less memory overall.
374
375         * glib/ghash.c (prime_mod): Table of suitable primes for
376         initial-probe distribution.
377         (g_hash_table_set_shift): New function.
378         (g_hash_table_find_closest_shift): New function.
379         (g_hash_table_set_shift_from_size): New function.
380         (g_hash_table_lookup_node_for_insertion): New function.
381         (g_hash_table_lookup_node): Rewritten to return node index instead of
382         pointer, use quadratic probe on flat table, and not return insertion
383         data. The latter saves some computation for read-only lookups.
384         (g_hash_table_remove_node): Rewrite to take a pointer directly to the
385         node structure to remove, and clear that. Remove unlinking code.
386         (g_hash_table_remove_all_nodes): Rewrite to not clear nodes
387         individually, but en masse using memset () after potentially calling
388         notify functions.
389         (iter_remove_or_steal): Use new data structure and algorithm. Vastly
390         simplified - now just a call to g_hash_table_remove_node ().
391         (g_hash_table_resize): New resize code, re-indexing with new prime
392         and cleaning up tombstones.
393         (g_hash_table_maybe_resize): Table may hold 8 buckets minimum, no less
394         than 1/4 load excluding tombstones, and no more than 15/16 load
395         including tombstones. These numbers are the results of a lot of
396         benchmarking with multiple complex applications, and should not be
397         changed lightly.
398         (g_hash_table_iter_next)
399         (g_hash_table_lookup)
400         (g_hash_table_lookup_extended)
401         (g_hash_table_insert_internal)
402         (g_hash_table_remove_internal)
403         (g_hash_table_foreach_remove_or_steal)
404         (g_hash_table_foreach)
405         (g_hash_table_find)
406         (g_hash_table_get_keys)
407         (g_hash_table_get_values): Use new data structure and algorithm,
408         fairly trivial changes.
409
410 2008-09-19  Tor Lillqvist  <tml@novell.com>
411
412         * glib-zip.in: Look for man pages in share/man.
413
414         * glib/gutils.c (_glib_get_dll_directory)
415         * glib/gspawn-win32.c (do_spawn_with_pipes): Be a bit less
416         restrictive, look for the helper programs in the same folder where
417         the GLib DLL is, not necessarily in a "bin" subfolder of the top
418         GLib installation folder.
419
420 2008-09-18  Matthias Clasen <mclasen@redhat.com>
421
422         * configure.in: Bump version to 2.19.0
423
424         * ChangeLog.pre-2-18: rotate ChangeLog
425         
426         * === branch for 2.18 ===