symbian/TODO

   1 =head1 BASE PORT
   2
   3 =head2 Console
   4
   5 - The Console only does "ASCII" input: e.g. pressing the "2"
   6   key five times, "aaaaa", does not produce "ä" ("a diaeresis"),
   7   but instead the "2" key rotates through "abc2abc2...".
   8   This is a pity because the Console is actually capable of full
   9   Unicode input and output (if you have the fonts, that is).  You
  10   can verify this by entering e.g. the euro character, which is
  11   U+20AC, well beyond U+00FF.  I don't know why the full repertoire
  12   of the keyboard is not available.
  13 - Enhance the console? (line editing, full x-y movement, history)
  14 - The role of the console needs to be rethought: the best way
  15   would be to have the console visible in the same screen as
  16   the GUI elements (an "embedded console"?)
  17
  18 =head2 Core Language
  19
  20 - the $^E does not work
  21 - select() does not work (not our fault)
  22 - starting external application: what now (0.1.0) works is:
  23   - system("app");
  24   - system("app&");
  25   - and those with arguments:
  26     - system("app arg1 arg2")
  27     - system("app arg1 arg2 &")
  28     but remember that a Symbian process does get only argv[0]
  29     and argv[1]: all the arguments of the application are passed
  30     in as a single argument, the second one ("arg1 arg2" in the above)
  31   What does not work:
  32   - I/O redirection
  33   - piped open, in either direction
  34   - qx/backtick/`
  35   - fork/wait (these unlikely to ever work as in POSIX)
  36   - IO redirection or filename globbing in system()
  37     (since there is no POSIX shell beneath)
  38   What might work in future:
  39   - some I/O redirection
  40   - exec() might be made to work
  41   - Symbian::spawn("cmd args") returning a process id (what does Win32 do?)
  42   - Symbian::waitpid($spawned_pid)
  43
  44 =head2 Platform
  45
  46 - in S60 1.2 (at least in 3650 Nokia 3650 v3.11) setjmp/longjmp is
  47   fragile (see Symbian FAQ-0929), intensive debugging and fix needed
  48
  49 =head2 Unicode
  50
  51 - Symbian has Unicode filenames, and Unicode all over the place.
  52 - Encode and the use of Symbian Unicode in general
  53   tie into the overall usefulness of PerlIO.
  54
  55 =head2 Portability
  56
  57 - Slash versus Backslash: where does one need to use "\\"?
  58   writing Perl applications, where can one get away with using "/" ?
  59
  60 =head2 Build
  61
  62 - make xsbuild.pl much more robust (for building external extensions)
  63   (see symbian\ext\README and symbian\ext\Moped\Msg\README)
  64 - now the .mmp functions both as input and as output - bad
  65 - MakeMaker?  Pure PM, PM + XS?
  66 - currently the PerlApp UID is in both config.pl (hardwired) and
  67   in makesis.pl (computed), this is quite error prone
  68 - Enable building also under Cygwin? (could be really hard,
  69   the Symbian SDKs pretty much assume cmd.exe)
  70
  71 =head1 PACKAGING
  72
  73 - subdivide perlext.sis?
  74 - pm-stripper: strip pod and comments, while inserting the appropriate
  75   #line commands to keep linenumbers in sync.  Shaves off easily 50%
  76   of the code, making install packages smaller.
  77 - Get MakeMaker to create SIS packages?  In non-Win32?
  78 - Symbian has APIs for opening .zip files
  79 - Investigate Autrijus Tang's PAR format
  80   http://www.autrijus.org/par-intro/
  81
  82 =head1 PerlBase
  83
  84 - review for proper Symbian coding practices
  85
  86 =head1 PerlApp
  87
  88 - In "Run" see how one could show also the file extensions.
  89 - How to allow passing command line options to scripts being run?
  90 - Terminate/Pause menu entries (to be used while the script is running)?
  91 - review for proper Symbian coding practices
  92
  93 =head2 All UIs
  94
  95 - Make it possible to call UI elements (or any other Symbianic
  96   asynchronous services) from Perl.
  97
  98   There is now a sample of enabling calling CPerlUi::TextQueryDialogL()
  99   from Perl as PerlApp::TextQuery(), see symbian_utils.c.  This, however,
 100   does not work: calling the dialog code blocks so that the screen is not
 101   redrawn at all.  Perl should do both: "yield" so that the GUI framework
 102   can redraw, but in the meanwhile Perl should wait for the completion
 103   (OK or Cancel) of the dialog, but Perl must not exit the current PL_op.
 104   Welcome to the wonderful world of cooperative multitasking.  The right
 105   solution surely involves Active Objects.  The problem may require having
 106   a different Perl op dispatch loop than the standard and debug ones in
 107   run.c and dump.c.
 108
 109 - menu/toolbar support
 110 - selection lists (single cf multi cf radio)
 111 - on/off (special case of two-item radio selection list)
 112 - forms (multicontrols)
 113 - "secret editor" (special case of text query)
 114
 115 =head2 Series 60
 116
 117 - in S60 2.6 (at least in Nokia 6630 v4.03.11) launching scripts via
 118   FExplorer does not open up the console
 119
 120 =head2 Series 80
 121
 122 - On exit "PerlApp" gets Symbian USER Panic 44: "This panic is raised
 123   by the Free() and FreeZ() member functions of an RHeap. It is caused
 124   when the cell being freed overlaps the next cell on the free list
 125   (i.e. the first cell on the free list with an address higher than the
 126   one being freed)."  Reason unknown.
 127 - Hotkey Newline so that it functions as 'OK' in dialogs
 128
 129 =head2 UIQ
 130
 131 - UIQ 3.0? UIQ 2.0? (now only tried in UIQ 2.1)
 132 - UIQ, at least UIQ 2.1, does not have "file select dialogs" since
 133   "files" are supposed to be hidden from the user.  Therefore, no
 134   "Run" in PerlApp.  (For similar stylistic reasons there is no "Exit".)
 135 - Long notes (e.g. the EPerlAppCommandAbout) are shown badly truncated.
 136
 137 =head1 CPAN LIBRARIES
 138
 139 - Include/Package more modules (or work harder on getting CPAN.pm working?)
 140   (but note that lib/**/*.pm is 3.5 megabytes, probably not worth including
 141    all of it, even after pm-stripping):
 142         - libnet
 143         - Bundle::CPAN
 144                 - Archive::Tar (now included in 5.9.x)
 145                 - Term::ReadKey (useless?)
 146                 - Term::ReadLine (useless?)
 147         - Bundle::LWP
 148                 - URI
 149                 - HTML::TagSet
 150                 - HTML::Parser
 151                         - HTML::Entities
 152                 - HTML::HeadParser
 153                 - LWP
 154         - Crypt::SSLeay? (ssl?)
 155         - IMAP?
 156         - Net::Telnet?
 157         - Archive::Zip?
 158         - Mail::Send?
 159         - Date::Calc?
 160         - XML? XML::Simple? (expat?) (there is builtin xml support)
 161         - RSS?
 162         - DBI (DBD::???)
 163         - DBD::SQLite? (sqlite?)
 164         - SOAP? XML-RPC?
 165
 166 =head1 CORE LIBRARIES
 167
 168 - Fix Devel::PPPort (worth it?) (Note that there is D::PPP 3.x out by now)
 169 - Fix Encode to not to have writeable data: seems to be tricky indeed
 170   because of copious global non-const data.
 171 - Verify that the modified File::Spec::Win32 does work in Symbian.
 172   (File::Spec::Epoc does not seem to be relevant?)
 173 - What does Cwd really do since the concept of cwd is a bit fuzzy in Symbian.
 174 - What should Sys::Hostname return?  GPRS? BT? WLAN?
 175 - ByteLoader problem: byterun.c does not see VERSION and XS_VERSION.
 176 - POSIX problem: STDLIB POSIX is not that POSIX.
 177
 178 =head1 REGRESSION SUITE
 179
 180 - how to run the standard test suite on a Symbian device?
 181
 182 =head1 FUTURE POSSIBILITIES
 183
 184 - GUI support (problematic that the MVC model enforces an "application")
 185   (name suggestion: Moped::Gui)
 186   (see above for the need of sorting out the Active Objectedness)
 187 - Messaging support (sms:, mms:, mailto:, irdaobex:, btobex:,
 188   cell location, WLAN)
 189   (name suggestion: Moped::Msg)
 190 - PDA support (address book)
 191   (name suggestion: Moped::PDA)
 192 - Device support (memory, camera)
 193   (name suggestion: Moped::Dev::Memory, Moped::Dev::Drives, Moped::Dev::Camera)
 194 - Phone APIs (e.g. how to catch an incoming call: BIO messaging)
 195 - Remote console (Bluetooth/IR/USB?)
 196