.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "pptemplate 3pm"
.TH pptemplate 3pm 2024-05-12 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
pptemplate \- script to generate Makefile.PL and PP file skeleton
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 2
\&        # generate Makefile.PL and mymodule.pd in CWD
\&        pptemplate PDL::MyModule;
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBpptemplate\fR script is the easiest way to start a new module
for PDL that contains PP code (see also PDL::PP). The usage is simply
.PP
.Vb 1
\&  pptemplate modulename;
.Ve
.PP
As a result pptemplate will generate a perl Makefile for the new
module (\fIMakefile.PL\fR) that contains the minimal structure to
generate a module from PP code and also a skeleton file
for your new module.
.PP
The file will be called \fImymod.pd\fR if you called \f(CW\*(C`pptemplate\*(C'\fR as
.PP
.Vb 1
\&  pptemplate PDL::CleverAlgs::Mymod;
.Ve
.PP
I suppose you can work out the naming rule \f(CW\*(C`;)\*(C'\fR. If not resort to
experimentation or the source code.
.PP
\&\f(CW\*(C`pptemplate\*(C'\fR will refuse to overwrite existing files of the same name
to avoid accidents. Move them out of the way if you really want to scrap
them.
.SS Options
.IX Subsection "Options"
Currently there is only the \f(CW\*(C`\-i\*(C'\fR option which switches \f(CW\*(C`pptemplate\*(C'\fR
into the so called \fIinternal mode\fR.  It should only be used when you
are starting a new module within the main PDL tree that is supposed to
be part of the PDL distribution and the normal PDL build process, e.g.
.PP
.Vb 3
\&   cd PDL/IO;
\&   mkdir Mpthree; cd Mpthree;
\&   pptemplate \-i PDL::IO::Mpthree;
.Ve
.SH BUGS
.IX Header "BUGS"
Maybe \f(CW\*(C`;)\*(C'\fR.
Feedback and bug reports are welcome.
.SH COPYRIGHT
.IX Header "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>).