NAME

Makefile.PL - Makefile generator for GRID::Machine. Developer notes

SYNOPSIS

  • When working as a developer place in etc/ a script to customize your environment, then do s.t. like:

    source etc/casianoperl5lib

    to set the appropriate environment variables. Some variables to set are:

    PATH                  to execute scripts
    PERL5LIB              to find any modules required
    DEVELOPER             used by many skip tests
    GRID_REMOTE_MACHINE   the remote machine used for testing (see C<t/*.t> files)
    MACHINES              a white space string containing the machines
                          for the 'remotetest' target
  • To build the documentation, you need Template installed. Issue the command:

    $ make -f makepods

    and the .pod files will be built from the templates in tt2/

  • To build the *.html files:

    $ make -f makepods html
  • To build pdf files:

    make -f makepods pdf
  • To delete generated docs (*.html, *.pdf, etc.)

    make -f makepods clean
  • To run the tests on remote machines:

    make remotetest

    (Set the environment variable GRID_REMOTE_MACHINE to the remote machine.

  • To use Devel::Cover to study test coverage:

    make coverage
  • To produce tags:

    make tags

DEPENDENCIES

To use this Makefile.PL as developer is convenient to have installed:

  • Template toolkit

  • Pod2LaTeX

  • LaTeX

  • mpod2html

  • Devel::Cover

AUTHOR

Casiano Rodriguez-Leon (casiano@ull.es)

LICENCE AND COPYRIGHT

Copyright (c) 2006-2009 Casiano Rodriguez-Leon (casiano@ull.es). All rights reserved.

These modules are free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.