.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "PERLEPOC 1"
.TH PERLEPOC 1 "2002-11-24" "perl v5.8.0" "Perl Programmers Reference Guide"
.SH "NAME"
README.epoc \- Perl for EPOC
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
Perl 5 \s-1README\s0 file for the \s-1EPOC\s0 Release 5 operating system.
.SH "INTRODUCTION"
.IX Header "INTRODUCTION"
\&\s-1EPOC\s0 is an \s-1OS\s0 for palmtops and mobile phones. For more informations look at:
http://www.symbian.com/
.PP
This is a port of perl to the epocemx \s-1SDK\s0 by Eberhard Mattes, which
itselfs uses the \s-1SDK\s0 by symbian. Essentially epocemx it is a \s-1POSIX\s0
look alike environment for the \s-1EPOC\s0 \s-1OS\s0. For more informations look at: 
http://www.windhager.de/~mattes/epocemx/
.PP
perl and epocemx runs on Epoc Release 5 machines: Psion 5mx, 5mx Pro,
Psion Revo, Psion Netbook and on the Ericson M128. It may run on Epoc
Release 3 Hardware (Series 5 classic), too. For more information about
this hardware please refer to http://www.psion.com/
.PP
Vendors which like to have support for their devices are free to send
me a sample. 
.SH "INSTALLING PERL ON EPOC"
.IX Header "INSTALLING PERL ON EPOC"
You can download a ready-to-install version from
http://www.science\-computing.de/o.flebbe/perl/
.PP
You will need at least ~6MB free space in order to install and run
perl.
.PP
Please install the emxusr.sis package from
http://www.windhager.de/~mattes/epocemx/ first.
.PP
Install perl.sis on the \s-1EPOC\s0 machine. If you do not know how to do
that, consult your PsiWin documentation.
.PP
Perl itself and its standard library is using 4 \s-1MB\s0 disk space.
Unicode support and some other modules are left out. (For details,
please look into epoc/createpkg.pl). If you like to use these modules,
you are free to copy them from a current perl release.
.SH "STARTING PERL ON EPOC"
.IX Header "STARTING PERL ON EPOC"
Please use the epocemx shell to start perl. perl integrates with the
conventions of epocemx. 
.Sh "Editors on Epoc"
.IX Subsection "Editors on Epoc"
A suitable text editor can be downloaded from symbian
http://www.symbian.com/developer/downloads/files/editor.zip
.Sh "Features of Perl on Epoc"
.IX Subsection "Features of Perl on Epoc"
The built-in function EPOC::getcwd returns the current directory.
.Sh "Restrictions of Perl on Epoc"
.IX Subsection "Restrictions of Perl on Epoc"
Features are left out, because of restrictions of the \s-1POSIX\s0 support in
\&\s-1EPOC:\s0
.IP "\(bu" 4
socket \s-1IO\s0 is only implemented poorly. You can only use sysread and
syswrite on them. The commands read, write, print, <> do not work for
sockets. This may change iff epocemx supports sockets.
.IP "\(bu" 4
kill, alarm and signals. Do not try to use them. This may be
impossible to implement on \s-1EPOC\s0.
.IP "\(bu" 4
select is missing.
.IP "\(bu" 4
binmode does not exist. (No \s-1CR\s0 \s-1LF\s0 to \s-1LF\s0 translation for text files)
.IP "\(bu" 4
\&\s-1EPOC\s0 does not handle the notion of current drive and current
directory very well (i.e. not at all, but it tries hard to emulate
one) See \s-1PATH\s0.
.IP "\(bu" 4
Heap is limited to 4MB.
.IP "\(bu" 4
Dynamic loading is not implemented.
.Sh "Compiling Perl 5 on the \s-1EPOC\s0 cross compiling environment"
.IX Subsection "Compiling Perl 5 on the EPOC cross compiling environment"
Sorry, this is far too short.
.IP "\(bu" 4
You will need the epocemx \s-1SDK\s0 from Eberhard Mattes. 
.IP "\(bu" 4
Get the Perl sources from your nearest \s-1CPAN\s0 site.
.IP "\(bu" 4
Unpack the sources. 
.IP "\(bu" 4
Build a native perl from this sources... Make sure to save the
miniperl executable as miniperl.native.
.Sp
Start again from scratch
.Sp
.Vb 7
\&      cp epoc/* .
\&      ./Configure -S
\&      make 
\&      cp miniperl.native miniperl
\&      touch miniperl.exe
\&      make
\&      perl createpkg.pl
.Ve
.Sp
.Vb 1
\&      emxsis perl.pkg perl.sis
.Ve
.SH "SUPPORT STATUS OF PERL ON EPOC"
.IX Header "SUPPORT STATUS OF PERL ON EPOC"
I'm offering this port \*(L"as is\*(R". You can ask me questions, but I can't
guarantee I'll be able to answer them. Since the port to epocemx is
quite new, please check the web for updates first.
.PP
Very special thanks to Eberhard Mattes for epocemx.
.SH "AUTHOR"
.IX Header "AUTHOR"
Olaf Flebbe <o.flebbe@science\-computing.de>
http://www.science\-computing.de/o.flebbe/perl/
.SH "LAST UPDATE"
.IX Header "LAST UPDATE"
2002\-03\-26