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