1CWGEN(1)                    General Commands Manual                   CWGEN(1)
2
3
4

NAME

6       cwgen - generate groups of random characters for Morse code practice
7

SYNOPSIS

9       cwgen   [-g --groups=groups]   [-n --groupsize=groupsize]  [-n --group‐
10       size=group_min-group_max]    [-r --repeat=repeat]    [-x --limit=limit]
11       [-c --charset=charset]  [-h --help] [-V --version]
12
13       cwgen  installed  on  GNU/Linux systems understands both short form and
14       long form command line options.  cwgen  installed  on  other  operating
15       systems may understand only the short form options.
16
17       Options  may  be  predefined in the environment variable CWGEN_OPTIONS.
18       If defined, these options are used first;  command  line  options  take
19       precedence.
20

DESCRIPTION

22       cwgen  provides a simple method to generate groups of random characters
23       for use as input into cw.  Command line options control the group size,
24       number  of  groups,  and character set from which the random characters
25       are selected.
26
27   COMMAND LINE OPTIONS
28       cwgen understands the following command line options.   The  long  form
29       options may not be available in non-LINUX versions.
30
31       -g, --groups
32              Specifies the number of groups of random characters to generate.
33              The default value is 128.
34
35       -n, --groupsize
36              Specifies either the number of random characters in each  group,
37              if  a single value is given, or a range for the number of random
38              characters in each group if a dash-separated pair of  values  is
39              given.   If  a range is given, cwgen generates groups sized ran‐
40              domly between 'group_min' and 'group_max'.  The default value is
41              5.
42
43       -r, --repeat
44              Specifies the number of times to repeat each group.  The default
45              value is 0, indicating that each group is printed just once.
46
47       -x, --limit
48              Specifies an upper limit on the number  of  characters  printed.
49              This option is useful when using random group sizes, to ensure a
50              given amount of practice text.  The default value is 0, indicat‐
51              ing no upper limit on the number of characters printed.
52
53       -c, --charset
54              Defines  the  character set from which the random characters are
55              selected.   The   default   value   is   'ABCDEFGHIJKLMNOPQRSTU‐
56              VWXYZ0123456789'.
57

EXAMPLES

59       Generate  20 groups of 10 characters from the set EISH5, and sound them
60       as Morse code.  Both  short-form  and  long-form  option  examples  are
61       shown:
62
63              cwgen -g 20 -n 10 -c "EISH5" | cw -w 25 -t 850
64
65              cwgen --groups=20 --groupsize=10 --charset="EISH5" | cw --wpm=25
66              --tone=850
67

SEE ALSO

69       Man pages for cw(7,LOCAL), libcw(3,LOCAL), cw(1,LOCAL),  cwcp(1,LOCAL),
70       and xcwcp(1,LOCAL).
71
72
73
74cwgen ver. 3.5.1               CW Tutor Package                       CWGEN(1)
Impressum