Module::Install::Share(3pm)

Module::Install::Share3pm

Install non-code files for use during run-time

Usage

    # Put everything inside ./share/ into the distribution 'auto' path
    install_share 'share';
    # Same thing as above using the default directory name
    install_share;

Overview

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.

Releases

11 releases since Debian 4.0 (Etch); the text changed 9 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10–11
  8. 12
  9. 13
  10. Arch

Authors

Audrey Tang <[email protected]>

Adam Kennedy <[email protected]>

From perl-module-install 1.21-6 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.