NAME

pptemplate - script to generate Makefile.PL and PP file skeleton

SYNOPSIS

# generate Makefile.PL and mymodule.pd in PDL-MyModule
pptemplate PDL::MyModule;

DESCRIPTION

The pptemplate script is the easiest way to start a new module for PDL that contains PP code (see also PDL::PP). The usage is simply

pptemplate modulename;

As a result pptemplate will generate the usual directory structure you would expect for a CPAN module: if you called pptemplate as

pptemplate PDL::CleverAlgs::Mymod;

Then you get the following files and directories:

PDL-CleverAlgs-Mymod
|-- lib
|   |-- PDL
|       |-- CleverAlgs
|           |-- MyMod.pd
|-- t
|   |-- basic.t
|-- Makefile.PL
|   MANIFEST
|   MANIFEST.SKIP
|   .gitignore

Adapt MyMod.pd to your needs and then you can build and test the module as usual: From the directory PDL-CleverAlgs-Mymod:

$ perl Makefile.pl   # To create a Makefile
$ make               # Build the module in blib
$ make test          # Run the tests
$ prove -vb          # ...or run the tests with prove

pptemplate will stop if the directory to be created already exists, to avoid accidents. Move it out of the way if you really want to scrap it.

The files MANIFEST, MANIFEST.SKIP and .gitignore are for bookkeeping: They avoid that temporary files created by building the module end up in a git repository or a CPAN distrubution.

As of 2.096, the "internal mode" of this script has been removed, and it creates the files using the new "deep mode". This is because the earlier practice of incorporating vast numbers of modules into the main PDL distribution has been rethought due to the problems it causes. Use this script to make it easy to create new CPAN-distributed PDL modules.

BUGS

Feedback and bug reports are welcome.

COPYRIGHT

Copyright (c) 2001, Christian Soeller. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as PDL itself (see http://pdl.perl.org).