1Devel::PatchPerl(3)   User Contributed Perl Documentation  Devel::PatchPerl(3)
2
3
4

NAME

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

VERSION

9       version 2.08
10

SYNOPSIS

12         use strict;
13         use warnings;
14
15         use Devel::PatchPerl;
16
17         Devel::PatchPerl->patch_source( '5.6.1', '/path/to/untarred/perl/source/perl-5.6.1' );
18

DESCRIPTION

20       Devel::PatchPerl is a modularisation of the patching code contained in
21       Devel::PPPort's "buildperl.pl".
22
23       It does not build perls, it merely provides an interface to the source
24       patching functionality.
25

FUNCTION

27       "patch_source"
28           Takes two parameters, a "perl" version and the path to unwrapped
29           perl source for that version.  It dies on any errors.
30
31           If you don't supply a "perl" version, it will attempt to auto-
32           determine the "perl" version from the specified path.
33
34           If you don't supply the path to unwrapped perl source, it will
35           assume the current working directory.
36
37       "determine_version"
38           Takes one optional parameter, the path to unwrapped perl source. It
39           returns the perl version of the source code at the given location.
40           It returns undef on error.
41
42           If you don't supply the path to unwrapped perl source, it will
43           assume the current working directory.
44

PLUGIN SYSTEM

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

PATCHLEVEL

50       Devel::PatchPerl will normally update the "patchlevel.h" file in the
51       perl source tree to indicate that it has applied local patches. This
52       behaviour is negated if it is detected that it is operating in a git
53       repository. To override this and update "patchlevel.h" when in a Git
54       repository, set the env var "PERL5_PATCHPERL_PATCHLEVEL" to a true
55       value.
56
57       Alternatively, call "patchperl" with the "--patchlevel" option.
58

CAVEAT

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

SEE ALSO

65       Devel::PPPort
66
67       Devel::PatchPerl::Plugin
68

AUTHOR

70       Chris Williams <chris@bingosnet.co.uk>
71

73       This software is copyright (c) 2021 by Chris Williams and Marcus
74       Holland-Moritz.
75
76       This is free software; you can redistribute it and/or modify it under
77       the same terms as the Perl 5 programming language system itself.
78
79
80
81perl v5.36.0                      2023-01-20               Devel::PatchPerl(3)
Impressum