Move XSLoader from ext/ to dist/
[perl.git] / 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