NAME

Module::Install::ManifestSkip - Generate a MANIFEST.SKIP file

SYNOPSIS

    use inc::Module::Install;

    all_from 'lib/Foo.pm';

    manifest_skip;

    WriteAll;

DESCRIPTION

This module generates a MANIFEST.SKIP file for you (using Module::Manifest::Skip) that contains the common files that people do not want in their MANIFEST files. The SKIP file is generated each time that you (the module author) run Makefile.PL.

You can add your own custom entries at the top of the MANIFEST file. Just put a blank line after your entries, and they will be left alone.

This module also adds 'MANIFEST' to the clean_files() list so that make clean will remove your MANIFEST.

OPTIONS

if you don't plan on adding anything to the stock MANIFEST.SKIP and just want make clean to delete it, say this:

    manifest_skip 'clean';

THEORY

one school of thought for release management is that you never commit your MANIFEST file. You just generate it using make manifest, right before releasing a module, and then delete it afterwards.

This is good because you never forget to add new files to your MANIFEST. The only problems are that you always need to generate a MANIFEST.SKIP file, and you need to add MANIFEST to your clean_files, or delete it by hand. This module does these things for you.

AUTHOR

Ingy döt Net <ingy@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2010-2014. Ingy döt Net.

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