C:\>Brass source.ext [binary.ext [export.ext]] [-switch [-switch [-...]]]
Brass only needs one command-line argument - the filename of the source file you are assembling. You can optionally pass a filename for the binary to be output - it defaults to the filename of the source file with .bin on the end.
You can also specify a file name for the label export table (generate with the .export directive).This defaults to the source filename with _labels.inc tacked on the end.
Switches can be passed as a - dash followed by a single character. The available switches are:
| Switch | Description |
|---|---|
| d | Debug mode - write a debug log file for Latenite. |
| e | Strict error mode. |
| l | Write list file (followed by filename). |
| o | Do not write headers on XML error log. |
| s | Force case sensitivity on macros and labels. |
| t | Use external table file (followed by filename). |
| x | Export XML error log. |
As far as the error log is concerned, it will write to the file name referenced in the environment variable. Latenite sets this for you, or you can manually set it with the command (on the Windows command-line):
SET ERROR_LOG=filename
Strict error mode stops after a single error. The default is to leave this off, so the assembler will skip over errors -this produces a useless binary, but it's easier to debug when you have a large list of errors to fix rather fixing than one at a time, recompiling, repeating.
Some examples:
| Example | Description |
|---|---|
| Brass file.asm | Assembles file.asm as file.bin |
| Brass file.asm "out file.com" | Assembles file.asm as out file.com |
| Brass file.asm -s hello.exe | Assembles file.asm as hello.exe (case sensitive). |
| Brass file.asm -l hello.lst | Assembles file.asm as file.bin and writes listing to hello.lst. |
| Brass -t tasm80.tab file.asm | Assembles file.asm as file.bin using tasm80.tab. |