Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CWGEN(1)		     General Commands Manual			CWGEN(1)

NAME
     cwgen - generate groups of random characters for Morse code practice

SYNOPSIS
     cwgen    [-g --groups=groups]    [-n --groupsize=groupsize]    [-n --group-
     size=group_min-group_max]	    [-r --repeat=repeat]      [-x --limit=limit]
     [-c --charset=charset] [-h --help] [-V --version]

     cwgen  installed  on GNU/Linux systems understands both short form and long
     form command line options.  cwgen installed on other operating systems  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  prece-
     dence.

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 op-
     tions 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 charac-
	    ters 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 up-
	    per limit on the number of characters printed.

     -c, --charset
	    Defines the character set from which the random characters	are  se-
	    lected.	The    default	  value    is	 'ABCDEFGHIJKLMNOPQRSTU-
	    VWXYZ0123456789'.

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
	    --tone=850

SEE ALSO
     Man pages for cw(7,LOCAL), libcw(3,LOCAL), cw(1,LOCAL), cwcp(1,LOCAL),  and
     xcwcp(1,LOCAL).

cwgen ver. 3.5.1		CW Tutor Package			CWGEN(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cwgen&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help