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