1   _        ___  ____ ____  ____                _     _
2  |_|_ _   / _ \/ ___/ ___||  _ \   _   _ _   _(_) __| |
3  _|_||_| | | | \___ \___ \| |_) | | | | | | | | |/ _` |
4 |_||_|_| | |_| |___) |__) |  __/  | |_| | |_| | | (_| |
5  |_|_|_|  \___/|____/____/|_|      \__,_|\__,_|_|\__,_|
6
7  OSSP uuid - Universally Unique Identifier
8
9  CHANGELOG
10
11  This is a list of all changes to OSSP uuid.
12  For a more brief summary please have a look at the NEWS file.
13
14  Changes between 1.6.1 and 1.6.2 (21-Feb-2008 to 04-Jul-2008)
15
16   o Adjust "devtool.func" for latest GNU Libtool compatibility.
17     [Ralf S. Engelschall]
18
19   o Improve PRNG under Win32.
20     [Hiroshi Saito]
21
22   o Consistently annotate "RFC-XXXX" with "IETF" to clearly
23     indicate from which standards body this comes from.
24     [Ralf S. Engelschall]
25
26   o Resolve namespace conflicts of recently introduced time_xxx()
27     functions by using a propoer "uuid_" prefix.
28     [Ralf S. Engelschall]
29
30   o Remove unused "struct timezone" from time_gettimeofday() in
31     order to simplify portability.
32     [Ralf S. Engelschall]
33
34   o Add support for POSIX clock_gettime(3) in case the Unix/POSIX
35     gettimeofday(3) is not available.
36     [Ralf S. Engelschall]
37
38   o Upgrade build environment to GNU autoconf 2.62.
39     [Ralf S. Engelschall]
40
41   o Upgrade build environment to GNU libtool 2.2.4.
42     [Ralf S. Engelschall]
43
44  Changes between 1.6.0 and 1.6.1 (19-May-2007 to 21-Feb-2008)
45
46   o Port to Win32 API.
47     [Hiroshi Saito, Wu Yongwei, Ralf S. Engelschall]
48
49   o Adjust copyright messages for new year 2008.
50     [Ralf S. Engelschall]
51
52   o Fix __VA_COPY_USE_{CSP,CPP} fallback macros for va_copy.
53     [Mark A. Lindner <mark.a.lindner@gmail.com>]
54
55   o PostgreSQL bindings: use SET_VARSIZE() instead
56     of assigning to bytea->v_len under PostgreSQL >= 8.3
57     [Ralf S. Engelschall]
58
59   o Upgrade build environment to GNU libtool 1.5.26
60     [Ralf S. Engelschall]
61
62  Changes between 1.5.1 and 1.6.0 (31-Jul-2006 to 19-May-2007)
63
64   o Expand unused "datarootdir" in Makefile.in and uuid-config.in to
65     make newer GNU autoconf versions happy.
66     [Ralf S. Engelschall]
67
68   o Upgrade build environment to GNU shtool 2.0.7
69     [Ralf S. Engelschall]
70
71   o Make GNU autoconf procedure of PHP binding more robust by using
72     -Wl,-Bsymbolic only on platforms where uuid_create(3) actually
73     exists and where -Wl,-Bsymbolic is really accepted by the tool
74     chain. This especially unbreaks MacOS X.
75     [Ralf S. Engelschall]
76
77   o Fix "uuid_export" function in PHP bindings under
78     UUID_FMT_SIV, UUID_FMT_STR and UUID_FMT_TXT where the
79     NUL-termination character should be not passed back to PHP.
80     [Neil Caunt <retardis@gmail.com>, Ralf S. Engelschall]
81
82   o Adjust copyright messages for new year 2007.
83     [Ralf S. Engelschall]
84
85   o Upgrade build environment to GNU autoconf 2.61
86     [Ralf S. Engelschall]
87
88   o Disable PostgreSQL "(CSTRING AS uuid)" and "(uuid AS CSTRING)"
89     CASTS as PostgreSQL 8.2 and higher explicitly disallow this.
90     [David Wheeler <david@kineticode.com>, Ralf S. Engelschall]
91
92   o Fix PostgreSQL bindings by mapping the correct DSO symbol
93     to the functions "uuid_send" and "uuid_recv".
94     [Ralf S. Engelschall]
95
96   o Silence PostgreSQL processing messages
97     [David Wheeler <david@kineticode.com>]
98
99   o Support MacOS X (aka Darwin) in PostgreSQL bindings by passing
100     a "-bundle_loader" option to the linker in order to resolve the
101     "undefined symbols" problem.
102     [David Wheeler <david@kineticode.com>, Ralf S. Engelschall]
103
104   o Pass the correct type to PostgreSQL's errmsg().
105     [David Wheeler <david@kineticode.com>, Ralf S. Engelschall]
106
107   o Added PostgreSQL 8.2 PG_MODULE_MAGIC support.
108     [David Wheeler <david@kineticode.com>]
109
110   o Fix the Data::UUID::to_b64string() function of the Perl backward
111     compatibility API: an empty string was not supplied as the EOL
112     marker to MIME::Base64::encode_base64() and hence the returned
113     string ended with a newline character (which in turn breaks many
114     applications using Data::UUID).
115     [Piotr Roszatycki <dexter@debian.org>]
116
117   o Change type of "data_ptr" argument in uuid_export() API signature
118     from "void **" to "void *" as there is unfortunately no
119     "generic pointer to pointer type" in ISO C (see also
120     http://c-faq.com/ptrs/genericpp.html) and "void **" is just a
121     "pointer to a 'void *'".
122
123     The "void **" especially had the nasty side-effect that it breaks
124     strict pointer aliasing rules of ISO C and hence would require
125     fiddling with temporary variables on all uuid_export() calls if
126     one would be 100% correct and avoid aliasing related compiler
127     warnings. Instead, as uuid_export() internally has to cast the
128     "data_ptr" to the particular expected type anyway, it is better
129     to have "data_ptr" just be a really generic "void *" in the API
130     signature.
131
132     Keep in mind that although this is an API change, it doesn't cause
133     any incompatibilities as the function still expects the same
134     "pointer to a pointer of a particular type". This expected pointer
135     is just now passed the more correct although less intuitive way.
136     [Hrvoje Niksic <hniksic@xemacs.org>, Ralf S. Engelschall]
137
138   o Optional DMALLOC based memory debugging support.
139     [Ralf S. Engelschall]
140
141   o Consistently include "uuid_ac.h" in all source files to have GNU
142     autoconf results and standard system defines available everywhere.
143     [Ralf S. Engelschall]
144
145  Changes between 1.5.0 and 1.5.1 (28-Jul-2006 to 31-Jul-2006)
146
147   o Use "MODULE_PATHNAME" instead of "@MODULE_PATHNAME@" in
148     uuid.sql.in to be more aligned to the PostgreSQL styles.
149     [Simon "janus" Dassow <janus@errornet.de>]
150
151   o Use the available variables $(LIB_NAME), $(DCE_NAME) and
152     $(CXX_NAME) more consistently in Makefile.in to allow packagers to
153     override the library name with less patching.
154     [Piotr Roszatycki <dexter@debian.org>]
155
156   o Fix the "make distclean" target of php/Makefile.local
157     to make sure the ".deps" file is not left over.
158     [Ralf S. Engelschall]
159
160   o Fix the tarball rolling procedure to make sure we
161     do not distribute binary files again. This now especially uses
162     a MANIFEST file which explicitly lists all files which form the
163     distribution tarball. We compare the tarball and the MANIFEST file
164     for differences in the "devtool dist" now.
165     [Ralf S. Engelschall]
166
167  Changes between 1.4.2 and 1.5.0 (13-Mar-2006 to 28-Jul-2006)
168
169   o Fixed potential memory leak in uuid_create() as spotted by SPLINT.
170     [Ralf S. Engelschall]
171
172   o Cleanup source code according to complains by SPLINT.
173     [Ralf S. Engelschall]
174
175   o Cleanup internal uuid_mac.h header.
176     [Ralf S. Engelschall]
177
178   o Numerous fixed to the error handling in the PostgreSQL bindings.
179     [Neil Conway <neilc@samurai.com>]
180
181   o Add Hash indexing support UUID data type of PostgreSQL bindings.
182     [Ralf S. Engelschall]
183
184   o Add comparison operators and B-Tree indexing support UUID data
185     type of PostgreSQL bindings.
186     [Roman Neuhauser <neuhauser@sigpipe.cz>]
187
188   o Fix PHP bindings: the wrong argument to uuid_create()
189     was forced to a reference
190     [Roman Neuhauser <neuhauser@sigpipe.cz>]
191
192   o Add full support for Single Integer Value (SIV) UUID representation
193     for both importing and exporting in C/C++/Perl/PHP APIs.
194     [Ralf S. Engelschall]
195
196   o Upgrade build environment to GNU shtool 2.0.6 and GNU autoconf 2.60
197     [Ralf S. Engelschall]
198
199   o Added an "OVERVIEW" file which tries to give the "big picture"
200     about UUIDs and allows to survice during the nasty UUID bit fiddling.
201     [Ralf S. Engelschall]
202
203   o Replaced "clock_seq_and_reserved" with
204     "clock_seq_high_and_reserved" in uuid.pod to already reflect the
205     description in the forthcoming RFC.
206     [Ralf S. Engelschall]
207
208   o Speed up processing in uuid_str.c by reducing va_copy() calls from
209     two to just one per formatting.
210     [Ralf S. Engelschall]
211
212  Changes between 1.4.1 and 1.4.2 (07-Feb-2006 to 13-Mar-2006)
213
214   o Fix uuid_export() function by fixing the internal
215     uuid_s[ar]printf() functions which require the backup of va_list
216     arguments between subsequent processing.
217     [Ralf S. Engelschall, Thomas Lotterer <thomas@lotterer.net>]
218
219   o Fix Perl API's "export" function by not taking over NUL-termination
220     character under UUID_FMT_TXT.
221     [Thomas Lotterer <thomas@lotterer.net>]
222
223   o Declare "install", "uninstall" and "clean" make(1) targets
224     ".PHONY". This especially workarounds problems on case insensitive
225     filesystems (like MacOS X' filesystem) where the "INSTALL" document
226     conflicts with the "install" target.
227     [Ralf S. Engelschall, David Wheeler <david@kineticode.com>]
228
229  Changes between 1.4.0 and 1.4.1 (15-Jan-2006 to 07-Feb-2006)
230
231   o Upgrade to GNU shtool 2.0.5
232     [Ralf S. Engelschall]
233
234   o Apply workaround to uuid.h to avoid conflicts with
235     vendor UUID implementations where uuid_t (Darwin/MacOSX)
236     or uuid_create/uuid_compare (POSIX) might exist.
237     [Ralf S. Engelschall]
238
239  Changes between 1.3.2 and 1.4.0 (06-Dec-2005 to 15-Jan-2006)
240
241   o Created a top-level Perl ExtUtils::MakeMaker wrapper script
242     [Ralf S. Engelschall]
243
244   o Adjust copyright messages for new year 2006.
245     [Ralf S. Engelschall]
246
247   o Added experimental PostgreSQL bindings.
248     [Ralf S. Engelschall]
249
250   o Fixed documentation of uuid_make() function.
251     [Ralf S. Engelschall]
252
253   o Upgrade build environment to GNU libtool 1.5.22
254     [Ralf S. Engelschall]
255
256  Changes between 1.3.1 and 1.3.2 (24-Sep-2005 to 06-Dec-2005)
257
258   o Cleaned up and speed optimized perl/uuid_compat.pm
259     (the Data::UUID compatibility module for Perl)
260     [David Wheeler <david@justatheory.com>]
261
262   o Upgrade to GNU shtool 2.0.3
263     [Ralf S. Engelschall]
264
265   o Consistently use "return" in uuid++.cc
266     [Ralf S. Engelschall]
267
268  Changes between 1.3.0 and 1.3.1 (02-Sep-2005 to 24-Sep-2005)
269
270   o Fix two incorrect casts, detected by compiling the C code
271     under C++ constraints.
272     [Ralf S. Engelschall]
273
274   o Remove a compiler warning in the PHP bindings.
275     [Ralf S. Engelschall]
276
277   o Plug memory leak in PRNG sub-library.
278     [Ralf S. Engelschall]
279
280   o Add VPATH/srcdir support for at the default
281     build procedure plus at least C++ and DCE build options.
282     [Ralf S. Engelschall]
283
284  Changes between 1.2.1 and 1.3.0 (30-Aug-2005 to 02-Sep-2005)
285
286   o Add an experimental PHP 4/5 language API binding which
287     can be enabled under build-time with opption --with-php.
288     [Ralf S. Engelschall]
289
290   o Upgrade to GNU libtool 1.5.20
291     [Ralf S. Engelschall]
292
293   o Add missing "const" in manual page.
294     [Ralf S. Engelschall]
295
296   o Add an experimental C++ API binding which can be
297     enabled under build-time with option --with-cxx.
298     [Ralf S. Engelschall]
299
300   o Cleanup the internals of the uuid_create() function and
301     add a new corresponding uuid_clone() API function.
302     [Ralf S. Engelschall]
303
304   o Cleanup some Makefile parts.
305     [Ralf S. Engelschall]
306
307   o Added a pkg-config(1) specification uuid.pc which is also
308     installed by default in addition to the old-style uuid-config tool.
309     [Ralf S. Engelschall]
310
311   o Added optional Data::UUID backward compatibility Perl API which can
312     be enabled with the build-time option --with-perl-compat.
313     [Piotr Roszatycki <dexter@debian.org>, Ralf S. Engelschall]
314
315   o Add a functionality-reduced TIE-style Perl API OSSP::uuid::tie,
316     intended for very high-level convenience programming.
317     [Ralf S. Engelschall]
318
319   o Reference the new officially published RFC 4122.
320     [Ralf S. Engelschall]
321
322  Changes between 1.2.0 and 1.2.1 (23-Jan-2005 to 30-Aug-2005)
323
324   o Add SEEALSO document which references all known
325     UUID implementations.
326     [Ralf S. Engelschall]
327
328   o Improve the PRNG in case no stronger system PRNG device is
329     available by passing time and rand(3) based entropy into the MD5
330     one-way hash function to achieve at least some sort of weaker PRN data.
331     [Ralf S. Engelschall]
332
333   o Fix MAC address determination under Solaris by using the result of
334     ioctl(...,SIOCGARP,...) only if arp_flags had ATF_COM set.
335     [Ralf S. Engelschall]
336
337   o Upgrade to GNU libtool 1.5.18 and GNU shtool 2.0.2.
338     [Ralf S. Engelschall]
339
340   o Cleanup the source code even more by following a large
341     set of FlexeLint's suggestions.
342     [Ralf S. Engelschall]
343
344   o Fixed generated "section" number in uuid-config(1).
345     [Piotr Roszatycki <dexter@debian.org>]
346
347  Changes between 1.1.2 and 1.2.0 (13-Jan-2005 to 23-Jan-2005)
348
349   o Added support for new version 5 UUIDs (name-based, SHA-1)
350     according to latest draft-mealling-uuid-urn-05.txt.
351     [Ralf S. Engelschall]
352
353   o Reference new ISO/IEC 9834-8:2004 / ITU-T Rec. X.667 2004 standard
354     and latest IETF draft-mealling-uuid-urn-05.txt.
355     [Ralf S. Engelschall]
356
357  Changes between 1.1.1 and 1.1.2 (18-Nov-2004 to 13-Jan-2005)
358
359   o Fix generation of v3 UUIDs by adding support for 64-bit platforms
360     to the underlying uuid_md5.c code (which internally is based on
361     the RFC reference code which in turn assumes a 32-bit environment).
362     [Ralf S. Engelschall, Piotr Roszatycki <Piotr_Roszatycki@netia.net.pl>]
363
364   o Optimize internal md5_store() function by directly finalizing MD5
365     calculation on buffer copy instead of finalizing original buffer
366     and having to restore it from the buffer copy.
367     [Ralf S. Engelschall]
368
369   o Adjust copyright messages for new year 2005.
370     [Ralf S. Engelschall]
371
372   o Do not rebuild the Perl API if there were no actual changes.
373     [Ralf S. Engelschall]
374
375  Changes between 1.1.0 and 1.1.1 (03-Nov-2004 to 18-Nov-2004)
376
377   o Apply the FreeBSD libc uuid_create() related workaround
378     in the Perl bindings also under FreeBSD 6.0-CURRENT.
379     [Ralf S. Engelschall]
380
381   o Fix --with-perl configure option processing: Perl is
382     only required if --with-perl is used although we search for Perl
383     always in order to provide the PERL variable substitution.
384     [Ralf S. Engelschall]
385
386  Changes between 1.0.4 and 1.1.0 (16-Oct-2004 to 03-Nov-2004)
387
388   o Add --with-perl configure option for optionally enabling
389     the Perl language bindings.
390     [Ralf S. Engelschall]
391
392   o Add Perl language bindings providing both a C-style and OO-style API.
393     [Ralf S. Engelschall]
394
395  Changes between 1.0.3 and 1.0.4 (15-Oct-2004 to 16-Oct-2004)
396
397   o Fix version detection from uuid_vers.h
398     [Ralf S. Engelschall]
399
400  Changes between 1.0.2 and 1.0.3 (12-Sep-2004 to 15-Oct-2004)
401
402   o Support configuring/building/installing from an arbitrary
403     directory via srcdir/top_srcdir/VPATH.
404     [David Lee <t.d.lee@durham.ac.uk>, Ralf S. Engelschall]
405
406   o Upgrade build environment to GNU libtool 1.5.10.
407     [Ralf S. Engelschall]
408
409  Changes between 1.0.1 and 1.0.2 (16-Jul-2004 to 12-Sep-2004)
410
411   o Upgrade build environment to GNU libtool 1.5.8 and GNU shtool 2.0.1
412     [Ralf S. Engelschall]
413
414  Changes between 1.0.0 and 1.0.1 (16-Feb-2004 to 16-Jul-2004)
415
416   o Made documentation of uuid_export() more clear.
417     [Ralf S. Engelschall]
418
419   o Upgrade build environment to GNU libtool 1.5.6 and GNU shtool 2.0.0
420     [Ralf S. Engelschall]
421
422   o Remove some warnings occurring under GCC 3.5
423     [Ralf S. Engelschall]
424
425  Changes between 0.9.7 and 1.0.0 (13-Feb-2004 to 16-Feb-2004)
426
427   o Replace remaining (old) UUID_VERSIONX names with UUID_MAKE_VX
428     in the documentation (uuid.pod).
429     [Ralf S. Engelschall]
430
431   o Resolve namespace conflicts with GCC 3.4 internal pow10() and round()
432     functions within uuid_str.c.
433     [Ralf S. Engelschall]
434
435   o Fix buffer handling in "uuid_export(..., UUID_FMT_TXT, vp, ...)" in
436     case "vp" is not NULL.
437     [Fuyuki <fuyuki@nigredo.org>]
438
439  Changes between 0.9.6 and 0.9.7 (11-Feb-2004 to 13-Feb-2004)
440
441   o remove --with-rfc2518 option and functionality because
442     even the IETF/IESG has finally approved our report about the broken
443     random multicast MAC address generation in the standard (and
444     will fix it in new versions of the draft-mealling-uuid-urn). So,
445     finally get rid of this broken-by-design backward compatibility
446     functionality.
447     [Ralf S. Engelschall]
448
449   o Add support to uuid(1) CLI for decoding from stdin for
450     both binary and string representations.
451     [Ralf S. Engelschall]
452
453   o Add missing documentation entries for UUID_XXXX API constants and
454     uuid_version() function.
455     [Fuyuki <fuyuki@nigredo.org>]
456
457   o Adjust references for new draft-mealling-uuid-urn-02.txt.
458     [Fuyuki <fuyuki@nigredo.org>]
459
460   o Replaced overlooked references to old
461     uuid_{unpack,pack,parse,format,dump}() functions with their
462     current uuid_{import,export}() replacements.
463     [Fuyuki <fuyuki@nigredo.org>]
464
465   o Fixed "uuid -h" command.
466     [Fuyuki <fuyuki@nigredo.org>]
467
468  Changes between 0.9.5 and 0.9.6 (06-Feb-2004 to 11-Feb-2004)
469
470   o Added an experimental additional DCE 1.1 API for backward
471     compatibility with existing applications.
472     [Ralf S. Engelschall]
473
474  Changes between 0.9.4 and 0.9.5 (19-Jan-2004 to 06-Feb-2004)
475
476   o Fixed filedescriptor leak in the PRNG sub-API.
477     [Guerry Semones <guerry@tsunamiresearch.com>]
478
479   o Upgraded build environment to GNU libtool 1.5.2.
480     [Ralf S. Engelschall]
481
482  Changes between 0.9.3 and 0.9.4 (16-Jan-2004 to 19-Jan-2004)
483
484   o Include <string.h> in uuid.h because of size_t usage.
485     [Ralf S. Engelschall]
486
487   o INCOMPATIBILITY: Refactor the API and rename uuid_generate()
488     to uuid_make() and use a "uuid_t" pointer for the namespace
489     on UUID_VERSION3 generation. To allow access to the internal
490     pre-defined namespace UUIDs, provide a new uuid_load() function.
491     Because uuid_load() now also allows the loading of the "nil" UUID,
492     remove uuid_nil() from the API. After this second refactoring the
493     API is now the one we originally wished for the forthcoming version
494     1.0 of OSSP uuid.
495     [Ralf S. Engelschall]
496
497   o INCOMPATIBILITY: rename UUID_VERSIONx to UUID_MAKE_Vx and
498     UUID_MCASTRND to UUID_MAKE_MC to be more consistent throughout API.
499     [Ralf S. Engelschall]
500
501   o Add version support to API via UUID_VERSION (compile-time)
502     and uuid_version() (link-time).
503     [Ralf S. Engelschall]
504
505   o INCOMPATIBILITY: Refactor the API by merging
506     uuid_{unpack,pack,parse,format,dump}() functions into unified
507     uuid_{import,export}() functions. This allows us to easily add
508     support for other formats (e.g. XML) in the future without having
509     the change the API in principle.
510     [Ralf S. Engelschall]
511
512   o Document what DCE 1.1 UUID versions exist and what they are
513     intended for.
514     [Ralf S. Engelschall]
515
516   o Cleanup the C code to also pass warning-free a C++ compiler.
517     [Ralf S. Engelschall]
518
519   o Support C++ by enclosing the C API declarations in
520     'extern "C" {...}' within uuid.h.
521     [Guerry Semones <guerry@tsunamiresearch.com>]
522
523   o Improvide decoding in uuid_dump() by at least hex-dumping the
524     binary representation in case of v3, v4 and Nil UUIDs. Also,
525     annotate with better hints.
526     [Ralf S. Engelschall]
527
528   o Recognize special "Nil UUID" on decoding in uuid_dump().
529     [Ralf S. Engelschall]
530
531  Changes between 0.9.2 and 0.9.3 (15-Jan-2004 to 16-Jan-2004)
532
533   o Tested OSSP uuid on 16 particular Unix platforms and list
534     those in the new PORTING file.
535     [Ralf S. Engelschall]
536
537   o Fixed minor formatting bug in call to str_rsprintf().
538     [Ralf S. Engelschall]
539
540   o Fix syntax error in uuid.ac.
541     [Ralf S. Engelschall]
542
543  Changes between 0.9.1 and 0.9.2 (13-Jan-2004 to 15-Jan-2004)
544
545   o Provide both incorrect RFC2518-based and correct IEEE 802
546     multicast address generation. The default now is the correct
547     IEEE 802 multicast address generation but compile-time option
548     --with-rfc2518 selects the broken variant.
549     [Ralf S. Engelschall]
550
551   o Decode also the IEEE 802 MAC address local/global bit.
552     [Ralf S. Engelschall]
553
554   o Added missing documentation for uuid_dump().
555     [Ralf S. Engelschall]
556
557   o Fixed BM_POW2() macro implementation.
558     [Ralf S. Engelschall]
559
560   o Use BM_XXX() and str_xxx() APIs throughout internal implementation.
561     [Ralf S. Engelschall]
562
563   o Added missing manual page uuid-config(1).
564     [Ralf S. Engelschall]
565
566   o Fixed output of "uuid-config --version"
567     [Ralf S. Engelschall]
568
569   o Fixed typos in uuid.pod
570     [Ralf S. Engelschall]
571
572   o Cleanup uuid.ac for unused elements.
573     [Ralf S. Engelschall]
574
575   o Moved uuid_[u]int{8,16,32}_t auto-configuration into
576     own internal header uuid_ac.h.
577     [Ralf S. Engelschall]
578
579   o Fixed portability by replacing accidentally introduced
580     uint{8,16,32}_t with the portable uuid_uint{8,16,32}_t.
581     [Guerry Semones <guerry@tsunamiresearch.com>]
582
583   o Prefix all variable symbols in uuid.h with underscores
584     to avoid namespace conflicts.
585     [Ralf S. Engelschall]
586
587   o Add decoding examples to uuid(1) manual page.
588     [Ralf S. Engelschall]
589
590  Changes between 0.9.0 and 0.9.1 (11-Jan-2004 to 13-Jan-2004)
591
592   o Make "md5_init" and "mac_address" symbols namespace clean
593     by adding correct embedding support via "uuid_" prefix.
594     [Ralf S. Engelschall]
595
596   o Implement uuid_dump() and corresponding uuid CLI "-d"
597     option for dumping a given UUID into clear text. For convenience
598     reasons add uuid_bm.h (bit mask API) and uuid_str (string
599     formatting API) sub-modules.
600     [Ralf S. Engelschall]
601
602   o Add "-m" option to CLI for allowing to generate v1 UUIDs
603     with random multi-cast addresses (API UUID_MCASTRND option).
604     [Ralf S. Engelschall]
605
606   o Disable the C++ and F77 checks in GNU libtool.
607     [Ralf S. Engelschall]
608
609   o Print involved option character (instead of '?') on invalid
610     option for uuid(1) CLI.
611     [Matthias Andree <matthias.andree@gmx.de>]
612
613   o Fixed "make install" and "make uninstall": the uuid(1) CLI
614     has to be [un]installed through GNU libtool, too.
615     [Matthias Andree <matthias.andree@gmx.de>]
616
617   o Document in uuid(1) [uuid_cli.pod] that for version 3
618     UUIDs additional arguments are required and what pre-defined
619     namespace ids are known.
620     [Ralf S. Engelschall, M.Daniel <mdaniel@scdi.com>]
621
622   o cleaned up source tree documentation files.
623     [Ralf S. Engelschall]
624
625