README
------
Andre Beckedorf < evilJazz AT katastrophos DOT net >


DISCLAIMER
----------
Everything in this directory is provided AS IS without any WARRANTY or
LIABILITIY of any kind implicitly or explicitly whatsoever.
In other words: IF SOMETHING GOES WRONG, IT'S YOUR FAULT, NOT MINE!


PREREQUISITES
-------------
In order to build the Quasar Media Player, you'll need a working
Qtopia or Qt3 SDK, a working cross-compiler setup and the usual build tools
(make, binutils etc).
For Qtopia and Zaurus development, Sharp's cross-compiler environment (see
below) will work okay.
You'll also need ccache for accelerated consecutive compilations. Most
project files rely on ccache. If you don't want to use it, just modify the
project file and remove the ccache calls.

Here are the cross-compiler environments I've used to build Quasar:

Qtopia / SharpROM:
------------------

My mirror:
http://www.katastrophos.net/zaurus/mirrors/externe.net/zaurus/sdk/Embedix.tgz
http://www.katastrophos.net/zaurus/mirrors/externe.net/zaurus/sdk/Qtopia.tgz

Externe.net
http://www.externe.net/zaurus/sdk/Embedix.tgz
http://www.externe.net/zaurus/sdk/Qtopia.tgz


Qt3 / pdaXrom:
--------------

ibiblio.org:
http://distro.ibiblio.org/pub/linux/distributions/pdaxrom/download/1.1.0beta1/Zaurus-7x0-860/cross-sdk-armv5tel-cacko-linux-3.4.5-2.2.5-softfloat.tar.bz2

My mirror:
http://www.katastrophos.net/zaurus/mirrors/pdaxrom/download/1.1.0beta1/Zaurus-7x0-860/cross-sdk-armv5tel-cacko-linux-3.4.5-2.2.5-softfloat.tar.bz2


The "distro" directory contains two example scripts "dev-arm-qpe.sh" and
"dev-arm-pdaxrom.sh" that will setup the environment variables for both
cross-compilers.


MANUAL BUILD
------------

For Qtopia use the following command to create a Makefile:

tmake quasar-qtopia.pro > Makefile

For pdaXrom use this command to create the Makefile:

qmake quasar-pdaxrom.pro

For native X11 compilation use this:

qmake quasar-qt.pro

If the Makefile was created successfully, do a simple

make

to create the "quasar" binary.


AUTOMATIC BUILD via makedistros.sh
----------------------------------

The included script "makedistros.sh" will take care of automatically
building the software. Make sure to setup both cross-compiler environments
correctly before proceeding. 
Included are two files "dev-arm-qpe.sh" and "dev-arm-pdaxrom.sh" that set 
the necessary environment variables. You'll probably need to adjust them 
and the "makedistros.sh" script to work on your machine.
If everything works as expected, you should have two IPK files waiting for
you in the distro/output directory.

