```{index} single: ExtUtils::PL2Bat ``` # 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 ## 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.