Add some files to DOSish and writables.

[p5sagit/p5-mst-13.2.git] / wince / README.perlce

NAME\r
	PerlCE - perl for Windows CE\r
\r
DESCRIPTION\r
	PerlCE is a simple port of perl to Windows CE. The program\r
	is currently linked with a simple console window, so it also\r
	works on non-hpc devices.\r
\r
	The simple stdio implementation creates the files stdin.txt,\r
	stdout.txt and stderr.txt, so you might examine them if your\r
	console has only a liminted number of cols.\r
\r
	When exitcode is non-zero, a message box appears, otherwise the\r
	console closes, so you might have to catch an exit with\r
	status 0 in your program to see any output.\r
\r
	stdout/stderr now go into the files /perl-stdout.txt and\r
	/perl-stderr.txt.\r
\r
LIMITATIONS\r
	No fork(), pipe(), popen() etc.\r
\r
ENVIRONMENT\r
	All environment vars must be stored in HKLM\Environment as\r
	strings. They are read at process startup.\r
\r
	PERL5LIB	- Usual perl lib path (semi-list).\r
	PATH		- Semi-list for executables.\r
	TMP		- Tempdir.\r
	UNIXROOTPATH	- Root for accessing some special files,\r
			  i.e. /dev/null, /etc/services.\r
	ROWS/COLS	- Rows/cols for console.\r
	HOME		- Home directory.\r
	CONSOLEFONTSIZE - Size for console font.\r
\r
	You can set these with cereg.exe, a (remote) registry editor\r
	or via the PerlIDE.\r
\r
REGISTRY\r
	To start perl by clicking on a perl source file, you have\r
	to make the according entries in HKCR (see wince-reg.bat).\r
	cereg.exe (which must be executed on a desktop pc with\r
	ActiveSync) is reported not to work on some devices.\r
	You have to create the registry entries by hand using a \r
	registry editor.\r
\r
FILES\r
	$(UNIXROOTPATH)/dev/null - nul simulation, needed for perl -V\r
	$(UNIXROOTPATH)/etc/services - services file\r
\r
	/perl-stdin.txt\r
	/perl-stdout.txt\r
	/perl-stderr.txt   \r
\r
PERLFILES \r
	Only a limited set of perl files is provided in the\r
	distribution archiv. You have to copy the original PERL5LIB\r
	files from a perl for win32 installation and put the\r
	distributed files into the right directories.\r
\r
	Do not copy any Win32/X86 dlls from your PC to the device...\r
\r
	The following files are a reasonable minimum if you want to do\r
	some socket stuff:\r
\r
	./auto\r
	./auto/DynaLoader\r
	./auto/DynaLoader/autosplit.ix\r
	./auto/DynaLoader/dl_expandspec.al\r
	./auto/DynaLoader/dl_findfile.al\r
	./auto/DynaLoader/dl_find_symbol_anywhere.al\r
	./auto/IO\r
	./auto/IO/IO.bs\r
	./auto/IO/IO.dll\r
	./auto/Socket\r
	./auto/Socket/Socket.bs\r
	./auto/Socket/Socket.dll\r
	./Carp\r
	./Carp/Heavy.pm\r
	./Carp.pm\r
	./Config.pm\r
	./DynaLoader.pm\r
	./Exporter\r
	./Exporter/Heavy.pm\r
	./Exporter.pm\r
	./IO\r
	./IO/File.pm\r
	./IO/Handle.pm\r
	./IO/Socket.pm\r
	./IO.pm\r
	./SelectSaver.pm\r
	./Socket.pm\r
	./strict.pm\r
	./Symbol.pm\r
	./warnings\r
	./warnings/register.pm\r
	./warnings.pm\r
	./XSLoader.pm\r
\r
XS\r
	The following Win32-Methods are built-in:\r
\r
	newXS("Win32::GetCwd", w32_GetCwd, file);\r
	newXS("Win32::SetCwd", w32_SetCwd, file);\r
	newXS("Win32::GetTickCount", w32_GetTickCount, file);\r
	newXS("Win32::GetOSVersion", w32_GetOSVersion, file);\r
	newXS("Win32::IsWinNT", w32_IsWinNT, file);\r
	newXS("Win32::IsWin95", w32_IsWin95, file);\r
	newXS("Win32::IsWinCE", w32_IsWinCE, file);\r
	newXS("Win32::CopyFile", w32_CopyFile, file);\r
	newXS("Win32::Sleep", w32_Sleep, file);\r
	newXS("Win32::MessageBox", w32_MessageBox, file);\r
	newXS("Win32::GetPowerStatus", w32_GetPowerStatus, file);\r
	newXS("Win32::GetOemInfo", w32_GetOemInfo, file);\r
	newXS("Win32::ShellEx", w32_ShellEx, file);\r
\r
DLLS\r
	In the newest version, my celib.dll is needed. Some XS dlls\r
	might be needed. Currently, Socket and IO are provided.\r
\r
BUGS\r
	Opening files for read-write is currently not supported if\r
	they use stdio (normal perl file handles).\r
\r
	If you find bugs or if it does not work at all on your\r
	device, send mail to the address below. Please report\r
	the details of your device (processor, ceversion, \r
	devicetype (hpc/palm/pocket)) and the date of the downloaded\r
	files. \r
\r
	I currently have only a Compaq/MIPS HPC, a Jornada/SH3 HPC and\r
	a Jornada/ARM HPC, so I can only test on these devices and\r
	under the Emulators.\r
\r
INSTALLATION\r
	This is only a suggestion...\r
\r
	* Unpack the tar archive on your desktop.\r
	* Create directories /bin, /lib/perl5, /home, /dev and /etc,\r
	  possibly on a CF card with the path to the card \r
	  prepended (i.e. /memcard/bin etc).\r
	* Copy perl.exe, perl56.dll and celib.dll from your desktop to\r
	  /bin. The dlls can also be copied to your /windows\r
	  directory, but if you use a CF card, you might want to store\r
          them there.\r
	* Copy the other DLLs to the corresponding auto directory.\r
	* Copy any needed perl module-files to /lib/perl5.\r
	* Create the registry entries.\r
	* If you need tcp service-name resolution, create\r
	  the file "services" in /etc and put int the entries you need.\r
\r
	* Under WINCE200, all dlls must be copied to the windows\r
          directory.\r
\r
MISC\r
	If you think a certain XS module should be ported, send\r
	me mail and explain why.\r
\r
	If you write useful scripts for perlce, please send me\r
	a copy.\r
\r
TERMINAL\r
	There are simple terminal control sequences now. See the\r
	readme file that comes with the console program.\r
\r
AUTHOR\r
	Rainer Keuchel <coyxc@rainer-keuchel.de> 2001\r
\r