Note: This applies to Windows env, Linux uses command line switches (options),
    
USAGE:
./txt2cw.pl [ -help ]
  
Below is the display of the "menu" questions in lieu of
command line options. A few comments in the form of # comment, 
are added.

 Input file name? (./in.txt): tst.txt
    # in addition to the .txt suffix, the file must be a
    # text file, that is characters as typed in an editor like:
    # notepad, or vi - NOT a word processor like: Microsoft Word.
 Character speed, in wpm? (25):
        Per-file char-speed increment, in wpm? (0.05): 0
        # can be a whole number or decimal
 Farns/words-worth speed, in wpm ( <= 25, 0 = none)? (0):
 Extra dit-widths between words? (0):
 CW tone in hz? (700):
 File length, in minutes? (5):
        # this is an average estimate
 Max number of output files? (8192):
        # The above two together determine the amount of practice 
	# material, therefore run time and diskspace.
 Optional functions:
        # either of the following can be used for IWR type training
	# will require a second file containing the IWR words or suffixes
        - match IWR words (i)
        - match suffixes (s)
        - neither (N) ?: i
        IWR word file? (ending in .txt): i.txt
		# file format for IWR or suffixes as follows
		# comments like this line ok
		# completely blank of space lines
		# data lines, may have leading or trailing spaces
		# the word or suffix cannot include spaces
                IWR word speed, in wpm? ( > 25): 30
		# if IWR or SUFFIX is choosen, the matched "word" can ALSO be of a
		# different tone
                Tone for IWR, in hz, different than: (CW tone value shown): 
 A symbol to emphasize, by tone? : "
        # a single character or prosign. sounded by its different tone
	# can use as a TEMPORARY aid in learning a new character 
	# You must listen for the pattern, not just the tone!
        Emphasis tone, in Hz, different than CW tone: 700): 750
	# this will NOT be shown if you chose tone in IWR or Suffixes.
        Pre-alert tone, instead of using the tone for the entire matched word, play an "E " at the new tone.
 Punctuation to ignore? (  []()!;":'_  ):
        # One or more questions will allow ignoring all, or sets of
	# punctuation. 
 Sound <XX> formatted ProSigns? (y/N):
        # If 'y' (default) supported prosigns in the input file, as well as the 
	# word or suffix file will be sent as CW. In any other case the all >, and <
	# will be ignored - unsupported prosigns are discarded.
 Silence audible header? (Y/n):
        # info in the form of: file path at XX Char WPM sent in CW
	# if answer is 'N'
 Output as WAV or MP3 files? (wav):
        # windows env, only seen IF a local lame folder exists

 Below is a sample IWR word file:

 # file created for listening to "Call Of The Wild"

 and
 the
 did
 do
 she
 #wolf  <== commented out to ignore instead of erasing
 73
 <SK>   <== not likely to be found, note all entries can be upper/lower case
 snow


 Below is a sample suffix file:

 # my first few suffixes
 # case doesn't matter, must be at least 2 in length, only alphas
 ing
 tion
 ed
 ly

 Supported Prosigns:

  ITU prosigns:
    <AR> <AS> <BT> <KA> <KN> <SK> <VA> <SOS> <HH> <SN> <VE>
    <VA> & <SK> same sound different look in text
    <SN> & <VE> same sound different look in text
    + or = in input are sent as the prosign, regardless of prosign option.

  Prosign format in some text, but will be sent as 2 letters:
    <BK> <CL> 

  Punctuation sometimes in prosign format, sent as the actual 
    punctuation:
    <IMI> (question mark ?) <DU> (hyphen or dash -)

  PC Environment:
    It's recommended that you create a new folder (directory) where you
    will run txt2cw.pl. When run, a new sub folder will be created with the
    name of the input file less the ".txt" extension. Assuming you 
    answer "Y" to create the files or "Y" to overwrite it, if it 
    already exists, then the input file is copied there and sub folders
    will be created to hold the wav or mp3 audio files.
      
    The directories are named like: 000-127, to mean this holds up to 
    the first 128 files as needed. This makes it easier for you to manually
    remove unwanted files with Windows Explorer when they are no longer
    of interest. 

    It is best to NOT have Windows Explorer or your media player sitting
    in the target directory.

    
