Documentation improvements
[platform/upstream/glib.git] / ChangeLog
1 2005-11-22  Matthias Clasen  <mclasen@redhat.com>
2
3         * glib/ghash.c (g_hash_table_ref): 
4         (g_hash_table_unref): Mark these as new API.
5
6         Avoid double locking in g_intern_string (#322133,
7         Benedikt Meurer)
8
9         * glib/gdataset.c (g_quark_from_string_internal): New 
10         internal function which factors out common parts of 
11         g_quark_from[_static]_string.
12         (g_quark_from_string, g_quark_from_static_string):
13         Use g_quark_from_string_internal.
14         (g_intern_string, g_intern_static_string): Use
15         g_quark_from_string_internal, and only take the
16         lock once.
17         (g_quark_new): Don't store the strings shifted by -1
18         in the g_quarks array.
19         (g_quark_to_string): Adapt to the previous change.
20
21 Tue Nov 22 14:04:26 2005  Tim Janik  <timj@imendio.com>
22
23         * glib/ghash.h: 
24         * glib/ghash.c: 
25         g_hash_table_new_full(): create hash tables with a ref count of 1.
26         g_hash_table_ref(): atomically ref_count+=1
27         g_hash_table_unref(): atomically ref_count-=1, destroys hash table
28         when refcount reaches 0.
29         g_hash_table_destroy(): just destroy keys and values, unref by 1.
30         g_hash_table_insert(): 
31         g_hash_table_replace(): assert ref_count>0.
32
33         * glib/gatomic.h: 
34         * glib/gatomic.c: added 'volatile' qualifier to all atomic pointer and
35         integer pointers.
36
37 2005-11-20  Behdad Esfahbod  <behdad@gnome.org>
38
39         * glib/guniprop.c (g_unichar_get_mirror_char): Remove unused
40         variables. (#321984, Andrew Paprocki)
41
42 2005-11-18  Matthias Clasen  <mclasen@redhat.com>
43
44         * configure.in: Bump version
45
46 2005-11-17  Matthias Clasen  <mclasen@redhat.com>
47
48         * === Released 2.9.0 ===
49
50         * glib/glib.symbols: Updates
51
52         * glib/gutf8.c (g_utf8_offset_to_pointer): Add some performance
53         hints to the docs. (Paolo Borelli)
54         
55         * NEWS: Updates
56
57         * glib/gthread.c (g_thread_foreach): Mark as new api.
58
59         * README.in: Updates.
60
61         * glib/glib.symbols: 
62         * glib/gdate.h: 
63         * glib/gdate.c (g_date_set_time_t): 
64         (g_date_set_time_val): Add functions to set a date from
65         a time_t and from a GTimeVal.
66         (g_date_set_time): Deprecate.  (#314067, Roger Leigh)
67         
68         * tests/Makefile.am:
69         * tests/utf8-pointer.c: Unit tests for g_utf8_pointer_to_offset
70         and g_utf8_offset_to_pointer.
71
72         * glib/gutf8.c (g_utf8_pointer_to_offset) 
73         (g_utf8_offset_to_pointer): Handle negative offsets, and use
74         "stutter stepping" for going backwards. (#320638, Larry
75         Ewing)
76
77         * glib/gbacktrace.c:
78         * glib/gdate.c:
79         * glib/gthread.c: const correctness fixes, found
80         by Arjan van de Ven and gcc.
81         
82 2005-11-16  Behdad Esfahbod  <behdad@gnome.org>
83
84         * docs/reference/glib/tmpl/unicode.sgml: Correct typo on mentioning
85         @G_UNICODE_BREAK_UNKNOWN that should be #G_UNICODE_BREAK_UNKNOWN.
86
87 2005-11-09  Behdad Esfahbod  <behdad@gnome.org>
88
89         * glib/guniprop.c: Use bit hacks instead when checking a general
90         category value against multiple values.
91
92         * glib/gutf8.c: Change ISO10646 to Unicode in docs.
93
94 2005-11-10  Simos Xenitellis  <simos@gnome.org>
95
96         * configure.in: Added tt (Tatar) to ALL_LINGUAS.
97
98 2005-11-05  Tor Lillqvist  <tml@novell.com>
99
100         * glib/giowin32.c (g_io_win32_set_flags): Don't call g_warning().
101         (#320688) Instead set error and return failure.
102
103 2005-11-07  Matthias Clasen  <mclasen@redhat.com>
104
105         * glib/gmain.c (g_main_dispatch): Don't call cb_funcs->unref
106         while holding the context lock.  (#320886, Andy Wingo)
107
108 2005-11-07  Billy Biggs <vektor@dumbterm.net>
109
110         * tests/refcount/Makefile.am: Add a missing reference to libglib
111         in the LDADD for this test.
112
113 2005-11-07  Matthias Clasen  <mclasen@redhat.com>
114
115         * glib/gmem.c (g_allocator_new): We need to set n_preallocs to a
116         nonzero value, otherwise GTK+ 2.8 breaks when compiled against
117         GLib 2.9.  (#320755, Luca Ferretti)
118
119 2005-11-04  Matthias Clasen  <mclasen@redhat.com>
120
121         * glib/Makefile.am: Apply a patch from Behdad Esfahbod to 
122         use a faster lookup table for g_unichar_get_mirror_char().
123         * glib/gmirroringtable.h: The new table.
124         * glib/gunichartables.h: Remove bidi_mirroring_table.
125         * glib/gen-unicode-tables.pl: Don't generate the mirroring
126         table.
127         * glib/glib-mirroring-tab/*: Sources for the program
128         which generated gmirroringtable.h.
129
130         * glib/glist.c: Avoid some code duplication.
131
132         * glib/gscanner.h: Include gdataset.h.  (#320322)
133
134         * glib/gdebug.h: add new GDebugFlag for fatal_criticals
135         * glib/gmessages.c: (_g_debug_init): handle G_DEBUG=fatal_criticals,
136         to help find critical warnings in applications.  (#320017,
137         Vincent Untz)
138
139 2005-11-02  Tor Lillqvist  <tml@novell.com>
140
141         * glib/glib.symbols: Remove large amount of trailing whitespace
142         from one line. Remove #ifdef G_UNDEFINED from around
143         g_hash_table_new and g_hash_table_new_full symbols, what was the
144         purpose of that? Add the g_slice functions.
145
146 Tue Nov  1 16:24:20 2005  Tim Janik  <timj@imendio.com>
147
148         * glib/gmem.[hc]: prepared deprecation of GMemChunk and GAllocator.
149         added g_slice_*() API to allocate and cache small bits of memory.
150         an actuall allocator implementation for g_slice_*() is still pending.
151
152         * glib/gthread.[hc]: changes from a patch by Matthias Clasen.
153         changed GRealThread list to use in-structure *next; fields instead
154         of GSList, in order for thread iteration to not depenend on g_slice_*()
155         indirectly.
156         _g_thread_mem_private_get():
157         _g_thread_mem_private_set(): added accessors for private memory,
158         needed because the ordinary GPrivate implementation relies on GArray
159         and GSList and therefore indirectly on working g_slice_*() allocations.
160
161         * glib/gthread.[hc]:
162         g_thread_foreach(): new public API function to loop over all existing threads.
163
164         * glib/gdataset.c:
165         * glib/gstring.c:
166         * glib/gcache.c:
167         * glib/garray.c: 
168         * glib/gqueue.c:
169         * glib/gslist.c:
170         * glib/glist.c:
171         * glib/ghash.c:
172         * glib/gtree.c:
173         * glib/ghook.c:
174         * glib/gmain.c:
175         * glib/gnode.c:
176         removed GAllocator and free list usages and accompanying locks.
177         use g_slice_*() API to allocate and cache small bits of memory.
178
179         * glib/ghook.h: removed GMemChunk field from public API.
180
181         * glib/gslist.h:
182         * glib/glist.h: deprecate allocator API, provide _free1() for consistency.
183
184         * glib/gnode.h: deprecate allocator API.
185
186         * glib/gmain.c: reordered GPollRec fields so g_slice_free_chain() can
187         be used for poll rec lists.
188
189         * glib/grel.c: removed mem chunk usage, and allocated tuples via g_slice_*().
190         g_relation_destroy(): free all tuples from the all_tuples hash table,
191         this effectively maintains the life time track keeping of tuples.
192         g_relation_delete_tuple(): free tuples which are removed from the
193         all_tuples hash table. this fixes a temporary leak that was present
194         in the memchunk code until the destruction of the relation.
195
196 2005-10-29  Matthias Clasen  <mclasen@redhat.com>
197
198         * tests/convert-test.c: Add some tests for conversions between
199         UTF-8, UCS-4 and UTF-16.
200
201         * glib/gutf8.c (g_utf8_to_ucs4, g_utf8_to_utf16): Fix handling
202         of len == -1, noticed by Morten Welinder.
203
204 2005-10-27  Erdal Ronahi  <erdal.ronahi@gmail.com>
205
206         * configure.in: Added ku (Kurdish) to ALL_LINGUAS
207
208 2005-10-26  Matthias Clasen  <mclasen@redhat.com>
209
210         * glib/gutf8.c (g_ucs4_to_utf8): Don't set items_read twice
211         in the error case, and add some documentation.  (#319806, Morten
212         Welinder)
213
214 2005-10-19  Manish Singh  <yosh@gimp.org>
215
216         * configure.in: Use AC_CHECK_FUNCS for _NSGetEnviron, to get the
217         config.h symbol automatically. Fixes bug #313731.
218
219 2005-10-19  Tor Lillqvist  <tml@novell.com>
220
221         * glib/gwin32.c (g_win32_get_package_installation_directory):
222         Return a g_strdup()ed copy of the value stored in the hash table,
223         so that it can be g_free()d without leaving a dangling pointer in
224         the hash table. (#319232)
225
226 2005-10-06  Matthias Clasen  <mclasen@redhat.com>
227
228         * glib/gunicollate.c (g_utf8_collate_key_for_filename): Handle
229         all-zero sequences correctly.  (#317930, Sebastien Bacher)
230
231 2005-10-05  Matthias Clasen  <mclasen@redhat.com>
232
233         * glib/gmarkup.c (g_markup_escape_text): Doc addition
234
235         * Makefile.am: Add Collation tests.
236
237         * tests/collate/*: Inputs and expected outputs for collation tests.
238
239         * tests/run-collate-tests.sh: Script to run collation tests.
240
241         * tests/unicode-collate.c (main): Rework slightly to make
242         it usable in unit tests. Also test g_utf8_collate_key_for_filename().
243
244 2005-10-01  Behdad Esfahbod  <behdad@gnome.org>
245
246         * docs/reference/glib/tmpl/unicode.sgml:
247         * glib/gen-unicode-tables.pl:
248         * glib/gunibreak.h:
249         * glib/gunichartables.h:
250         * glib/gunicode.h:
251         * tests/casefold.txt:
252         * tests/casemap.txt: Updated to Unicode 4.1.  There are five new
253         GUnicodeBreakType types.  That may break some applications, like
254         Pango <= 1.10.
255
256 2005-09-26  Matthias Clasen  <mclasen@redhat.com>
257
258         * glib/gstrfuncs.c (g_ascii_strtoull): Add details to the 
259         docs.  (#314393, Matthew F. Barnes)
260
261         * glib/glib.symbols:
262         * glib/gprintf.h: Remove g_snprintf() and g_vsnprintf(), since
263         they are already declared in glib.h. This doesn't break documented
264         use of gprintf.h, but should probably be pointed out in the 
265         release notes for 2.10. (#314232, Behdad Esfahbod)
266
267 Tue Sep 20 13:16:04 2005  Tim Janik  <timj@imendio.com>
268
269         * glib/gpattern.c (g_pattern_ph_match): applied significant recursion
270         complexity optimization, based on a patch from Matthias Clasen.
271
272         * tests/patterntest.c: more tests, mostly from matthias.
273
274 2005-09-20  Matthias Clasen  <mclasen@redhat.com>
275
276         * glib/gqueue.c (g_queue_insert_sorted): Correct the docs.
277         (#316703, Mark Drago)
278
279 Mon Sep 19 17:23:23 2005  Tim Janik  <timj@imendio.com>
280
281         * glib/gpattern.c: applied a patch from matthias which checks on the
282         upper bound of GPatternSpec length to optimize matches.
283         cosmetic fixups.
284
285         * tests/patterntest.c: added more match cases.
286
287 2005-09-16  Tor Lillqvist  <tml@novell.com>
288
289         * glib/gstrfuncs.c (g_ascii_strcasecmp, g_ascii_strncasecmp): Add
290         warning to doc comment that these functions should not be used on
291         encodings like CP932.
292
293 2005-09-14  Matthias Clasen  <mclasen@redhat.com>
294
295         * tests/keyfile-test.c: Add a test for grup names of length 1.
296
297         * glib/gkeyfile.c (g_key_file_line_is_group): Accept group names
298         of length 1.  (#316309)
299         
300 2005-09-12  Matthias Clasen  <mclasen@redhat.com>
301
302         * glib/gmarkup.c (g_markup_escape_text): Clarify docs.
303
304 2005-09-11  Sebastian Wilhelmi  <seppi@seppi.de>
305
306         * tests/refcount/Makefile.am (INCLUDES): Link the the refcount
307         tests to the system thread library $(G_THREAD_LIBS). Fixes #313744
308         and #314217.
309
310 2005-09-11  Kjartan Maraas  <kmaraas@gnome.org>
311
312         * glib/gmain.c: (g_child_watch_prepare), (g_child_watch_check),
313         (child_watch_helper_thread): Remove some dead code. Closes
314         bug #315278.
315
316 2005-09-07  Tor Lillqvist  <tml@novell.com>
317
318         * glib/Makefile.am: Create also a console version of the
319         gspawn-win32-helper program, gspawn-win32-helper-console.exe.
320         It's otherwise identical to gspawn-win32-helper.exe, except marked
321         as a console application (linked without the -mwindows option).
322         
323         * glib/gspawn-win32.c (do_spawn_directly, do_spawn_with_pipes):
324         Drop the dont_wait parameter. Its truth value correlated 100% with
325         the NULLness of the exit_status parameter anyway, so it's enough
326         to check whether exit_status is NULL. Invert the sense of the
327         dont_return_handle parameter and rename it to do_return_handle, to
328         make the code easier to read by avoiding double negations.
329
330         (g_spawn_sync_utf8, g_spawn_async_with_pipes_utf8): Modify calls
331         to do_spawn_with_pipes() accordingly.
332
333         (do_spawn_with_pipes): If we have a console, use the console
334         version of the helper program, otherwise use the GUI one. This
335         avoids extra console windows opening up in some situations. (In
336         case a console application uses the GUI gspawn-win32-helper.exe to
337         spawn another console application we would get a separate console
338         for the spawned console application).
339
340         * glib-zip.in: Distribute also gspawn-win32-helper-console.exe.
341
342 2005-09-05  Matthias Clasen  <mclasen@redhat.com>
343
344         * glib/gmappedfile.c (g_mapped_file_new): Report an error
345         if the file is too large.  (#315275, Kjartan Maraas)
346
347         * glib/gkeyfile.c (g_key_file_load_from_fd): The return value
348         of read() is signed.  (#315273, Kjartan Maraas)
349         
350 2005-08-31  Tor Lillqvist  <tml@novell.com>
351
352         * glib/gutils.h: Wrapping atexit() is a bad idea on Windows, where
353         the EXE and each DLL have their own atexit function chains.
354
355         #define g_atexit as atexit instead. This means it has a
356         better chance of doing what the caller wants. For instance,
357         gtkhtml calls g_atexit() registering a function in gtkhtml
358         itself. This caused a crash when g_atexit() was implemented as a
359         function in the GLib DLL. The gtkhtml DLL was already unloaded by
360         the time the GLib DLL got unloaded.
361
362         * glib/gutils.c: #undef the #define mentioned above, to also get a
363         real g_atexit() into the DLL for backward compatibility. Document
364         the Windows behaviour of g_atexit(), and document the varying ways
365         atexit() can behave in the context of dynamically loaded modules
366         on Unix.
367
368 2005-08-31  Matthias Clasen  <mclasen@redhat.com>
369
370         * glib/glib.symbols: 
371         * glib/gquark.h: 
372         * glib/gdataset.c: Add string interning functions.
373
374 2005-08-28  Matthias Clasen  <mclasen@redhat.com>
375
376         * glib/giochannel.c: Unify some near-duplicate strings. (#314654,
377         Clytie Siddall)
378         
379 2005-08-26  Matthias Clasen  <mclasen@redhat.com>
380
381         * configure.in: Bump version to 2.9.0
382
383 2005-08-25  Tor Lillqvist  <tml@novell.com>
384
385         Make also the g_spawn*() functions take parameters in the GLib
386         file name encoding, i.e. UTF-8, on Windows. Has no impact on Unix
387         API or ABI. Like the other GLib API that was earlier changed to
388         use UTF-8 on Windows, the names of the functions that take UTF-8
389         have _utf8 suffixes added by using preprocessor macros in the
390         header file. The old names are kept for functions with the old
391         behaviour, taking parameters in the system codepage, for DLL ABI
392         stability.
393         
394         * glib/gspawn.h: On Win32 add the suffix _utf8 to the names of the
395         g_spawn*() functions.
396         
397         * glib/gspawn-win32.c: Use wide-char API on NT-based
398         Windows. Convert parameters from UTF-8 to wide chars (NT) or
399         system codepage (Win9x) and call the C library _wspawn*() or
400         spawn*() functions respectvely. Add DLL ABI stability versions
401         that take parameters in the system codepage.
402
403         * glib/gspawn-win32-helper.c: On NT-based Windows use the
404         wide-char versions of argv and envp, and use wide-char API to
405         change directory and spawn the program to run. Remove the verbose
406         debugging output, it was too complex to modify for the wide-char
407         features. (Just add temporary debugging printouts if needed, no
408         need to have them permanently in the source.)
409
410         * glib/gspawn.c: Corresponding documentation updates.
411
412         * glib/glib.symbols: Corresponding changes: Mark the ABI stability
413         symbols as PRIVATE, add the new _utf8-suffixed ones.
414
415 2005-08-24  Stepan Kasal  <kasal@ucw.cz>
416
417         * glib/gtypes.h (G_MININT64): Cast the constant to gint64; it is
418         guint64 otherwise and that can produce warnings about comparison
419         between signed and unsigned.
420
421 2005-08-23  Matthias Clasen  <mclasen@redhat.com>
422
423         * glib/gutils.c: Fix the crt_externs.h include.
424
425 2005-08-23  Stepan Kasal  <kasal@ucw.cz>
426
427         * NEWS: Fix spelling of my first name.
428
429 2005-08-23  Matthias Clasen  <mclasen@redhat.com>
430
431         * Bump version
432
433         * === Released 2.8.1 ===
434
435         * NEWS: Updates
436
437 2005-08-20  Hans Breuer  <hans@breuer.org>
438
439         * glib/makefile.msc.in : link with ws2_32.lib
440
441 2005-08-18  Tor Lillqvist  <tml@novell.com>
442
443         * configure.in: Check for <sys/wait.h>
444
445         * glib/gbacktrace.c: Include <sys/wait.h> on if HAVE_SYS_WAIT_H.
446
447 2005-08-18  Ross Burton  <ross@burtonini.com>
448
449         * glib/gstring.c:
450         Optimise single-character insertions.
451         
452         * glib/gutf8.c:
453         Note copied code.
454         
455         * tests/string-test.c:
456         Add tests for new optimisation, and fix a leak.
457
458 2005-08-17  Matthias Clasen  <mclasen@redhat.com>
459
460         * configure.in: Check for crt_externs.h and _NSGetEnviron.
461
462         * glib/gutils.c: On Darwin, include crt-externs.h and
463         define environ using _NSGetEnviron().  (#313731)
464
465 2005-08-16  Stepan Kasal  <kasal@ucw.cz>
466
467         * glib/gutils.c (g_get_any_init): Move the body of the big if...
468         (g_get_any_init_do): ... to this new function.
469         (g_get_any_init): Declare as inline.
470         (g_get_any_init_locked): New inline function, does the locking.
471         Make use of these two throughout the code.
472
473 2005-08-15  Matthias Clasen  <mclasen@redhat.com>
474
475         * glib/gbacktrace.c (g_on_error_stack_trace): Wait for
476         the child process and then simply return. This makes 
477         The "S" option work as documented in g_on_error_query().
478         (#313125, Matthew F. Barnes)
479
480         * glib/gunicode.h: Update the link to Unicode category
481         values.  (#313369, Behnam Esfahbod)
482
483         * glib/gqueue.c (g_queue_find_custom): Clarify docs
484         a little.  (#311727, Tristan van Berkom)
485
486         * glib/abicheck.sh, gobject/abicheck.sh: Make the 
487         check work on ia64 too, where some symbols ended up 
488         in yet another section.
489