________________________________________________________________________________

                          Filter::Crypto, Version 2.03
________________________________________________________________________________

PREREQUISITES

    Compiler

        You need a C compiler to build these modules.

        Note that you should try to use the same compiler as was used to build
        your Perl itself.

        In particular, Windows users should be aware that these modules will not
        work correctly if they load a different C run-time DLL to that loaded by
        perl itself.  Note that Visual C++ 6.0 (part of Visual Studio 6.0) and
        earlier produce binaries that require the system's msvcrt.dll, while
        Visual C++ .NET (aka Visual C++ 7.0, part of Visual Studio .NET), Visual
        C++ .NET 2003 (aka Visual C++ 7.1, part of Visual Studio .NET 2003 and
        the free Visual C++ Toolkit 2003), Visual C++ 2005 (aka Visual C++ 8.0,
        part of Visual Studio 2005 and the free Visual C++ 2005 Express Edition)
        and later produce binaries that require compiler-specific DLLs named
        msvcr70.dll, msvcr71.dll, msvcr80.dll etc.  Therefore, building these
        modules with anything later than VC6 for use with ActivePerl, which is
        known currently to be built with VC6, will not work.

        On Windows, the Makefile.PL script will try to detect if a different
        compiler is being used and will give an error if necessary.  Note,
        however, that it is not always possible for it to detect which
        particular compiler version was used to build Perl, especially for Perl
        version 5.8.6 or older, which did not have this information stored in
        the standard library module Config.

    OpenSSL

        OpenSSL (any version), or SSLeay version 0.6.0 or later.
        The latest version of OpenSSL is available from http://www.openssl.org/.

    Perl

        Perl version 5.6.0 or later.
        The latest version of Perl is available from http://www.perl.com/.

    Perl Modules

        There are no non-standard Perl modules required by the two main modules
        in this distribution (Filter::Crypto::CryptFile and
        Filter::Crypto::Decrypt), but the crypt_file script and the
        PAR::Filter::Crypto module both require

            File::Temp

        which is only a standard Perl module from Perl version 5.6.1 onwards
        (crypt_file only requires it when run with the "-e tempfile" option),
        and the PAR::Filter::Crypto module also requires

            PAR::Filter

        which is part of the PAR distribution.

        A standalone distribution of the File::Temp module, as well as the PAR
        distribution, is available from CPAN (http://www.cpan.org/).

INSTALLATION

    To install these modules, cd to the directory that contains this INSTALL
    file and type the following:

        perl Makefile.PL
        make
        make test
        make install

    The Makefile.PL script will ask various questions regarding (amongst other
    things) the location of OpenSSL or SSLeay, which cipher algorithm to use,
    what password or key to use and whether to install a script.

    Alternatively, command-line options can be used to provide the answers to
    these questions and hence run the script non-interactively.  Type:

        perl Makefile.PL --help

    for more details.

    On Microsoft Windows platforms, you will need to use "nmake" or "dmake"
    rather than "make" in the commands above, depending on what your Perl was
    built with.  To determine which make program was used to build your Perl
    type the following:

        perl -V:make
________________________________________________________________________________