• NAME
• VERSION
• SYNOPSIS
• DESCRIPTION
• DIAGNOSTICS
• PREREQUISITES
• AUTHOR & COPYRIGHT
• ACKNOWLEDGEMENTS
• SEE ALSO

NAME

Filter::Encoding - Write your script in any encoding

VERSION

Version 0.01

SYNOPSIS

  use Filter::Encoding 'MacRoman';
  # Code that follows can be written in MacRoman encoding.

DESCRIPTION

This module allows your code to be written in any ASCII-based encoding. Just pass the name of the encoding as an argument to use Filter::Encoding. The source code will be decoded and treated as though it had been written in UTF-8 with use utf8 in effect. That's all this module does.

It is intended as a simpler, saner replacement for encoding.pm, one that does not change the up- and downgrading of strings or touch your file handles.

DIAGNOSTICS

Too many arguments to Filter::Encoding->import()

use Filter::Encoding (which implies ->import) only allows one argument.

Filter::Encoding: Unknown encoding '%s'

The encoding must be one recognized by the Encode module.

PREREQUISITES

perl 5.8.0 or later

AUTHOR & COPYRIGHT

Copyright (C) 2016 Father Chrysostomos <sprout [at] cpan [dot] org>

This program is free software; you may redistribute it, modify it, or both under the same terms as perl.

ACKNOWLEDGEMENTS

Much of the code was based on the filter feature of encoding.pm.

SEE ALSO

Encode, encoding

                    cpanm Filter::Encoding

                    perl -MCPAN -e shell
                    install Filter::Encoding