1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108
|
UNIX Morse Code Tutor, Version 2
--------------------------------
About the source
----------------
The source code for Unixcw version 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 KIOCSOUND console sound ioctl available on
your system; this is necessary to build the CW library.
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
-------------------------
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 Personality.
|