NAME¶
Module::Install::Share - Install non-code files for use during run-time
SYNOPSIS¶
# Put everything inside ./share/ into the distribution 'auto' path
install_share 'share';
# Same thing as above using the default directory name
install_share;
DESCRIPTION¶
As well as Perl modules and Perl binary applications, some distributions need to
install read-only data files to a location on the file system for use at
run-time.
XML Schemas, YAML data files, and SQLite databases are examples of the sort of
things distributions might typically need to have available after
installation.
"Module::Install::Share" is a Module::Install extension that provides
commands to allow these files to be installed to the applicable location on
disk.
To locate the files after installation so they can be used inside your module,
see this extension's companion module File::ShareDir.
TO DO¶
Currently "install_share" installs not only the files you want, but if
called by the author will also copy
.svn and other source-control
directories, and other junk.
Enhance this to copy only files under
share that are in the
MANIFEST, or possibly those not in
MANIFEST.SKIP.
AUTHORS¶
Audrey Tang <autrijus@autrijus.org>
Adam Kennedy <adamk@cpan.org>
SEE ALSO¶
Module::Install, File::ShareDir
COPYRIGHT¶
Copyright 2006 Audrey Tang, Adam Kennedy.
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
See <
http://www.perl.com/perl/misc/Artistic.html>