(Partly consisting of text excerpted from the Pod.)

NAME
   PerlIO::via::Unidecode -- a perlio layer for Unidecode

SYNOPSIS
     % cat utf8translit
     #!/usr/bin/perl
     use strict;
     use PerlIO::via::Unidecode;
     foreach my $f (@ARGV) {
       open IN, '<:encoding(utf8):via(Unidecode)', $f or die "$f -> $!\n";
       print while <IN>;
       close(IN);
     }
     __END__

     % od -x home_city.txt
     000000:  E5 8C 97 E4 BA B0 0D 0A

   (that's the the Chinese characters for Beijing, in UTF8)

     % utf8translit home_city.txt
     Bei Jing

DESCRIPTION
   PerlIO::via::Unidecode implements a PerlIO::via layer that applies
   Unidecode (Text::Unidecode) to data passed through it.

   You can use PerlIO::via::Unidecode on already-Unicode data, as in the
   example in the SYNOPSIS; or you can combine it with other layers, as in
   this little program that converts KOI8R text into Unicode and then feeds
   it to Unidecode, which then outputs an ASCII transliteration:

     % cat transkoi8r
     #!/usr/bin/perl
     use strict;
     use PerlIO::via::Unidecode;
     foreach my $f (@ARGV) {
       open IN, '<:encoding(koi8-r):via(Unidecode)', $f or die $!;
       print while <IN>;
       close(IN);
     }
     __END__
[...]

SEE ALSO
   Text::Unidecode

   PerlIO::via

   Encode and Encode::Supported

   PerlIO::via::PinyinConvert

NOTES
   Thanks for Jarkko Hietaniemi for help with this module and many other
   things besides.

COPYRIGHT AND DISCLAIMER
   Copyright 2003, Sean M. Burke [email protected], all rights reserved. This
   program is free software; you can redistribute it and/or modify it under
   the same terms as Perl itself.

   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 purpose.

AUTHOR
   Sean M. Burke [email protected]




INSTALLATION

You install PerlIO::via::Unidecode, as you would install any perl module
library, by running these commands:

  perl Makefile.PL
  make
  make test
  make install

If you want to install a private copy of PerlIO::via::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.


DOCUMENTATION

POD-format documentation is included in Unidecode.pm.  POD is readable
with the 'perldoc' utility.  See ChangeLog for recent changes.


SUPPORT

Questions, bug reports, useful code bits, and suggestions for
PerlIO::via::Unidecode should just be sent to me at [email protected]


AVAILABILITY

The latest version of PerlIO::via::Unidecode is available from the
Comprehensive Perl Archive Network (CPAN).  Visit
<http://www.perl.com/CPAN/> to find a CPAN site near you.