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=groups] [-n groupsize] [--groupsize=group‐
10       size] [-n  group_min-group_max]  [--groupsize=group_min-group_max]  [-r
11       repeat]  [--repeat=repeat]  [-x  limit]  [--limit=limit]  [-c  charset]
12       [--charset=charset]
13
14       cwgen also accepts the -h, --help, -v and --version options.
15
16       The LINUX version understands both short form  and  long  form  command
17       line  options.   Other  versions  may  understand  only  the short form
18       options.
19
20       Options may be predefined in the  environment  variable  CWGEN_OPTIONS.
21       If  defined,  these  options  are used first; command line options take
22       precedence.
23

DESCRIPTION

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

EXAMPLES

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

SEE ALSO

72       Man  pages for cw(7,LOCAL), cwlib(3,LOCAL), cw(1,LOCAL), cwcp(1,LOCAL),
73       and xcwcp(1,LOCAL).
74
75
76
77G0FRD                          CW Tutor Package                       CWGEN(1)
Impressum