June 10, 2003

How to use the insult generator
-------------------------------

The file controlling which insult types are available is named "insult.ini".

The program builds a filename from each non-comment line in insult.ini to search for insult data. In the default configuration, the insult.ini contains three entries: "shakespeare", "pirate", and "slang". The program will then look for "shakespeare.ini", "pirate.ini" and "slang.ini" in the same directory.

Each individual insult data file contains a "grammar", which tells the program where to place individual parts of the insult, as well as punctuation and other words which may be part of all insults.

Each percent sign (%) in the grammar represents one part of the insult. Random data values are substituted for each percent sign. Each list of insult data is separated by a line of text containing [MARKER]. Please direct any inquiries and comments to cakemeister AT comcast DOT net. Thanks, and happy insulting!