X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.epoc;h=74ea6b7c7edb209d40c3f7e3ffc0c667f45617f3;hb=78d3e1bf81e401020937b98d17bdfe2107623029;hp=f688b46c05a9b04f023bfb2511f126dbe4d917e6;hpb=d5ff79b3161a608c49c52fd6aa22cff1af6f6b82;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.epoc b/README.epoc index f688b46..74ea6b7 100644 --- a/README.epoc +++ b/README.epoc @@ -12,14 +12,13 @@ Perl 5 README file for the EPOC operating system. =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, -5mx Pro, Psion Revo and on the Ericson M128. I have no report about -the Psion Netbook or the S7. It runs on ER3 Hardware (Series 5 -classic), too. For more information about this hardware please refer -to http://www.psion.com. +5mx Pro, Psion Revo, Psion Netbook and on the Ericson M128. It runs on +ER3 Hardware (Series 5 classic), too. For more information about this +hardware please refer to http://www.psion.com. Vendors which like to have support for their devices are free to send me a sample. @@ -50,15 +49,9 @@ start perl with a double click on the camel icon. Be sure to configure the perl installation drive first. You can even provide a script with a special commandline, if needed. -Alternativly you can get ESHELL from symbian: -http://developer.epocworld.com/downloads/progs/Eshell.zip +Alternatively you can use the epocemx shell -Running ESHELL you can enter: perl -de 0 in order to run the perl -debugger. If you are leaving perl, you get into the system screen. You -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 @@ -67,13 +60,12 @@ command line switch '-x'. See L for details. =head1 STOPPING PERL ON EPOC 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 -redirection. You will have to reboot the PDA! +application `STDOUT'. You can use the kill command in the epocemx +shell to kill perl. =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 @@ -85,7 +77,7 @@ perl test.pl >stdout_file stderr_file 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 @@ -107,16 +99,16 @@ internally in perl, so please use slashes for redirects. 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 +http://www.symbian.com/developer/downloads/files/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: @@ -129,7 +121,7 @@ backquoting, pipes etc. =item * -system() does not inherit ressources like: file descriptors, +system() does not inherit resources like: file descriptors, environment etc. =item * @@ -169,17 +161,8 @@ Sorry, this is far too short. =item * -You will need the C++ SDK from http://developer.epocworld.com/. - -=item * - -You will need to set up the cross SDK from -http://www.science-computing.de/o.flebbe/sdk - -=item * - -You may have to adjust config.sh (cc, cppflags) to reflect your epoc -and SDK location. +You will need the epocemx SDK from Eberhard Mattes. Watch out for an +announcement. =item * @@ -201,20 +184,13 @@ Start again from scratch make cp miniperl.native miniperl make - make ext/Errno/pm_to_blib - perl link.pl perlmain.o lib/auto/DynaLoader/DynaLoader.a \ - lib/auto/Data/Dumper/Dumper.a \ - lib/auto/File/Glob/Glob.a lib/auto/IO/IO.a \ - lib/auto/Socket/Socket.a \ - lib/auto/Fcntl/Fcntl.a lib/auto/Sys/Hostname/Hostname.a \ - perl.a `cat ext.libs` perl createpkg.pl - wine G:/bin/makesis perl.pkg perl.sis + emxsis perl.pkg perl.sis =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. @@ -226,6 +202,6 @@ http://www.science-computing.de/o.flebbe/perl/ =head1 LAST UPDATE -2001-02-26 +2001-12-12 =cut