X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=ucw%2Fdoc%2Frelnotes.txt;h=7d726dd5ab212f1212422c35a752c89c8d198dac;hb=d4123b266f32fe1c84c03cc66ed7cc6c943a355b;hp=f3eb031eb1482c68c963117c8fea08a9622e9c4d;hpb=65a5be71fc985728d13d3ba3c16afb8212b394a5;p=libucw.git

diff --git a/ucw/doc/relnotes.txt b/ucw/doc/relnotes.txt
index f3eb031e..7d726dd5 100644
--- a/ucw/doc/relnotes.txt
+++ b/ucw/doc/relnotes.txt
@@ -1,8 +1,36 @@
 Release notes
 =============
 
-5.0 (work in progress)
-----------------------
+WIP
+---
+
+* The <<conf:,configuration file parser>> has been improved:
+** Multiple instances of the configuration parser are supported.
+** *Incompatible:* As there may be more instances, we can no longer use
+   global variables to control the configuration system. In particular,
+   `cf_need_journal` and `cf_pool` variables have been replaced by
+   functions <<conf:fun_cf_set_journalling,`cf_set_journalling()`>> and
+   <<conf:fun_cf_get_pool,`cf_get_pool()`>>.
+** *Incompatible:* Loading of configuration files has been decoupled from
+   the getopt wrapper, so you might need to include `conf.h` for functions
+   which were previously declared in `getopt.h`.
+** New functions have been added:
+   <<conf:fun_cf_open_group,`cf_open_group()`>>,
+   <<conf:fun_cf_close_group,`cf_close_group()`>>, and
+   <<conf:fun_cf_revert,`cf_revert()`>>.
+* <<daemon:,Daemon helpers>> have been added including a new `daemon-control`
+  utility. The old `daemon-helper` utility has been obsoleted and it is not
+  compiled by default.
+* <<signal:,Signal helpers>> for translation between signal names and numbers
+  have been added.
+
+5.0
+---
+
+* *Incompatible:* The `timestamp_t` type has been decoupled from wall clock time.
+  It now specifies the number of milliseconds from an unspecified origin, so that
+  it can for example refer to the system monotonic clock. The `ucw_time_t` type
+  has been removed.
 
 * The <<mainloop:,mainloop>> module has been rewritten:
 ** Multiple instances of the main loop are supported (to be used in different
@@ -12,10 +40,10 @@ Release notes
 ** The return value of <<mainloop:struct_main_file,`main_file`>> handlers has been
    changed to <<mainloop:enum_main_hook_return,`HOOK_IDLE`>> and <<mainloop:enum_main_hook_return,`HOOK_RETRY`>>.
    However, the numerical values are equal, so old code should keep working.
-** *Incompatible:* The global variables `main_now`, `main_now_seconds`,
-   and `main_idle_time` are no longer available. They have become fields
-   in the `main_context` structure, which can be accessed either directly
-   or via helper functions like <<mainloop:fun_main_get_now,`main_get_now()`>>.
+** *Incompatible:* The main loop time (`main_now`) has been decoupled from wall clock time
+   and moved to a field in the `main_context` structure. It can be accessed either directly
+   or via <<mainloop:fun_main_get_now,`main_get_now()`>>. The `main_now_seconds` variable has
+   been removed, `main_idle_time` has become a structure field.
 ** *Incompatible:* The interface for asynchronous reading and writing
    (file_read() and friends) has been separated from the core of the main loop.
    Use <<mainloop:struct_main_block_io,`struct main_block_io`>> and related functions instead.
@@ -56,12 +84,27 @@ Release notes
 * *Incompatible:* Several modules now have their own header files:
 ** `process.h` -- all functions related to processes, previously declared in `lib.h`
 ** `io.h` -- functions related to files from `lib.h` and `lfs.h`
+** `time.h` -- timestamps and interval timers, previously in `lib.h`
+
+* *Incompatible:* Several configuration options were renamed or removed:
+** `CONFIG_FAKE_ELTPOOL` &rarr; `CONFIG_UCW_FAKE_ELTPOOL`
+** `CONFIG_LARGE_FILES` &rarr; `CONFIG_UCW_LARGE_FILES`
+** `CONFIG_OWN_GETOPT` &rarr; `CONFIG_UCW_OWN_GETOPT`
+** `CONFIG_DIRECT_IO` &rarr; `CONFIG_UCW_DIRECT_IO`
+** `DEFAULT_CONFIG` &rarr; `CONFIG_UCW_DEFAULT_CONFIG`
+** `ENV_VAR_CONFIG` &rarr; `CONFIG_UCW_ENV_VAR_CONFIG`
+** `CONFIG_LFS` was removed
+** `CONFIG_URL_ESCAPE_COMPAT` was removed
 
 * `UCW::Configure` supports running of test programs.
 
 * `UCW::CGI` support multiple argument tables and UTF-8 mode. Also, it uses the
   proper HTTP status codes when reporting errors.
 
+* Implementation details of <<fastbuf:,fastbufs>> have changed. The new code checks
+  invariants more carefully, so it is possible that custom fastbuf back-ends which
+  are buggy now fail, although they previously seemed to work.
+
 
 4.0 (2009-04-13)
 ----------------