Dictionaries: Expanding the Witch's Vocabulary
The Witch doesn't just guess a file's language; she consults her internal lexicons to recognize linguistic patterns. When she recognizes words she knows, she can confidently suggest the correct Locale and its associated Codepages.
1. Two Volumes of Knowledge
The Witch maintains two distinct ledgers of words:
- The Master Dictionary: A pre-written, multi-language tome provided with the program. This is read-only and cannot be altered by the user.
- The User Dictionary: Your personal collection of words. This is where you add new terms to help the Witch recognize unique dialects, technical jargon, or project-specific terminology.
2. Teaching the Witch (Adding Words)
To expand the dictionary, you must use a Unicode 
or 7-Bit ASCII 
file as your source.
(Note: Adding words from Codepage files is currently disabled to ensure only clean, valid text is added to the lexicons.)
The Ritual:
- Select a file in the cauldron and click the Dictionary
icon. - The Witch will present a list of words found in the file that she does not yet recognize.
- Choose a Locale: Select the intended language from the dropdown menu.
- Auto-Selection: For known locales, the Witch will pre-check candidates that are at least 6 letters long, are not all-caps, and don't already exist in another language.
- Sanctity of the Lexicon: Before clicking Add, manually scan the list. You must ensure that no "errant" words from other languages or non-linguistic strings (like code variables or hex strings) have sneaked into the selection.
- Click Add: The checked words are added to the memory of the User Dictionary.
Pro-Tip: The Power of Five
You don't need to add an entire language's vocabulary! Usually, adding just 5 to 10 unique, common words for a specific locale is enough to "tip the scales." Once the Witch recognizes a few signature words, her statistical confidence will surge, allowing her to identify that locale instantly in future scryings.
3. Re-Scrying and Refinement
When you add words, the Witch immediately re-analyzes all files currently in the cauldron. You may see a file's icon color or detected locale change as she applies her new knowledge in real-time.
4. Finalizing the Knowledge (Save vs. Reload)
Changes made in the Dictionary window are held in a "semi-temporary" state until the session is finalized:
- Save: Click the Save button to commit your new words to the disk permanently.
- Reload: If you made a mistake or the results caused confusion, click Reload to dump the current changes and revert to the last saved state.
- Auto-Save: If you close the program without explicitly clicking Reload, the Witch will assume you approved the changes and automatically save them to your User Dictionary.