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
|
.\"
.\" CW Tutor Package, (c)1997, Simon Baldwin G0FRD
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\"
.\"
.TH CWGEN 1 "CW Tutor Package" "G0FRD" \" -*- nroff -*-
.SH NAME
.\"
cwgen \- generate groups of random characters for Morse code practice
.\"
.\"
.\"
.SH SYNOPSIS
.\"
.B cwgen
[\-g \fIgroups\fP] [\-\-groups=\fIgroups\fP]
[\-n \fIgroupsize\fP] [\-\-groupsize=\fIgroupsize\fP]
[\-c \fIcharset\fP] [\-\-charset=\fIcharset\fP]
.PP
.B cwgen
also accepts the \-h, \-\-help, \-v and \-\-version options.
.PP
The LINUX version understands both short form and long form command
line options. Other versions understand only the short form options.
.PP
Options may be predefined in the environment variable \fBCWGEN_OPTIONS\fP.
If defined, these options are used first; command line options take
precedence.
.PP
.\"
.\"
.\"
.SH DESCRIPTION
.\"
.PP
.B cwgen
provides a simple method to generates groups of random characters for
use as input into \fBcw\fP. Command line options control the group
size, number of groups, and character set from which the random
characters are selected.
.PP
.\"
.\"
.\"
.SS COMMAND LINE OPTIONS
.\"
.B cwgen
understands the following command line options. Only the short form
options are available in non-LINUX versions.
.TP
.I "\-g, \-\-groups"
Specifies the number of groups of random characters to generate. The
default value is 128.
.TP
.I "\-n, \-\-groupsize"
Specifies the number random characters in each group. The default
value is 5.
.TP
.I "\-c, \-\-charset"
Defines the character set from which the random characters are
selected. The default value is 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'.
.PP
.\"
.\"
.\"
.SH EXAMPLES
.\"
Generate 20 groups of 10 characters from the set EISH5, and sound
them as Morse code (both short-form and long-form option examples
are shown):
.IP
cwgen \-g 20 \-n 10 \-c "EISH5" | unixcw \-w 25 \-t 850
.IP
cwgen \-\-groups=20 \-\-groupsize=10 \-\-charset="EISH5" |
unixcw \-\-wpm=25 \-\-hz=850
.PP
.\"
.\"
.\"
.SH SEE ALSO
.\"
Man pages for \fBunixcw\fP(1,LOCAL), and \fBcwcp\fP(1,LOCAL).
.\"
|
