ExtUtils::PL2Bat(3perl) Perl Programmers Reference GuideExtUtils::PL2Bat(3perl)
NAME
ExtUtils::PL2Bat - Batch file creation to run perl scripts on Windows
VERSION
version 0.005
OVERVIEW
This module converts a perl script into a batch file that can be
executed on Windows/DOS-like operating systems. This is intended to
allow you to use a Perl script like regular programs and batch files
where you just enter the name of the script [probably minus the
extension] plus any command-line arguments and the script is found in
your PATH and run.
FUNCTIONS
pl2bat(%opts)
This function takes a perl script and write a batch file that contains
the script. This is sometimes necessary
• "in"
The name of the script that is to be batchified. This argument
is mandatory.
• "out"
The name of the output batch file. If not given, it will be
generated using "in" and "stripsuffix".
• "ntargs"
Arguments to invoke perl with in generated batch file when run
from Windows NT. Defaults to '-x -S %0 %*'.
• "otherargs"
Arguments to invoke perl with in generated batch file except
when run from Windows NT (ie. when run from DOS, Windows 3.1, or
Windows 95). Defaults to
'-x -S "%0" %1 %2 %3 %4 %5 %6 %7 %8 %9'.
• "stripsuffix"
Strip a suffix string from file name before appending a ".bat"
suffix. The suffix is not case-sensitive. It can be a regex or
a string and a trailing "$" is always assumed). Defaults to
"qr/\.plx?/".
• "usewarnings"
With the "usewarnings" option, " -w" is added after the value of
$Config{startperl}. If a line matching "/^#!.*perl/" already
exists in the script, then it is not changed and the -w option
is ignored.
• "update"
If the script appears to have already been processed by pl2bat,
then the script is skipped and not processed unless "update" was
specified. If "update" is specified, the existing preamble is
replaced.
ACKNOWLEDGEMENTS
This code was taken from Module::Build and then modified; which had
taken it from perl's pl2bat script. This module is an attempt at
unifying all three implementations.
AUTHOR
Leon Timmermans <leont@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2015 by Leon Timmermans.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
perl v5.40.1 2026-08-30 ExtUtils::PL2Bat(3perl)
Generated by dwww version 1.16 on Sat Oct 3 07:41:11 CEST 2026.