A generic morse-code practice utility for Unix systems.

Currently supported devices:
 Sun:    Sun workstation with audio hardware.
 HP:     HP9000s700 with audio hardware.
 X11:    The X11 window system. (Warning: not all X11 implementations handle
         duration and frequency of beeps properly!)
 Indigo: The SGI Indigo workstation. (See comments in beepIndigo.c about
         caveats and limitations.)
 Linux:  The IBM PC console speaker.
 AdLib:  AdLib/SoundBlaster FM chip. (See comments in beepAdLib.c about
         caveats and limitations.)
 OSS:    Open Sound System /dev/dsp device.

Adding a new device is as simple as creating a new implementation of the
beep.h interface. See beep*.[ch] for examples and documentation.
Please send any additions to the authors!!

A modified version of the program "QSO" by Paul J. Drongowski is also included.

                            Morse Code Table

        A  .-          N  -.          1  .----       .  .-.-.-
        B  -...        O  ---         2  ..---       ,  --..--
        C  -.-.        P  .--.        3  ...--       ?  ..--..
        D  -..         Q  --.-        4  ....-       (  -.--.
        E  .           R  .-.         5  .....       -  -....-
        F  ..-.        S  ...         6  -....
        G  --.         T  -           7  --...
        H  ....        U  ..-         8  ---..
        I  ..          V  ...-        9  ----.
        J  .---        W  .--         0  -----
        K  -.-         X  -..-        /  -..-.
        L  .-..        Y  -.--        +  .-.-.
        M  --          Z  --..        =  -...-

The following characters are included if one defines ALLPUNCTUATION :

        )  -.--.-      "  .-..-.      _  ..--.-      '  .----.
        :  ---...      ;  -.-.-.      $  ...-..-     !  -.-.--

            Procedural Signals (Prosigns) for Morse Code

<AR>    "+" over, end of message
<AS>    "*" please stand by (<AS> 5  Wait 5 Minutes) (".-...")
<BT>    "=" (double dash) pause, break for text
CL          going off the air (clear)
CQ          calling any station
K           go, invite any station to transmit
<KN>    "(" go only, invite a specific station to transmit
R           all received OK
<SK>    "%" end of contact (sent before call) ("...-.-", known also as <VA>)

The following Procedural Signals (Prosigns) are included if one
defines ALLPROSIGNS :

<AA>    "^" new line (".-.-", the same as :a, ae)
<BK>    "#" invite receiving station to transmit ("-...-.-")
<KA>    "&" attention ("-.-.-")
<SN>    "@" understood ("...-.")

The following characters are included if one defines ALLINTERNATIONAL :

        :a  .-.-   (also for ae, the same as <AA>)
        `a  .--.-  (also oa, danish a with ring over it)
        ch  ----   (bar-ch ?, bar-h ?, ISO 8859-1 code 199 and 231 ?)
        -d  ..--.  (eth, overstrike d with -, ISO 8859-1 code 208 and 240)
        `e  ..-..
        ~n  --.--
        :o  ---.   (also for oe)
        :u  ..--   (also for ue)
        ]p  .--..  (thorn, overstrike ] with p, ISO 8859-1 code 222 and 254)
        paragraph  .-.-..  (ISO 8859-1 code 167 ?)

Special Characters and Groups (never included, placed here for completeness) :

Multiplication sign  -..-  (the same as x, ISO 8859-1 code 215 ?)

"Mistake, delete the last word"  ........  (actually six or more dots are
used for this purpose, eight dots are recommended).

Cut Numbers :
1   .-      6   -...           1   .-      6   -....
2   ..-     7   --.            2   ..-     7   -...
3   .--     8   -..            3   ...-    8   -..
4   ...-    9   -.             4   ....-   9   -.
5   ...     0   -              5   .       0   -

Written by:
  Joe Dellinger, Hawaii Institute of Geophysics, University of Hawaii at Manoa
  submitted to comp.sources.misc Dec 15 1993
  Revised version submitted to comp.sources.misc Nov 22 1994

- joe@sep.stanford.edu
  jdellinger@trc.amoco.com
  joe@soest.hawaii.edu

This version dated:
	Wed Jan 17 09:43:16 CET 2001

