diff -Nur /newlycreated/book.xml en/reference/idn/book.xml
--- /newlycreated/book.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/book.xml 2008-12-05 04:01:21.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 -Nur /newlycreated/constants.xml en/reference/idn/constants.xml
--- /newlycreated/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 -Nur /newlycreated/entities.functions.xml en/reference/idn/entities.functions.xml
--- /newlycreated/entities.functions.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/entities.functions.xml 2008-12-05 04:01:29.000000000 +0100
@@ -0,0 +1,3 @@
+&reference.idn.functions.idn-strerror;
+&reference.idn.functions.idn-to-ascii;
+&reference.idn.functions.idn-to-utf8;
diff -Nur /newlycreated/functions/idn-strerror.xml en/reference/idn/functions/idn-strerror.xml
--- /newlycreated/functions/idn-strerror.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/functions/idn-strerror.xml 2008-12-05 03:35: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 -Nur /newlycreated/functions/idn-to-ascii.xml en/reference/idn/functions/idn-to-ascii.xml
--- /newlycreated/functions/idn-to-ascii.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/functions/idn-to-ascii.xml 2008-12-05 03:28:47.000000000 +0100
@@ -0,0 +1,131 @@
+
+
+
+
+
+ idn_to_ascii
+ Convert UTF-8 encoded domain name to ASCII
+
+
+
+ &reftitle.description;
+
+ string|booleanidn_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. CAVEAT: 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
+
+
+ If a reference to a variable is passed, the variable is 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.
+
+
+
+]]>
+
+
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ utf8_encode
+ idn_strerror
+ itn_to_utf8
+
+
+
+
+
+
+
diff -Nur /newlycreated/functions/idn-to-utf8.xml en/reference/idn/functions/idn-to-utf8.xml
--- /newlycreated/functions/idn-to-utf8.xml 1970-01-01 01:00:00.000000000 +0100
+++ en/reference/idn/functions/idn-to-utf8.xml 2008-12-05 03:29:12.000000000 +0100
@@ -0,0 +1,128 @@
+
+
+
+
+
+ idn_to_utf8
+ Convert ASCII encoded domain name to UTF-8
+
+
+
+ &reftitle.description;
+
+ string|booleanidn_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
+
+
+ If a reference to a variable is passed, the variable is 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).
+
+
+
+]]>
+
+
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ utf8_decode
+ idn_strerror
+ idn_to_ascii
+
+
+
+
+
+
+
diff -Nur /newlycreated/reference.xml en/reference/idn/reference.xml
--- /newlycreated/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 -Nur /newlycreated/setup.xml en/reference/idn/setup.xml
--- /newlycreated/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 -Nur /newlycreated/versions.xml en/reference/idn/versions.xml
--- /newlycreated/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 @@
+
+
+
+
+
+
+
+
+
+
+
+