PyUIQ

File Release Notes and Changelog

Release Name: 0.1

Notes:
==================================
Python for UIQ (PyUIQ), 13.03.2007
==================================

This is Python for UIQ 2.1 and UIQ 3 v0.1 (hereafter PyUIQ). This preliminary 
port is based on Python for S60 (hereafter PyS60) port created by Nokia 
Corporation which is based on Python 2.2.2.

TRADEMARKS
----------

Python and the Python logo are registered trademarks of the Python
Software Foundation.

LICENSING
---------

Copyright (c) 2007 TietoEnator Telecom & Media Oy. This is Python for UIQ 
created by TietoEnator Telecom & Media Oy based on Python for S60. Files added 
or modified by TietoEnator Telecom & Media Oy are licensed under Apache License 
Version 2.0. 

The licensing information of the original software Python for S60 is as follows:

Copyright (c) 2005-2006 Nokia Corporation. This is Python for S60
created by Nokia Corporation. Files added by Nokia Corporation are
licensed under Apache License Version 2.0. The original software,
including modifications of Nokia Corporation therein, is licensed
under the applicable license(s) for Python 2.2.2, unless specifically
indicated otherwise in the relevant source code file.

See http://www.apache.org/licenses/LICENSE-2.0
and http://www.python.org/2.2.2/license.html

CHANGES TO PYS60
----------------

Please see "changes_UIQ.txt".

Installation to emulator
------------------------

Unzip the "sdk_files.zip" to your UIQ "<UIQ_ROOT>\epoc" root folder, make sure 
that the folders align with your SDK installation.

Usage in emulator
-----------------

Start the "Python" application from the emulator menu. This launches the script 
"default.py" found from:

"<UIQ_ROOT>\epoc32\release\wins\udeb\z\system\apps\PYTHON"

For testing other features and functionalities, replace "default.py" with your 
own script, rename it as "default.py" as the script search path is hard coded.

The current "default.py" included in the distribution is a simple script 
demonstrating the application menu and text widget.

Supported features
------------------

NOTE: No formal testing has been done for this release, the below list acts 
therefore only as a guideline.

For the supported features, please see the screenshots illustrating the current 
funtionality.

The following extensions are supported:

calendar  (does not show the entries in agenda application)
e32db
graphics  ("Image.open" is not supported)
inbox
audio     (not supported currently in UIQ21)
socket
telephone
zlib

The Python standard library support is as in Python for S60 1.3.18 version, 
refer to "API_Reference_for_Python" available from:

http://sourceforge.net/project/showfiles.php?group_id=154155

The following extensions are not currently supported:

contacts
location
messaging
sysinfo
camera

Native UI widgets, except "appuifw.Text" and the application menu, are not 
supported.

Unistallation
-------------

Run the "uninstall_PythonForS60_SDK_UIQ21.cmd".

Building
--------

Download the Python for S60 source code version 1.3.18 from:

http://sourceforge.net/project/showfiles.php?group_id=154155

Apply the "PyS60_UIQ.patch" to the PyS60 source code downloaded.

After this invoke:

  N:\PyUIQ>python setup.py obb UIQ30
  
    --> For building Python for UIQ 3
  
  N:\PyUIQ>python setup.py obb UIQ21
  
    --> For building Python for UIQ 2.1

Supported devices
-----------------

The current port has been tested only in SonyEricsson p910i but it should 
support other devices also based on UIQ 2.1 (e.g. Motorola A1000 and Benq P30 -
please see http://www.uiq.com/uiqphones.html for more information).

The UIQ3 version has been tested only in emulator.

Detailed versions
-----------------

This port is otherwise based on PyS60 version 1.3.18, except "socket" which is 
based on PyS60 version 1.3.14 and "appui" which is based on PyS60 version 
1.3.11.


Changes: