home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _78de7758e341b001c8237a4e8aaf185d < prev    next >
Encoding:
Text File  |  2000-03-23  |  5.7 KB  |  130 lines
  1. <HTML>
  2. <HEAD>
  3. <TITLE>README.machten - Perl version 5 on Power MachTen systems</TITLE>
  4. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  5. <LINK REV="made" HREF="mailto:">
  6. </HEAD>
  7.  
  8. <BODY>
  9. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  10. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  11. <STRONG><P CLASS=block> README.machten - Perl version 5 on Power MachTen systems</P></STRONG>
  12. </TD></TR>
  13. </TABLE>
  14.  
  15. <A NAME="__index__"></A>
  16. <!-- INDEX BEGIN -->
  17.  
  18. <UL>
  19.  
  20.     <LI><A HREF="#name">NAME</A></LI>
  21.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  22.     <UL>
  23.  
  24.         <LI><A HREF="#compiling perl 5 on machten">Compiling Perl 5 on MachTen</A></LI>
  25.         <LI><A HREF="#failures during make test">Failures during <CODE>make test</CODE></A></LI>
  26.         <LI><A HREF="#using external modules">Using external modules</A></LI>
  27.         <LI><A HREF="#building external modules">Building external modules</A></LI>
  28.     </UL>
  29.  
  30.     <LI><A HREF="#author">AUTHOR</A></LI>
  31.     <LI><A HREF="#date">DATE</A></LI>
  32. </UL>
  33. <!-- INDEX END -->
  34.  
  35. <HR>
  36. <P>
  37. <H1><A NAME="name">NAME</A></H1>
  38. <P>README.machten - Perl version 5 on Power MachTen systems</P>
  39. <P>
  40. <HR>
  41. <H1><A NAME="description">DESCRIPTION</A></H1>
  42. <P>This document describes how to build Perl 5 on Power MachTen systems,
  43. and discusses a few wrinkles in the implementation.</P>
  44. <P>
  45. <H2><A NAME="compiling perl 5 on machten">Compiling Perl 5 on MachTen</A></H2>
  46. <P>To compile perl under MachTen 4.1.4 (and probably earlier versions):</P>
  47. <PRE>
  48.   ./Configure -de
  49.   make
  50.   make test
  51.   make install</PRE>
  52. <P>This builds and installs a statically-linked perl; MachTen's dynamic
  53. linking facilities are not adequate to support Perl's use of
  54. dynamically linked libraries.  (See <EM>hints/machten.sh</EM> for more
  55. information.)</P>
  56. <P>You should have at least 32 megabytes of free memory on your
  57. system before running the <CODE>make</CODE> command.</P>
  58. <P>For much more information on building perl -- for example, on how to
  59. change the default installation directory -- see <EM>INSTALL</EM>.</P>
  60. <P>
  61. <H2><A NAME="failures during make test">Failures during <CODE>make test</CODE></A></H2>
  62. <DL>
  63. <DT><STRONG><A NAME="item_op%2Flexassign%2Et">op/lexassign.t</A></STRONG><BR>
  64. <DD>
  65. This test may fail when first run after building perl.  It does not
  66. fail subsequently.  The cause is unknown.
  67. <P></P>
  68. <DT><STRONG><A NAME="item_pragma%2Fwarnings%2Et">pragma/warnings.t</A></STRONG><BR>
  69. <DD>
  70. Test 257 fails due to a failure to warn about attempts to read from a
  71. filehandle which is a duplicate of stdout when stdout is attached to a
  72. pipe.  The output of the test contains a block comment which discusses
  73. a different failure, not applicable to MachTen.
  74. <P>The root of the problem is that Machten does not assign a file type to
  75. either end of a pipe (see <A HREF="../../lib/File/stat.html">the stat manpage</A>), resulting, among other things
  76. in Perl's <CODE>-p</CODE> test failing on file descriptors belonging to pipes.
  77. As a result, perl becomes confused, and the test for reading from a
  78. write-only file fails.  I am reluctant to patch perl to get around
  79. this, as it's clearly an OS bug (about which Tenon has been informed),
  80. and limited in its effect on practical Perl programs.</P>
  81. <P></P></DL>
  82. <P>
  83. <H2><A NAME="using external modules">Using external modules</A></H2>
  84. <P>If warnings are enabled with Perl's <CODE>-w</CODE> command-line flag, you are
  85. likely to see warnings when using external modules containing XS
  86. (compiled) code:</P>
  87. <PRE>
  88.   Subroutine DynaLoader::dl_error redefined at /usr/local/lib/perl5/5.6.0/powerpc-machten/DynaLoader.pm line 93.</PRE>
  89. <P>This is a harmless consequence of the static linking used for MachTen
  90. perl.  You can suppress the warnings by using the more modern
  91. <CODE>-Mwarnings</CODE> instead of the traditional <CODE>-w</CODE>.  (See <A HREF="../../lib/Pod/perllexwarn.html">the perllexwarn manpage</A>.)</P>
  92. <P>
  93. <H2><A NAME="building external modules">Building external modules</A></H2>
  94. <P>To add an external module to perl, build in the normal way, which
  95. is documented in <A HREF="../../lib/ExtUtils/MakeMaker.html">the ExtUtils::MakeMaker manpage</A>, or which can be driven
  96. automatically by the CPAN module (see <A HREF="../../lib/CPAN.html">the CPAN manpage</A>), which is part of the
  97. standard distribution.  If wou want to install a
  98. module contains XS code (C or C++ source which compiles to object code
  99. for linking with perl), you will have to replace your perl binary with
  100. a new version containing the new statically-linked object module.  The
  101. build process tells you how to do this.</P>
  102. <P>There is a gotcha, however, which users usually encounter immediately
  103. they respond to CPAN's invitation to <CODE>install Bundle::CPAN</CODE>. When
  104. installing a <EM>bundle</EM> -- a group of modules which together achieve
  105. some particular purpose, the installation process for later modules in
  106. the bundle tends to assume that earlier modules have been fully
  107. installed and are available for use.  This is not true on a
  108. statically-linked system for earlier modules which contain XS code.
  109. As a result the installation of the bundle fails.  The work-around is
  110. not to install the bundle as a one-shot operation, but instead to see
  111. what modules it contains, and install these one-at-a-time by hand in
  112. the order given.</P>
  113. <P>
  114. <HR>
  115. <H1><A NAME="author">AUTHOR</A></H1>
  116. <P>Dominic Dunlop <<A HREF="mailto:domo@computer.org">domo@computer.org</A>></P>
  117. <P>
  118. <HR>
  119. <H1><A NAME="date">DATE</A></H1>
  120. <P>Version 1.0 2000-03-22</P>
  121. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  122. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  123. <STRONG><P CLASS=block> README.machten - Perl version 5 on Power MachTen systems</P></STRONG>
  124. </TD></TR>
  125. </TABLE>
  126.  
  127. </BODY>
  128.  
  129. </HTML>
  130.