NAME

File::Sharedir::Install - Install shared files

SYNOPSIS

use ExtUtils::MakeMaker;
use File::Sharedir::Install;

install_share 'share';
install_share dist => 'dist-share';
install_share module => 'My::Module' => 'other-share';

WriteMakefile( ... );       # As you normaly would

package MY;
use File::Sharedir::Install qw(postamble);

DESCRIPTION

File::ShareDir::Install allows you to install read-only data files from a distribution. It is a companion module to File::ShareDir, which allows you to locate these files after installation.

It is a port Module::Install::Share to ExtUtils::MakeMaker with the improvement only installing the files you want; .svn and other source-control junk will be ignored.

EXPORT

install_share

install_share $dir;
install_share dist => $dir;
install_share module => $module, $dir;

postamble

Exported into the MY package. Only documented here if you need to write your own postable.

package MY;
use File::Sharedir::Install;

sub postamble {
    my $self = shift;
    my @ret = File::Sharedir::Install::postamble( $self );
    # ... add more things to @ret;
    return join "\n", @ret;
}

SEE ALSO

File::Sharedir, Module::Install.

AUTHOR

Philip Gwyn, <gwyn-AT-cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Philip Gwyn

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.