NAME
    eval - Eval code

VERSION
    This document describes version 0.002 of eval (from Perl distribution
    eval), released on 2019-10-19.

SYNOPSIS
    Use in one-liner or in PERL5OPT:

     % perl -Meval='$Carp::MaxArgLen = 1000' script.pl

     % DEBUG=1 PERL5OPT='-Meval=$Carp::MaxArgLen=1000' script.pl
     eval.pm: Eval'ing: $Carp::MaxArgLen=1000

DESCRIPTION
    This pragma lets you run some Perl code before running your script. Some
    other ways to accomplish the same include:

    *   creating $Config{sitelib}/sitecustomize.pl

        See perlrun.

    *   putting your code in a module and load it using "-m" or "-M"

        For example, you put your code in lib/Foo.pm and run your script
        using:

         % PERL5OPT="-Ilib -MFoo" script.pl

    *   "do"

         % perl -e'$Carp::MaxArgLen = 1000; do "script.pl"'

    Some caveats:

    *   No whitespace in code in PERL5OPT

        Space is used to separate perl options in PERL5OPT, so you can't do:

         % PERL5OPT='-Meval=$Carp::MaxArgLen = 1000' script.pl

        but you can do:

         % PERL5OPT='-Meval=$Carp::MaxArgLen=1000' script.pl

        To help you see what code is being eval'ed, set "DEBUG" to true:

         % DEBUG=1 PERL5OPT='-Meval=$Carp::MaxArgLen=1000' script.pl
         eval.pm: Eval'ing: $Carp::MaxArgLen=1000

ENVIRONMENT
  DEBUG
    Bool. If set to true, will show what code is being eval'ed.

HOMEPAGE
    Please visit the project's homepage at
    <https://metacpan.org/release/eval>.

SOURCE
    Source repository is at <https://github.com/perlancar/perl-eval>.

BUGS
    Please report any bugs or feature requests on the bugtracker website
    <https://rt.cpan.org/Public/Dist/Display.html?Name=eval>

    When submitting a bug or request, please include a test-file or a patch
    to an existing test-file that illustrates the bug or desired feature.

AUTHOR
    perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2019 by perlancar@cpan.org.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

