1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
.TH MIXAL 1 "2 February 1999" "Debian project" "Mixal user's manual"
\" This manual page was put together by Antti-Juhani Kaijanaho on 19990121.
\" It has since been modified by Darius Bacon and Antti-Juhani Kaijanaho.
\" Use, modify and distribute it as you please.
.SH NAME
mixal \- a load-and-go MIX assembler
.SH SYNOPSIS
.B mixal
[
.IR file " ..."
]
.SH DESCRIPTION
.B Mixal
is an implementation of the hypothetical
.SM MIX
computer and its assembly language called
.SM MIXAL.
The computer was designed by Donald Knuth for use in his monumental
and yet to be finished book series
.IR "The Art of Computer Programming" .
All programs and all programming exercises in the book are written in the
.SM MIXAL
language.
.PP
This implementation is a load-and-go assembler, meaning that you
provide it with a
.SM MIXAL
program source, which it translates into
.SM MIX
machine code, which it promptly executes by acting as a
.SM MIX
emulator.
.PP
You give
.B Mixal
zero or more
.SC MIXAL
program source files in the command line, which the program
interprets. If you give it no arguments, it expects to find a program
in the standard input stream. After the program has executed, the
final state of the machine registers are printed to the standard
output stream.
.PP
The card punch and line printer devices are connected to the standard
input and output stream, respectively. Console input and output are
connected to standard input and output, and the disk devices are
connected to files named diskN in the current directory, where N is
the device number. Those files are created on demand.
.SH BUGS
This
.SM MIXAL
implementation does not do floating-point. The tape devices are not
implemented.
.SH AUTHOR
This
.SM MIXAL
implementation was designed and written by Darius Bacon, and then
ported to Unixish systems and debugged by Eric S. Raymond. This
version includes corrections to multiplication and division by Larry
Gately. This manual page was written for Debian by Antti-Juhani
Kaijanaho, with changes by Darius Bacon.
.SH "SEE ALSO"
The files
.I /usr/doc/mixal/READ.ME
and
.I /usr/doc/mixal/NOTES
contain some information about this
.SM MIXAL
implementation. Be sure to read
.IR /usr/doc/mixal/README.Debian ,
too.
.PP
A description of the
.SM MIX
system
and the
.SM MIXAL
language can be found in Donald E. Knuth's book
.IR "The Art of Computer Programming" ,
Volume 1:
.IR "Fundamental Algorithms" ;
3rd Edition (Addison-Wesley 1997).
(Or see the home page at http://www-cs-faculty.stanford.edu/%7Eknuth/taocp.html.)
|
