MAN page from Old RedHat 5.X perl-5.004-4.i386.rpm

ExtUtils::Install

Section: Perl Programmers Reference Guide (3)
Updated: perl 5.004, patch 04
Index

NAME

ExtUtils::Install - install files from here to there

SYNOPSIS

use ExtUtils::Install;

install($hashref,$verbose,$nonono);

uninstall($packlistfile,$verbose,$nonono);

pm_to_blib($hashref);

DESCRIPTION

Both install() and uninstall() are specific to the wayExtUtils::MakeMaker handles the installation and deinstallation ofperl modules. They are not designed as general purpose tools.

install() takes three arguments. A reference to a hash, a verboseswitch and a don't-really-do-it switch. The hash ref contains amapping of directories: each key/value pair is a combination ofdirectories to be copied. Key is a directory to copy from, value is adirectory to copy to. The whole tree below the ``from'' directory willbe copied preserving timestamps and permissions.

There are two keys with a special meaning in the hash: ``read'' and``write''. After the copying is done, install will write the list oftarget files to the file named by $hashref->{write}. If there isanother file named by $hashref->{read}, the contents of this file willbe merged into the written file. The read and the written file may beidentical, but on AFS it is quite likely, people are installing to adifferent directory than the one where the files later appear.

install_default() takes one or less arguments. If no arguments are specified, it takes $ARGV[0] as if it was specified as an argument. The argument is the value of MakeMaker's FULLEXT key, like Tk/Canvas. This function calls install() with the same arguments as the defaults the MakeMaker would use.

The argumement-less form is convenient for install scripts like

  perl -MExtUtils::Install -e install_default Tk/Canvas

Assuming this command is executed in a directory with populated blib directory, it will proceed as if the blib was build by MakeMaker on this machine. This is useful for binary distributions.

uninstall() takes as first argument a file containing filenames to beunlinked. The second argument is a verbose switch, the third is ano-don't-really-do-it-now switch.

pm_to_blib() takes a hashref as the first argument and copies all keysof the hash to the corresponding values efficiently. Filenames withthe extension pm are autosplit. Second argument is the autosplitdirectory.

This document was created byman2html,using the manual pages.