1Module::Manifest::Skip(U3s)er Contributed Perl DocumentatMioodnule::Manifest::Skip(3)
2
3
4

NAME

6       Module::Manifest::Skip - MANIFEST.SKIP Manangement for Modules
7

SYNOPSIS

9       From the command line:
10
11           > perl -MModule::Manifest::Skip=create
12
13       From Perl:
14
15           use Module::Manifest::Skip;
16           use IO::All;
17
18           my $mms = Module::Manifest::Skip->new;
19           # optional add and removes:
20           $mms->add('^foo-bar$');
21           $mms->remove('^foo$');
22           $mms->remove(qr/\Q\bfoo\b/);
23           io('MANIFEST.SKIP')->print($mms->text);
24

DESCRIPTION

26       NOTE: This module is mostly intended for module packaging frameworks to
27       share a common, up-to-date "MANIFEST.SKIP" base. For example,
28       Module::Install::ManifestSkip, uses this module to get the actual SKIP
29       content. However this module may be useful for any module author.
30
31       CPAN module authors use a "MANIFEST.SKIP" file to exclude certain well
32       known files from getting put into a generated "MANIFEST" file, which
33       would cause them to go into the final distribution package.
34
35       The packaging tools try to automatically skip things for you, but if
36       you add one of your own entries, you have to add all the common ones
37       yourself.  This module attempts to make all of this boring process as
38       simple and reliable as possible.
39
40       Module::Manifest::Skip can create or update a MANIFEST.SKIP file for
41       you. You can add your own entries, and it will leave them alone. You
42       can even tell it to not skip certain entries that it normally skips,
43       although this is rarely needed.
44

USAGE

46       Usually this module is called by other packaging modules. If you want
47       this to be used by Module::Install, then you would put this:
48
49           manifest_skip 'clean';
50
51       in your "Makefile.PL", and everything would be taken care of for you.
52
53       If you want to simply create a "MANIFEST.SKIP" file from the command
54       line, this handy syntax exists:
55
56           > perl -MModule::Manifest::Skip=create
57

BEHAVIOR

59       This module ships with a share file called "share/MANIFEST.SKIP". This
60       is the basis for all new MANIFEST.SKIP files. This module will look for
61       an already existing "MANIFEST.SKIP" file and take all the text before
62       the first blank line, and prepend it to the start of a new SKIP file.
63       This allows you to put your own personal section at the top, that will
64       not be overwritten later.
65
66       It will then look for lines beginning with a dash followed by a space.
67       Like this:
68
69             - \bfoo\b
70             - ^bar/
71             - ^baz$
72
73       It will comment out each of these lines and any other lines that match
74       the text (after the '- '). This allows you to override the default
75       SKIPs.
76

AUTHOR

78       Ingy döt Net <ingy@cpan.org>
79
81       Copyright 2011-2014. Ingy döt Net.
82
83       This program is free software; you can redistribute it and/or modify it
84       under the same terms as Perl itself.
85
86       See <http://www.perl.com/perl/misc/Artistic.html>
87
88
89
90perl v5.28.0                      2014-08-16         Module::Manifest::Skip(3)
Impressum