README for Text::Unidecode
Time-stamp: "2001-07-14 02:03:33 MDT"
Text::Unidecode -- US-ASCII transliterations of Unicode text
# those are the Chinese characters for Beijing
# That prints: Bei Jing
It often happens that you have non-Roman text data in Unicode, but
you can't display it -- usually because you're trying to show it
to a user via an application that doesn't support Unicode, or
because the fonts you need aren't accessible. You could represent
the Unicode characters as "???????" or "\15BA\15A0\1610...", but
that's nearly useless to the user who actually wants to read what
the text says.
What Text::Unidecode provides is a function, `unidecode(...)' that
takes Unicode data and tries to represent it in US-ASCII
characters (i.e., the universally displayable characters between
0x00 and 0x7F). The representation is almost always an attempt at
*transliteration* -- i.e., conveying, in Roman letters, the
pronunciation expressed by the text in some other writing
system. (See the example in the synopsis.)
See the POD for more information.
This module requires Perl 5.6.0 or higher. (Earlier Perls apparently
lack the "use utf8" pragma that Text::Unidecode needs.)
I have also observed that 5.6.0's Unicode support is shakey; strongly
consider upgrading to 5.6.1 at least.
You install Text::Unidecode, as you would install any perl module
library, by running these commands:
If you want to install a private copy of Text::Unidecode in your home
directory, then you should try to produce the initial Makefile with
something like this command:
perl Makefile.PL LIB=~/perl
See perldoc perlmodinstall for more information on installing modules.
POD-format documentation is included in Unidecode.pm. POD is readable
with the 'perldoc' utility. See ChangeLog for recent changes.
Questions, bug reports, useful code bits, and suggestions for
Text::Unidecode should just be sent to me at email@example.com
The latest version of Text::Unidecode is available from the
Comprehensive Perl Archive Network (CPAN). Visit
<http://www.perl.com/CPAN/> to find a CPAN site near you.
Copyright 2001, Sean M. Burke <firstname.lastname@example.org>, all rights reserved.
The programs and documentation in this dist are distributed in the
hope that they will be useful, but without any warranty; without even
the implied warranty of merchantability or fitness for a particular
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.