The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.