Please note that you may find several different cache files which may be of use located in the cache/ subdirectory of the GTKeyboard documentation directory.
Creating word completion cache files is quite easy - simply choose the ``Convert Text File to Word Cache'' button located in the main word completion window. It will present you with a dialog asking you to specify which file is to be converted, and what it should be saved as. The default is to save the newly created cache file as /.gtkeyboard-wordcache, which will overwrite your previous word cache.
Using the browse buttons to the right of the entry areas, you may choose a filename to convert, and what to convert it to. Note that this process works only for text files. It will also work on any file you give it, but the results will most likely be an ugly, unusable cache. The cache file creation mechanism makes each block of letters it sees into a word in the cache. If you try to make a cache out of a bit of HTML such as ``
1 <P>This
1 is
1 a
1 bit
1 of
1 HTML
(Notice that GTKeyboard saw ``
You may also choose to click the toggle button below the entry areas, labled ``Cache words in lower case'' which will cause words in the cache to be all lower case. This can be helpful, since GTKeyboard would normall consider the words ``Hello'' and ``hello'' to be different words and would count their occurance seperately.
When you are done picking options, click the ``OK'' button, and the cache will be created. A status message signalling completion will be printed into the status window. Note: GTKeyboard does not automatically load newly converted cache files.
In addition to this method, there is a perl script distributed with GTKeyboard called gtkeyboard-create-cache-file. It is located in the same directory that the GTKeyboard binary was installed in. To use this program, call it with two arguments. The first argument should be the file to read from, and the second argument the file to save the new cache to.
By default, gtkeyboard-create-cache-file caches all words as lower case, and strips all punctuation from the words. Please note that using this additional program requires Perl, which is freely available from http://www.perl.com/.