NAME

       Devel::PatchPerl - Patch perl source a la Devel::PPPort's buildperl.pl

VERSION

       version 2.08

SYNOPSIS

         use strict;
         use warnings;

         use Devel::PatchPerl;

         Devel::PatchPerl->patch_source( '5.6.1', '/path/to/untarred/perl/source/perl-5.6.1' );

DESCRIPTION

       Devel::PatchPerl is a modularisation of the patching code contained in Devel::PPPort's
       "buildperl.pl".

       It does not build perls, it merely provides an interface to the source patching
       functionality.

FUNCTION

       "patch_source"
           Takes two parameters, a "perl" version and the path to unwrapped perl source for that
           version.  It dies on any errors.

           If you don't supply a "perl" version, it will attempt to auto-determine the "perl"
           version from the specified path.

           If you don't supply the path to unwrapped perl source, it will assume the current
           working directory.

       "determine_version"
           Takes one optional parameter, the path to unwrapped perl source. It returns the perl
           version of the source code at the given location. It returns undef on error.

           If you don't supply the path to unwrapped perl source, it will assume the current
           working directory.

PLUGIN SYSTEM

       See Devel::PatchPerl::Plugin for details of Devel::PatchPerl's plugin system.

PATCHLEVEL

       Devel::PatchPerl will normally update the "patchlevel.h" file in the perl source tree to
       indicate that it has applied local patches. This behaviour is negated if it is detected
       that it is operating in a git repository. To override this and update "patchlevel.h" when
       in a Git repository, set the env var "PERL5_PATCHPERL_PATCHLEVEL" to a true value.

       Alternatively, call "patchperl" with the "--patchlevel" option.

CAVEAT

       Devel::PatchPerl is intended only to facilitate the "building" of perls, not to facilitate
       the "testing" of perls. This means that it will not patch failing tests in the perl
       testsuite.

SEE ALSO

       Devel::PPPort

       Devel::PatchPerl::Plugin

AUTHOR

       Chris Williams <chris@bingosnet.co.uk>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2021 by Chris Williams and Marcus Holland-Moritz.

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