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 (http://ccache.samba.org) 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.


Qt3 / MinGW / Windows:
----------------------

You may use any MinGW toolchain that is capable of compiling the 
Q... Windows Edition (GPLed Qt 3.x code for Windows).
Although the project is closed, the source code is still available and has
been used to create the Windows binaries of Quasar.

Check out:
http://qtwin.sourceforge.net

Detailed instructions on how to set up the build environment are here:
http://qtwin.sourceforge.net/qt3-win32/compile-mingw.php


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

For Qtopia use the following command to create a Makefile:

tmake quasar-common.pro.in quasar-sharp-qtopia.pro > Makefile

For pdaXrom use this command to create the Makefile:

qmake quasar-pdaxrom.pro

To compile with the MinGW toolchain please use:

qmake quasar-mingw.pro

For native X11 compilation use this:

qmake quasar-qt3.pro

If the Makefile was created successfully, do a simple

make

to create the "quasar" or "quasar.exe" binary.


AUTOMATIC BUILD via makedistro-* scripts
----------------------------------------

The included scripts in the "distro" subdirectory will take care of
automatically building the software:

  makedistro-pdaxrom.sh
  makedistro-sharp-qtopia.sh
  makedistro-windows.sh

Make sure to setup your cross-compiler environment correctly before proceeding. 
Included are three scripts in distro/tools that set the necessary environment 
variables:

  devenv-arm-pdaxrom.sh
  devenv-arm-sharp-qtopia.sh
  devenv-x86-mingw.sh

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 the distribution files waiting
for you in the distro/output directory.
