home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _69ece1f2226442937e2b688aa8283260 < prev    next >
Encoding:
Text File  |  2000-03-23  |  9.2 KB  |  234 lines
  1. <HTML>
  2. <HEAD>
  3. <TITLE>perlamiga - Perl under Amiga OS</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> perlamiga - Perl under Amiga OS</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="#synopsis">SYNOPSIS</A></LI>
  22.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  23.     <UL>
  24.  
  25.         <LI><A HREF="#prerequisites">Prerequisites</A></LI>
  26.         <LI><A HREF="#starting perl programs under amigaos">Starting Perl programs under AmigaOS</A></LI>
  27.         <LI><A HREF="#shortcomings of perl under amigaos">Shortcomings of Perl under AmigaOS</A></LI>
  28.     </UL>
  29.  
  30.     <LI><A HREF="#installation">INSTALLATION</A></LI>
  31.     <LI><A HREF="#accessing documentation">Accessing documentation</A></LI>
  32.     <UL>
  33.  
  34.         <LI><A HREF="#manpages">Manpages</A></LI>
  35.         <LI><A HREF="#html"><STRONG>HTML</STRONG></A></LI>
  36.         <LI><A HREF="#gnu info files"><STRONG>GNU</STRONG> <CODE>info</CODE> files</A></LI>
  37.         <LI><A HREF="#latex docs"><CODE>LaTeX</CODE> docs</A></LI>
  38.     </UL>
  39.  
  40.     <LI><A HREF="#build">BUILD</A></LI>
  41.     <UL>
  42.  
  43.         <LI><A HREF="#prerequisites">Prerequisites</A></LI>
  44.         <LI><A HREF="#getting the perl source">Getting the perl source</A></LI>
  45.         <LI><A HREF="#making">Making</A></LI>
  46.         <LI><A HREF="#testing">Testing</A></LI>
  47.         <LI><A HREF="#installing the built perl">Installing the built perl</A></LI>
  48.     </UL>
  49.  
  50.     <LI><A HREF="#author">AUTHOR</A></LI>
  51.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  52. </UL>
  53. <!-- INDEX END -->
  54.  
  55. <HR>
  56. <P>
  57. <H1><A NAME="name">NAME</A></H1>
  58. <P>perlamiga - Perl under Amiga OS</P>
  59. <P>
  60. <HR>
  61. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  62. <P>One can read this document in the following formats:</P>
  63. <PRE>
  64.         man <A HREF="../../lib/Pod/perlamiga.html">perlamiga</A>
  65.         multiview <A HREF="../../lib/Pod/perlamiga.html">perlamiga</A>.guide</PRE>
  66. <P>to list some (not all may be available simultaneously), or it may
  67. be read <EM>as is</EM>: either as <EM>README.amiga</EM>, or <EM>pod/perlamiga.pod</EM>.</P>
  68. <P>
  69. <HR>
  70. <H1><A NAME="description">DESCRIPTION</A></H1>
  71. <P>
  72. <H2><A NAME="prerequisites">Prerequisites</A></H2>
  73. <DL>
  74. <DT><STRONG><A NAME="item_Unix_emulation_for_AmigaOS%3A_ixemul%2Elibrary"><STRONG>Unix emulation for AmigaOS: ixemul.library</STRONG></A></STRONG><BR>
  75. <DD>
  76. You need the Unix emulation for AmigaOS, whose most important part is
  77. <STRONG>ixemul.library</STRONG>. For a minimum setup, get the following archives from
  78. <A HREF="ftp://ftp.ninemoons.com/pub/ade/current">ftp://ftp.ninemoons.com/pub/ade/current</A> or a mirror:
  79. <P>ixemul-46.0-bin.lha
  80. ixemul-46.0-env-bin.lha
  81. pdksh-4.9-bin.lha
  82. ADE-misc-bin.lha</P>
  83. <P>Note that there might be newer versions available by the time you read
  84. this.</P>
  85. <P>Note also that this is a minimum setup; you might want to add other
  86. packages of <STRONG>ADE</STRONG> (the <EM>Amiga Developers Environment</EM>).</P>
  87. <P></P>
  88. <DT><STRONG><A NAME="item_Version_of_Amiga_OS"><STRONG>Version of Amiga OS</STRONG></A></STRONG><BR>
  89. <DD>
  90. You need at the very least AmigaOS version 2.0. Recommended is version 3.1.
  91. <P></P></DL>
  92. <P>
  93. <H2><A NAME="starting perl programs under amigaos">Starting Perl programs under AmigaOS</A></H2>
  94. <P>Start your Perl program <EM>foo</EM> with arguments <CODE>arg1 arg2 arg3</CODE> the
  95. same way as on any other platform, by</P>
  96. <PRE>
  97.         perl foo arg1 arg2 arg3</PRE>
  98. <P>If you want to specify perl options <CODE>-my_opts</CODE> to the perl itself (as
  99. opposed to to your program), use</P>
  100. <PRE>
  101.         perl -my_opts foo arg1 arg2 arg3</PRE>
  102. <P>Alternately, you can try to get a replacement for the system's <STRONG>Execute</STRONG>
  103. command that honors the #!/usr/bin/perl syntax in scripts and set the s-Bit
  104. of your scripts. Then you can invoke your scripts like under UNIX with</P>
  105. <PRE>
  106.         foo arg1 arg2 arg3</PRE>
  107. <P>(Note that having *nixish full path to perl <EM>/usr/bin/perl</EM> is not
  108. necessary, <EM>perl</EM> would be enough, but having full path would make it
  109. easier to use your script under *nix.)</P>
  110. <P>
  111. <H2><A NAME="shortcomings of perl under amigaos">Shortcomings of Perl under AmigaOS</A></H2>
  112. <P>Perl under AmigaOS lacks some features of perl under UNIX because of
  113. deficiencies in the UNIX-emulation, most notably:</P>
  114. <DL>
  115. <DT><STRONG><A NAME="item_fork"><CODE>fork()</CODE></A></STRONG><BR>
  116. <DD>
  117. <DT><STRONG><A NAME="item_some_features_of_the_UNIX_filesystem_regarding_lin">some features of the UNIX filesystem regarding link count and file dates</A></STRONG><BR>
  118. <DD>
  119. <DT><STRONG><A NAME="item_operation">inplace operation (the -i switch) without backup file</A></STRONG><BR>
  120. <DD>
  121. <DT><STRONG><A NAME="item_umask"><CODE>umask()</CODE> works, but the correct permissions are only set when the file is
  122.       finally close()d</A></STRONG><BR>
  123. <DD>
  124. </DL>
  125. <P>
  126. <HR>
  127. <H1><A NAME="installation">INSTALLATION</A></H1>
  128. <P>Change to the installation directory (most probably ADE:), and
  129. extract the binary distribution:</P>
  130. <P>lha -mraxe x perl-5.003-bin.lha</P>
  131. <P>or</P>
  132. <P>tar xvzpf perl-5.003-bin.tgz</P>
  133. <P>(Of course you need lha or tar and gunzip for this.)</P>
  134. <P>For installation of the Unix emulation, read the appropriate docs.</P>
  135. <P>
  136. <HR>
  137. <H1><A NAME="accessing documentation">Accessing documentation</A></H1>
  138. <P>
  139. <H2><A NAME="manpages">Manpages</A></H2>
  140. <P>If you have <CODE>man</CODE> installed on your system, and you installed perl
  141. manpages, use something like this:</P>
  142. <PRE>
  143.         man <A HREF="../../lib/Pod/perlfunc.html">perlfunc</A>
  144.         man less
  145.         man ExtUtils.MakeMaker</PRE>
  146. <P>to access documentation for different components of Perl. Start with</P>
  147. <PRE>
  148.         man perl</PRE>
  149. <P>Note: You have to modify your man.conf file to search for manpages
  150. in the /ade/lib/perl5/man/man3 directory, or the man pages for the
  151. perl library will not be found.</P>
  152. <P>Note that dot (<EM>.</EM>) is used as a package separator for documentation
  153. for packages, and as usual, sometimes you need to give the section - <CODE>3</CODE>
  154. above - to avoid shadowing by the <EM>less(1) manpage</EM>.</P>
  155. <P>
  156. <H2><A NAME="html"><STRONG>HTML</STRONG></A></H2>
  157. <P>If you have some WWW browser available, you can build <STRONG>HTML</STRONG> docs.
  158. Cd to directory with <EM>.pod</EM> files, and do like this</P>
  159. <PRE>
  160.         cd /ade/lib/perl5/pod
  161.         pod2html</PRE>
  162. <P>After this you can direct your browser the file <EM>perl.html</EM> in this
  163. directory, and go ahead with reading docs.</P>
  164. <P>Alternatively you may be able to get these docs prebuilt from <CODE>CPAN</CODE>.</P>
  165. <P>
  166. <H2><A NAME="gnu info files"><STRONG>GNU</STRONG> <CODE>info</CODE> files</A></H2>
  167. <P>Users of <CODE>Emacs</CODE> would appreciate it very much, especially with
  168. <CODE>CPerl</CODE> mode loaded. You need to get latest <CODE>pod2info</CODE> from <CODE>CPAN</CODE>,
  169. or, alternately, prebuilt info pages.</P>
  170. <P>
  171. <H2><A NAME="latex docs"><CODE>LaTeX</CODE> docs</A></H2>
  172. <P>can be constructed using <CODE>pod2latex</CODE>.</P>
  173. <P>
  174. <HR>
  175. <H1><A NAME="build">BUILD</A></H1>
  176. <P>Here we discuss how to build Perl under AmigaOS.</P>
  177. <P>
  178. <H2><A NAME="prerequisites">Prerequisites</A></H2>
  179. <P>You need to have the latest <STRONG>ADE</STRONG> (Amiga Developers Environment)
  180. from <A HREF="ftp://ftp.ninemoons.com/pub/ade/current.">ftp://ftp.ninemoons.com/pub/ade/current.</A>
  181. Also, you need a lot of free memory, probably at least 8MB.</P>
  182. <P>
  183. <H2><A NAME="getting the perl source">Getting the perl source</A></H2>
  184. <P>You can either get the latest perl-for-amiga source from Ninemoons
  185. and extract it with:</P>
  186. <PRE>
  187.   tar xvzpf perl-5.004-src.tgz</PRE>
  188. <P>or get the official source from CPAN:</P>
  189. <PRE>
  190.   <A HREF="http://www.perl.com/CPAN/src/5.0">http://www.perl.com/CPAN/src/5.0</A></PRE>
  191. <P>Extract it like this</P>
  192. <PRE>
  193.   tar xvzpf perl5.004.tar.gz</PRE>
  194. <P>You will see a message about errors while extracting <EM>Configure</EM>. This
  195. is normal and expected. (There is a conflict with a similarly-named file
  196. <EM>configure</EM>, but it causes no harm.)</P>
  197. <P>
  198. <H2><A NAME="making">Making</A></H2>
  199. <PRE>
  200.   sh configure.gnu --prefix=/ade</PRE>
  201. <P>Now</P>
  202. <PRE>
  203.   make</PRE>
  204. <P>
  205. <H2><A NAME="testing">Testing</A></H2>
  206. <P>Now run</P>
  207. <PRE>
  208.   make test</PRE>
  209. <P>Some tests will be skipped because they need the <A HREF="#item_fork"><CODE>fork()</CODE></A> function:</P>
  210. <P><EM>io/pipe.t</EM>, <EM>op/fork.t</EM>, <EM>lib/filehand.t</EM>, <EM>lib/open2.t</EM>, <EM>lib/open3.t</EM>, 
  211. <EM>lib/io_pipe.t</EM>, <EM>lib/io_sock.t</EM></P>
  212. <P>
  213. <H2><A NAME="installing the built perl">Installing the built perl</A></H2>
  214. <P>Run</P>
  215. <PRE>
  216.   make install</PRE>
  217. <P>
  218. <HR>
  219. <H1><A NAME="author">AUTHOR</A></H1>
  220. <P>Norbert Pueschel, <A HREF="mailto:pueschel@imsdd.meb.uni-bonn.de">pueschel@imsdd.meb.uni-bonn.de</A></P>
  221. <P>
  222. <HR>
  223. <H1><A NAME="see also">SEE ALSO</A></H1>
  224. <P>perl(1).</P>
  225. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  226. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  227. <STRONG><P CLASS=block> perlamiga - Perl under Amiga OS</P></STRONG>
  228. </TD></TR>
  229. </TABLE>
  230.  
  231. </BODY>
  232.  
  233. </HTML>
  234.