ucw/doc/relnotes.txt

   1 Release notes
   2 =============
   3
   4 4.1 (work in progress)
   5 ----------------------
   6
   7 * The mainloop module has been rewritten:
   8 ** Multiple instances of the main loop are supported (to be used in different
   9    threads or locally within a library function).
  10 ** The new implementation is more efficient: it uses heaps for timers,
  11    epoll() for file descriptors (when available).
  12 ** The return value of <<mainloop:struct_main_file,`main_file`>> handlers has been
  13    changed to <<mainloop:enum_main_hook_return,`HOOK_IDLE`>> and <<mainloop:enum_main_hook_return,`HOOK_RETRY`>>.
  14    However, the numerical values are equal, so old code should keep working.
  15 ** *Incompatible:* The global variables `main_now`, `main_now_seconds`,
  16    and `main_idle_time` are no longer available. They have become fields
  17    in the `main_context` structure, which can be accessed either directly
  18    or via helper functions like <<mainloop:fun_main_get_now,`main_get_now()`>>.
  19 ** *Incompatible:* The interface for asynchronous reading and writing
  20    (file_read() and friends) has been separated from the core of the main loop.
  21    Use <<mainloop:struct_main_block_io,`struct main_block_io`>> and related functions instead.
  22 ** *Incompatible:* file_close_all() is gone. You have to call <<mainloop:fun_main_teardown,`main_teardown()`>>
  23    or <<mainloop:fun_main_destroy,`main_destroy()`>> to clean up properly after fork().
  24 ** Added support for <<mainloop:signal,synchronous delivery of signals>>.
  25 ** Added relative timers: <<mainloop:fun_timer_add_rel,`timer_add_rel()`>>.
  26 ** Modification of events from a running event handler should be always safe.
  27 ** For any event type, it is possible to ask whether it is active (added to the mainloop) or not: <<mainloop:fun_hook_is_active,`hook_is_active()`>> and friends.
  28 ** A new mainloop front-end for asynchronous <<mainloop:recordio,record-based I/O>> has been added.
  29
  30 * Added a growing array module `gary.h`, similar to `gbuf.h`, but with
  31   a much more convenient interface.
  32
  33 * The <<lists:,Circular linked lists>> can recognize unlinked nodes,
  34   see <<lists:fun_clist_unlink,`clist_unlink()`>>.
  35
  36 * Added `strtonum.h` -- a module for precise parsing of numbers.
  37
  38 * When compiled by a recent enough GCC, `__thread` is used for thread-local variables,
  39   which is more efficient than the POSIX per-thread storage.
  40 ** *Incompatible:* `ucwlib_context->thread_id` is no longer available directly,
  41   please use ucwlib_thread_id() instead.
  42
  43 * `UCW::Configure` supports running of test programs.
  44
  45 * `UCW::CGI` support multiple argument tables and UTF-8 mode.
  46
  47
  48 4.0 (2009-04-13)
  49 ----------------
  50 This was the first stand-alone release of LibUCW. Before that, LibUCW was developed
  51 as a part of the http://www.ucw.cz/holmes/[Sherlock Holmes project].