file::sharedir::install(3pm) [debian man page]

File::ShareDir::Install(3pm)				User Contributed Perl Documentation			      File::ShareDir::Install(3pm)

NAME

       File::ShareDir::Install - Install shared files

SYNOPSIS

	   use ExtUtils::MakeMaker;
	   use File::ShareDir::Install;

	   install_share 'share';
	   install_share dist => 'dist-share';
	   install_share module => 'My::Module' => 'other-share';

	   WriteMakefile( ... );       # As you normaly would

	   package MY;
	   use File::ShareDir::Install qw(postamble);

DESCRIPTION

       File::ShareDir::Install allows you to install read-only data files from a distribution. It is a companion module to File::ShareDir, which
       allows you to locate these files after installation.

       It is a port Module::Install::Share to ExtUtils::MakeMaker with the improvement of only installing the files you want; ".svn" and other
       source-control junk will be ignored.

EXPORT

   install_share
	   install_share $dir;
	   install_share dist => $dir;
	   install_share module => $module, $dir;

       Causes all the files in $dir and its sub-directories.  to be installed into a per-dist or per-module share directory.  Must be called
       before WriteMakefile.

       The first 2 forms are equivalent.

       The files will be installed when you run "make install".

       To locate the files after installation so they can be used inside your module, see  File::ShareDir.

	   my $dir = File::ShareDir::module_dir( $module );

       Note that if you make multiple calls to "install_share" on different directories that contain the same filenames, the last of these calls
       takes precedence.  In other words, if you do:

	   install_share 'share1';
	   install_share 'share2';

       And both "share1" and "share2" contain a fill called "info", the file "share2/info" will be installed into your "dist_dir()".

   postamble
       Exported into the MY package.  Only documented here if you need to write your own postable.

	   package MY;
	   use File::ShareDir::Install;

	   sub postamble {
	       my $self = shift;
	       my @ret = File::ShareDir::Install::postamble( $self );
	       # ... add more things to @ret;
	       return join "
", @ret;
	   }

SEE ALSO

       File::ShareDir, Module::Install.

AUTHOR

       Philip Gwyn, <gwyn-AT-cpan.org>

COPYRIGHT AND LICENSE

       Copyright (C) 2009-2011 by Philip Gwyn

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.12.4							    2011-08-26					      File::ShareDir::Install(3pm)

Module::Install::Makefile(3)				User Contributed Perl Documentation			      Module::Install::Makefile(3)

NAME

       Module::Install::MakeMaker - Extension Rules for ExtUtils::MakeMaker

SYNOPSIS

       In your Makefile.PL:

	   use inc::Module::Install;
	   WriteMakefile();

DESCRIPTION

       This module is a wrapper around ExtUtils::MakeMaker.  It exports two functions: "prompt" (an alias for "ExtUtils::MakeMaker::prompt") and
       "WriteMakefile".

       The "WriteMakefile" function will pass on keyword/value pair functions to "ExtUtils::MakeMaker::WriteMakefile". The required parameters
       "NAME" and "VERSION" (or "VERSION_FROM") are not necessary if it can find them unambiguously in your code.

CONFIGURATION OPTIONS

       This module also adds some Configuration parameters of its own:

   NAME
       The NAME parameter is required by ExtUtils::MakeMaker. If you have a single module in your distribution, or if the module name indicated by
       the current directory exists under lib/, this module will use the guessed package name as the default.

       If this module can't find a default for "NAME" it will ask you to specify it manually.

   VERSION
       ExtUtils::MakeMaker requires either the "VERSION" or "VERSION_FROM" parameter.  If this module can guess the package's "NAME", it will
       attempt to parse the "VERSION" from it.

       If this module can't find a default for "VERSION" it will ask you to specify it manually.

MAKE TARGETS

       ExtUtils::MakeMaker provides you with many useful "make" targets. A "make" target is the word you specify after "make", like "test" for
       "make test". Some of the more useful targets are:

       o   all

	   This is the default target. When you type "make" it is the same as entering "make all". This target builds all of your code and stages
	   it in the "blib" directory.

       o   test

	   Run your distribution's test suite.

       o   install

	   Copy the contents of the "blib" directory into the appropriate directories in your Perl installation.

       o   dist

	   Create a distribution tarball, ready for uploading to CPAN or sharing with a friend.

       o   clean distclean purge

	   Remove the files created by "perl Makefile.PL" and "make".

       o   help

	   Same as typing "perldoc ExtUtils::MakeMaker".

       This module modifies the behaviour of some of these targets, depending on your requirements, and also adds the following targets to your
       Makefile:

       o   cpurge

	   Just like purge, except that it also deletes the files originally added by this module itself.

       o   chelp

	   Short cut for typing "perldoc Module::Install".

       o   distsign

	   Short cut for typing "cpansign -s", for Module::Signature users to sign the distribution before release.

SEE ALSO

       Module::Install, CPAN::MakeMaker, CPAN::MakeMaker::Philosophy

AUTHORS

       Adam Kennedy <adamk@cpan.org>

       Audrey Tang <autrijus@autrijus.org>

       Brian Ingerson <INGY@cpan.org>

COPYRIGHT

       Some parts copyright 2008 - 2012 Adam Kennedy.

       Copyright 2002, 2003, 2004 Audrey Tang and Brian Ingerson.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.16.3							    2012-03-01					      Module::Install::Makefile(3)