summaryrefslogtreecommitdiff
path: root/libraries/perl-Net-LibIDN/README
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/perl-Net-LibIDN/README')
-rw-r--r--libraries/perl-Net-LibIDN/README14
1 files changed, 14 insertions, 0 deletions
diff --git a/libraries/perl-Net-LibIDN/README b/libraries/perl-Net-LibIDN/README
new file mode 100644
index 0000000000..e495139df4
--- /dev/null
+++ b/libraries/perl-Net-LibIDN/README
@@ -0,0 +1,14 @@
+Net::LibIDN - Perl bindings for GNU Libidn
+
+Provides bindings for GNU Libidn, a C library for handling Internationalized
+Domain Names according to IDNA (RFC 3490), in a way very much inspired by
+Turbo Fredriksson's PHP-IDN.
+There is currently no support for Perl's unicode capabilities (man
+perlunicode). All input strings are assumed to be octet strings, all output
+strings are generated as octet strings. Thus, if you require Perl's unicode
+features, you will have to convert your strings manually. For example:
+
+ use Encode;
+ use Data::Dumper;
+ print Dumper(Net::LibIDN::idn_to_unicode('xn--uro-j50a.com', 'utf-8'));
+ print Dumper(decode('utf-8', Net::LibIDN::idn_to_unicode('xn--uro-j50a.com', 'utf-8')));