DISTRIBUTION PACKAGES

The recommended method of installing Qemu Launcher is by using the
packages available for your operating system via standard package
management systems. Currently the packages are available for Debian,
FreeBSD, and possibly others.

Dear package maintainers, we are more than willing to fix our bugs, but
we cannot do that if you do not tell us about them. 


SOFTWARE REQUIREMENTS

If you decided to install from source rather than using distribution
packages, you will have to make sure that the following software is
already installed on your system:

  Perl interpreter            (5.8.8)
  Gtk2 Perl module            (1.140)
  Gtk2::GladeXML Perl module  (1.006)
  Locale::gettext Perl module (1.05)
  QEMU emulator suite         (0.8.2)

You will also need to have gzip compression utility installed during
the build process, but it is not needed to actually run Qemu Launcher.
No GNOME libraries are needed.

The version numbers in the list signify the last tested version. Earlier
or later versions may or may not work. QEMU 0.7.x is not supported!


INSTALLING

To install Qemu Launcher, become root, and run the following command
from inside the source directory:

  make install

This will install all necessary files under '/usr/local' in appropriate
directories. If you want to install it to other location, you can pass
an optional PREFIX parameter. For example:

  make install PREFIX=/usr

To uninstall it afterwards, run the following command the same way you
did during install:

  make uninstall

If you specified PREFIX during install, you will also have to specify it
during uninstall.


RUNNING LOCALLY

The trick is that you do not really have to install Qemu Launcher to be
able to run it. You can run it directly from the source directory like
this:

  perl qemu-launcher.pl

Note that some features like i18n will not be available.
