NAME

Gantry::Build - a Module::Build subclass for Gantry apps

SYNOPSIS

Sample Build.PL:

use strict;
use Gantry::Build;

my $build = Gantry::Build->new(
    build_web_directory => 'html',
    install_web_directories =>  {
        # XXX unix specific paths
        'dev'   => '/home/httpd/html/Contact',
        'qual'  => '/home/httpd/html/Contact',
        'prod'  => '/home/httpd/html/Contact',
    },
    create_makefile_pl => 'passthrough',
    license            => 'perl',
    module_name        => 'Contact',
    requires           => {
        'perl'      => '5',
        'Gantry'    => '3.0',
        'HTML::Prototype' => '0',
    },
    create_makefile_pl  => 'passthrough',

    # XXX unix specific paths
    script_files        => [ glob('bin/*') ],
    'recursive_test_files' => 1,

    # XXX unix specific paths
    install_path        => { script => '/usr/local/bin' },
);

$build->create_build_script;

DESCRIPTION

Use this module instead of Module::Build (which it subclasses). Use any or all of the Module::Build constructor keys as needed. Include these keys to make the module sing:

build_web_directory

Usually html. This is the top level directory of your web content. Put your content in subdirectories of this dir. Example: if you are in the build directory (the one where Build.PL lives), your templates should live in html/templates.

install_web_directories

This is a hash reference. The keys are what installing users will type, values are where the content from build_web_directory subdirectories will go.

METHODS

Except new, these methods are all internal or for use by Module::Build. They are documented to keep POD tests happy.

new

Just like Module::Build->new, but takes the extra parameters shown in the DESCRIPTION above.

ACTION_code

Standard Module::Build routine.

ACTION_install

Standard Module::Build routine.

AUTHOR

Phil Crow <philcrow2000@yahoo.com>

Tim Keefer <tkeefer@gmail.com>

COPYRIGHT and LICENSE

Copyright (C) 2005-6 by Phil Crow

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.6 or, at your option, any later version of Perl 5 you may have available.