debian man page for module::install::catalyst

Module::Install::Catalyst(3pm)				User Contributed Perl Documentation			    Module::Install::Catalyst(3pm)

NAME
	 Module::Install::Catalyst - Module::Install extension for Catalyst

SYNOPSIS
	 use inc::Module::Install;

	 name 'MyApp';
	 all_from 'lib/MyApp.pm';

	 requires 'Catalyst::Runtime' => '5.7014';

	 catalyst_ignore('.*temp');
	 catalyst_ignore('.*tmp');
	 catalyst;
	 WriteAll;

DESCRIPTION
       Module::Install extension for Catalyst.

METHODS
   catalyst
       Calls catalyst_files and catalyst_par. Should be the last catalyst* command called in "Makefile.PL".

   catalyst_files
       Collect a list of all files a Catalyst application consists of and copy it inside the blib/lib/ directory. Files and directories that match
       the modules ignore list are excluded (see catalyst_ignore and catalyst_ignore_all).

   catalyst_ignore_all(@ignore)
       This function replaces the built-in default ignore list with the given list.

   catalyst_ignore(@ignore)
       Add a regexp to the list of ignored patterns. Can be called multiple times.

   catalyst_par($name)
   catalyst_par_core($core)
   catalyst_par_classes(@clases)
   catalyst_par_engine($engine)
   catalyst_par_multiarch($multiarch)
   catalyst_par_options($optstring)
       This command can be used in Makefile.PL to customise the PAR creation process.  The parameter "$optstring" contains a string with arguments
       in identical syntax as arguments of pp command from PAR::Packer package.

       Example:

	   # part of your Makefile.PL

	   catalyst_par_options("--verbose=2 -f Bleach -z 9");
	   # verbose mode; use filter 'Bleach'; zip with compression level 9
	   catalyst;

       Note1: There is no reason to use catalyst_par_options() command multiple times as you can spacify in "$optstring" as many options as you
       want. Still, it is supported to call catalyst_par_options() more than once. In that case the specified options are merged (collisions are
       handled on principle "later wins").  BEWARE: you are discouraged from using parameters -a -A -X -f -F -I -l -M in multiple
       catalyst_par_options() as they are not merged but replaced as you would expected.

       Note2: By default the options "-x -p -o=<appname>.par" are set and option "-n" is unset. This default always overrides whatever you specify
       by catalyst_par_options().

   catalyst_par_script($script)
   catalyst_par_usage($usage)
AUTHORS
       Catalyst Contributors, see Catalyst.pm

LICENSE
       This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2011-08-16					    Module::Install::Catalyst(3pm)