1. M40_V45.exe Driver
2. mactrans.txt File Contents

mactrans.txt Driver File Contents (M40_V45.exe)

Mactrans Instructions

Note: this program only functions on the M20 and M40 Millennium; it does not function on the Type Lite or on classic notetakers.  

Mactrans allows you to convert macros.sys files into text for easy editing, and correctly formatted text files back into macro files.

You can run Mactrans, or any external program, from the file menu, from the programs menu, or by pressing X at the options menu. When Mactrans starts, it presents you with a menu with four options: "macros to text", "text to macros", "multi language macros to text", and "exit".  Hotkeys are 'm', 't', 'l', and 'z-chord'.  Use standard movement keys to choose the option you want, then press E CHORD.

Note that text 2 macros may take up to a minute to run as the text to macros conversion takes longer than the macros to text conversion.

The program speaks a list of errors with line numbers if problems are encountered when converting the text file.

When converting a file from text into macros, the output file becomes macros.bak. In order to use the new macros, you must rename macros.bak to macros.sys. If macros.sys already exists on your unit, you should rename that file to something else.

If you select a multi language macro to text, you will be prompted to select language a and b from a list of all available languages.  Use standard editing commands to select the language, and E CHORD to select.

Any line which starts with a semicolon or any blank line will be ignored.  There may be as many of these as desired.

Each macro is listed starting on the line after the text [macros].

Before the [macros] line there will be two lines containing information if the macros file has macros for two languages; the lines will take the form of:
Language a=enu
Language b=spa

Note: if only 1 of these lines is present, an error is produced.  The three letters after the '=' sign are any of the valid three letter suffixes which are now standardized.


Each macro definition will start with one of four possible declaration types as shown:
Macro'startup'=
Macros'startup'[a]=
Macro'q'=
Macro'q'[b]

If a single character is between the apostraphy characters, then that is the symbol which is assigned to that macro; otherwise if 'startup' is specified, it attaches to the space bar.

A letter in brackets indicates a multi language macro export. Only a or b is valid.  If any other letter is used, the program reports and error.

The macro definition should be in all lower case.  Note that only symbols which can be produced with the six standard Braille dots can be specified.

Following the macro definition will appear a string of text.  Any character not enclosed in brackets is translated as what ever character is shown directly.  If a single character appears within brackets, it refers to that character as a chord, thus [e] refers to an E CHORD.  Spaces are not represented as space characters; this is so that the user can type spaces to separate text for better speech performance; see the next paragraph.

In order to refer to any other control on the units, put a word into the brackets; they are listed below.

[space]		a space character
[lwu]		left wheel up
[lwd]		left wheel down
[rwu]		right wheel up
[rwd]		right wheel down
[adv]		advance bar
[backadv]	back advance bar
[#nn]		router button nn EG [#11]
[eol]		end of line; macro continued on next line
[next]		put at the start of each line of a macro
		after the first line to show it is continuing

After the [macros] section is optionally a section which starts with [definitions].  This section allows all of the tokens in the table above to me modified.  This is present for multi language exports, and in general should not be touched by the user as it will cause the macros to import improperly if it is modified.

part # 440127-001 Rev B