NAME App::ChangeShebang - change shebang lines for relocatable perl SYNOPSIS > change-shebang /path/to/bin/script.pl > head -3 /path/to/bin/script.pl #!/bin/sh exec "$(dirname "$0")"/perl -x "$0" "$@" #!perl DESCRIPTION change-shebang changes shebang lines from #!/path/to/bin/perl to #!/bin/sh exec "$(dirname "$0")"/perl -x "$0" "$@" #!perl Why do we need this? Let's say you build perl with relocatable enabled (-Duserelocatableinc). Then the shebang lines of executable scripts point at the installation time perl binary path. So if you move your perl directory to other places, the shebang lines of executable scripts point at a wrong perl binary and we cannot execute scripts. Oops! A solution of that problem is to replace shebang lines by #!/bin/sh exec "$(dirname "$0")"/perl -x "$0" "$@" #!perl which means that scripts will be executed by the perl located in the same directory. SEE ALSO Relocatable installations in perl5100delta.pod https://github.com/shoichikaji/relocatable-perl https://github.com/shoichikaji/relocatable-perl-growthforecast AUTHOR Shoichi Kaji COPYRIGHT AND LICENSE Copyright 2018 Shoichi Kaji This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.