mingw/html/pod/perlamiga.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>perlamiga - Perl under Amiga OS</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:" />
   8 </head>
   9
  10 <body style="background-color: white">
  11 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  12 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  13 <big><strong><span class="block">&nbsp;perlamiga - Perl under Amiga OS</span></strong></big>
  14 </td></tr>
  15 </table>
  16
  17 <p><a name="__index__"></a></p>
  18 <!-- INDEX BEGIN -->
  19
  20 <ul>
  21
  22         <li><a href="#name">NAME</a></li>
  23         <li><a href="#note">NOTE</a></li>
  24         <li><a href="#synopsis">SYNOPSIS</a></li>
  25         <li><a href="#description">DESCRIPTION</a></li>
  26         <ul>
  27
  28                 <li><a href="#prerequisites_for_compiling_perl_on_amigaos">Prerequisites for Compiling Perl on AmigaOS</a></li>
  29                 <li><a href="#starting_perl_programs_under_amigaos">Starting Perl programs under AmigaOS</a></li>
  30                 <li><a href="#shortcomings_of_perl_under_amigaos">Shortcomings of Perl under AmigaOS</a></li>
  31         </ul>
  32
  33         <li><a href="#installation">INSTALLATION</a></li>
  34         <li><a href="#accessing_documentation">Accessing documentation</a></li>
  35         <ul>
  36
  37                 <li><a href="#manpages_for_perl_on_amigaos">Manpages for Perl on AmigaOS</a></li>
  38                 <li><a href="#perl_html_documentation_on_amigaos">Perl HTML Documentation on AmigaOS</a></li>
  39                 <li><a href="#perl_gnu_info_files_on_amigaos">Perl GNU Info Files on AmigaOS</a></li>
  40                 <li><a href="#perl_latex_documentation_on_amigaos">Perl LaTeX Documentation on AmigaOS</a></li>
  41         </ul>
  42
  43         <li><a href="#building_perl_on_amigaos">BUILDING PERL ON AMIGAOS</a></li>
  44         <ul>
  45
  46                 <li><a href="#build_prerequisites_for_perl_on_amigaos">Build Prerequisites for Perl on AmigaOS</a></li>
  47                 <li><a href="#getting_the_perl_source_for_amigaos">Getting the Perl Source for AmigaOS</a></li>
  48                 <li><a href="#making_perl_on_amigaos">Making Perl on AmigaOS</a></li>
  49                 <li><a href="#testing_perl_on_amigaos">Testing Perl on AmigaOS</a></li>
  50                 <li><a href="#installing_the_built_perl_on_amigaos">Installing the built Perl on AmigaOS</a></li>
  51         </ul>
  52
  53         <li><a href="#perl_5_8_0_broken_in_amigaos">PERL 5.8.0 BROKEN IN AMIGAOS</a></li>
  54         <li><a href="#authors">AUTHORS</a></li>
  55         <li><a href="#see_also">SEE ALSO</a></li>
  56 </ul>
  57 <!-- INDEX END -->
  58
  59 <hr />
  60 <p>
  61 </p>
  62 <h1><a name="name">NAME</a></h1>
  63 <p>perlamiga - Perl under Amiga OS</p>
  64 <p>
  65 </p>
  66 <hr />
  67 <h1><a name="note">NOTE</a></h1>
  68 <p><strong>Perl 5.8.0 cannot be built in AmigaOS.  You can use either the
  69 maintenance release Perl 5.6.1 or the development release Perl 5.7.2
  70 in AmigaOS.  See <a href="#perl_5_8_0_broken_in_amigaos">PERL 5.8.0 BROKEN IN AMIGAOS</a> if you want to help
  71 fixing this problem.</strong></p>
  72 <p>
  73 </p>
  74 <hr />
  75 <h1><a name="synopsis">SYNOPSIS</a></h1>
  76 <p>One can read this document in the following formats:</p>
  77 <pre>
  78         man <a href="//C|\msysgit\mingw\html/pod/perlamiga.html">perlamiga</a>
  79         multiview <a href="//C|\msysgit\mingw\html/pod/perlamiga.html">perlamiga</a>.guide</pre>
  80 <p>to list some (not all may be available simultaneously), or it may
  81 be read <em>as is</em>: either as <em>README.amiga</em>, or <em>pod/perlamiga.pod</em>.</p>
  82 <p>A recent version of perl for the Amiga can be found at the Geek Gadgets
  83 section of the Aminet:</p>
  84 <pre>
  85       <a href="http://www.aminet.net/~aminet/dev/gg/index.html">http://www.aminet.net/~aminet/dev/gg/index.html</a></pre>
  86 <p>
  87 </p>
  88 <hr />
  89 <h1><a name="description">DESCRIPTION</a></h1>
  90 <p>
  91 </p>
  92 <h2><a name="prerequisites_for_compiling_perl_on_amigaos">Prerequisites for Compiling Perl on AmigaOS</a></h2>
  93 <dl>
  94 <dt><strong><a name="item_unix_emulation_for_amigaos_3a_ixemul_2elibrary"><strong>Unix emulation for AmigaOS: ixemul.library</strong></a></strong>
  95
  96 <dd>
  97 <p>You need the Unix emulation for AmigaOS, whose most important part is
  98 <strong>ixemul.library</strong>. For a minimum setup, get the latest versions
  99 of the following packages from the Aminet archives
 100 ( <a href="http://www.aminet.net/~aminet/">http://www.aminet.net/~aminet/</a> ):</p>
 101 </dd>
 102 <dd>
 103 <pre>
 104         ixemul-bin
 105         ixemul-env-bin
 106         pdksh-bin</pre>
 107 </dd>
 108 <dd>
 109 <p>Note also that this is a minimum setup; you might want to add other
 110 packages of <strong>ADE</strong> (the <em>Amiga Developers Environment</em>).</p>
 111 </dd>
 112 </li>
 113 <dt><strong><a name="item_version_of_amiga_os"><strong>Version of Amiga OS</strong></a></strong>
 114
 115 <dd>
 116 <p>You need at the very least AmigaOS version 2.0. Recommended is version 3.1.</p>
 117 </dd>
 118 </li>
 119 </dl>
 120 <p>
 121 </p>
 122 <h2><a name="starting_perl_programs_under_amigaos">Starting Perl programs under AmigaOS</a></h2>
 123 <p>Start your Perl program <em>foo</em> with arguments <code>arg1 arg2 arg3</code> the
 124 same way as on any other platform, by</p>
 125 <pre>
 126         perl foo arg1 arg2 arg3</pre>
 127 <p>If you want to specify perl options <code>-my_opts</code> to the perl itself (as
 128 opposed to your program), use</p>
 129 <pre>
 130         perl -my_opts foo arg1 arg2 arg3</pre>
 131 <p>Alternately, you can try to get a replacement for the system's <strong>Execute</strong>
 132 command that honors the #!/usr/bin/perl syntax in scripts and set the s-Bit
 133 of your scripts. Then you can invoke your scripts like under UNIX with</p>
 134 <pre>
 135         foo arg1 arg2 arg3</pre>
 136 <p>(Note that having *nixish full path to perl <em>/usr/bin/perl</em> is not
 137 necessary, <em>perl</em> would be enough, but having full path would make it
 138 easier to use your script under *nix.)</p>
 139 <p>
 140 </p>
 141 <h2><a name="shortcomings_of_perl_under_amigaos">Shortcomings of Perl under AmigaOS</a></h2>
 142 <p>Perl under AmigaOS lacks some features of perl under UNIX because of
 143 deficiencies in the UNIX-emulation, most notably:</p>
 144 <ul>
 145 <li>
 146 <p><code>fork()</code></p>
 147 </li>
 148 <li>
 149 <p>some features of the UNIX filesystem regarding link count and file dates</p>
 150 </li>
 151 <li>
 152 <p>inplace operation (the -i switch) without backup file</p>
 153 </li>
 154 <li>
 155 <p><a href="file://C|\msysgit\mingw\html/pod/perlfunc.html#item_umask"><code>umask()</code></a> works, but the correct permissions are only set when the file is
 156 finally close()d</p>
 157 </li>
 158 </ul>
 159 <p>
 160 </p>
 161 <hr />
 162 <h1><a name="installation">INSTALLATION</a></h1>
 163 <p>Change to the installation directory (most probably ADE:), and
 164 extract the binary distribution:</p>
 165 <p>lha -mraxe x perl-$VERSION-bin.lha</p>
 166 <p>or</p>
 167 <p>tar xvzpf perl-$VERSION-bin.tgz</p>
 168 <p>(Of course you need lha or tar and gunzip for this.)</p>
 169 <p>For installation of the Unix emulation, read the appropriate docs.</p>
 170 <p>
 171 </p>
 172 <hr />
 173 <h1><a name="accessing_documentation">Accessing documentation</a></h1>
 174 <p>
 175 </p>
 176 <h2><a name="manpages_for_perl_on_amigaos">Manpages for Perl on AmigaOS</a></h2>
 177 <p>If you have <code>man</code> installed on your system, and you installed perl
 178 manpages, use something like this:</p>
 179 <pre>
 180         man <a href="//C|\msysgit\mingw\html/pod/perlfunc.html">perlfunc</a>
 181         man less
 182         man ExtUtils.MakeMaker</pre>
 183 <p>to access documentation for different components of Perl. Start with</p>
 184 <pre>
 185         man perl</pre>
 186 <p>Note: You have to modify your man.conf file to search for manpages
 187 in the /ade/lib/perl5/man/man3 directory, or the man pages for the
 188 perl library will not be found.</p>
 189 <p>Note that dot (<em>.</em>) is used as a package separator for documentation
 190 for packages, and as usual, sometimes you need to give the section - <code>3</code>
 191 above - to avoid shadowing by the <em>less(1) manpage</em>.</p>
 192 <p>
 193 </p>
 194 <h2><a name="perl_html_documentation_on_amigaos">Perl HTML Documentation on AmigaOS</a></h2>
 195 <p>If you have some WWW browser available, you can build <strong>HTML</strong> docs.
 196 Cd to directory with <em>.pod</em> files, and do like this</p>
 197 <pre>
 198         cd /ade/lib/perl5/pod
 199         pod2html</pre>
 200 <p>After this you can direct your browser the file <em>perl.html</em> in this
 201 directory, and go ahead with reading docs.</p>
 202 <p>Alternatively you may be able to get these docs prebuilt from <code>CPAN</code>.</p>
 203 <p>
 204 </p>
 205 <h2><a name="perl_gnu_info_files_on_amigaos">Perl GNU Info Files on AmigaOS</a></h2>
 206 <p>Users of <code>Emacs</code> would appreciate it very much, especially with
 207 <code>CPerl</code> mode loaded. You need to get latest <code>pod2info</code> from <code>CPAN</code>,
 208 or, alternately, prebuilt info pages.</p>
 209 <p>
 210 </p>
 211 <h2><a name="perl_latex_documentation_on_amigaos">Perl LaTeX Documentation on AmigaOS</a></h2>
 212 <p>Can be constructed using <code>pod2latex</code>.</p>
 213 <p>
 214 </p>
 215 <hr />
 216 <h1><a name="building_perl_on_amigaos">BUILDING PERL ON AMIGAOS</a></h1>
 217 <p>Here we discuss how to build Perl under AmigaOS.</p>
 218 <p>
 219 </p>
 220 <h2><a name="build_prerequisites_for_perl_on_amigaos">Build Prerequisites for Perl on AmigaOS</a></h2>
 221 <p>You need to have the latest <strong>ixemul</strong> (Unix emulation for Amiga)
 222 from Aminet.</p>
 223 <p>
 224 </p>
 225 <h2><a name="getting_the_perl_source_for_amigaos">Getting the Perl Source for AmigaOS</a></h2>
 226 <p>You can either get the latest perl-for-amiga source from Ninemoons
 227 and extract it with:</p>
 228 <pre>
 229   tar xvzpf perl-$VERSION-src.tgz</pre>
 230 <p>or get the official source from CPAN:</p>
 231 <pre>
 232   <a href="http://www.cpan.org/src/5.0">http://www.cpan.org/src/5.0</a></pre>
 233 <p>Extract it like this</p>
 234 <pre>
 235   tar xvzpf perl-$VERSION.tar.gz</pre>
 236 <p>You will see a message about errors while extracting <em>Configure</em>. This
 237 is normal and expected. (There is a conflict with a similarly-named file
 238 <em>configure</em>, but it causes no harm.)</p>
 239 <p>
 240 </p>
 241 <h2><a name="making_perl_on_amigaos">Making Perl on AmigaOS</a></h2>
 242 <p>Remember to use a hefty wad of stack (I use 2000000)</p>
 243 <pre>
 244   sh configure.gnu --prefix=/gg</pre>
 245 <p>Now type</p>
 246 <pre>
 247   make depend</pre>
 248 <p>Now!</p>
 249 <pre>
 250   make</pre>
 251 <p>
 252 </p>
 253 <h2><a name="testing_perl_on_amigaos">Testing Perl on AmigaOS</a></h2>
 254 <p>Now run</p>
 255 <pre>
 256   make test</pre>
 257 <p>Some tests will be skipped because they need the <code>fork()</code> function:</p>
 258 <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>,
 259 <em>lib/io_pipe.t</em>, <em>lib/io_sock.t</em></p>
 260 <p>
 261 </p>
 262 <h2><a name="installing_the_built_perl_on_amigaos">Installing the built Perl on AmigaOS</a></h2>
 263 <p>Run</p>
 264 <pre>
 265   make install</pre>
 266 <p>
 267 </p>
 268 <hr />
 269 <h1><a name="perl_5_8_0_broken_in_amigaos">PERL 5.8.0 BROKEN IN AMIGAOS</a></h1>
 270 <p>As told above, Perl 5.6.1 was still good in AmigaOS, as was 5.7.2.
 271 After Perl 5.7.2 (change #11423, see the Changes file, and the file
 272 pod/perlhack.pod for how to get the individual changes) Perl dropped
 273 its internal support for vfork(), and that was very probably the step
 274 that broke AmigaOS (since the ixemul library has only vfork).
 275 The build finally fails when the ext/DynaLoader is being built, and
 276 PERL ends up as ``0'' in the produced Makefile, trying to run ``0'' does
 277 not quite work.  Also, executing miniperl in backticks seems to
 278 generate nothing: very probably related to the (v)fork problems.
 279 <strong>Fixing the breakage requires someone quite familiar with the ixemul
 280 library, and how one is supposed to run external commands in AmigaOS
 281 without fork().</strong></p>
 282 <p>
 283 </p>
 284 <hr />
 285 <h1><a name="authors">AUTHORS</a></h1>
 286 <p>Norbert Pueschel, <a href="mailto:pueschel@imsdd.meb.uni-bonn.de">pueschel@imsdd.meb.uni-bonn.de</a>
 287 Jan-Erik Karlsson, <a href="mailto:trg@privat.utfors.se">trg@privat.utfors.se</a></p>
 288 <p>
 289 </p>
 290 <hr />
 291 <h1><a name="see_also">SEE ALSO</a></h1>
 292 <p>perl(1).</p>
 293 <table border="0" width="100%" cellspacing="0" cellpadding="3">
 294 <tr><td class="block" style="background-color: #cccccc" valign="middle">
 295 <big><strong><span class="block">&nbsp;perlamiga - Perl under Amiga OS</span></strong></big>
 296 </td></tr>
 297 </table>
 298
 299 </body>
 300
 301 </html>