2017-01-10 17:42:11 +00:00
|
|
|
.TH MIX 1
|
|
|
|
|
.SH NAME
|
|
|
|
|
mix \-
|
|
|
|
|
.B MIX
|
|
|
|
|
assembler and emulator
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B games/mix
|
|
|
|
|
[
|
2017-01-18 02:51:08 +00:00
|
|
|
.B -g
|
|
|
|
|
]
|
|
|
|
|
[
|
2017-01-10 17:42:11 +00:00
|
|
|
.I file ...
|
|
|
|
|
]
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.I Mix
|
|
|
|
|
is an assembler and emulator for Donald Knuth's
|
|
|
|
|
fictitious
|
|
|
|
|
.B MIX
|
|
|
|
|
architecture. The command assembles the named
|
|
|
|
|
.B MIXAL
|
|
|
|
|
files into memory and then presents a command
|
|
|
|
|
prompt to control an emulated
|
|
|
|
|
.B MIX
|
2017-01-18 02:51:08 +00:00
|
|
|
machine. The
|
|
|
|
|
.B -g
|
|
|
|
|
option causes the emulator immediately to run a complete assembled
|
|
|
|
|
.B MIX
|
2017-01-20 22:14:03 +00:00
|
|
|
program and exits when the emulator halts.
|
2017-01-10 17:42:11 +00:00
|
|
|
.PP
|
|
|
|
|
The following commands are accepted:
|
|
|
|
|
.TP
|
|
|
|
|
.B addr[(a:b)]
|
|
|
|
|
Print the value at
|
|
|
|
|
.I addr.
|
|
|
|
|
An optional field specification is given by
|
|
|
|
|
.I (a:b).
|
|
|
|
|
.TP
|
|
|
|
|
.B a [< file]
|
|
|
|
|
Start the MIXAL assembler. The assembler will begin
|
|
|
|
|
assembling at the address after the last assembled
|
|
|
|
|
instruction. If no file is given, the assembler will
|
|
|
|
|
accept instructions from the console.
|
|
|
|
|
.TP
|
|
|
|
|
.B b addr
|
|
|
|
|
Set or unset a breakpoint at
|
|
|
|
|
.I addr.
|
|
|
|
|
.TP
|
|
|
|
|
.B c
|
|
|
|
|
Resets the
|
|
|
|
|
.B MIX
|
|
|
|
|
machine to a fresh state by clearing all memory
|
|
|
|
|
and registers.
|
|
|
|
|
.TP
|
|
|
|
|
.B d addr
|
|
|
|
|
Disassemble the instruction at
|
|
|
|
|
.I addr.
|
|
|
|
|
.TP
|
|
|
|
|
.B o addr
|
|
|
|
|
Print the alphanumeric
|
|
|
|
|
.B MIX
|
|
|
|
|
word at
|
|
|
|
|
.I addr.
|
|
|
|
|
.TP
|
|
|
|
|
.B o(addr, d)
|
|
|
|
|
Print
|
|
|
|
|
.I d
|
|
|
|
|
alphanumeric mix words starting at
|
|
|
|
|
.I addr.
|
|
|
|
|
.TP
|
|
|
|
|
.B r*[(a:b)]
|
|
|
|
|
Print the value in register
|
|
|
|
|
.I r*
|
|
|
|
|
where * is one of a, x, ax, j, or 1-6. An optional
|
|
|
|
|
field specification is given by
|
|
|
|
|
.I (a:b).
|
|
|
|
|
.TP
|
|
|
|
|
.B s
|
|
|
|
|
Step through one instruction of the emulated
|
|
|
|
|
.B MIX
|
|
|
|
|
machine.
|
|
|
|
|
.TP
|
|
|
|
|
.B g
|
|
|
|
|
Start the emulated
|
|
|
|
|
.B MIX
|
|
|
|
|
machine at the instruction specified by the
|
|
|
|
|
.B END
|
|
|
|
|
pseudo-instruction.
|
|
|
|
|
.TP
|
|
|
|
|
.B x
|
|
|
|
|
Quit the emulator/assembler.
|
|
|
|
|
.PP
|
|
|
|
|
The
|
|
|
|
|
.I addr
|
|
|
|
|
field of the above instructions must be an integer between 0 and 3999
|
2017-02-04 00:55:02 +00:00
|
|
|
inclusive. A number-sign (#) or an asterisk (*) at the beginning of
|
|
|
|
|
a line starts a comment which extends to the end
|
2017-01-10 17:42:11 +00:00
|
|
|
of the line.
|
|
|
|
|
.SH SOURCE
|
2017-01-20 22:14:03 +00:00
|
|
|
.B /sys/src/games/mix
|
2017-01-10 17:42:11 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.nf
|
|
|
|
|
Donald Knuth, ``The Art of Computer Programming'', Volume 1. Section 1.3
|
|
|
|
|
.PP
|
2017-01-20 22:14:03 +00:00
|
|
|
.B /sys/src/games/mix/examples
|
2017-01-10 17:42:11 +00:00
|
|
|
.SH BUGS
|
|
|
|
|
As opposed to Knuth's specification,
|
|
|
|
|
the
|
|
|
|
|
.B ALF
|
|
|
|
|
pseudo-instruction takes as argument five
|
|
|
|
|
.B MIX
|
|
|
|
|
characters surrounded by quotation marks.
|
|
|
|
|
Unresolved forward references are assembled
|
|
|
|
|
to 0 instead of to a location determined by
|
|
|
|
|
the
|
|
|
|
|
.B END
|
|
|
|
|
psuedo-instruction.
|
|
|
|
|
.PP
|
|
|
|
|
The magnetic tapes and drum units are not
|
|
|
|
|
implemented.
|
|
|
|
|
.PP
|
|
|
|
|
Comments are handled as described above and not
|
2017-02-04 00:55:02 +00:00
|
|
|
exactly as Knuth specifies.
|
