

                INSTALLATION, RUNNING, REMOVAL


-------------------------------------------------------------------
INSTALLATION
-------------------------------------------------------------------

Once uncompressed in a temporary directory, you may or may not
have to do some editings depending on your system and your needs.
In case you do, then follow the steps explained here.

From this point onward, we will assume that you have uncompressed
the tar file in /tmp/qu:


    $ tar -xzf qu-xxx.tar.gz
                  |
                  +-- the source file, e.g. qu-latest.tar.gz


To compile and install all you need to do is:

	$ cd /tmp/qu
	$ ./configure
	$ make
	$ make install


If configure fails then our configuration program is not familiar
with your platform. It is generally useless to proceed. So just
send us a message and we'll do better in the next version.

If you made it to 'make' then Qu has been successfully compiled.
The last line, 'make install', will execute a Qu installer program.
This program will check for versions, install the files in the
appropriate directories, including the documentations. It is an
interactive program so just follow the instructions.

If make install failed, you can install Qu manually:

	- create directory /opt/qu
	- create directory /opt/qu/bin
	- copy the qu executable /tmp/qu/src/qu to /opt/qu/bin
	- copy the version file /tmp/qu/VERSION to /opt/qu/bin/VERSION
	- copy the whole directory /tmp/qu/lib to /opt/qu/lib
	- copy the whole directory /tmp/qu/include to /opt/qu/include
	- copy the file /tmp/qu/config.h to /opt/qu/config.h
	- make a link /usr/bin/qu to /opt/qu/bin/qu
	- copy the whole directory /tmp/qu/demo to /opt/qu/demo


Before you start, however, you might want to check if there are
any extra options to configure:

	$ ./configure --help


That would show you a help screen with options you can set. You might
see some extra options, for example:

	--enable-debug      Turn on debugging


Unless you are developing or debugging, do not set the debugging
options, otherwise you would change the ./configure line with:

	$ ./configure --enable-debug


Suppose you have profound reasons not to install in /opt/qu, then:

	$ ./configure --prefix=/foo/bar


but don't do this!


-------------------------------------------------------------------
RUNNING
-------------------------------------------------------------------

The installer should have created a symbolic link named qu in your
executable directory (/usr/bin/qu) pointing to the real executable
/opt/qu/bin/qu.

Now try this to see a help screen:

	$ qu


To run the hello.qu demo program:

	$ cd /opt/qu/demo
	$ qu hello


-------------------------------------------------------------------
REMOVAL
-------------------------------------------------------------------

Assuming that you have installed in /opt/qu, then simply do this:

	$ rm -fR /opt/qu
	$ rm -f  /usr/bin/qu



That's it!
