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>