This utility is designed to build new perl binaries from existing
extensions on the fly. Called without any arguments it produces a new
binary with the name perl in the current directory. Intermediate files are produced in /tmp, if that is writeable, else in the current directory. The most important
intermediate file is a Makefile, that is used internally to call make. The new perl binary will consist

The -l switch lets you specify the name of a perl library to be linked into the
new binary. If you do not specify a library, makeaperl writes targets for
any libperl*.a it finds in the search path. The topmost target will be the one related to libperl.a.

With the -m switch you can provide a name for the Makefile that will be written
(default /tmp/Makefile.$$). Likewise specifies the
-o switch a name for the perl binary (default perl). The -t
switch lets you determine, in which directory the intermediate files should
be stored.

All object files and static extensions following on the command line will
be linked into the target file. If there are any directories specified on
the command line, these directories are searched for
*.a files, and all of the found ones will be linked in, too. If there is no directory named, then the contents of
$INC[0] are searched.

If the command fails, there is currently no other mechanism to adjust the
behaviour of the program than to alter the generated Makefile and run make by hand.

DISCLAIMER

We are painfully aware that these documents may contain incorrect links and
misformatted HTML. Such bugs lie in the automatic translation process
that automatically created the hundreds and hundreds of separate documents that you find here. Please do
not report link or formatting bugs, because we cannot fix
per-document problems. The only bug reports that will help us are those
that supply working patches to the installhtml or pod2html
programs, or to the Pod::HTML module itself, for which I and the entire
Perl community will shower you with thanks and praises.

If rather than formatting bugs, you encounter substantive content errors in these documents, such as mistakes in
the explanations or code, please use the perlbug utility included
with the Perl distribution.