README.epoc

   1 =================================================
   2 Perl 5 README file for the EPOC operating system.
   3 ==================================================
   4
   5 Olaf Flebbe <o.flebbe@gmx.de>
   6 http://www.fortunecity.de/wolkenkratzer/trumpet/84/perl5.html
   7 June 27, 1999
   8
   9 Introduction
  10 ------------
  11
  12 This is a port of Perl version 5, revision 005-57 to EPOC.
  13
  14 There are many features left out, because of restrictions of the posix
  15 support in the SDK.
  16
  17 The following known problems do exist:
  18
  19 1) very little testing.
  20
  21 2) no support for system, backquoting, pipes etc. One cannot exec a
  22    different process.
  23
  24 3) no signals, kill. Do not try to use them.
  25
  26 4) select is missing.
  27
  28 5) binmode does not work. (No CR LF to LF translation for text files)
  29
  30 6) no Config.pm
  31
  32 7) no I/O redirection.
  33
  34 8) it may not run from a drive other than C: (I have no CF Card to test)
  35
  36 9) sockets may hardly of any use.
  37
  38 10) You need a shell in order to run perl.exe.
  39
  40
  41 Compiling Perl 5 on the EPOC cross compiling envionment.
  42 --------------------------------------------------------
  43
  44 0. You will need the C++ SDK from
  45    http://developer.epocworld.com/. Install it on a separate drive.
  46
  47 1. Unpack the sources in the epoc development drive: The sources
  48    should be in a directory perl5.005/perl5.005_57
  49
  50 2. Move all files in the directory perl5.005_57/epoc to perl5.005_57.
  51
  52 3. Check the perl.mmp file: It should have the correct locations for
  53    project und subproject (see step 1)
  54
  55 4. Change to the EPOC development drive and run
  56      makmake perl marm
  57      nmake -f perl.marm
  58      makesis perl.pkg perl5.005.sis
  59
  60 5. Beam the perl5.005.sis to the Psion5, install and enjoy!
  61
  62 ToDo List
  63 ---------
  64
  65 - Allocate an UID from symbian.
  66
  67 - Implement system() and I/O redirection, in order to run the
  68   tests.
  69
  70 - Implement getprotcolbyname() and relatives.
  71
  72 - Implement perl as a OPX module. (What do you think?)
  73
  74 Support Status
  75 --------------
  76
  77 I'm offering this port "as is".  You can ask me questions, but I can't
  78 guarantee I'll be able to answer them; I don't know much about Perl
  79 itself;
  80