home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _95b99489e6c7f5788c5537bc54f486d6 < prev    next >
Text File  |  2000-03-23  |  4KB  |  92 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>ExtUtils::Install - install files from here to there</TITLE>
  5. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> ExtUtils::Install - install files from here to there</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25. </UL>
  26. <!-- INDEX END -->
  27.  
  28. <HR>
  29. <P>
  30. <H1><A NAME="name">NAME</A></H1>
  31. <P>ExtUtils::Install - install files from here to there</P>
  32. <P>
  33. <HR>
  34. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  35. <UL>
  36. <LI>Linux</LI>
  37. <LI>Solaris</LI>
  38. <LI>Windows</LI>
  39. </UL>
  40. <HR>
  41. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  42. <P><STRONG>use ExtUtils::Install;</STRONG></P>
  43. <P><STRONG>install($hashref,$verbose,$nonono);</STRONG></P>
  44. <P><STRONG>uninstall($packlistfile,$verbose,$nonono);</STRONG></P>
  45. <P><STRONG>pm_to_blib($hashref);</STRONG></P>
  46. <P>
  47. <HR>
  48. <H1><A NAME="description">DESCRIPTION</A></H1>
  49. <P>Both <CODE>install()</CODE> and <CODE>uninstall()</CODE> are specific to the way
  50. ExtUtils::MakeMaker handles the installation and deinstallation of
  51. perl modules. They are not designed as general purpose tools.</P>
  52. <P><CODE>install()</CODE> takes three arguments. A reference to a hash, a verbose
  53. switch and a don't-really-do-it switch. The hash ref contains a
  54. mapping of directories: each key/value pair is a combination of
  55. directories to be copied. Key is a directory to copy from, value is a
  56. directory to copy to. The whole tree below the ``from'' directory will
  57. be copied preserving timestamps and permissions.</P>
  58. <P>There are two keys with a special meaning in the hash: ``read'' and
  59. ``write''. After the copying is done, install will write the list of
  60. target files to the file named by <CODE>$hashref->{write}</CODE>. If there is
  61. another file named by <CODE>$hashref->{read}</CODE>, the contents of this file will
  62. be merged into the written file. The read and the written file may be
  63. identical, but on AFS it is quite likely that people are installing to a
  64. different directory than the one where the files later appear.</P>
  65. <P><CODE>install_default()</CODE> takes one or less arguments.  If no arguments are 
  66. specified, it takes $ARGV[0] as if it was specified as an argument.  
  67. The argument is the value of MakeMaker's <CODE>FULLEXT</CODE> key, like <EM>Tk/Canvas</EM>.  
  68. This function calls <CODE>install()</CODE> with the same arguments as the defaults 
  69. the MakeMaker would use.</P>
  70. <P>The argument-less form is convenient for install scripts like</P>
  71. <PRE>
  72.   perl -MExtUtils::Install -e install_default Tk/Canvas</PRE>
  73. <P>Assuming this command is executed in a directory with a populated <EM>blib</EM> 
  74. directory, it will proceed as if the <EM>blib</EM> was build by MakeMaker on 
  75. this machine.  This is useful for binary distributions.</P>
  76. <P><CODE>uninstall()</CODE> takes as first argument a file containing filenames to be
  77. unlinked. The second argument is a verbose switch, the third is a
  78. no-don't-really-do-it-now switch.</P>
  79. <P><CODE>pm_to_blib()</CODE> takes a hashref as the first argument and copies all keys
  80. of the hash to the corresponding values efficiently. Filenames with
  81. the extension pm are autosplit. Second argument is the autosplit
  82. directory.</P>
  83. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  84. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  85. <STRONG><P CLASS=block> ExtUtils::Install - install files from here to there</P></STRONG>
  86. </TD></TR>
  87. </TABLE>
  88.  
  89. </BODY>
  90.  
  91. </HTML>
  92.