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