A number of parameters may be set from a configuration file.
If a filename is given is argument to WordGenerator, that file will be read as the
configuration file. Otherwise, WordGenerator will look for the configuration
file first in the current directory, then in the user's home directory.
A configuration file named on the command line may have any valid name.
A configuration file located automatically should be named
".wgrc" on all systems other than MS Windows, where it should be named "WordGeneratorInit".
It is also possible to read a configuration file after WordGenerator has started
up via a command on the File menu.

A configuration file specifies one parameter per line, with the parameter and the
value separated by a tab character. Lines beginning with a crosshatch (#) are taken
to be comments and are ignored. A sample configuration file will be found in this
directory.

Multicomponent options may be written as single words or may be broken
up with a space, an underscore, or a hyphen, e.g.: WordLimit, Word Limit,
Word_Limit, or Word-Limit.

These three parameters take positive integers as arguments: 

MaximumSyllables
SampleSize
WordLimit

Be very careful about using large values for MaximumSyllables. With typical syllable
structures, the number of words generated increases very rapidly with the number
of syllables. For example, in a language in which syllables consist of an onset
chosen from eight consonants, one of five vowels, and a coda that is either null
or comprised of one of three nasals, there are 160 words of one syllable, 25,760
words of up to two syllables, 4,121,760 words of up to three syllables, and
659,481,760 words of up to four syllables. Generating very large numbers of words
can take a long time and use a lot of memory, as well as a lot of storage if
you save them to a file.

It is wise to check the number of words that will be generated
before pressing "Generate". The WordLimit parameter is also useful in this
regard in that it will prevent the generation of enormous numbers of words unless
you explicitly choose to do so. It defaults to one million.

The following consists of strings of syllable components of your choice,
one component separated from the next by a space, just as in the GUI. For
example, you might specify a Core syllable as "C V".

Core
Sole
Initial
Final

Any parameter that is not one of the ones named here will be taken to be
a syllable component. A line like:

WIP	   s ""

will be taken to define a syllable component called "WIP" (possibly standing
for "Word Initial Prefix") consisting of either an /s/ or nothing.
It is expected that this will be a component of one or more syllable types.   

The following parameters take Boolean arguments. Boolean arguments may be T, 1, yes,
and so forth for True, F, 0, no, and so forth for False.

AlphabetizeP
AttachHeaderP
RandomP
SeparateSyllablesP

If you choose to mark syllable boundaries in the output, the character used to mark
them may is controlled by:

Syllable Separator

The encoding used for saving results may be set using:

Encoding

followed by the name of an encoding, e.g.:

Encoding iso8859-1

for Latin-1.

The following parameters control the fonts used:

Text Font Family
Text Font Size
Main Font Family
Main Font Size

The following parameters take color specifications as their arguments.

DefaultBackgroundColor
DefaultForegroundColor
OutputTextBackgroundColor
OutputTextForegroundColor
FrameBackgroundColor

A color specification may a name such as "red" or "navajo white"
drawn from the X Window System color name list or a numerical color
specification. WordGenerator will complain if it does not recognize
a color specification.

A numerical color specification begins with a crosshatch.
The crosshatch is followed by three groups of two
characters. The first group specifies the amount of red, the second the amount
of green, and the third the amount of blue. Each pair of characters represents
two hexadecimal (base 16) digits. The hexadecimal digits are:
0,1,2,3,4,5,6,7,8,9,A,B,C,D,E, and F. The proportion of each
primary color is therefore specified as a number ranging from 00 (0*16 + 0*1 = 0) to
FF (15*16 + 15*1 = 240 + 15 = 255). For example, #FF0000 is bright red, #00FF00 bright
green, #0000FF bright blue, #FFFFFF white, #00000 black.

The error that you are most likely to make when writing a configuration file
is to use spaces rather than a tab character to separate the parameter name from
the value. The separator must consist of a tab character.



