NEWS

   1 Libidn NEWS -- History of user-visible changes.                 -*- outline -*-
   2 Copyright (C) 2002, 2003 Simon Josefsson
   3 See the end for copying conditions.
   4
   5 * Version 0.3.0 (released 2003-09-23)
   6
   7 ** Ported to Mac OS X.
   8
   9 ** Gnulib code removed, we now assume a C89 compatible environment.
  10
  11 ** Building libidn as a libc add-on now works again.
  12
  13 ** Man pages for all public API functions are included.
  14
  15 ** Fixed bug in SASLprep profile.
  16
  17 ** API and ABI is NOT backwards compatible with the previous version.
  18 All previously labeled (since 0.1.x) obsolete functions have been dropped.
  19 The use of 'enum' types instead of 'int' added in 0.2.3 reverted, it
  20 confused documentation generators and wasn't all that common practice.
  21
  22 * Version 0.2.3 (released 2003-08-26)
  23
  24 ** Example 4 was the same as example 3, now changed to demo ToUnicode.
  25
  26 ** Documentation improvements.
  27
  28 ** Prototype cleanups.
  29 The proper enum types (Stringprep_rc, Idna_rc, etc) are now used in
  30 several places where plain int where used before.  String lengths are
  31 handled by (s)size_t instead of int.
  32
  33 ** API and ABI is backwards compatible with the previous version.
  34
  35 * Version 0.2.2 (released 2003-08-13)
  36
  37 ** Fixed problem with strings longer than 4GB in punycode functions.
  38 The punycode code cannot handle strings longer than 4GB.  The code now
  39 return PUNYCODE_BAD_INPUT on too long input, instead of failing in an
  40 unknown way.
  41
  42 ** The "idn --idna-to-unicode" command now output locale encoded strings.
  43
  44 ** Build fixes, bug fixes.
  45
  46 ** API and ABI is backwards compatible with the previous version.
  47
  48 * Version 0.2.1 (released 2003-07-04)
  49
  50 ** Don't reject zero-length trailing labels as in, e.g., "www.example.org.".
  51 The IDNA RFC is not clear on this topic, zero-length labels in general
  52 are forbidden by the ToASCII algorithm in section 4.1 step 8, but the
  53 terminology section define, inside a parenthesis, that the zero-length
  54 root label is in fact not considered a label at all in IDNA.
  55
  56 ** Bug fixes.
  57
  58 ** API and ABI is backwards compatible with the previous version.
  59
  60 * Version 0.2.0 (released 2003-06-19)
  61
  62 ** Unicode code point data is now uint32_t, defined in "idn-int.h".
  63 A header file "idn-int.h" is generated and installed to make sure the
  64 "uint32_t" data type is available on all platforms.  The reason for
  65 this change is that on 64-bit platforms, the application was required
  66 to convert 32 bit integers (which is how Unicode code points are
  67 typically represented) into 64 bit integers before calling libidn
  68 functions.
  69
  70 ** New idna_*() functions have improved flags handling.
  71 The allowunassigned and usestd3asciirules parameters were collapsed
  72 into a flags parameter, that can take on the IDNA_ALLOW_UNASSIGNED and
  73 IDNA_USE_STD3_ASCII_RULES values.  This allows for easier extensions
  74 to support, e.g., Unicode 4.0 or RFC 952 ASCII rules checking.  Note
  75 that the old entry points are unmodified (in this regard), and new
  76 entry points with this modification were added.
  77
  78 ** The manual was moved into a separate directory doc/.
  79
  80 ** Bugfixes.
  81
  82 ** API and ABI is not backwards compatible.
  83 In punycode.h and stringprep.h the "unsigned long" data type was
  84 changed into "uint32_t", which cause a API and ABI missmatch.  For
  85 idna.h, the old entry points that used "unsigned long" still exist,
  86 and new entry points that uses "uint32_t" was added.  To update your
  87 application, you probably only need to change "unsigned long" to
  88 "uint32_t".  As a result of these changes, the shared object version
  89 has been increased.
  90
  91 * Version 0.1.15 (released 2003-06-07)
  92
  93 ** Bugfixes.
  94
  95 ** API and ABI is backwards compatible with the previous version.
  96
  97 * Version 0.1.14 (released 2003-05-10)
  98
  99 ** Experimental documentation generation in contrib/doxygen/.
 100 Simply invoke "doxygen" in that directory and it should build the
 101 documentation.
 102
 103 ** Lisp API bug fixes.
 104
 105 ** API and ABI is backwards compatible with the previous version.
 106
 107 * Version 0.1.13 (released 2003-03-13)
 108
 109 ** Unfinished Java *.class files implementing the libidn API.
 110 See the contrib/java/ directory.  It is implemented using the Java
 111 Native Interface, and light initial testing indicate interoperability
 112 between GCJ, IBM's JDK and Sun's JDK.
 113
 114 ** Building is now silent when gengetopt is not present.
 115
 116 ** Bug fixes.
 117
 118 ** API and ABI is backwards compatible with the previous version.
 119
 120 * Version 0.1.12 (released 2003-03-06)
 121
 122 ** Building libidn doesn't require gengetopt.
 123 Warnings are still printed though.  Gengetopt will be replaced by argp
 124 eventually.
 125
 126 ** Command line tool "idn" supports stringprep too.
 127
 128 ** New stringprep API entry point: stringprep_profile().
 129 It takes a name of the stringprep profile as an argument instead of
 130 the stringprep table structure.
 131
 132 ** stringprep_*.h are deprecated and will be removed in the future.
 133 All symbols have been moved to stringprep.h.  The reasons are that (1)
 134 the files typically only defined one CPP macro and exported one symbol
 135 definition, which is wasteful as it generates too much work in the
 136 manual, and (2) using one header file for all profiles allows easier
 137 access to all stringprep profiles during runtime.  Note that the files
 138 are still installed, but they only #include stringprep.h now, for
 139 backwards compatibility.
 140
 141 ** GNU Libc add-on build instructions updated to GNU Libc 2.3.2.
 142
 143 ** SASLprep stringprep profile added.
 144
 145 ** An online interface to libidn written in PHP added to contrib/web/.
 146
 147 ** API and ABI is backwards compatible with the previous version.
 148
 149 * Version 0.1.11 (released 2003-02-26)
 150
 151 ** Command line application "idn" is included.
 152 A simple wrapper around the library that allows you to invoke punycode
 153 encoding/decoding and IDNA ToASCII/ToUnicode on the command line.
 154
 155 ** Emacs Lisp interface for punycode and IDNA included.
 156 See punycode.el and idna.el.
 157
 158 ** API and ABI is backwards compatible with the previous version.
 159
 160 * Version 0.1.10 (released 2003-02-21)
 161
 162 ** idna_*_to_ace() and idna_*ace_to_*() are deprecated in favor of
 163 ** idna_to_ascii_from_*() and idna_to_unicode_*_from_*() respectively.
 164 The reason was that the old interfaces did not accept the
 165 AllowUnassigned and UseSTD3ASCIIRules flags.  Note that the old
 166 functions are not removed, but will be in the future.
 167
 168 ** IPS iSCSI stringprep profile added.
 169
 170 ** A new contrib/ directory added.
 171 Currently it contains a Python interface to Libidn, contributed by
 172 Stephane Bortzmeyer.
 173
 174 ** idna.h and punycode.h are now installed by "make install".
 175
 176 ** API and ABI is backwards compatible with the previous version.
 177
 178 * Version 0.1.9 (released 2003-02-20)
 179
 180 ** SASL ANONYMOUS "plain" stringprep profile added.
 181
 182 ** XMPP nodeprep profile fixed.
 183
 184 ** API and ABI is backwards compatible with the previous version.
 185 For future releases, the NEWS entry will specifically mention whether
 186 the C header API or library ABI backwards compatibility is affected.
 187
 188 * Version 0.1.8 (released 2003-02-14)
 189
 190 ** Portability fixes.
 191 This includes not building the API Reference Manual with GTK-DOC by
 192 default, if you want it use configure parameter --enable-gtk-doc after
 193 making sure your gtkdoc-mkdb accept the --tmpl-dir parameter.
 194
 195 ** The type for string length variables is now (s)size_t.
 196 Unfortunately this means binary shared library binary backwards
 197 compatible is lost.
 198
 199 ** New nameprep test vectors.
 200
 201 * Version 0.1.7 (released 2003-02-12)
 202
 203 ** Uses official IDNA ACE prefix.
 204
 205 * Version 0.1.6 (released 2003-02-11)
 206
 207 ** Uses tentative IDNA ACE prefix.
 208
 209 ** Added XMPP Node/Resource Identifiers stringprep profiles.
 210
 211 ** Fixed prohibited character checks for bidi.
 212
 213 * Version 0.1.5 (released 2003-01-28)
 214
 215 ** The library can now be built as part of GNU Libc.
 216 This is experimental and only tested against GNU Libc version 2.3.1.
 217 See the libc/ directory, and libc/README in particular.
 218
 219 ** Bug fixes.
 220
 221 * Version 0.1.4 (released 2003-01-15)
 222
 223 ** Documentation fixes.
 224
 225 ** Portability fixes.
 226
 227 ** Bug fixes.
 228
 229 * Version 0.1.3 (released 2003-01-15)
 230
 231 ** Added texinfo manual.
 232
 233 * Version 0.1.2 (released 2003-01-08)
 234
 235 ** Added high-level IDNA API.
 236
 237 ** Added example3.c and example4.c demonstrating the high-level IDNA API.
 238
 239 * Version 0.1.1 (released 2003-01-08)
 240
 241 ** Added documentation using GTK-DOC.
 242
 243 ** The obsolete stringprep_utf8_to_ucs4_fast API entry point was removed.
 244 By accident it was never removed in 0.1.0.
 245
 246 * Version 0.1.0 (released 2003-01-05)
 247
 248 ** Official GNU project.
 249
 250 ** Renamed from libstringprep to libidn.
 251
 252 ** Supports punycode and IDNA.  Caveat emptor: I don't use it myself.
 253
 254 ** Uses "unsigned long" for Unicode code points instead of "long".
 255 Long is guaranteed to be at least 32 bits by C standards so it is
 256 always sufficiently large, no need to use uint32_t and the like.
 257
 258 ** The obsolete stringprep_utf8_to_ucs4_fast API entry point was removed.
 259
 260 * Version 0.0.8 (released 2002-12-13)
 261
 262 ** Portability fixes (now works under Cygwin on Windows 2000).
 263
 264 ** Bug fixes.
 265
 266 * Version 0.0.7 (released 2002-12-09)
 267
 268 ** Apply all tables to entire strings, not just first hit.
 269
 270 ** Fix bidi infloop.
 271
 272 * Version 0.0.5 (released 2002-12-07)
 273
 274 ** Fix prohibited characters handling.
 275
 276 ** Fix bidi.
 277
 278 ** Renamed type (struct) stringprep_table_element to Stringprep_table_element.
 279
 280 ** Renamed type stringprep_profile to Stringprep_profile.
 281
 282 ** Renamed type (struct) stringprep_table to Stringprep_table.
 283
 284 ** Added more self-tests.
 285
 286 * Version 0.0.4 (released 2002-12-06)
 287
 288 ** Add unassigned code point handling, including self test cases.
 289
 290 ** Portability fixes.
 291
 292 * Version 0.0.3 (released 2002-11-30)
 293
 294 ** Exported utility function `stringprep_utf8_to_unichar', complementary
 295 to existing `stringprep_unichar_to_utf8'.
 296
 297 ** Renamed `stringprep_utf8_to_ucs4_fast' to `stringprep_utf8_to_ucs4' to
 298 clean up API. The old entry point is maintained for binary backwards
 299 compatibility though.
 300
 301 ** The distribution is from now on signed using GnuPG.
 302
 303 ** Bug fixes.
 304
 305 * Version 0.0.2 (released 2002-11-07)
 306
 307 ** NFKC self test.
 308
 309 ** Bug fixes.
 310
 311 * Version 0.0.1 (released 2002-11-06)
 312
 313 ** Add utility functions stringprep_locale_charset(), stringprep_convert()
 314 and stringprep_locale_to_utf8 () that can be used to convert text from
 315 system's locale into UTF-8, which should be done before invoking
 316 stringprep().  The functions requires iconv() in the operating system.
 317
 318 ** An example program (example.c) that illustrates how libstringprep can be
 319 used is included.
 320
 321 ** The pkg-config --libs output should now include necessary -R options.
 322
 323 * Version 0.0.0 (released 2002-11-05)
 324
 325 ** Initial release
 326
 327 ----------------------------------------------------------------------
 328 Copying and distribution of this file, with or without modification,
 329 are permitted in any medium without royalty provided the copyright
 330 notice and this notice are preserved.