8 Usage: $0 [-h] [-a argstring] [-s stripsuffix] [files]
9 -a argstring arguments to invoke perl with in generated file
10 Defaults to "-x -S %0 %*" on WindowsNT,
11 "-x -S %0 %1 %2 %3 %4 %5 %6 %7 %8 %9" otherwise
12 -s stripsuffix strip this suffix from file before appending ".bat"
14 Can be a regex if it begins with `/'
20 warn($usage), exit(0) if !getopts('ha:s:',\%OPT) or $OPT{'h'};
21 $OPT{'a'} = ($^O eq 'MSWin32' and &Win32::IsWinNT
23 : '-x -S %0 %1 %2 %3 %4 %5 %6 %7 %8 %9')
24 unless exists $OPT{'a'};
25 ($OPT{'a2'} = $OPT{'a'} ) =~ s/\%0/\%0.bat/g;
26 $OPT{'s'} = '.pl' unless exists $OPT{'s'};
27 $OPT{'s'} = ($OPT{'s'} =~ m|^/([^/]*)| ? $1 : "\Q$OPT{'s'}\E");
29 (my $head = <<EOT) =~ s/^\t//gm;
32 if not exist \%0.bat goto over
40 my $headlines = 2 + ($head =~ tr/\n/\n/);
41 my $tail = "__END__\n:endofperl\n";
43 @ARGV = ('-') unless @ARGV;
52 my $linenum = $headlines;
54 open( FILE, $_ ) or die "$0: Can't open $_: $!";
56 foreach $line ( @file ) {
58 if ( $line =~ /^:endofperl/) {
59 warn "$0: $_ has already been converted to a batch file!\n";
62 if ( not $linedone and $line =~ /^#!.*perl/ ) {
63 $line .= "#line $linenum\n";
69 $_ .= '.bat' unless /\.bat$/i or /^-$/;
70 open( FILE, ">$_" ) or die "Can't open $_: $!";
72 print FILE "#!perl\n#line " . ($headlines+1) . "\n" unless $linedone;
73 print FILE @file, $tail;
81 pl2bat - wrap perl code into a batch file
85 B<pl2bat> [B<-h>] S<[B<-a> I<argstring>]> S<[B<-s> I<stripsuffix>]> [files]
89 This utility converts a perl script into a batch file that can be
90 executed on DOS-like operating systems.
92 Note that by default, the ".pl" suffix will be stripped before adding
93 a ".bat" suffix to the supplied file names. This can be controlled
94 with the C<-s> option.
96 The default behavior on WindowsNT is to generate a batch file that
97 uses the C<%*> construct to refer to all the command line arguments
98 that were given to it, so you'll need to make sure that works on your
99 variant of the command shell. It is known to work in the cmd.exe shell
100 under WindowsNT. 4DOS/NT users will want to put a C<ParameterChar = *>
101 line in their initialization file, or execute C<setdos /p*> in
102 the shell startup file. On Windows95 and other platforms a nine
103 argument limit is imposed on command-line arguments given to the
104 generated batch file, since they may not support C<%*> in batch files.
105 This can be overridden using the C<-a> option.
111 =item B<-a> I<argstring>
113 Arguments to invoke perl with in generated batch file. Defaults to
114 S<"-x -S %0 %*"> on WindowsNT, S<"-x -S %0 %1 %2 %3 %4 %5 %6 %7 %8 %9">
117 =item B<-s> I<stripsuffix>
119 Strip a suffix string from file name before appending a ".bat"
120 suffix. The suffix is not case-sensitive. It can be a regex if it
121 begins with `/' (the trailing '/' being optional. Defaults to ".pl".
125 Show command line usage.
131 C:\> pl2bat foo.pl bar.PM
132 [..creates foo.bat, bar.PM.bat..]
134 C:\> pl2bat -s "/\.pl|\.pm/" foo.pl bar.PM
135 [..creates foo.bat, bar.bat..]
137 C:\> pl2bat < somefile > another.bat
139 C:\> pl2bat > another.bat
140 print scalar reverse "rekcah lrep rehtona tsuj\n";
142 [..another.bat is now a certified japh application..]
146 C<$0> will contain the full name, including the ".bat" suffix
147 when the generated batch file runs. If you don't like this,
148 see runperl.bat for an alternative way to invoke perl scripts.
150 Default behavior is to invoke Perl with the -S flag, so Perl will
151 search the PATH to find the script. This may have undesirable
156 perl, perlwin32, runperl.bat