(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, 2014, 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

* For using the "CPAN Plus" system, read:   perldoc cpanp
* For old-style "make" interface, read:     perldoc perlmodinstall


DOCUMENTATION

POD-format documentation is included in PerlIO/via/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.