The Forth dictionary is divided up into sections called vocabularies. Each contains words that are related and this subdivision means that only a part of the dictionary need be searched to find a function.
The Forth word ORDER shows a list of vocabularies that represent the current search order. The one at the top of the list, highlighted, is called the CURRENT vocabulary and is the one that new definitions will be entered into. The list below starts with the CONTEXT vocabulary which is the first one to be searched to find a word being parsed. If the word is not found the next vocabulary in the list will be searched, and so on until the word is found or the list expires. IRTCis set to remove the necessity for you to need to modify this order during normal operation. Only is you wish to modify the compiler or do special operations to create new Library definitions will this order need to be changed.
You will notice that the Host and Remote modes have different vocabularies selected. Below is a list of the functions and their vocabularies.
This is the root vocabulary and is always present. It contains words that allow the search order to be changed and the other vocabularies to be selected.
This is the main Win32Forth vocabulary that contains the usual Forth words. These are the Host definitions that run IRTC and relate to the PC processor.
Here are the meta-compiler functions that make up IRTC.
The AVR assembler mnemonics, registers and flags are in here. This is only searched if a CODE or C[ ... ]C definition is being compiled.
Many of the words in here are replicas of those in FORTH. These are the optimisers for IRTC and this vocabulary is the first to be searched during a Target : definition.
These are the Library macros that compile the Target code and create the Target vocabulary entries.
The Target vocabulary contains the words that exist in the AVR code space. These words may be interactively executed. All Target : definition words go here together with any Library definitions used during compilation.
When changing from Host to Remote or back the vocabulary order is also changed. This order is re-established whenever the <cr> key is pressed. If you change the order it will only last for one command line of input.
When entering CODE definitions from the command line, each new line should start with XASM. : definitions may only be one line in length.