Copyright (C) 2007 Nokia Corporation. All rights reserved.


RELEASE NOTES
=============

RELEASE INFORMATION

Project:           maemo 4.0 'chinook' Development Platform
Version:           4.0
Baseline:          ITOS Chinook
Date:              2007-09-17


GENERAL INFORMATION
===================

This is maemo Development Platform 4.0 beta containing the following
components:

 - i386 development environment
 - armel development environment
 - maemo SDK installer
 - Scratchbox installer

Maemo SDK 4.0 beta release provides a development environment for
porting software for the upcoming Internet Tablet 'chinook' software
release. This release replaces maemo SDK 4.0 alpha release, but does
not replace maemo SDK 3.x bora releases.

The SDK contains a large number of headers, libraries and tools that
are needed to develop software for the selected target system. The SDK
is installed inside the Scratchbox cross compilation environment.

This release includes two targets for two different architectures
and purposes:

- i386: The i386 environment is used during the development stage of the 
  software. Majority of development work is done in the i386 environment 
  inside Scratchbox.

- ARMEL: The ARMEL environment can be used for cross compiling software
  for the device. Note that software built with this SDK does not run in 
  any published ITOS software.


NEWS
====

 - There are binary interface and programming interface breaks in many
   subsystems. Please see 

   http://maemo.org/development/documentation/how-tos/4-x/api_changes_between_maemo_3_2_and_maemo_4_0.html

   for further information on porting.

 - glibc has been upgraded to version 2.5. This also affects the toolchain.

 - Scratchbox installer installs and takes into use the new debian-etch 
   devkit with updated packaging tools.

 - Most of the Scratchbox tools are delivered also as packages for both 
   i386 and ARMEL environments. All virtual tools packages have been removed.

 - Xephyr should be started with new command line parameters:
      Xephyr :2 -host-cursor -screen 800x480x16 -dpi 96 -ac -extension Composite

 - Fixed bugs (see bugs.maemo.org for details): 

   844  xsltproc segfaults when run from gtkdoc-mkhtml
   947  bora rootstrap lacks pkg-config
   955  libstdc++-dev cannot be installed
   1018 gnome-autogen.sh broken
   1942 CDBS is asking automake 1.9 and patchutils
   1940 Unmet dependencies in 4.0 sdk (perl, perl5, dist-upgrade)

 - Libraries not present in ITOS, but that have been provided in SDK have
   been removed.

 - Some libraries present in ITOS, but which should not be used directly
   have been removed: libosso-gsf, libart.

SOFTWARE AND HARDWARE REQUIREMENTS
==================================

Recommended minimum hardware setup:
 - Please visit http://www.scratchbox.org/ for detailed information
    about hardware requirements.
 
Software:
 - Scratchbox Apophis R4 or later. Please see INSTALL.txt for more detailed
   version requirements.

This release was tested on Ubuntu Feisty Linux distribution, but it 
should also work on other Scratchbox supported operating systems.


FEATURES
========

Hildon Application Framework
 - application framework libraries
 - home/desktop
 - control panel
 - task navigator
 - games wrapper

Multimedia subsystem
 - Audio and video
 - gstreamer and plugins included

System software subsystem
 - Alarm subsystem
 - HAL

Connectivity subsystem
 - UPnP 
 - Samba
 - Bluetooth libraries
 - WLAN libraries

Full package management, apt support
 - All the required tools are included.
 - Most of the tools are included also as Debian packages.

INSTALLATION INSTRUCTIONS
=========================

Please see the INSTALL.txt file under this directory. 


KNOWN LIMITATIONS
=================

 - Nokia binaries installer is not included. GPS subsystem and email interface
   are missing due to this.

 - Virtual keyboard is not provided.

 - You cannot test software built with this SDK on any released ITOS version.

 - Unnecessary warnings and debugging messages are printed out when the
   Hildon Application Framework is started.

 - In some Ubuntu Edgy Linux installation the networking might not
   work from inside Scratchbox. The workaround is to reset the target
   and reinstall the rootstraps.

 - Xephyr is not included in SDK and should be installed to host system 
   instead. See the INSTALL.txt file for details.



RELEASE FEEDBACK
================

General feedback about this release can be send to:

    chinook-feedback@maemo.org

maemo 4.0 'chinook' related bug reports should be reported to the
maemo bugzilla.

---
END