File: INSTALLING

package info (click to toggle)
unixcw 2.0-6
  • links: PTS
  • area: main
  • in suites: woody
  • size: 764 kB
  • ctags: 645
  • sloc: ansic: 5,693; cpp: 1,736; makefile: 333; sh: 213; awk: 209
file content (108 lines) | stat: -rw-r--r-- 3,407 bytes parent folder | download
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.