NEWS

-*- coding: utf-8-unix -*-


		       News file for CCExceptions
		       ==========================


Notes for revision 0.10.0-devel.6
---------------------------------

* Renamed  "VFUNC"  to  "VNAME"  in   the  variadic  macros  defined  by
  "cclibraries.h".


Notes for revision 0.10.0-devel.4
---------------------------------

* Added "_t" aliases for "cclib_" macros composing a type name.


Notes for revision 0.10.0-devel.3
---------------------------------

* Development of "cclibraries.h".

* More examples.

* More testing.


Notes for revision 0.10.0-devel.2
---------------------------------

* Embedded in the  header file "cclibrareis.h" the  preprocessor API for
  automatic names generation.


Notes for revision 0.10.0-devel.1
---------------------------------

* Added function attribute "__constructor__" to "cclibraries.h".


Notes for revision 0.10.0-devel.0
---------------------------------

* Added the header file "cclibraries.h".

* Added  GNU Autoconf  macros to  check for  C compiler  "__attribute__"
  support.

* Added   requirement   to   use    the   "cclibraries.m4"   macros   in
  "configure.ac".


Notes for revision 0.9.0-devel.3
--------------------------------

* Added CSS file for HTML documentation.


Notes for revision 0.9.0-devel.2
--------------------------------

* Documentation review and documentation macros development.

* Added preprocessor macro "cce_resource_destructor()".

* Split single header files into multiple header files; "ccexceptions.h"
  still exports the whole API.


Notes for revision 0.9.0-devel.1
--------------------------------

* Added preprocessor macro "cce_resource_pointer()".

* Changed the order in which the handlers are called.  When an exception
  is raised: both the clean handlers and the error handlers are invoked;
  the clean handlers are invoked first, in reverse order with respect of
  their registration;  the error handlers  are invoked last,  in reverse
  order with respect of their registration.


Notes for revision 0.9.0-devel.0
--------------------------------

* ABI  BACKWARDS  INCOMPATIBILITY  Changed  internal  representation  of
  "cce_location_t".

* BACKWARDS INCOMPATIBILITY Implemented  distinction between "clean" and
  "error" handlers through tagging pointers.

* Added API to use client data destructor functions in handlers.

* Deprecated functions:

  cce_handler_set
  cce_clean_handler_set
  cce_error_handler_set

* Added macros:

  cce_init_handler
  cce_init_and_register_handler

  and related functions.

* BACKWARDS  INCOMPATIBILITY Removed  all the  deprecated functions  and
  macros.

* BACKWARDS INCOMPATIBILITY General overhaul of handlers API.


Notes for revision 0.8.0-devel.13
---------------------------------

* Added function "cce_condition_is_errno_with_code()".

* Added functions:

    cce_clean_handler_handler()
    cce_error_handler_handler()

* BACKWARDS    INCOMPATIBILITY    Reimplemented   the    internals    of
  "cce_handler_t".


Notes for revision 0.8.0-devel.12
---------------------------------

* Introduced macro "cce_descriptor_pointer".

* BACKWARDS INCOMPATIBILITY  Removed the variables "_ptr"  from the API.
  Some definitions are still there for backwards compatibility, but they
  are deprecated.

* Make  "cce_descriptor_set_root_parent"  deprecated.    We  should  use
  "cce_descriptor_set_parent_to(cce_descriptor_root_t)".

* Made many inline function internal, as part of the process or removing
  "_ptr" variables from the API.

* BACKWARDS INCOMPATIBILITY Removed  pointer-cast macros for exceptional
  condition object types.


Notes for revision 0.8.0-devel.11
---------------------------------

* Packaging infrastructure development.

* Documentation development about linking with the installed library.


Notes for revision 0.8.0-devel.10
---------------------------------

* Packaging infrastructure development.


Notes for revision 0.8.0-devel.9
--------------------------------

* Packaging infrastructure development.

* Development of  exceptional-condition object-types API:  new functions
  to set the parent of a descriptor to a selected descriptor type.


Notes for revision 0.8.0-devel.8
--------------------------------

* Packaging infrastructure development.


Notes for revision 0.8.0-devel.7
--------------------------------

* Added functions:

  cce_handler_set
  cce_clean_handler_set
  cce_error_handler_set


Notes for revision 0.8.0-devel.6
--------------------------------

* Selected gzip as compressor for tarballs.

* Fixed error in pkg-config module file.


Notes for revision 0.8.0-devel.5
--------------------------------

* Updated build infrastructure for better system inspection (especially
  compiler support).

* Fixed names in __deprecated__ messages.

* Fixed errors in test file.


Notes for revision 0.8.0-devel.4
--------------------------------

* Added aliases to functions and macros (the old names are deprecated):

    cce_clean_handler_malloc_init -> cce_init_clean_handler_malloc
    cce_error_handler_malloc_init -> cce_init_error_handler_malloc
    cce_handler_malloc_init	  -> cce_init_handler_malloc

* Cleanup of headers inclusion: less  headers are included in the public
  header  file "ccexceptions.h".   Beware  of code  not working  anymore
  because of this.

