The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Perl::Dist::WiX::Mixin::Patching - Provides routines for patching files in a Win32 perl distribution.

VERSION

This document describes Perl::Dist::WiX::Mixin::Patching version 1.500.

SYNOPSIS

        # This module is not to be used independently.
        # It provides methods to be called on a Perl::Dist::WiX object.
  

DESCRIPTION

This module provides methods for patching files within a distribution, either from Template Toolkit files or from edited files, for Perl::Dist::WiX.

METHODS

process_template

        # Loads up the template for merge module docs.
        $text = $self->process_template('Merge-Module.documentation.txt.tt');

Loads the file template passed in as the first parameter, using this object, and returns it as a string.

Additional entries (beyond the one given that 'dist' is the Perl::Dist::WiX object, and 'directory_tree' is the stringification of the current directory tree) for the second parameter of Template->process are given as a list of pairs following the first parameter.

patch_include_path

        my $directory_list_ref = $self->patch_include_path(); 

Returns an array reference containing a list of paths containing files that are used to replace or patch files in the distribution.

patch_pathlist

        my $pathlist = $self->patch_pathlist();

Returns the list of directories in patch_include_path as a File::PathList object.

patch_file

        $self->patch_file('Merge-Module.wxs');

patch_file patches an individual file installed in the distribution using a file from the directories returned from "patch_pathlist".

The file to patch from can either be a file that replaces the file named, or a Template Toolkit file with a '.tt' extension added to the file named.

patch_perl_file

        $self->patch_perl_file('makefile.mk')

patch_file patches an individual file installed in the distribution using a file from the perl plugin modules.

SUPPORT

Bugs should be reported via the CPAN bug tracker at

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Perl-Dist-WiX

For other issues, contact the author.

AUTHOR

Curtis Jewell <csjewell@cpan.org>

Adam Kennedy <adamk@cpan.org>

SEE ALSO

Perl::Dist::WiX,

COPYRIGHT AND LICENSE

Copyright 2009 - 2010 Curtis Jewell.

Copyright 2007 - 2009 Adam Kennedy.

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

The full text of the license can be found in the LICENSE file included with this distribution.