~ubuntu-branches/ubuntu/edgy/morse/edgy

.\"Generated by db2man.xsl. Don't modify this, modify the source.

.de Sh \" Subsection

.br

.if t .Sp

.ne 5

.PP

\fB\\$1\fR

.PP

..

.de Sp \" Vertical space (when we can't use .PP)

.if t .sp .5v

.if n .sp

..

.de Ip \" List item

.br

.ie \\n(.$>=3 .ne \\$3

.el .ne 3

.IP "\\$1" \\$2

..

.TH "MORSE" 1 "" "" ""

.SH NAME

morse, QSO \- Morse-code trainer and QSO generator for aspiring radio hams

.SH "SYNOPSIS"

.ad l

.hy 0

.HP 6

\fBmorse\fR [\-i] [\-I] [\-r] [\-n\ \fInum\fR] [\-R\ \fInum\fR] [\-N\ \fInum\fR] [\-C\ \fIcharset\fR] [\-w\ \fInum\fR] [\-f\ \fInum\fR] [\-v\ \fInum\fR] [\-g\ \fInum\fR] [\-f\ \fInum\fR] [\-e] [\-c] [\-b] [\-a] [\-l] [\-m] [\-t] [\-T] [\-s] [\-q] [\-p\ \fInum\fR] [\-E\ \fInum\fR] [\-M\ \fInum\fR] [\-d] [\-A] [\-B] [\-S] [\-x\ \fInum\fR] [\-X\ \fInum\fR] [\fIword\fR...]

.ad

.hy

 

.SH "DESCRIPTION"

 

.PP

The \fBmorse\fR program is a Morse\-code trainer intended to help aspiring radio hams pass the 5\-word\-per\-minute Element 1 test\&. It can take test text from a text file on standard input, or test words from its command\-line arguments, or generate random text (\-r) or play back what you type (\-i)\&.

 

.PP

A helper program, \fBQSO\fR, generates plausible QSOs that can be fed to the standard input of \fBmorse\fR\&.

 

.PP

The following options control the behavior of \fBmorse\fR:

 

.TP

\-i

Play what you type\&.

 

.TP

\-I

Like \-i but don't turn off keyboard echoing\&.

 

.TP

\-r

Generate random text\&. Starts out slanted towards easy letters, then slants towards ones you get wrong\&.

 

.TP

\-n NUM

Make words (groups) NUM characters long\&. Valid values are between 1 and 20\&.

 

.TP

\-R NUM

Set the total time (in minutes) to generate text\&.

 

.TP

\-N NUM (default 0 means unlimited)

Set the total number of words (groups) to generate\&.

 

.TP

\-C 'STRING' (default all available characters)

Select characters to send from this STRING only\&.

 

.TP

\-w

words_per_minute

 

.TP

\-f

frequency_in_hertz

 

.TP

\-v

volume (zero to one, rather nonlinear)

 

.TP

\-g

alternate_frequency (toggles via control\-G in input FILE at a word break)

 

.TP

\-F

Farnsworth_character_words_per_minute

 

.TP

\-e

leave off the <SK> sound at the end

 

.TP

\-c

complain about illegal characters instead of just ignoring them

 

.TP

\-b

print each word before doing it

 

.TP

\-a

print each word after doing it

 

.TP

\-l

print each letter just before doing it

 

.TP

\-m

print morse dots and dashes as they sound (this printing\-intensive option slows the wpm down!)

 

.TP

\-t

Type along with the morse, but don't see what you're typing (unless you make a mistake)\&. You are allowed to get ahead as much as you want\&. If you get too far behind it will stop and resync with you\&. You can force it to resync at the next word end by hitting control\-H\&. Hit ESC to see how you are doing, control\-D to end\&. (The rightmost space in the printout marks where the average is\&. Farther left spaces separate off blocks of letters that are about twice as probable as the average to occur, three times, etc\&.)

 

.TP

\-T

Like \-t but see your characters (after they are played)\&.

 

.TP

\-s

Stop after each character and make sure you get it right\&. (implies \-t)

 

.TP

\-q

Quietly resyncs with your input (after you make a mistake)\&.

 

.TP

\-p NUM

Make you get it right NUM times, for penance\&. (implies \-s)\&.

 

.TP

\-E NUM

If your count of wrong answers minus right answers for a given character exceeds this, the program will start prompting you\&. If above the maximum error prompt it will never prompt (implies \-t)\&.

 

.TP

\-M NUM

If you get more than this number of characters behind, pause until you do your next letter\&. 1 behind is normal, 0 behind means never pause\&. This option mplies \-t\&.

 

.TP

\-d

Dynamically speed up or slow down depending on how you are doing\&. (if also\-s, then \-d \fIonly speeds up\fR!)

 

.TP

\-A

Add ISO 8859\-1 (Latin\-1) signs to test set\&.

 

.TP

\-B

Add uncommon punctuation to test set\&.

 

.TP

\-S

Add uncommon prosigns to test set\&.

 

.TP

\-X

Set error volume\&. Error volume 0 means use console speaker\&.

 

.TP

\-x

Set frequency of error tone\&.

 

.PP

Here is the basic International Morse codest that the program will train you in:

 

.IP

 

        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  \-\-\&.\&.        =  \-\&.\&.\&.\-

 

.PP

The following characters are included if one uses the \-B option:

 

.IP

 

        )  \-\&.\-\-\&.\-      "  \&.\-\&.\&.\-\&.      _  \&.\&.\-\-\&.\-      '  \&.\-\-\-\-\&.

        :  \-\-\-\&.\&.\&.      ;  \-\&.\-\&.\-\&.      $  \&.\&.\&.\-\&.\&.\-     !  \-\&.\-\&.\-\-

 

