Alternative Words

By using alternative words and optional words you can write a single command which is invoked by different phrases and whose behavior depends on the phrase spoken.

For example, you might want to be able to say either "Switch View" or "Next View" to switch between views in an application:

Here the alternative term (Switch | Next) allows you to say either.

In many cases you want the actions invoked by a command to depend on which alternative was spoken. For example, you might want to move the cursor in one of four directions by saying "Move Left", "Move Down", etc.:

Here the reference $1 specifies that the first variable term should be substituted. So, when you say "Move Left" the value of the first variable term is "Left" and the keystroke {Left} is sent.

Number ranges

Often you will want to specify a range of numbers as alternatives in a command. This can be specified concisely in Vocola, as in the following example:

Here the syntax 1..9 is shorthand for (1|2|3|4|5|6|7|8|9). On the right hand side we substitute the spoken number (e.g. 6) to construct the syntax for a repeated keystroke ({Down_6}) and we have a command which moves the cursor down a specified number of lines.

In real life it's very useful to control the arrow keys by saying simply "1 Down", "3 Left", "6 Up", etc. Here's how to write it in Vocola:

This command has two variable terms. On the right-hand side the second term (which direction to move) is substituted first and the first term (how many times) is substituted second, to create the necessary keystroke syntax.

Note that large number ranges such as 1..9999 can cause recognition problems. One solution is to define more than one smaller range to denote a larger range, as for example in these commands to go to a particular line number in Visual Studio:

        Line 1..99 Oh 1..9 = {Ctrl+g} $1 0 $2 {Enter};
        Line 1..99 10..99  = {Ctrl+g} $1 $2   {Enter};

Optional words

You may want different ways of saying the same command; perhaps a longer form which is easy to remember and a shorter form for everyday use. For example, you might want to be able to say either "Kill Back 3" or just "Back 3" to delete 3 characters before the insertion point:

Enclosing the optional word "Kill" in square brackets does the trick.

Note that optional words are not considered variable terms. Because the optional word [Kill] is not considered variable, the range 1..99 is the first variable term and is referenced using $1.