blead 25801: Symbian batch of today

[p5sagit/p5-mst-13.2.git] / README.symbian

diff --git a/README.symbian b/README.symbian
index e6cb4dc..f3e565b 100644 (file)
--- a/README.symbian
+++ b/README.symbian
@@ -12,7 +12,7 @@ This document describes various features of the Symbian operating
 system that will affect how Perl version 5 (hereafter just Perl)
 is compiled and/or runs.
 
-B<NOTE: this port (as of 0.1.0) does not compile into a Symbian
+B<NOTE: this port (as of 0.2.0) does not compile into a Symbian
 OS GUI application, but instead it results in a Symbian DLL.>
 The DLL includes a C++ class called CPerlBase, which one can then
 (derive from and) use to embed Perl into applications, see F<symbian/README>.
@@ -31,7 +31,8 @@ mainly as demonstrations.
 (0) You need to have the Symbian SDK installed.
 
     These instructions have been tested under various Nokia Series 60
-    Symbian SDKs (1.2 to 2.6).  You can get the SDKs from
+    Symbian SDKs (1.2 to 2.6, 2.8 should also work, 1.2 compiles but
+    does not work).  You can get the SDKs from
     Forum Nokia (http://www.forum.nokia.com/).
 
     A prerequisite for any of the SDKs is to install ActivePerl
@@ -42,7 +43,7 @@ mainly as demonstrations.
     or the Microsoft Visual C++ 6.0 installed (SP3 minimum, SP5 recommended).
 
     Note that for example the Serie s60 2.0 VC SDK installation talks
-    about ActivePerl build 518, which does no more (as of mid-2004) exist
+    about ActivePerl build 518, which does no more (as of mid-2005) exist
     at the ActiveState website.  The ActivePerl 5.8.4 build 810 was
     used successfully for compiling Perl on Symbian.  The 5.6.x ActivePerls
     do not work.
@@ -93,6 +94,8 @@ mainly as demonstrations.
         2.1 | -  | +  | 6670
         2.6 | +  | +  | 6630    
 
+    Also 2.8 should work fine.
+
     If you are using the 'make' directly, it is the GNU make from the SDKs,
     and it will invoke the right make commands for the Windows emulator
     build and the Arm target builds ('thumb' by default) as necessary.
@@ -126,7 +129,7 @@ mainly as demonstrations.
     the messages.
 
     Since the total size of all Perl SIS files once installed is
-    over 1.9 MB, it is recommended to do the installation into a
+    over 2 MB, it is recommended to do the installation into a
     memory card (drive E:) instead of the C: drive.
 
     The size of the perlXYZ.SIS is about 370 kB but once it is in the
@@ -147,7 +150,7 @@ mainly as demonstrations.
 
         make perlext.sis
 
-    which will create perlXYZext.sis (210 kB -> 470 kB).
+    which will create perlXYZext.sis (290 kB -> 770 kB).
 
     To compile the demonstration application PerlApp you need first to
     install the Perl headers under the SDK.
@@ -237,6 +240,15 @@ and offers either to install it under \Perl (if the Perl file is in
 the inbox of the messaging application) or to run it (if the Perl file
 is under \Perl).
 
+=head2 sisify.pl
+
+In the symbian subdirectory there is sisify.pl utility which can be
+used to package Perl scripts and/or Perl library directories into SIS
+files, which can be installed to the device.  To run the sisify.pl
+utility, you will need to have the 'makesis' and 'uidcrc' utilities
+already installed.  If you don't have the S60 Win32 SDKs, you may try
+for example http://gnupoc.sourceforge.net/ or http://symbianos.org/~andreh/.
+
 =head2 Using Perl in Symbian
 
 First of all note that you have full access to the Symbian device
@@ -284,7 +296,7 @@ Lots.  See F<symbian\TODO>.
 
 =head1 WARNING
 
-As of Perl Symbian port version 0.1.0 any part of Perl's standard
+As of Perl Symbian port version 0.2.0 any part of Perl's standard
 regression test suite has not been run on a real Symbian device using
 the ported Perl, so innumerable bugs may lie in wait.  Therefore there
 is absolutely no warranty.
@@ -317,7 +329,12 @@ The Symbian port is licensed under the same terms as Perl itself.
 
 =head1 HISTORY
 
-Perl Symbian Port version 0.1.0: April 2005
+=over 4
+
+=item *
+
+0.1.0: April 2005
+
 (This will show as "0.01" in the Symbian Installer.)
 
   - The console window is a very simple console indeed: one can
@@ -331,7 +348,7 @@ Perl Symbian Port version 0.1.0: April 2005
     DynaLoader Exporter File::Spec integer lib strict Symbol
     vars warnings XSLoader
   - The following extensions are available:
-    attrs Cwd Data::Dumper Devel::Peek Digest::MD5 DynaLoader
+    attrs Compress::Zlib Cwd Data::Dumper Devel::Peek Digest::MD5 DynaLoader
     Fcntl File::Glob Filter::Util::Call IO List::Util MIME::Base64
     PerlIO::scalar PerlIO::via SDBM_File Socket Storable Time::HiRes
   - The following extensions are missing for various technical reasons:
@@ -340,13 +357,25 @@ Perl Symbian Port version 0.1.0: April 2005
     re Safe Sys::Hostname Sys::Syslog
     threads threads::shared Unicode::Normalize
   - Using MakeMaker or the Module::* to build and install modules
-    is not supported.  A future solution might use the native
-    SIS packaging format (see symbian\TODO).
+    is not supported.
   - Building XS other than the ones in the core is not supported.
 
-Since this is 0.1.0, any future releases are almost guaranteed to be
-binary incompatible.  As a sign of this the Symbian symbol exports are
-kept unfrozen and the .def files rebuilt every time.
+Since this is 0.something release, any future releases are almost
+guaranteed to be binary incompatible.  As a sign of this the Symbian
+symbol exports are kept unfrozen and the .def files rebuilt every
+time.
+
+=item *
+
+0.2.0: October 2005
+
+  - Perl 5.9.3 (patch level 25741)
+  - Compress::Zlib and IO::Zlib supported
+  - sisify.pl added
+
+We maintain the binary incompatibility.
+
+=back
 
 =cut