Notes
-----
Configure generates only doxygen documentation.


Quick Start at your device
--------------------------
0. Install the dependencies:

libqt4-maemo5-gui, libqt4-maemo5-dev, libqt4-sql, libqt4-sql-sqlite, 
libqt4-sql-sqlite3-0,libqt4-maemo5-core, libqt4-maemo5-dbus.

1. Download the current deb package of MobileTrade (folder debian/).

2. Copy the deb package to your device.

3. Install the .deb package:

    dpkg -i mobile-trade.deb

4. Start MobileTrade:

    ./run-standalone.sh MobileTrade


Building the source in Scratchbox
---------------------------------
1. Launch Scratchbox.

2. Extract the files from the mobile-trade ZIP archive.

3. Go to the folder where mobile-trade.pro is located.

    qmake
    make

Select the target (ARMEL/X86) with 'sb-menu' before executing 'qmake/make'
depending on whether you are building for emulator (Xephyr) or device.


Running MobileTrade in Scratchbox with Xephyr (running example in emulator)
---------------------------------------------------------------------------
1. Launch Xephyr and Scratchbox:

    Xephyr :2 -host-cursor -screen 800x480x16 -dpi 96 -ac &

2. Under Scratchbox, run the following commands to use Xephyr and
   initialise the Hildon environment:

    export DISPLAY=":2"
    af-sb-init.sh start

3. Install the .deb package:

    dpkg -i mobile-trade.deb

4. Start MobileTrade from the QtImageViewer icon in the 'More' folder in
   the emulator.


Setting up Qt for Maemo/Meego (Maemo 5) at a Nokia N900 device
--------------------------------------------------------------
Enabling root access:
1. Activate Extras-devel
        Application manager > Application catalogs > New
        Catalog name: Maemo Extras-devel
        Web address: http://repository.maemo.org/extras-devel
        Distribution: fremantle
        Components: free non-free

Before clicking 'Save', ensure that the catalogue it's not disabled!
2. Browse > Application manager > Search > Type rootsh > Search > rootsh

Wait for the Application manager to install the application. Then use the
terminal to install Qt libraries.

3. Menu > More > X Terminal

sudo gainroot
apt-get update
apt-get install libqt4-maemo5-gui


Installing and running based on Maemo Extras-devel
--------------------------------------------------
Enabling root access:
1. Activate Extras-devel
        Application manager > Application catalogs > New
        Catalog name: Maemo Extras-devel
        Web address: http://repository.maemo.org/extras-devel
        Distribution: fremantle
        Components: free non-free

Before clicking 'Save', ensure that the catalogue is not disabled!
2. Browse > Application manager > Search > Type rootsh > Search > rootsh

Wait for the Application manager to install the application.

3. Transfer the 'mobile-trade.deb' package to the Nokia N900 device.

4. Use the terminal to install the application:

Menu > More > X Terminal

sudo gainroot
dpkg -i path/to/mobile-trade.deb

5. Start the application from the Mobile-trade icon in the 'More' folder 
on the Nokia N900 device.

For more instructions on how to set up the Maemo 5 SDK / Scratchbox /
Qt for Maemo, please see:
http://www.forum.nokia.com/Technology_Topics/Device_Platforms/Maemo.xhtml
http://qt.nokia.com [Qt documentation]


Build & installation instructions for WINDOWS / LINUX / MAC OS
--------------------------------------------------------------
You need Qt SDK installed to build the example source:

1. Extract the files from the Mobile-trade ZIP archive.

2. Go to the folder where mobile-trade.pro is located.

   qmake
   make

For instructions on how to set up Qt for your platform, please see:
http://qt.nokia.com [Qt documentation]


--------------------------------------------------------------------------------

COMPATIBILITY

Qt 4.6 (for Maemo Technology Preview 2) [http://qt.nokia.com/downloads].

Tested on Nokia N900.

Developed and tested using Qt Creator.

