view release on metacpan or  search on metacpan

lib/Devel/PatchPerl/Plugin/Cygwin.pm  view on Meta::CPAN

=head1 DESCRIPTION

This module is a plugin module for L<Devel::PatchPerl> for the Cygwin environment.
It might be better to be included in original because it is not for variant but for environment.
The Cygwin environment is, however, relatively minor and tricky environment.
So, this module is provided as a plugin in order to try patches unofficially and experimentally.

As of this writing, it is confirmed that the following versions are compilable with Cygwin 2.10.0.

=over 4

=item * 5.8.9

=item * 5.10.1

=item * 5.12.5

=item * 5.14.4

=item * 5.16.3

=item * 5.18.4

=item * 5.20.3

=item * 5.22.4

=item * 5.24.4

=item * 5.26.2

=back

=head1 METHODS

=head2 patchperl

A class method of plugin interface for L<Devel::PatchPerl>. See L<Devel::PatchPerl::Plugin>.

=head1 TESTS

If you want to check if patches succeed for all stable releases on and after 5.8 series,
specify the environment variables C<PERL5_DPPPC_PATCH_TESTING> and C<AUTHOR_TESTING> when testing.

If you have dist tarballs in your perlbrew root, they are used.
Otherwise they are downloaded into a temporary directory for each invoking test.

=head1 CAVEAT

L<Devel::PatchPerl> says as the following:

=over 4

L<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.

=back

This statement is applicable also for this plugin.
For example, on some versions of perls, it is observed that tests such as op/taint.t and op/threads.t are blocked at the author's environment.

=head1 SEE ALSO

=over 4

=item *

L<Devel::PatchPerl::Plugin>

=item *

L<App::perlbrew>

=back

=head1 AUTHOR

Yasutaka ATARASHI <yakex@cpan.org>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2018 by Yasutaka ATARASHI.

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

=cut