source: trunk/essentials/dev-lang/perl/wince/README.perlce@ 3184

Last change on this file since 3184 was 3181, checked in by bird, 19 years ago

perl 5.8.8

File size: 5.0 KB
Line 
1NAME
2 PerlCE - perl for Windows CE
3
4DESCRIPTION
5 PerlCE is a simple port of perl to Windows CE. The program
6 is currently linked with a simple console window, so it also
7 works on non-hpc devices.
8
9 The simple stdio implementation creates the files stdin.txt,
10 stdout.txt and stderr.txt, so you might examine them if your
11 console has only a liminted number of cols.
12
13 When exitcode is non-zero, a message box appears, otherwise the
14 console closes, so you might have to catch an exit with
15 status 0 in your program to see any output.
16
17 stdout/stderr now go into the files /perl-stdout.txt and
18 /perl-stderr.txt.
19
20LIMITATIONS
21 No fork(), pipe(), popen() etc.
22
23ENVIRONMENT
24 All environment vars must be stored in HKLM\Environment as
25 strings. They are read at process startup.
26
27 PERL5LIB - Usual perl lib path (semi-list).
28 PATH - Semi-list for executables.
29 TMP - Tempdir.
30 UNIXROOTPATH - Root for accessing some special files,
31 i.e. /dev/null, /etc/services.
32 ROWS/COLS - Rows/cols for console.
33 HOME - Home directory.
34 CONSOLEFONTSIZE - Size for console font.
35
36 You can set these with cereg.exe, a (remote) registry editor
37 or via the PerlIDE.
38
39REGISTRY
40 To start perl by clicking on a perl source file, you have
41 to make the according entries in HKCR (see wince-reg.bat).
42 cereg.exe (which must be executed on a desktop pc with
43 ActiveSync) is reported not to work on some devices.
44 You have to create the registry entries by hand using a
45 registry editor.
46
47FILES
48 $(UNIXROOTPATH)/dev/null - nul simulation, needed for perl -V
49 $(UNIXROOTPATH)/etc/services - services file
50
51 /perl-stdin.txt
52 /perl-stdout.txt
53 /perl-stderr.txt
54
55PERLFILES
56 Only a limited set of perl files is provided in the
57 distribution archiv. You have to copy the original PERL5LIB
58 files from a perl for win32 installation and put the
59 distributed files into the right directories.
60
61 The following files are a reasonable minimum if you want to do
62 some socket stuff:
63
64 ./auto
65 ./auto/DynaLoader
66 ./auto/DynaLoader/autosplit.ix
67 ./auto/DynaLoader/dl_expandspec.al
68 ./auto/DynaLoader/dl_findfile.al
69 ./auto/DynaLoader/dl_find_symbol_anywhere.al
70 ./auto/IO
71 ./auto/IO/IO.bs
72 ./auto/IO/IO.dll
73 ./auto/Socket
74 ./auto/Socket/Socket.bs
75 ./auto/Socket/Socket.dll
76 ./Carp
77 ./Carp/Heavy.pm
78 ./Carp.pm
79 ./Config.pm
80 ./DynaLoader.pm
81 ./Exporter
82 ./Exporter/Heavy.pm
83 ./Exporter.pm
84 ./IO
85 ./IO/File.pm
86 ./IO/Handle.pm
87 ./IO/Socket.pm
88 ./IO.pm
89 ./SelectSaver.pm
90 ./Socket.pm
91 ./strict.pm
92 ./Symbol.pm
93 ./warnings
94 ./warnings/register.pm
95 ./warnings.pm
96 ./XSLoader.pm
97
98XS
99 The following Win32-Methods are built-in:
100
101 newXS("Win32::GetCwd", w32_GetCwd, file);
102 newXS("Win32::SetCwd", w32_SetCwd, file);
103 newXS("Win32::GetTickCount", w32_GetTickCount, file);