INSTALLATION INSTRUCTIONS FOR SLIGHT

Unfortunately, this project is not autoconf-enabled yet.  Between qmake's
configuration and the small project size, I don't think autoconf is warrented.
So, you get to do it yourself.

REQUIREMENTS
============

1)  Working dmx4linux-2.2 drivers and accompanying libdmx.  The dmx.h header 
    is provided in this source directory.  I would highly, highly suggest 
    trying this software with the dmxdummy.o driver FIRST, and testing the 
    dmx driver installation with the dmxconsole utility provided with 
    dmx4linux package.  I cannot support installation and configuration
    questions relating to the dmx4linux driver set, so please don't
    email and ask me!

2)  Working installation of QT 3.0.  The MULTITHREADED version of the QT
    library is required: check in $QTDIR/lib and make sure a copy of 
    "qt-mt.so.3" resides there.  QT 3 is the widget library used because
    it was easier to code in than GTK or GTK--, and coding speed was 
    an important requirement.  

3)  A kernel with the Real-Time Clock enabled and headers installed for
    the kernel you're running.  SLight depends on the RTC for a consistent
    time pulse; if you recieve a message at the console that SLight can't
    open the real-time clock, you don't have it enabled.  Make sure you have
    /dev/rtc created and the appropriate module loaded or kernel option
    enabled.  If you're running a recent distribution (RedHat, Mandrake, etc.)
    you should be fine.
    

These are the only hard, fast requirements that I can think of.  I don't think
that versions of gcc, libc, or libstdc++ will matter when building from
source, but FYI, here are the versions this software was developed upon:

Kernel 2.4.18
GCC 3.0.4
LIBC 2.2.5
libstdc++ 3.0.4
QT 3.0.4 

While building from source shouldn't depend on these, providing binary
packages sure does!  (Maintaining C++ ABI compatibility is a pain in the rear.)
Ergo, this is a source-only distribution.


BUILDING
========

(These instructions assume that you have installed and verified operation
 of dmx4linux and QT 3.0)

1) qmake slight.pro
2) make

Hey, that was easy.  Now for the interesting bit: if you are planning on using
this software in a production environment, I STRONGLY recommend you install
it SUID root.  The timer thread can't increase its priority without the SUID
bit set, and you will NOT be happy with the performance on a fast fade if you
don't.  So, do this:

1) su
  (type in your root password)
2) chmod +s slight
3) chown root slight
4) chgrp root slight
5) cp slight /wherever/you/are/installing/it

Install the slight binary anywhere you want to.  There aren't any other files
that need to be copied.

----

If you (for some crazy reason) want to hack on this yourself (and, ::gasp::
send me patches!) you can build the Designer plugin for the channel panel
by running

1) qmake plugin.pro
2) make

and copying the resulting .so to your QT Designer plugins directory.  Or
doing an LD_PRELOAD=libchannelpanel.so before you run Designer.  Your call.


