home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / games / volume2 / autopun / autopun.man.orig < prev    next >
Text File  |  1987-11-25  |  2KB  |  72 lines
  1. autopun - Phonetically Reparse an English Phrase 
  2.  
  3. SYNTAX
  4.     autopun [-e English_dict] [-p Phone_dict]
  5.     autopun [-e English_dict] -c -p Phone_dict
  6.  
  7. OPTIONS
  8.     -e specifies which English word list to read instead of the default,
  9.     /usr/dict/words.
  10.  
  11.     -p specifies the encoded phonetic word list to read instead of an
  12.     English word list (see -c).
  13.  
  14.     -c creates (rather than reads) the given phonetic word list.
  15.     The -c option requires that the -p option be used.
  16.     (this is how a phonetic word list is created.)
  17.  
  18. DESCRIPTION
  19.     Autopun generates (to standard-out) a table of phonetic reparsings
  20.     of the given English phrase (from standard-in).  The table is useful
  21.     for generating rebus, punch-lines for shaggy-dog stories, and other
  22.     perversions of spoken English.
  23.  
  24.     For efficiency, autopun can read from a previously-encoded phonetic
  25.     word list rather than an unencoded English dictionary.
  26.  
  27. EXAMPLES
  28.     $ autopun -c -p phdict
  29.  
  30.     If the phrase "Merry Christmas" is typed as standard-input to the
  31.     above command, autopun will generate the following table and (as
  32.     a side-effect) create the phonetic word list, phdict, for later use.
  33.  
  34.     Merry Christmas
  35.     00:
  36.       merry:04 murre:03 moo:02
  37.     02:
  38.       wreak:05 rick:05 reek:05 re:04
  39.     03:
  40.       eke:05
  41.     04:
  42.       Christmas:$  Christ:09
  43.     05:
  44.       wrist:09 re:07
  45.     07:
  46.       St.:09 St:09
  47.     09:
  48.       mush:$  mouse:$  moss:$  mass:$  mash:$ 
  49.  
  50.     To (manually) generate a new phrase from the above table, start
  51.     at the list marked "0".  Pick an interesting word from that list,
  52.     such as "moo".  Go to the list whose number appears to the right
  53.     of the selected word (list 02 in this case).  Repeat the process
  54.     until the table says to go to list "$".  Following this procedure
  55.     might produce the phrase "Moo wreak wrist moss".
  56.  
  57. SPECIAL CONSIDERATIONS
  58.     Autopun blindly believes that the word list contains all interesting
  59.     words and that everything in the word list is interesting.  Careful
  60.     editing of the English word list can correct these problems.
  61.  
  62.     Autopun doesn't know how to pronounce abbreviations, punctuation,
  63.     or numerals.
  64.  
  65.     This man page is not in Man format because our copy of the man macros
  66.     has been "improved" to the point that I cannot generate a standard
  67.     man page.  Credit goes to nroff for having a macro language obscure
  68.     enough to be a temptation to the undisciplined.
  69.  
  70. FILES
  71.     /usr/dict/words
  72.