.PP

The following procedural signals (prosigns) are also included if one uses \-B:

 

.IP

 

<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>)

 

.PP

The following less\-used prosigns are included if one uses the \-S option:

 

.IP

 

<AA>    "^" new line ("\&.\-\&.\-", the same as :a, ae)

<BK>    "#" invite receiving station to transmit ("\-\&.\&.\&.\-\&.\-")

<KA>    "&" attention ("\-\&.\-\&.\-")

<SN>    "@" understood ("\&.\&.\&.\-\&.")

 

.PP

The following characters are included if one uses the \-A option:

 

.IP

 

        :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 ?)

 

.PP

For the raw beginner trying to learn morse code, we recommend the following sequence:

 

.TP 3

1.

Start learning the alphabet:

 

.nf

 

morse \-r \-s \-T \-d \-w 5 \-F 15 \-p 5 \-E \-10

 

.fi

.TP

2.

Then drill drill drill:

 

.nf

 

morse \-r \-s \-T \-d \-w 5 \-F 15 \-p 5 \-E 0

 

.fi

.TP

3.

Real\-time drill, with hints if you really need it:

 

.nf

 

morse \-r \-T \-d \-w 5 \-F 15 \-M 2 \-E 4

 

.fi

.TP

4.

Simulated test:

 

.nf

 

QSO | morse \-e \-T \-d \-w 5 \-F 15

 

.fi

.TP

5.

The dreaded random\-letter test:

 

.nf

 

morse \-r \-T \-d \-w 5 \-F 15

 

.fi

.TP

6.

Finally try for greater and greater speed:

 

.nf

 

morse \-r \-T \-d \-w 13 \-F 24

 

.fi

.LP

 

.SH "AUTHORS"

 

.PP

Joe Dellinger <joe@montebello\&.soest\&.hawaii\&.edu>\&.

 

.PP

Updated 2005 by Eric S\&. Raymond <esr@thyrsus\&.com>\&.

 

.PP

Other contributions by Jacek M\&. Holeczek and Marc Unangst\&.