Man Linux: Main Page and Category List

NAME

       cwgen - generate groups of random characters for Morse code practice

SYNOPSIS

       cwgen      [-g     groups]     [--groups=groups]     [-n     groupsize]
       [--groupsize=groupsize]            [-n             group_min-group_max]
       [--groupsize=group_min-group_max]  [-r  repeat]  [--repeat=repeat]  [-x
       limit] [--limit=limit] [-c charset] [--charset=charset]

       cwgen also accepts the -h, --help, -v and --version options.

       The LINUX version understands both short form  and  long  form  command
       line  options.   Other  versions  may  understand  only  the short form
       options.

       Options may be predefined in the  environment  variable  CWGEN_OPTIONS.
       If  defined,  these  options  are used first; command line options take
       precedence.

DESCRIPTION

       cwgen provides a simple method to generate groups of random  characters
       for use as input into cw.  Command line options control the group size,
       number of groups, and character set from which  the  random  characters
       are selected.

   COMMAND LINE OPTIONS
       cwgen  understands  the  following command line options.  The long form
       options may not be available in non-LINUX versions.

       -g, --groups
              Specifies the number of groups of random characters to generate.
              The default value is 128.

       -n, --groupsize
              Specifies  either the number of random characters in each group,
              if a single value is given, or a range for the number of  random
              characters  in  each group if a dash-separated pair of values is
              given.  If a  range  is  given,  cwgen  generates  groups  sized
              randomly between ’group_min’ and ’group_max’.  The default value
              is 5.

       -r, --repeat
              Specifies the number of times to repeat each group.  The default
              value is 0, indicating that each group is printed just once.

       -x, --limit
              Specifies  an  upper  limit on the number of characters printed.
              This option is useful when using random group sizes, to ensure a
              given  amount  of  practice  text.   The  default  value  is  0,
              indicating no upper limit on the number of characters printed.

       -c, --charset
              Defines the character set from which the random  characters  are
              selected.           The         default         value         is
              ’ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789’.

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:

              cwgen -g 20 -n 10 -c "EISH5" | cw -w 25 -t 850

              cwgen --groups=20 --groupsize=10 --charset="EISH5" | cw --wpm=25
              --hz=850

SEE ALSO

       Man  pages for cw(7,LOCAL), cwlib(3,LOCAL), cw(1,LOCAL), cwcp(1,LOCAL),
       and xcwcp(1,LOCAL).