/ 
Parse-Eyapp-1.139
River stage one • 1 direct dependent • 4 total dependents
/ Makefile.PL

NAME

Makefile.PL - Makefile generator for Parse::Eyapp. Developer notes

SYNOPSIS

  • When working as a developer run

    source etc/myscript

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

    PATH                  to execute eyapp, treereg, etc.
PERL5LIB              to find any modules required
DEVELOPER             used by many skip tests
MACHINES              a white space string containing the machines
                      for the 'remotetest' target
PUBLIC_PLACE          A dir to save the pdf files

  • After you checked out from the svn repository this project, and set the environment variables, try to produce a Makefile. You will surely get a warning:

    pl@nereida:~/src/perl/Parse-Eyapp$ perl Makefile.PL
Checking if your kit is complete...
Warning: the following files are missing in your kit:
        lib/Parse/Eyapp/Parse.pm
        lib/Parse/Eyapp/Treeregexp.pm
Please inform the author.
Writing Makefile for Parse::Eyapp

    This is because the files lib/Parse/Eyapp/Parse.pm and lib/Parse/Eyapp/Treeregexp.pm are derived from the respective grammars (lib/Parse/Eyapp/Parse.yp and lib/Parse/Eyapp/Treeregexp.yp). Compile the grammars using the target release:

    pl@nereida:~/src/perl/Parse-Eyapp$ make release
yapp -n -m 'Parse::Eyapp::Parse' -o 'lib/Parse/Eyapp/Parse.pm' lib/Parse/Eyapp/Parse.yp
PERL5LIB=lib; eyapp -n -m 'Parse::Eyapp::Parse' -o 'lib/Parse/Eyapp/Parse.pm' lib/Parse/Eyapp/Parse.yp
PERL5LIB=lib; /usr/bin/perl -I./lib eyapp -v -n -m Parse::Eyapp::Treeregparser -o lib/Parse/Eyapp/Treeregexp.pm lib/Parse/Eyapp/Treeregexp.yp
rm -fR Parse-Eyapp-*.tar.gz

    This target uses Parse::Yapp to make a first compilation. Then uses bootstrap and eyapp compiles itself. Be sure you installed Parse::Yapp.

  • Before realising a distribution in CPAN via PAUSE do:

    make publicdist

    Remember to change the version number in Parse::Eyapp::Driver and Parse::Eyapp

  • To build the *.html files:

    make html

  • To build pdf files:

    make pdfs

  • To build dvi files:

    make dvis

  • To make public the *.html files:

    make publichtml

  • To make public pdf files:

    make publicpdf

  • To delete generated docs (*.html, *.pdf, etc.)

    make docclean

  • To run the tests on remote machines

    make remotetest

    (Set the environment variable MACHINES). The module GRID::Machine must be available.

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

    make coverage

DEPENDENCIES

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

  • Template toolkit

  • Pod2LaTeX

  • LaTeX

  • mpod2html

  • Devel::Cover

  • Parse::Yapp

  • GRID::Machine

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.