# 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:

1. Select a file in the cauldron and click the Dictionary icon.
2. The Witch will present a list of words found in the file that she does not yet recognize.
3. Choose a Locale: Select the intended language from the dropdown menu.
4. 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.
5. 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.
6. 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.

## Spells and Incantations

- The Grimoire: A Conjuring Guide
- Face of the Witch: The main window
- Art of Transmutation: Unicode to Codepage
- Precognition: Codepage to Unicode
- Tuning the Cauldron: Options and Settings
- Expanding the Vocabulary: Master and User Dictionaries
- The Forge: Downloading and Compiling
- Glossary: The Pocket Reference

Documentation languages: English, German, Spanish, French, Portuguese, Turkish and Ukrainian.

This user manual was created with the assistance of Google Gemini.