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


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

RELEASE INFORMATION

Project:           maemo 4.0.1 Chinook Development Platform
Version:           4.0.1
Baseline:          OS2008 2.2007.51-3
Date:              2008-02-18
Updated:           2008-06-02


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

This is maemo Development Platform 4.0.1 containing the following
components:

 - i386 development environment
 - armel development environment
 - maemo SDK installer
 - Scratchbox installer
 - Nokia EUSA licensed binaries installer

Maemo SDK 4.0.1 release provides a development environment for porting 
software for the OS2008 software release. This release replaces maemo
SDK 4.0 release.

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 runs only in 
  OS2008 software.


NEWS
====

 - The baseline for this SDK has been updated to the OS2008 (51-3) sales release.

 - Some packages have been upgraded. Please refer to the content comparison
   table between 4.0 and 4.0.1 for the details, found in the same place as the 
   release notes.

 - cputransparency devkit: Although there is an updated version available in scratchbox.org, 
   the version to be used in Chinook  is 1.0.3.

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

  2417    No includes for libapt-pkg (aka libapt-pkg-dev)
  2917    libgdbm-dev is reported missing with chinook's apt-get
  2766    Missing libxslt1-dev in chinook
  2901    Can't install blues-utils-tools on current n810.


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
 - virtual keyboard
 - libglade

Multimedia subsystem
 - Audio and video
 - gstreamer and plugins included

System software subsystem
 - Alarm subsystem
 - HAL

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

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

Others
 - Email interface

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

Please see the INSTALL.txt file under this directory. 


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

 - 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.

-  In order to install local packages using application manager, one needs 
   to make a symbolic link as  follows inside scratchbox under both armel 
   and i386 targets:
   $ ln -s /scratchbox/tools/bin/fakeroot /usr/bin/fakeroot
   This will be fixed in the next release of the SDK.

-  Scratchbox Apophis may have some problems with your system's default
   settings especially on Ubuntu Hardy.
   Two known limitations are: 
   1. Scratchbox does not work when the host kernel VDSO support is enabled
   2. Scratchbox qemu is incompatible with host kernel mmap_min addr value > 4096. 
      This results in problems with qemu in armel target, eg: unable to
      compile or build pacakages.

   The scratchbox and SDK installers are updated to handle this.
    

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

General feedback about this release can be send to:

    chinook-feedback@maemo.org

Maemo 4.0.1 Chinook related bug reports should be reported to the
maemo bugzilla.

---
END