Commit | Line | Data |
---|---|---|
9a997319 JH |
1 | If you read this file _as_is_, just ignore the funny characters you |
2 | see. It is written in the POD format (see pod/perlpod.pod) which is | |
3 | specially designed to be readable as is. | |
4d2c4e07 | 4 | |
9a997319 JH |
5 | =head1 NAME |
6 | ||
de2902a6 | 7 | perlepoc - Perl for EPOC |
4d2c4e07 | 8 | |
9a997319 JH |
9 | =head1 SYNOPSIS |
10 | ||
2585f9a3 | 11 | Perl 5 README file for the EPOC Release 5 operating system. |
9a997319 JH |
12 | |
13 | =head1 INTRODUCTION | |
4d2c4e07 | 14 | |
2179af5e MS |
15 | EPOC is an OS for palmtops and mobile phones. For more information look |
16 | at: L<http://www.symbian.com/> | |
4d2c4e07 | 17 | |
2585f9a3 | 18 | This is a port of perl to the epocemx SDK by Eberhard Mattes, which |
3a1825b5 | 19 | itself uses the SDK by symbian. Essentially epocemx it is a POSIX |
6c852fd0 | 20 | look alike environment for the EPOC OS. For more information look at: |
2179af5e | 21 | L<http://epocemx.sourceforge.net/> |
2585f9a3 JH |
22 | |
23 | perl and epocemx runs on Epoc Release 5 machines: Psion 5mx, 5mx Pro, | |
a4cd2bbe | 24 | Psion Revo, Psion Netbook and on the Ericsson M128. It may run on Epoc |
2585f9a3 | 25 | Release 3 Hardware (Series 5 classic), too. For more information about |
2179af5e | 26 | this hardware please refer to L<http://www.psion.com/> |
d5ff79b3 OF |
27 | |
28 | Vendors which like to have support for their devices are free to send | |
29 | me a sample. | |
4d2c4e07 | 30 | |
9a997319 | 31 | =head1 INSTALLING PERL ON EPOC |
4d2c4e07 | 32 | |
d5ff79b3 | 33 | You can download a ready-to-install version from |
2179af5e | 34 | L<http://www.oflebbe.de/perl/perl5.html> |
d5ff79b3 | 35 | |
6c852fd0 | 36 | You will need at least ~6MB free space in order to install and run perl. |
d5ff79b3 | 37 | |
2585f9a3 | 38 | Please install the emxusr.sis package from |
2179af5e | 39 | L<http://epocemx.sourceforge.net/> first. |
2585f9a3 | 40 | |
d5ff79b3 OF |
41 | Install perl.sis on the EPOC machine. If you do not know how to do |
42 | that, consult your PsiWin documentation. | |
43 | ||
2585f9a3 | 44 | Perl itself and its standard library is using 4 MB disk space. |
d5ff79b3 OF |
45 | Unicode support and some other modules are left out. (For details, |
46 | please look into epoc/createpkg.pl). If you like to use these modules, | |
47 | you are free to copy them from a current perl release. | |
ae2d1787 | 48 | |
d5ff79b3 | 49 | =head1 STARTING PERL ON EPOC |
ae2d1787 | 50 | |
2585f9a3 JH |
51 | Please use the epocemx shell to start perl. perl integrates with the |
52 | conventions of epocemx. | |
4d2c4e07 | 53 | |
a83b6f46 | 54 | =head2 Features of Perl on Epoc |
4d2c4e07 | 55 | |
ed79a026 | 56 | The built-in function EPOC::getcwd returns the current directory. |
3a2f06e9 | 57 | |
a83b6f46 | 58 | =head2 Restrictions of Perl on Epoc |
4d2c4e07 | 59 | |
ed79a026 OF |
60 | Features are left out, because of restrictions of the POSIX support in |
61 | EPOC: | |
4d2c4e07 | 62 | |
9a997319 JH |
63 | =over 4 |
64 | ||
eccd403f JH |
65 | =item * |
66 | ||
67 | socket IO is only implemented poorly. You can only use sysread and | |
68 | syswrite on them. The commands read, write, print, <> do not work for | |
69 | sockets. This may change iff epocemx supports sockets. | |
70 | ||
9a997319 JH |
71 | =item * |
72 | ||
2585f9a3 | 73 | kill, alarm and signals. Do not try to use them. This may be |
9a997319 JH |
74 | impossible to implement on EPOC. |
75 | ||
76 | =item * | |
77 | ||
78 | select is missing. | |
79 | ||
80 | =item * | |
ae2d1787 | 81 | |
9a997319 | 82 | binmode does not exist. (No CR LF to LF translation for text files) |
ae2d1787 | 83 | |
9a997319 | 84 | =item * |
ae2d1787 | 85 | |
9a997319 JH |
86 | EPOC does not handle the notion of current drive and current |
87 | directory very well (i.e. not at all, but it tries hard to emulate | |
3a1825b5 | 88 | one). See PATH. |
ae2d1787 | 89 | |
9a997319 | 90 | =item * |
ae2d1787 | 91 | |
d5ff79b3 | 92 | Heap is limited to 4MB. |
4d2c4e07 | 93 | |
9a997319 | 94 | =item * |
4d2c4e07 | 95 | |
d5ff79b3 | 96 | Dynamic loading is not implemented. |
4d2c4e07 | 97 | |
9a997319 JH |
98 | =back |
99 | ||
100 | =head2 Compiling Perl 5 on the EPOC cross compiling environment | |
4d2c4e07 | 101 | |
3a2f06e9 | 102 | Sorry, this is far too short. |
4d2c4e07 | 103 | |
9a997319 JH |
104 | =over 4 |
105 | ||
106 | =item * | |
107 | ||
2585f9a3 | 108 | You will need the epocemx SDK from Eberhard Mattes. |
4d2c4e07 | 109 | |
9a997319 | 110 | =item * |
4d2c4e07 | 111 | |
9a997319 | 112 | Get the Perl sources from your nearest CPAN site. |
4d2c4e07 | 113 | |
9a997319 | 114 | =item * |
4d2c4e07 | 115 | |
9a997319 | 116 | Unpack the sources. |
ae2d1787 | 117 | |
9a997319 | 118 | =item * |
ae2d1787 | 119 | |
d5ff79b3 OF |
120 | Build a native perl from this sources... Make sure to save the |
121 | miniperl executable as miniperl.native. | |
122 | ||
123 | Start again from scratch | |
ed79a026 | 124 | |
3a2f06e9 | 125 | cp epoc/* . |
f83d2536 | 126 | ./Configure -S |
d5ff79b3 | 127 | make |
3a2f06e9 | 128 | cp miniperl.native miniperl |
2585f9a3 | 129 | touch miniperl.exe |
d5ff79b3 | 130 | make |
3a2f06e9 | 131 | perl createpkg.pl |
4d2c4e07 | 132 | |
02a99678 | 133 | emxsis perl.pkg perl.sis |
4d2c4e07 | 134 | |
9a997319 | 135 | =back |
4d2c4e07 | 136 | |
a83b6f46 | 137 | =head1 SUPPORT STATUS OF PERL ON EPOC |
4d2c4e07 | 138 | |
ed79a026 | 139 | I'm offering this port "as is". You can ask me questions, but I can't |
2585f9a3 JH |
140 | guarantee I'll be able to answer them. Since the port to epocemx is |
141 | quite new, please check the web for updates first. | |
142 | ||
143 | Very special thanks to Eberhard Mattes for epocemx. | |
9a997319 JH |
144 | |
145 | =head1 AUTHOR | |
146 | ||
6c852fd0 | 147 | Olaf Flebbe <olaf@oflebbe.de> |
2179af5e | 148 | L<http://www.oflebbe.de/perl/perl5.html> |
9a997319 JH |
149 | |
150 | =head1 LAST UPDATE | |
151 | ||
6c852fd0 | 152 | 2003-01-18 |
9a997319 JH |
153 | |
154 | =cut |