Welcome to CW Trainer!

Legal Stuff:

This application and its source code are hereby released under the
GPL, Version 2. Please find the enclosed LICENSE for more information
on the GPL.

Initial release date is 2/15/2002 by John Wagner, N1QO -
john@wagner-usa.net

The program uses Source Code from Ray Goff, G4FON - notably the
EncodeSineWave function. This code is used by permission from Ray.  It
should also be noted that Ray gave me the source code to his windows
program and from that I was inspired to write this program.

The files lcdrange.h and lcdrange.cpp are from the QT Tutorial.
These files may be removed at a later date.

********** BEFORE YOU SUBMIT REQUESTS FOR FEATURES ********** 
********** BEFORE YOU SUBMIT REQUESTS FOR FEATURES ********** 
********** BEFORE YOU SUBMIT REQUESTS FOR FEATURES ********** 

Please read the file TODO - the early versions of this program are
more or less working prototypes intended to get something [anything]
out there for Linux to help people learn CW. Numerous features are
planned as well as a general unfudging of the source code. Again, the
early versions are out here just so people have something to use.

Purpose:

This application is intended to teach Morse Code (CW). 

It supports the Koch method;

	Teach at high speed, starting with two characters. When
	those character is recognized 90% of the time then add
	another character. Repeat until using all characters and 90%
	correctness is achieved... then speed up and start over!

Koch Method Resources:
Dave Finley, N1IRZ - http://www.sdc.org/~finley/
Windows software by Ray Goff, G4FON - http://www.qsl.net/g4fon
Go to http://www.google.com/ - type in "koch method" - tons of pages

It supports the Farnsworth method;

	Fast character speed (typically 20wpm) but wide character
	space (start at 5 wpm). Can use all characters at the same
	time or use with the Koch method above.

Farnsworth Method Resources:
Go to http://www.google.com/ - type in "farnsworth cw" - tons of pages

Requires QT Version 2.x (I use 2.3.1) and a Linux system with /dev/dsp
sound support.

Installation:

Unpack the archive: 

tar zxvf cwtrainer.tar.gz

Ensure you have your QTDIR environment variable set;

export QTDIR=/usr/lib/qt-2.3.1

(yours may be different)

type: make

You should now have an executable called "cwtrainer"

Run it!: ./cwtrainer

A cwtrainer.pro file is included for tmake users who want to hack on
the program.

The "Load File..." will read a text file and play it as CW. At the
moment you will note that once you hit the "Stop CW" or "Start CW"
button, you will need to reload the file if you want to play it again.
A sample QSO is included in the file "qso.txt". Also note that Prosigns
are supported in the text file, append a ^ before the prosign;

Examples: ^AR ^BK ^BT ^SK

Maintainer:
John Wagner, N1QO - john@wagner-usa.net (original author)

Thanks to:
Ray Goff, G4FON - Source code to Koch
Karl Larsen, K5DI - testing and suggestions

History:
2/13/2002 - Version 0.01 - First public release
