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