   _        ___  ____ ____  ____                _     _
  |_|_ _   / _ \/ ___/ ___||  _ \   _   _ _   _(_) __| |
  _|_||_| | | | \___ \___ \| |_) | | | | | | | | |/ _` |
 |_||_|_| | |_| |___) |__) |  __/  | |_| | |_| | | (_| |
  |_|_|_|  \___/|____/____/|_|      \__,_|\__,_|_|\__,_|

  OSSP uuid - Universally Unique Identifier

  CHANGELOG

  This is a list of all changes to OSSP uuid.
  For a more brief summary please have a look at the NEWS file.

  Changes between 1.6.1 and 1.6.2 (21-Feb-2008 to 04-Jul-2008)

   o Adjust "devtool.func" for latest GNU Libtool compatibility.
     [Ralf S. Engelschall]

   o Improve PRNG under Win32.
     [Hiroshi Saito]

   o Consistently annotate "RFC-XXXX" with "IETF" to clearly
     indicate from which standards body this comes from.
     [Ralf S. Engelschall]

   o Resolve namespace conflicts of recently introduced time_xxx()
     functions by using a propoer "uuid_" prefix.
     [Ralf S. Engelschall]

   o Remove unused "struct timezone" from time_gettimeofday() in
     order to simplify portability.
     [Ralf S. Engelschall]

   o Add support for POSIX clock_gettime(3) in case the Unix/POSIX
     gettimeofday(3) is not available.
     [Ralf S. Engelschall]

   o Upgrade build environment to GNU autoconf 2.62.
     [Ralf S. Engelschall]

   o Upgrade build environment to GNU libtool 2.2.4.
     [Ralf S. Engelschall]

  Changes between 1.6.0 and 1.6.1 (19-May-2007 to 21-Feb-2008)

   o Port to Win32 API.
     [Hiroshi Saito, Wu Yongwei, Ralf S. Engelschall]

   o Adjust copyright messages for new year 2008.
     [Ralf S. Engelschall]
   
   o Fix __VA_COPY_USE_{CSP,CPP} fallback macros for va_copy.
     [Mark A. Lindner <mark.a.lindner@gmail.com>]

   o PostgreSQL bindings: use SET_VARSIZE() instead
     of assigning to bytea->v_len under PostgreSQL >= 8.3
     [Ralf S. Engelschall]

   o Upgrade build environment to GNU libtool 1.5.26
     [Ralf S. Engelschall]

  Changes between 1.5.1 and 1.6.0 (31-Jul-2006 to 19-May-2007)

   o Expand unused "datarootdir" in Makefile.in and uuid-config.in to
     make newer GNU autoconf versions happy.
     [Ralf S. Engelschall]

   o Upgrade build environment to GNU shtool 2.0.7
     [Ralf S. Engelschall]

   o Make GNU autoconf procedure of PHP binding more robust by using
     -Wl,-Bsymbolic only on platforms where uuid_create(3) actually
     exists and where -Wl,-Bsymbolic is really accepted by the tool
     chain. This especially unbreaks MacOS X.
     [Ralf S. Engelschall]

   o Fix "uuid_export" function in PHP bindings under
     UUID_FMT_SIV, UUID_FMT_STR and UUID_FMT_TXT where the
     NUL-termination character should be not passed back to PHP.
     [Neil Caunt <retardis@gmail.com>, Ralf S. Engelschall]

   o Adjust copyright messages for new year 2007.
     [Ralf S. Engelschall]

   o Upgrade build environment to GNU autoconf 2.61
     [Ralf S. Engelschall]

   o Disable PostgreSQL "(CSTRING AS uuid)" and "(uuid AS CSTRING)"
     CASTS as PostgreSQL 8.2 and higher explicitly disallow this.
     [David Wheeler <david@kineticode.com>, Ralf S. Engelschall]

   o Fix PostgreSQL bindings by mapping the correct DSO symbol
     to the functions "uuid_send" and "uuid_recv".
     [Ralf S. Engelschall]

   o Silence PostgreSQL processing messages
     [David Wheeler <david@kineticode.com>]

   o Support MacOS X (aka Darwin) in PostgreSQL bindings by passing
     a "-bundle_loader" option to the linker in order to resolve the
     "undefined symbols" problem.
     [David Wheeler <david@kineticode.com>, Ralf S. Engelschall]

   o Pass the correct type to PostgreSQL's errmsg().
     [David Wheeler <david@kineticode.com>, Ralf S. Engelschall]

   o Added PostgreSQL 8.2 PG_MODULE_MAGIC support.
     [David Wheeler <david@kineticode.com>]

   o Fix the Data::UUID::to_b64string() function of the Perl backward
     compatibility API: an empty string was not supplied as the EOL
     marker to MIME::Base64::encode_base64() and hence the returned
     string ended with a newline character (which in turn breaks many
     applications using Data::UUID).
     [Piotr Roszatycki <dexter@debian.org>]

   o Change type of "data_ptr" argument in uuid_export() API signature
     from "void **" to "void *" as there is unfortunately no
     "generic pointer to pointer type" in ISO C (see also
     http://c-faq.com/ptrs/genericpp.html) and "void **" is just a
     "pointer to a 'void *'".
     
     The "void **" especially had the nasty side-effect that it breaks
     strict pointer aliasing rules of ISO C and hence would require
     fiddling with temporary variables on all uuid_export() calls if
     one would be 100% correct and avoid aliasing related compiler
     warnings. Instead, as uuid_export() internally has to cast the
     "data_ptr" to the particular expected type anyway, it is better
     to have "data_ptr" just be a really generic "void *" in the API
     signature.
     
     Keep in mind that although this is an API change, it doesn't cause
     any incompatibilities as the function still expects the same
     "pointer to a pointer of a particular type". This expected pointer
     is just now passed the more correct although less intuitive way.
     [Hrvoje Niksic <hniksic@xemacs.org>, Ralf S. Engelschall]

   o Optional DMALLOC based memory debugging support.
     [Ralf S. Engelschall]

   o Consistently include "uuid_ac.h" in all source files to have GNU
     autoconf results and standard system defines available everywhere.
     [Ralf S. Engelschall]

  Changes between 1.5.0 and 1.5.1 (28-Jul-2006 to 31-Jul-2006)

   o Use "MODULE_PATHNAME" instead of "@MODULE_PATHNAME@" in
     uuid.sql.in to be more aligned to the PostgreSQL styles.
     [Simon "janus" Dassow <janus@errornet.de>]

   o Use the available variables $(LIB_NAME), $(DCE_NAME) and
     $(CXX_NAME) more consistently in Makefile.in to allow packagers to
     override the library name with less patching.
     [Piotr Roszatycki <dexter@debian.org>]

   o Fix the "make distclean" target of php/Makefile.local
     to make sure the ".deps" file is not left over.
     [Ralf S. Engelschall]

   o Fix the tarball rolling procedure to make sure we
     do not distribute binary files again. This now especially uses
     a MANIFEST file which explicitly lists all files which form the
     distribution tarball. We compare the tarball and the MANIFEST file
     for differences in the "devtool dist" now.
     [Ralf S. Engelschall]

  Changes between 1.4.2 and 1.5.0 (13-Mar-2006 to 28-Jul-2006)

   o Fixed potential memory leak in uuid_create() as spotted by SPLINT.
     [Ralf S. Engelschall]

   o Cleanup source code according to complains by SPLINT.
     [Ralf S. Engelschall]

   o Cleanup internal uuid_mac.h header.
     [Ralf S. Engelschall]
   
   o Numerous fixed to the error handling in the PostgreSQL bindings.
     [Neil Conway <neilc@samurai.com>]

   o Add Hash indexing support UUID data type of PostgreSQL bindings.
     [Ralf S. Engelschall]

   o Add comparison operators and B-Tree indexing support UUID data
     type of PostgreSQL bindings.
     [Roman Neuhauser <neuhauser@sigpipe.cz>]

   o Fix PHP bindings: the wrong argument to uuid_create()
     was forced to a reference
     [Roman Neuhauser <neuhauser@sigpipe.cz>]

   o Add full support for Single Integer Value (SIV) UUID representation
     for both importing and exporting in C/C++/Perl/PHP APIs.
     [Ralf S. Engelschall]
   
   o Upgrade build environment to GNU shtool 2.0.6 and GNU autoconf 2.60
     [Ralf S. Engelschall]

   o Added an "OVERVIEW" file which tries to give the "big picture"
     about UUIDs and allows to survice during the nasty UUID bit fiddling.
     [Ralf S. Engelschall]

   o Replaced "clock_seq_and_reserved" with
     "clock_seq_high_and_reserved" in uuid.pod to already reflect the
     description in the forthcoming RFC.
     [Ralf S. Engelschall]

   o Speed up processing in uuid_str.c by reducing va_copy() calls from
     two to just one per formatting.
     [Ralf S. Engelschall]

  Changes between 1.4.1 and 1.4.2 (07-Feb-2006 to 13-Mar-2006)

   o Fix uuid_export() function by fixing the internal
     uuid_s[ar]printf() functions which require the backup of va_list
     arguments between subsequent processing.
     [Ralf S. Engelschall, Thomas Lotterer <thomas@lotterer.net>]

   o Fix Perl API's "export" function by not taking over NUL-termination
     character under UUID_FMT_TXT.
     [Thomas Lotterer <thomas@lotterer.net>]
   
   o Declare "install", "uninstall" and "clean" make(1) targets
     ".PHONY". This especially workarounds problems on case insensitive
     filesystems (like MacOS X' filesystem) where the "INSTALL" document
     conflicts with the "install" target.
     [Ralf S. Engelschall, David Wheeler <david@kineticode.com>]

  Changes between 1.4.0 and 1.4.1 (15-Jan-2006 to 07-Feb-2006)

   o Upgrade to GNU shtool 2.0.5
     [Ralf S. Engelschall]

   o Apply workaround to uuid.h to avoi                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      