		UNIX Morse Code Tutor, Version 2.2
		----------------------------------


About the source
----------------
The source code for Unixcw version 2.2 comes with a 'configure' file,
whose job it is to try and decide which features your system offers,
and then configures Unixcw the best way it can for these features.

At minimum, you will need a set of sound card definitions (usually in
the file soundcard.h) and a KIOCSOUND console sound ioctl available on
your system; this is necessary to build the CW library.  Note that
it's not necessary for the system doing the build to actually have a
sound card, nor for that matter, a working console speaker, but you
will need the definitions from various header files.  Of course, you
will need a sound card or console speaker if you want to run any of
the programs once they are built.

If you have a Curses library, Unixcw will build 'cwcp'.  And if you
have a Qt library and a C++ compiler, it will also build 'xcwcp'.  You
need to set the environment variable

    QTDIR

to indicate the Qt library directory on your system, for example

    export QTDIR=/usr/lib/qt-2.1.0

if QTDIR is not already set.  The configure script will look for the Qt
'moc' utility on either your current $PATH or in $QTDIR/bin.

Unixcw may port to other platforms, but the primary target systems on
which it should "just build", perhaps with a bit of tweaking as shown
above with environment variables, are:

    o Linux
    o Caldera Open UNIX
    o Caldera OpenServer


Building Unixcw version 2.2
---------------------------
To build the CW library and the Unixcw applications, you should be
able to type the following commands in the directory where you
unpacked the source code:

    ./configure
    make all

'configure' will tell you of any problems with missing features on
your system.  If you lack a Qt library, it will omit building 'xcwcp'.
If you lack a Curses library, it will omit building 'cwcp'.  The other
components should still build, however.


Installing the library, man pages, and programs
-----------------------------------------------
Assuming the 'make all' succeeded, you can now install the programs
with

    make install

By default, this will install everything under /usr/local.  You would
probably want to be 'root' to do this, otherwise you may not have the
permissions to do this.

Note that it is not necessary to install the programs in order to run
them.  You should be able to run any of them in the directories in
which they built themselves.

If you want icons for xcwcp, there are two Xpm icon files in the
xcwcp subdirectory:

    icon_xcwcp.xpm
    icon_mini_xcwcp.xpm

And as you will see if you look at them, I don't have much ability at
all in the area of graphic design.


Uninstalling Unixcw
-------------------

To uninstall the programs, use

    make uninstall

with the same user/permissions as you used for installing.  To clean
out the directory for a rebuild, use

    make distclean

If you have autoconf installed on your system, you can regenerate the
configure file, if you like, from configure.in, with

    make maintainer-clean
    autoconf


Notes
-----
Caldera OpenServer does not contain nroff/groff by default.  You will
therefore have to handle the man pages manually for this platform.

Caldera OpenServer contains a 'cw' binary as standard, in /usr/bin/cw.
Make sure that /usr/local/bin, or wherever you installed Unixcw, appears
first in your $PATH.

Under some circumstances, Caldera Open UNIX's curses library hijacks the
SIGALRM signal handler vector.  This causes cwcp to hang up, normally
just after stopping sending.  Until the curses library is changed, the
only current solution is to avoid using cwcp on Open UNIX, or to use the
Linux version of the program under Open UNIX's Linux Kernel Personality.
