=head1 INTRODUCTION
-EPOC is a OS for palmtops and mobile phones. For more informations look at:
+EPOC is an OS for palmtops and mobile phones. For more informations look at:
http://www.symbian.com/
This is a port of perl to EPOC. It runs on ER5 machines: Psion 5mx,
the perl installation drive first. You can even provide a script with
a special commandline, if needed.
-Alternativly you can get ESHELL from symbian:
+Alternatively you can get ESHELL from symbian:
http://developer.epocworld.com/downloads/progs/Eshell.zip
Running ESHELL you can enter: perl -de 0 in order to run the perl
have to switch back manually to ESHELL. When perl is running, you will
see a task with the name STDOUT in the task list.
-If you have a ER3 machine (i.e. a PSION 5), you may have to supply the
+If you have an ER3 machine (i.e. a PSION 5), you may have to supply the
full path to the perl executable C:\system\programs\perl.exe.
If you need to set the current directory of perl, please use the
You can stop a running perl process in the task list by closing the
application `STDOUT'. You cannot stop a running perl process if it has
-not written anyting to stdout or stderr! Be very cautious with I/O
+not written anything to stdout or stderr! Be very cautious with I/O
redirection. You will have to reboot the PDA!
=head1 USING PERL ON EPOC
-=head2 I/O Redirection
+=head2 I/O Redirection on Epoc
You can redirect the output with the UNIX bourne shell syntax (this is
built into perl rather then eshell) For instance the following command
Alternatively you can use 2>&1 in order to add the standard error
output to stdout.
-=head2 PATH Names
+=head2 PATH Names on Epoc
ESHELL looks for executables in ?:/System/Programs. The SIS file
installs perl in this special folder directory. The default drive and
perl.exe C:/test.pl >C:/output.txt
-=head2 Editors
+=head2 Editors on Epoc
A suitable text editor can be downloaded from symbian
http://developer.epocworld.com/downloads/progs/Editor.zip
-=head2 Features
+=head2 Features of Perl on Epoc
The built-in function EPOC::getcwd returns the current directory.
-=head2 Restrictions
+=head2 Restrictions of Perl on Epoc
Features are left out, because of restrictions of the POSIX support in
EPOC:
=item *
-system() does not inherit ressources like: file descriptors,
+system() does not inherit resources like: file descriptors,
environment etc.
=item *
=back
-=head1 SUPPORT STATUS
+=head1 SUPPORT STATUS OF PERL ON EPOC
I'm offering this port "as is". You can ask me questions, but I can't
guarantee I'll be able to answer them.