Ken Williams wrote:
On Feb 15, 2008 3:03 PM, Elliot Shank <[EMAIL PROTECTED]> wrote:
It's not documented, but it doesn't have a leading underscore
either. Can I count on it being available in the future, or do I
need to handle this type of thing myself?
Yeah, we should document it and make it available for good. Or evil.
Even if we change the name or factor it out, we'll be sure to keep a
wrapper there for backward compatibility.
Bonus points if you provide a doc patch, because I'm not sure I could
write a decent description of it myself.
How's this?
Index: lib/Module/Build/API.pod
===================================================================
--- lib/Module/Build/API.pod (revision 10805)
+++ lib/Module/Build/API.pod (working copy)
@@ -1175,6 +1175,19 @@
Module::Build's main support for configuration of installed modules.
See also L<Module::Build::Authoring/"SAVING CONFIGURATION INFORMATION">.
+=item fix_shebang_line(@files)
+
+[version 0.??]
+
+Modify any "shebang" line in the specified files to use the path to the
+perl executable being used for the current build. Files are modified
+in-place. The existing shebang line must have a command that contains
+"C<perl>"; arguments to the command do not count. In particular, this
+means that the use of C<#!/usr/bin/env perl> will not be changed.
+
+For an explanation of shebang lines, see
+L<http://en.wikipedia.org/wiki/Shebang_%28Unix%29>.
+
=item have_c_compiler()
[version 0.21]
