(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 sburke@cpan.org, 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 sburke@cpan.org




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 sburke@cpan.org


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.