* Added alias to function (the old name is deprecated):

    cce_is_condition -> cce_condition_is


Notes for revision 0.8.0-devel.3
--------------------------------

* BACKWARDS  INCOMPATIBILITY More  strict  types  in exception  handlers
  functions.


Notes for revision 0.8.0-devel.2
--------------------------------

* BACKWARDS INCOMPATIBILITY Renamed functions:

    cce_register_clean_handler_to_run_clean_handlers
    cce_register_error_handler_to_run_clean_handlers

  to:

    cce_register_clean_handler_to_run_body_handlers
    cce_register_error_handler_to_run_body_handlers

* Added  "run_body_handlers" aliases  for  all the  "run_clean_handlers"
  macros and functions.  The "body"  variants are preferred; the "clean"
  variants are deprecated.


Notes for revision 0.8.0-devel.1
--------------------------------

* Added handler registering functions:

    cce_register_clean_handler_to_run_clean_handlers
    cce_register_clean_handler_to_run_catch_handlers
    cce_register_error_handler_to_run_clean_handlers
    cce_register_error_handler_to_run_catch_handlers

* Added macro "cce_registe_handler()".

* Added  "run_catch_handlers" aliases  for all  the "run_error_handlers"
  macros and functions.  The "catch" variants are preferred; the "error"
  variants are deprecated.


Notes for revision 0.8.0-devel.0
--------------------------------

* Review of packaging infrastructure.

* Added preprocessor macro "cce_check_argument()".

* Renamed functions:

     cce_ref_condition_errno_errnum -> cce_condition_ref_errno_errnum
     cce_ref_condition_errno_message -> cce_condition_ref_errno_message

* Removed "cleanup"  aliases that were  kept for compatibility  with old
  versions.


Notes for revision 0.7.2-beta.0
-------------------------------

* For  every name  in the  API containing  "cleanup" there  is an  alias
  containing "clean".  The  "clean" names are to be  considered the main
  ones.  This  is because "clean"  and "error"  have the same  number of
  characters and code aligns more beautifully.


Notes for revision 0.7.1-beta.1
-------------------------------

* Changed implementation of retry facilities.

* Added missing types to some _Generic macro definitions.


Notes for revision 0.7.1-beta.0
-------------------------------

* Added another, simpler, implementation of the retry facilities.


Notes for revision 0.7.0-beta.0
-------------------------------

* Removed the retry facilities.


Notes for revision 0.6.4-devel.3
--------------------------------

* Some code tweaking about non-null pointers.

* Added field getters:

    cce_ref_condition_errno_errnum()
    cce_ref_condition_errno_message()

* Added tracing features.

* Added mathematical errors condition objects.


Notes for revision 0.6.4-devel.2
--------------------------------

* Removed duplicate definitions for errno code ENOLINK.

* Added "cce_handler_malloc_init()".


Notes for revision 0.6.4-devel.1
--------------------------------

* Added API for guarded malloc invocation:

    cce_sys_calloc_guarded_cleanup
    cce_sys_calloc_guarded_error
    cce_sys_calloc_guarded
    cce_sys_realloc_guarded_cleanup
    cce_sys_realloc_guarded_error
    cce_sys_realloc_guarded


Notes for revision 0.6.4-devel.0
--------------------------------

* Added API for guarded malloc invocation:

    cce_sys_malloc_guarded_cleanup
    cce_sys_malloc_guarded_error
    cce_sys_malloc_guarded


Notes for revision 0.6.3-devel.0
--------------------------------

* Added new condition object type: unreachable code.


Notes for revision 0.6.2-devel.3
--------------------------------

* Fixed wrong names for malloc handlers.  In the source code it was wrongly:

    cce_sys_error_handler_malloc_init()
    cce_sys_error_handler_malloc_init()

  instead of the correct:

    cce_error_handler_malloc_init()
    cce_error_handler_malloc_init()

* Added some examples under the "examples" directory of the source tree.

* Fixed tests handling asynchronous resources incorrectly.

* Fixed   parent  type   of  "cce_condition_invalid_argument_t"   to  be
  "cce_condition_logic_error_t".

* Fixed    parent     type    of    "cce_condition_errno_t"     to    be
  "cce_condition_runtime_error_t".

* Fixed   parent   type   of   "cce_condition_unimplemented_t"   to   be
  "cce_condition_logic_error_t".


Notes for revision 0.6.2-devel.2
--------------------------------

* Removed some useless condition object finalisation functions.


Notes for revision 0.6.2-devel.1
--------------------------------

* Added function "cce_condition_init_root()".

* More documentation for the "root" condition type.


Notes for revision 0.6.2-devel.0
--------------------------------

* Added initialiser and finaliser functions for some condition objects.


Notes for revision 0.6.0-devel.0
--------------------------------

* Removed all the system adapter functions  that are now in a standalone
  package: CCSys.


### end of file
# Local Variables:
# mode: text
# fill-column: 72
# paragraph-start: "*"
# ispell-local-dictionary: "en_GB"
# End: