File::ShareDir::InstalUser Contributed Perl DocumentFile::ShareDir::Install(3)NAMEFile::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::Installqw(postamble);
DESCRIPTIONFile::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 of 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;
Causes all the files in $dir and its sub-directories. to be installed
into a per-dist or per-module share directory. Must be called before
WriteMakefile.
The first 2 forms are equivalent.
The files will be installed when you run "make install".
To locate the files after installation so they can be used inside your
module, see File::ShareDir.
my $dir = File::ShareDir::module_dir( $module );
Note that if you make multiple calls to "install_share" on different
directories that contain the same filenames, the last of these calls
takes precedence. In other words, if you do:
install_share 'share1';
install_share 'share2';
And both "share1" and "share2" contain a fill called "info", the file
"share2/info" will be installed into your "dist_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.
perl v5.14.1 2009-09-09 File::ShareDir::Install(3)