11.5

Chapter 7: Customizing and optimizing Vocabularies
Voctool command line examples
The following are examples of how to use the Voctool from the command line:
Example 1
To use Voctool to add a set of new words to the General vocabulary of a user profile named Katar-
ina Phelps, you would first copy the file that contains the words ( NewWords.txt ) to the Program
Files\Nuance\NaturallySpeaking11\Program directory, then type the following on the com-
mand line:
voctool.exe /S /U "Katarina Phelps" /V "General - Large" /WI NewWords.txt
/AW /Summary voc_actions.txt
The /AW option is required to add the new "unknown" words to the vocabulary.
The voc_actions.txt file contains a summary of the actions that Voctool performs.
Dragon Vocabulary Tool Version x.xx
User:______________Katarina Phelps
Vocabulary:________General - Large
Language:__________0x409 - English (United States)
Processed 1 word list file(s):
________NewWords.txt
7 unknown word(s) found.
7 word(s) added.
Language model was not built.
No errors occurred.
No warnings occurred.
Example 2
In this example, we perform all of the actions from Example 1 and also build the language model
using the new words. On the command line, we include the /LM option to build the language
model. To have Voctool store the language model in the Middle slot, you would add M after
/LM; to store the language model in the User slot, you would add U after /LM.
You can instruct Voctool to have the language model include all previous changes (called non-
incremental) by adding an N after /LM or have the language model include only the most recent
changes (called incremental) by adding an I after /LM.
If you include /LM on the command line and do not specify a particular slot to build the language
model in or do not specify the type of build to do, Voctool builds the language model non-incre-
mentally and stores it in the Middle slot.
To build the language model in an incremental fashion and store it in the User slot, type the fol-
lowing on the command line:
voctool.exe /S /U "Katarina Phelps" /V "General - Large" /WI NewWords.txt
/AW /LMU I /Summary voc_actions.txt
283