diff -Nurp en/reference/NULL/book.xml en/reference/idn/book.xml
--- en/reference/NULL/book.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/book.xml 2009-01-04 19:26:30.000000000 +0100
@@ -0,0 +1,45 @@
+
+
+
+
+
+
+ idn
+ International Domain Names
+
+
+ &reftitle.intro;
+
+ This extension gives access to the GNU Libidn which is
+ an implementation of the Stringprep, Punycode and IDNA specifications
+ defined by the IETF Internationalized Domain Names (IDN) working
+ group, used for internationalized domain names.
+
+
+
+ &reference.idn.setup;
+ &reference.idn.constants;
+ &reference.idn.reference;
+
+
+
+
diff -Nurp en/reference/NULL/constants.xml en/reference/idn/constants.xml
--- en/reference/NULL/constants.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/constants.xml 2008-12-04 23:57:09.000000000 +0100
@@ -0,0 +1,133 @@
+
+
+
+
+ &reftitle.constants;
+ &extension.constants;
+
+
+
+
+ IDNA_STRINGPREP_ERROR
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_PUNYCODE_ERROR
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_CONTAINS_NON_LDH
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_CONTAINS_MINUS
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_INVALID_LENGTH
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_NO_ACE_PREFIX
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_ROUNDTRIP_VERIFY_ERROR
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_CONTAINS_ACE_PREFIX
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_ICONV_ERROR
+ (integer)
+
+
+
+
+
+
+
+
+ IDNA_MALLOC_ERROR
+ (integer)
+
+
+
+
+
+
+
+
+
+
+
+
diff -Nurp en/reference/NULL/.cvsignore en/reference/idn/.cvsignore
--- en/reference/NULL/.cvsignore 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/.cvsignore 2009-01-04 19:49:04.000000000 +0100
@@ -0,0 +1 @@
+entities.*.xml
diff -Nurp en/reference/NULL/functions/idn-strerror.xml en/reference/idn/functions/idn-strerror.xml
--- en/reference/NULL/functions/idn-strerror.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/functions/idn-strerror.xml 2009-01-04 19:03:28.000000000 +0100
@@ -0,0 +1,75 @@
+
+
+
+
+
+ idn_strerror
+ Returns string describing the IDNA error code
+
+
+
+ &reftitle.description;
+
+ stringidn_strerror
+ integererrorcode
+
+
+ This function returns the error message string that corresponds to the given error code.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ errorcode
+
+
+ The error code as returned by idn_to_ascii or idn_to_utf8.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ The corresponding libidn error message string is returned.
+
+
+
+
+ &reftitle.seealso;
+
+
+ idn_to_ascii
+ idn_to_utf8
+
+
+
+
+
+
+
diff -Nurp en/reference/NULL/functions/idn-to-ascii.xml en/reference/idn/functions/idn-to-ascii.xml
--- en/reference/NULL/functions/idn-to-ascii.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/functions/idn-to-ascii.xml 2009-01-04 19:27:59.000000000 +0100
@@ -0,0 +1,139 @@
+
+
+
+
+
+ idn_to_ascii
+ Convert UTF-8 encoded domain name to ASCII
+
+
+
+ &reftitle.description;
+
+ stringidn_to_ascii
+ stringutf8_domain
+ integererrorcode
+
+
+ This function converts a UTF-8 encoded domain name to ASCII according to the IDNA toUnicode() specification.
+ If the input has non-ASCII characters, the output will be in the "xn--" ACE notation.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ utf8_domain
+
+
+ The UTF-8 encoded domain name.
+
+
+ If e.g. an ISO-8859-1 (aka Western Europe latin1) encoded string is
+ passed it will be converted into an ACE encoded "xn--" string.
+ It will not be the one you expected though!
+
+
+
+
+
+
+ errorcode
+
+
+ Will be set to the IDNA error code.
+
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+
+ The ACE encoded version of the domain name or &false; in case of an error.
+
+
+
+
+ &reftitle.errors;
+
+ If an error occurs &false; is returned and the optional errorcode is set.
+ In addition a E_WARNING message is printed.
+
+
+
+
+ &reftitle.examples;
+
+
+ <function>idn_to_ascii</function> example
+
+ First a simple example and then one explaining how to catch errors.
+
+
+
+]]>
+
+ &example.outputs.similar;
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ utf8_encode
+ idn_strerror
+ itn_to_utf8
+
+
+
+
+
+
+
diff -Nurp en/reference/NULL/functions/idn-to-utf8.xml en/reference/idn/functions/idn-to-utf8.xml
--- en/reference/NULL/functions/idn-to-utf8.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/functions/idn-to-utf8.xml 2009-01-04 19:28:05.000000000 +0100
@@ -0,0 +1,130 @@
+
+
+
+
+
+ idn_to_utf8
+ Convert ASCII encoded domain name to UTF-8
+
+
+
+ &reftitle.description;
+
+ stringidn_to_utf8
+ stringascii_domain
+ integererrorcode
+
+
+ This function converts a ASCII encoded domain name to its original UTF-8 version.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ ascii_domain
+
+
+ The ASCII encoded domain name. Looks like "xn--..." if the it originally contained non-ASCII characters.
+
+
+
+
+ errorcode
+
+
+ Will be set to the IDNA error code.
+
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ The UTF-8 encoded version of the domain name or &false; in case of an error.
+ RFC 3490 4.2 states though "ToUnicode never fails. If any step fails, then the original input
+ sequence is returned immediately in that step."
+
+
+
+
+ &reftitle.errors;
+
+ If an error occurs &false; is returned and the optional errorcode is set.
+ In addition a E_WARNING message is printed.
+
+
+
+
+ &reftitle.examples;
+
+
+ <function>idn_to_utf8</function> example
+
+ First a simple example and then one explaining how to catch errors (which should never happen according to the RFC).
+
+
+
+]]>
+
+ &example.outputs.similar;
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ utf8_decode
+ idn_strerror
+ idn_to_ascii
+
+
+
+
+
+
+
diff -Nurp en/reference/NULL/reference.xml en/reference/idn/reference.xml
--- en/reference/NULL/reference.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/reference.xml 2008-12-04 23:57:09.000000000 +0100
@@ -0,0 +1,31 @@
+
+
+
+
+ Idn &Functions;
+
+ &reference.idn.entities.functions;
+
+
+
+
+
diff -Nurp en/reference/NULL/setup.xml en/reference/idn/setup.xml
--- en/reference/NULL/setup.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/setup.xml 2008-12-05 04:01:13.000000000 +0100
@@ -0,0 +1,66 @@
+
+
+
+
+ &reftitle.setup;
+
+
+
+ &reftitle.required;
+
+ The GNU IDN library must be installed.
+
+
+
+
+
+
+ &reftitle.install;
+
+ &pecl.moved;
+
+
+ &pecl.info;
+ &url.pecl.package;idn.
+
+
+
+
+
+
+ &reftitle.runtime;
+ &no.config;
+
+
+
+
+
+ &reftitle.resources;
+ &no.resource;
+
+
+
+
+
+
+
+
diff -Nurp en/reference/NULL/versions.xml en/reference/idn/versions.xml
--- en/reference/NULL/versions.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/versions.xml 2008-12-05 03:34:10.000000000 +0100
@@ -0,0 +1,33 @@
+
+
+
+
+
+
+
+
+
+
+
+