Version 1.2.1 imported1.2.1

git-archimport-id: mdk@sv.gnu.org/mdk--devel--1--patch-1

3 files changed, 1495 insertions, 0 deletions

diff --git a/misc/Makefile.am b/misc/Makefile.am
new file mode 100644
index 0000000..f703ba0
--- /dev/null
+++ b/misc/Makefile.am
@@ -0,0 +1,16 @@
+## Process this file with automake to produce Makefile.in
+
+# Copyright (C) 2001, 2003 Free Software Foundation, Inc.
+#
+# This file is free software; as a special exception the author gives
+# unlimited permission to copy and/or distribute it, with or without
+# modifications, as long as this notice is preserved.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
+# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+EXTRA_DIST = mixvm.el mixal-mode.el
+
+pkgdata_DATA = mixvm.el mixal-mode.el
+
diff --git a/misc/mixal-mode.el b/misc/mixal-mode.el
new file mode 100644
index 0000000..638947a
--- /dev/null
+++ b/misc/mixal-mode.el
@@ -0,0 +1,1321 @@
+;;; mixal-mode.el --- Major mode for the mix asm language.
+
+;; Copyright (C) 2003, 2005 Free Software Foundation
+
+;; This program is free software; you can redistribute it and/or
+;; modify it under the terms of the GNU General Public License as
+;; published by the Free Software Foundation; either version 2 of
+;; the License, or (at your option) any later version.
+
+;; This program is distributed in the hope that it will be
+;; useful, but WITHOUT ANY WARRANTY; without even the implied
+;; warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+;; PURPOSE.  See the GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public
+;; License along with this program; if not, write to the Free
+;; Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+;; MA 02110-1301 USA
+
+;; Author: Pieter E.J. Pareit <pieter.pareit@skynet.be>
+;; Maintainer: Pieter E.J. Pareit <pieter.pareit@skynet.be>
+;; Created: 09 Nov 2002
+;; Version: 0.1
+;; Keywords: Knuth mix mixal asm mixvm "The Art Of Computer Programming"
+
+;;; Commentary:
+;; Major mode for the mix asm language.
+;; The mix asm language is described in "The Art Of Computer Programming".
+;;
+;; For optimal use, also use GNU MDK. Compiling needs mixasm, running
+;; and debugging needs mixvm and mixvm.el from GNU MDK. You can get
+;; GNU MDK from `https://savannah.gnu.org/projects/mdk/' and
+;; `ftp://ftp.gnu.org/pub/gnu/mdk'.
+;;
+;; To use this mode, place the following in your .emacs file:
+;; `(load-file "/PATH-TO-FILE/mixal-mode.el")'.
+;; When you load a file with the extension .mixal the mode will be started
+;; automatic. If you want to start the mode manual, use `M-x mixal-mode'.
+;; Font locking will work, the behavior of tabs is the same as emacs
+;; default behavior. You can compile a source file with `C-c c' you can
+;; run a compiled file with `C-c r' or run it in debug mode with `C-c d'.
+;; You can get more information about a particular operation code by using
+;; mixal-describe-operation-code or `C-h o'.
+;;
+;; Have fun.
+
+;;; History:
+;; Version 0.2:
+;; 06/04/05: mixasm no longer needs -g option
+;;           fontlocking of comments works in all? cases now
+;;           added some more mixal-operation-codes
+;; Version 0.1:
+;; Version 0.1.1:
+;; 22/11/02: bugfix in fontlocking, needed to add a '-' to the regex.
+;; 19/11/02: completed implementing mixal-describe-operation-code.
+;; 13/11/02: implemented compile, mixal-run and mixal-debug.
+;; 10/11/02: implemented font-locking and syntax table.
+;; 09/11/02: started mixal-mode.
+
+;;; Code:
+
+;;; Key map
+(defvar mixal-mode-map
+  (let ((map (make-sparse-keymap)))
+    (define-key map "\C-cc" 'compile)
+    (define-key map "\C-cr" 'mixal-run)
+    (define-key map "\C-cd" 'mixal-debug)
+    (define-key map "\C-ho" 'mixal-describe-operation-code)
+    map)
+  "Keymap for `mixal-mode'.")
+; (makunbound 'mixal-mode-map)
+
+;;; Syntax table
+(defvar mixal-mode-syntax-table
+  (let ((st (make-syntax-table)))
+    ; (modify-syntax-entry ?* "<" st)    we need to do a bit more to make
+    ; (modify-syntax-entry ?\n ">" st)    fontlocking for comments work
+    st)
+  "Syntax table for `dot-mode'.")
+
+(defvar mixal-font-lock-label-face 'font-lock-variable-name-face
+  "Face name to use for label names.
+Default value is that of `font-lock-variable-name-face', but you can modify
+its value.")
+
+(defvar mixal-font-lock-operation-code-face 'font-lock-keyword-face
+  "Face name to use for operation code names.
+Default value is that of `font-lock-keyword-face', but you can modify its
+value.")
+
+(defvar mixal-font-lock-assembly-pseudoinstruction-face 'font-lock-builtin-face
+  "Face name to use for assembly pseudoinstruction names.
+Default value is that of `font-lock-builtin-face', but you can modify its
+value.")
+
+(defvar mixal-operation-codes
+  '("NOP" "ADD" "FADD" "SUB" "FSUB" "MUL" "FMUL" "DIV" "FDIV" "NUM" "CHAR"
+    "HLT" "SLA" "SRA" "SLAX" "SRAX" "SLC" "SRC" "MOVE" "LDA" "LD1" "LD2" "LD3"
+    "LD4" "LD5" "LD6" "LDX" "LDAN" "LD1N" "LD2N" "LD3N" "LD4N" "LD5N" "LD6N"
+    "LDXN" "STA" "ST1" "ST2" "ST3" "ST4" "ST5" "ST6" "STX" "STJ" "STZ" "JBUS"
+    "IOC" "IN" "OUT" "JRAD" "JMP" "JSJ" "JOV" "JNOV"
+    "JL" "JE" "JG" "JGE" "JNE" "JLE"
+    "JAN" "J1N" "J2N" "J3N" "J4N" "J5N" "J6N" "JXN"
+    "JAZ" "J1Z" "J2Z" "J3Z" "J4Z" "J5Z" "J6Z" "JXZ"
+    "JAP" "J1P" "J2P" "J3P" "J4P" "J5P" "J6P" "JXP"
+    "JANN" "J1NN" "J2NN" "J3NN" "J4NN" "J5NN" "J6NN" "JXNN"
+    "JANZ" "J1NZ" "J2NZ" "J3NZ" "J4NZ" "J5NZ" "J6NZ" "JXNZ"
+    "JANP" "J1NP" "J2NP" "J3NP" "J4NP" "J5NP" "J6NP" "JXNP"
+    "INCA" "DECA" "ENTA" "ENNA" "INC1" "DEC1" "ENT1" "ENN1"
+    "INC2" "DEC2" "ENT2" "ENN2" "INC3" "DEC3" "ENT3" "ENN3" "INC4" "DEC4"
+    "ENT4" "ENN4" "INC5" "DEC5" "ENT5" "ENN5" "INC6" "DEC6" "ENT6" "ENN6"
+    "INCX" "DECX" "ENTX" "ENNX" "CMPA" "FCMP" "CMP1" "CMP2" "CMP3" "CMP4"
+    "CMP5" "CMP6" "CMPX")
+  "List of possible operation codes as strings.")
+; (makunbound 'mixal-operation-codes)
+
+(defvar mixal-assembly-pseudoinstructions
+  '("ORIG" "EQU" "CON" "ALF" "END")
+  "List of possible assembly pseudoinstructions")
+
+;;; Font-locking:
+(defvar mixal-font-lock-keywords
+  `(("^\\([A-Z0-9a-z]+\\).*$"
+     (1 mixal-font-lock-label-face))
+    (,(regexp-opt mixal-operation-codes 'words)
+     . mixal-font-lock-operation-code-face)
+    (,(regexp-opt
+       mixal-assembly-pseudoinstructions 'words)
+     . mixal-font-lock-assembly-pseudoinstruction-face)
+    ("^[A-Z0-9a-z]*[ \t]+[A-ZO-9a-z]+[ \t]+\\(=.*=\\).*$"
+     (1 font-lock-constant-face))
+    ("^[A-Z0-9a-z]*[ \t]+[A-Z0-9a-z]+[ \t]+[A-Z0-9a-z,():+-\\*=\" ]*[\t]+\\(.*\\)$"
+     (1 font-lock-comment-face))
+    ("^\\*.*$" . font-lock-comment-face))
+  "Keyword highlighting specification for `mixal-mode'.")
+; (makunbound 'mixal-font-lock-keywords)
+
+;;;; Compilation
+;; Output from mixasm is compatible with default behavior of emacs,
+;; I just added a key (C-cc) and modified the make-command.
+
+;;;; Indentation
+;; Tabs works well by default.
+
+;;;; Describe
+(defvar mixal-operation-codes-alist '()
+  "Alist that contains all the possible operation codes for mix.
+Each elt has the form (OP-CODE GROUP FULL-NAME C-BYTE F-BYTE DESCRIPTION EXECUTION-TIME)
+Where OP-CODE is the text of the opcode as an symbol, FULL NAME is the human readable name
+as a string, C-BYTE is the operation code telling what operation is to be performed, F-BYTE holds
+an modification of the operation code which can be a symbol or a number, DESCRIPTION contains
+an string with a description about the operation code and EXECUTION-TIME holds info
+about the time it takes, number or string")
+; (makunbound 'mixal-operation-codes-alist)
+
+(defun mixal-add-operation-code (op-code group full-name C-byte F-byte description execution-time)
+  "Add an operation code to the list that contains information about possible op code's."
+  (setq mixal-operation-codes-alist (cons (list op-code group full-name C-byte F-byte
+						description execution-time)
+					  mixal-operation-codes-alist )))
+
+;; now add each operation code
+
+(mixal-add-operation-code
+ 'LDA 'loading "load A" 8 'field
+ "Put in rA the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word."
+ 2)
+
+(mixal-add-operation-code
+ 'LDX 'loading "load X" 15 'field
+ "Put in rX the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word."
+ 2)
+
+(mixal-add-operation-code
+ 'LD1 'loading "load I1" (+ 8 1) 'field
+ "Put in rI1 the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word. Index registers only have 2 bytes and a sign, Trying
+to set anything more that that will result in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD2 'loading "load I2" (+ 8 2) 'field
+ "Put in rI2 the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word. Index registers only have 2 bytes and a sign, Trying
+to set anything more that that will result in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD3 'loading "load I3" (+ 8 3) 'field
+ "Put in rI3 the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word. Index registers only have 2 bytes and a sign, Trying
+to set anything more that that will result in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD4 'loading "load I4" (+ 8 4) 'field
+ "Put in rI4 the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word. Index registers only have 2 bytes and a sign, Trying
+to set anything more that that will result in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD5 'loading "load I5" (+ 8 5) 'field
+ "Put in rI5 the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word. Index registers only have 2 bytes and a sign, Trying
+to set anything more that that will result in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD6 'loading "load I6" (+ 8 6) 'field
+ "Put in rI6 the contents of cell no. M.
+Uses a + when there is no sign in subfield. Subfield is left padded with
+zeros to make a word. Index registers only have 2 bytes and a sign, Trying
+to set anything more that that will result in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LDAN 'loading "load A negative" 16 'field
+ "Put in rA the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word."
+ 2)
+
+(mixal-add-operation-code
+ 'LDXN 'loading "load X negative" 23 'field
+ "Put in rX the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word."
+ 2)
+
+(mixal-add-operation-code
+ 'LD1N 'loading "load I1 negative" (+ 16 1) 'field
+ "Put in rI1 the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word. Index registers only
+have 2 bytes and a sign, Trying to set anything more that that will result
+in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD2N 'loading "load I2 negative" (+ 16 2) 'field
+ "Put in rI2 the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word. Index registers only
+have 2 bytes and a sign, Trying to set anything more that that will result
+in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD3N 'loading "load I3 negative" (+ 16 3) 'field
+ "Put in rI3 the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word. Index registers only
+have 2 bytes and a sign, Trying to set anything more that that will result
+in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD4N 'loading "load I4 negative" (+ 16 4) 'field
+ "Put in rI4 the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word. Index registers only
+have 2 bytes and a sign, Trying to set anything more that that will result
+in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD5N 'loading "load I5 negative" (+ 16 5) 'field
+ "Put in rI5 the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word. Index registers only
+have 2 bytes and a sign, Trying to set anything more that that will result
+in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'LD6N 'loading "load I6 negative" (+ 16 6) 'field
+ "Put in rI6 the contents of cell no. M, with opposite sign.
+Uses a + when there is no sign in subfield, otherwise use the opposite sign.
+Subfield is left padded with zeros to make a word. Index registers only
+have 2 bytes and a sign, Trying to set anything more that that will result
+in undefined behavior."
+ 2)
+
+(mixal-add-operation-code
+ 'STA 'storing "store A" 24 'field
+ "Store in cell Nr. M the contents of rA.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield."
+ 2)
+
+(mixal-add-operation-code
+ 'STX 'storing "store X" 31 'field
+ "Store in cell Nr. M the contents of rX.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield."
+ 2)
+
+(mixal-add-operation-code
+ 'ST1 'storing "store I1" (+ 24 1) 'field
+ "Store in cell Nr. M the contents of rI1.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield.
+Because index registers only have 2 bytes and a sign, the rest of the bytes
+are assumed to be 0."
+ 2)
+
+(mixal-add-operation-code
+ 'ST2 'storing "store I2" (+ 24 2) 'field
+ "Store in cell Nr. M the contents of rI2.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield.
+Because index registers only have 2 bytes and a sign, the rest of the bytes
+are assumed to be 0."
+ 2)
+
+(mixal-add-operation-code
+ 'ST3 'storing "store I3" (+ 24 3) 'field
+ "Store in cell Nr. M the contents of rI3.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield.
+Because index registers only have 2 bytes and a sign, the rest of the bytes
+are assumed to be 0."
+ 2)
+
+(mixal-add-operation-code
+ 'ST4 'storing "store I4" (+ 24 4) 'field
+ "Store in cell Nr. M the contents of rI4.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield.
+Because index registers only have 2 bytes and a sign, the rest of the bytes
+are assumed to be 0."
+ 2)
+
+(mixal-add-operation-code
+ 'ST5 'storing "store I5" (+ 24 5) 'field
+ "Store in cell Nr. M the contents of rI5.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield.
+Because index registers only have 2 bytes and a sign, the rest of the bytes
+are assumed to be 0."
+ 2)
+
+(mixal-add-operation-code
+ 'ST6 'storing "store I6" (+ 24 6) 'field
+ "Store in cell Nr. M the contents of rI6.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The
+sign of the memory cell is not changed, unless it is part of the subfield.
+Because index registers only have 2 bytes and a sign, the rest of the bytes
+are assumed to be 0."
+ 2)
+
+(mixal-add-operation-code
+ 'STJ 'storing "store J" 32 'field
+ "Store in cell Nr. M the contents of rJ.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with bytes from a register. These
+bytes are taken beginning by the rightmost side of the register. The sign
+of rJ is always +, sign of the memory cell is not changed, unless it is
+part of the subfield. The default field for STJ is (0:2)."
+ 2)
+
+(mixal-add-operation-code
+ 'STZ 'storing "store zero" 33 'field
+ "Store in cell Nr. M '+ 0'.
+The modification of the operation code represents the subfield of the
+memory cell that is to be overwritten with zeros."
+ 2)
+
+(mixal-add-operation-code
+ 'ADD 'arithmetic "add" 1 'field
+ "Add to A the contents of cell Nr. M.
+Subfield is padded with zero to make a word.
+If the result is to large, the operation result modulo 1,073,741,823 (the
+maximum value storable in a MIX word) is stored in `rA', and the overflow
+toggle is set to TRUE."
+ 2)
+
+(mixal-add-operation-code
+ 'SUB 'arithmetic "subtract" 2 'field
+ "Subtract to A the contents of cell Nr. M.
+Subfield is padded with zero to make a word.
+If the result is to large, the operation result modulo 1,073,741,823 (the
+maximum value storable in a MIX word) is stored in `rA', and the overflow
+toggle is set to TRUE."
+ 2)
+
+(mixal-add-operation-code
+ 'MUL 'arithmetic "multiply" 3 'field
+ "Multiplies the contents of cell Nr. M with A, result is 10 bytes and stored in rA and rX.
+The sign is + if the sign of rA and cell M where the same, otherwise, it is -"
+ 10)
+
+(mixal-add-operation-code
+ 'DIV 'arithmetic "divide" 4 'field
+ "Both rA and rX are taken together and divided by cell Nr. M, quotient is placed in rA, remainder in rX.
+The sign is taken from rA, and after the divide the sign of rA is set to + when
+both the sign of rA and M where the same. Divide by zero and overflow of rA result
+in undefined behavior."
+ 12)
+
+(mixal-add-operation-code
+ 'ENTA 'address-transfer "enter A" 48 2
+ "Literal value is stored in rA.
+Indexed, stores value of index in rA."
+ 1)
+
+(mixal-add-operation-code
+ 'ENTX 'address-transfer "enter X" 55 2
+ "Literal value is stored in rX.
+Indexed, stores value of index in rX."
+ 1)
+
+(mixal-add-operation-code
+ 'ENT1 'address-transfer "Enter rI1" (+ 48 1) 2
+ "Literal value is stored in rI1.
+Indexed, stores value of index in rI1."
+ 1)
+
+(mixal-add-operation-code
+ 'ENT2 'address-transfer "Enter rI2" (+ 48 2) 2
+ "Literal value is stored in rI2.
+Indexed, stores value of index in rI2."
+ 1)
+
+(mixal-add-operation-code
+ 'ENT3 'address-transfer "Enter rI3" (+ 48 3) 2
+ "Literal value is stored in rI3.
+Indexed, stores value of index in rI3."
+ 1)
+
+(mixal-add-operation-code
+ 'ENT4 'address-transfer "Enter rI4" (+ 48 4) 2
+ "Literal value is stored in rI4.
+Indexed, stores value of index in rI4."
+ 1)
+
+(mixal-add-operation-code
+ 'ENT5 'address-transfer "Enter rI5" (+ 48 5) 2
+ "Literal value is stored in rI5.
+Indexed, stores value of index in rI5."
+ 1)
+
+(mixal-add-operation-code
+ 'ENT6 'address-transfer "Enter rI6" (+ 48 6) 2
+ "Literal value is stored in rI6.
+Indexed, stores value of index in rI6."
+ 1)
+
+(mixal-add-operation-code
+ 'ENNA 'address-transfer "enter negative A" 48 3
+ "Literal value is stored in rA with opposite sign.
+Indexed, stores value of index in rA with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'ENNX 'address-transfer "enter negative X" 55 3
+ "Literal value is stored in rX with opposite sign.
+Indexed, stores value of index in rX with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'ENN1 'address-transfer "Enter negative rI1" (+ 48 1) 3
+ "Literal value is stored in rI1 with opposite sign.
+Indexed, stores value of index in rI1 with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'ENN2 'address-transfer "Enter negative rI2" (+ 48 2) 3
+ "Literal value is stored in rI2 with opposite sign.
+Indexed, stores value of index in rI2 with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'ENN3 'address-transfer "Enter negative rI3" (+ 48 3) 3
+ "Literal value is stored in rI3 with opposite sign.
+Indexed, stores value of index in rI3 with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'ENN4 'address-transfer "Enter negative rI4" (+ 48 4) 3
+ "Literal value is stored in rI4 with opposite sign.
+Indexed, stores value of index in rI4 with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'ENN5 'address-transfer "Enter negative rI5" (+ 48 5) 3
+ "Literal value is stored in rI5 with opposite sign.
+Indexed, stores value of index in rI5 with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'ENN6 'address-transfer "Enter negative rI6" (+ 48 6) 3
+ "Literal value is stored in rI6 with opposite sign.
+Indexed, stores value of index in rI6 with opposite sign."
+ 1)
+
+(mixal-add-operation-code
+ 'INCA 'address-transfer "increase A" 48 0
+ "Increase register A with the literal value of M.
+On overflow the overflow toggle is set."
+ 1)
+
+(mixal-add-operation-code
+ 'INCX 'address-transfer "increase X" 55 0
+ "Increase register X with the literal value of M.
+On overflow the overflow toggle is set."
+ 1)
+
+(mixal-add-operation-code
+ 'INC1 'address-transfer "increase I1" (+ 48 1) 0
+ "Increase register I1 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'INC2 'address-transfer "increase I2" (+ 48 2) 0
+ "Increase register I2 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'INC3 'address-transfer "increase I3" (+ 48 3) 0
+ "Increase register I3 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'INC4 'address-transfer "increase I4" (+ 48 4) 0
+ "Increase register I4 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'INC5 'address-transfer "increase I5" (+ 48 5) 0
+ "Increase register I5 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'INC6 'address-transfer "increase I6" (+ 48 6) 0
+ "Increase register I6 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'DECA 'address-transfer "decrease A" 48 1
+ "Decrease register A with the literal value of M.
+On overflow the overflow toggle is set."
+ 1)
+
+(mixal-add-operation-code
+ 'DECX 'address-transfer "decrease X" 55 1
+ "Decrease register X with the literal value of M.
+On overflow the overflow toggle is set."
+ 1)
+
+(mixal-add-operation-code
+ 'DEC1 'address-transfer "decrease I1" (+ 48 1) 1
+ "Decrease register I1 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'DEC2 'address-transfer "decrease I2" (+ 48 2) 1
+ "Decrease register I2 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'DEC3 'address-transfer "decrease I3" (+ 48 3) 1
+ "Decrease register I3 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'DEC4 'address-transfer "decrease I4" (+ 48 4) 1
+ "Decrease register I4 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'DEC5 'address-transfer "decrease I5" (+ 48 5) 1
+ "Decrease register I5 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'DEC6 'address-transfer "decrease I6" (+ 48 6) 1
+ "Decrease register I6 with the literal value of M.
+The result is undefined when the result does not fit in
+2 bytes."
+ 1)
+
+(mixal-add-operation-code
+ 'CMPA 'comparison "compare A" 56 'field
+ "Compare contents of A with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome."
+ 2)
+
+
+(mixal-add-operation-code
+ 'CMPX 'comparison "compare X" 63 'field
+ "Compare contents of rX with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome."
+ 2)
+
+
+(mixal-add-operation-code
+ 'CMP1 'comparison "compare I1" (+ 56 1) 'field
+ "Compare contents of rI1 with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome. Bit 1,2 and 3
+have a value of 0."
+ 2)
+
+
+(mixal-add-operation-code
+ 'CMP2 'comparison "compare I2" (+ 56 2) 'field
+ "Compare contents of rI2 with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome. Bit 1,2 and 3
+have a value of 0."
+ 2)
+
+
+(mixal-add-operation-code
+ 'CMP3 'comparison "compare I3" (+ 56 3) 'field
+ "Compare contents of rI3 with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome. Bit 1,2 and 3
+have a value of 0."
+ 2)
+
+
+(mixal-add-operation-code
+ 'CMP4 'comparison "compare I4" (+ 56 4) 'field
+ "Compare contents of rI4 with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome. Bit 1,2 and 3
+have a value of 0."
+ 2)
+
+
+(mixal-add-operation-code
+ 'CMP5 'comparison "compare I5" (+ 56 5) 'field
+ "Compare contents of rI5 with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome. Bit 1,2 and 3
+have a value of 0."
+ 2)
+
+
+(mixal-add-operation-code
+ 'CMP6 'comparison "compare I6" (+ 56 6) 'field
+ "Compare contents of rI6 with contents of M.
+The field specifier works on both fields. The comparison indicator
+is set to LESS, EQUAL or GREATER depending on the outcome. Bit 1,2 and 3
+have a value of 0."
+ 2)
+
+(mixal-add-operation-code
+ 'JMP 'jump "jump" 39 0
+ "Unconditional jump.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'JSJ 'jump "jump, save J" 39 1
+ "Unconditional jump, but rJ is not modified."
+ 1)
+
+(mixal-add-operation-code
+ 'JOV 'jump "jump on overflow" 39 2
+ "Jump if OV is set (and turn it off).
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'JNOV 'jump "Jump on no overflow" 39 3
+ "Jump if OV is not set (and turn it off).
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'JL 'jump "Jump on less" 39 4
+ "Jump if '[CM] = L'.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JE 'jump "Jump on equal" 39 5
+ "Jump if '[CM] = E'.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JG 'jump "Jump on greater" 39 6
+ "Jump if '[CM] = G'.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JGE 'jump "Jump on not less" 39 7
+ "Jump if '[CM]' does not equal 'L'.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JNE 'jump "Jump on not equal" 39 8
+ "Jump if '[CM]' does not equal 'E'.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JLE 'jump "Jump on not greater" 39 9
+ "Jump if '[CM]' does not equal 'G'.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'JAN 'jump "jump A negative" 40 0
+ "Jump if the content of rA is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JAZ 'jump "jump A zero" 40 1
+ "Jump if the content of rA is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JAP 'jump "jump A positive" 40 2
+ "Jump if the content of rA is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JANN 'jump "jump A non-negative" 40 3
+ "Jump if the content of rA is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JANZ 'jump "jump A non-zero" 40 4
+ "Jump if the content of rA is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JANP 'jump "jump A non-positive" 40 5
+ "Jump if the content of rA is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'JXN 'jump "jump X negative" 47 0
+ "Jump if the content of rX is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JXZ 'jump "jump X zero" 47 1
+ "Jump if the content of rX is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JXP 'jump "jump X positive" 47 2
+ "Jump if the content of rX is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JXNN 'jump "jump X non-negative" 47 3
+ "Jump if the content of rX is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JXNZ 'jump "jump X non-zero" 47 4
+ "Jump if the content of rX is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JXNP 'jump "jump X non-positive" 47 5
+ "Jump if the content of rX is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'J1N 'jump "jump I1 negative" (+ 40 1) 0
+ "Jump if the content of rI1 is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J1Z 'jump "jump I1 zero" (+ 40 1) 1
+ "Jump if the content of rI1 is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J1P 'jump "jump I1 positive" (+ 40 1) 2
+ "Jump if the content of rI1 is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J1NN 'jump "jump I1 non-negative" (+ 40 1) 3
+ "Jump if the content of rI1 is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J1NZ 'jump "jump I1 non-zero" (+ 40 1) 4
+ "Jump if the content of rI1 is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J1NP 'jump "jump I1 non-positive" (+ 40 1) 5
+ "Jump if the content of rI1 is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'J2N 'jump "jump I2 negative" (+ 40 1) 0
+ "Jump if the content of rI2 is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J2Z 'jump "jump I2 zero" (+ 40 1) 1
+ "Jump if the content of rI2 is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J2P 'jump "jump I2 positive" (+ 40 1) 2
+ "Jump if the content of rI2 is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J2NN 'jump "jump I2 non-negative" (+ 40 1) 3
+ "Jump if the content of rI2 is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J2NZ 'jump "jump I2 non-zero" (+ 40 1) 4
+ "Jump if the content of rI2 is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J2NP 'jump "jump I2 non-positive" (+ 40 1) 5
+ "Jump if the content of rI2 is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J3N 'jump "jump I3 negative" (+ 40 1) 0
+ "Jump if the content of rI3 is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J3Z 'jump "jump I3 zero" (+ 40 1) 1
+ "Jump if the content of rI3 is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J3P 'jump "jump I3 positive" (+ 40 1) 2
+ "Jump if the content of rI3 is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J3NN 'jump "jump I3 non-negative" (+ 40 1) 3
+ "Jump if the content of rI3 is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J3NZ 'jump "jump I3 non-zero" (+ 40 1) 4
+ "Jump if the content of rI3 is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J3NP 'jump "jump I3 non-positive" (+ 40 1) 5
+ "Jump if the content of rI3 is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J4N 'jump "jump I4 negative" (+ 40 1) 0
+ "Jump if the content of rI4 is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J4Z 'jump "jump I4 zero" (+ 40 1) 1
+ "Jump if the content of rI4 is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J4P 'jump "jump I4 positive" (+ 40 1) 2
+ "Jump if the content of rI4 is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J4NN 'jump "jump I4 non-negative" (+ 40 1) 3
+ "Jump if the content of rI4 is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J4NZ 'jump "jump I4 non-zero" (+ 40 1) 4
+ "Jump if the content of rI4 is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J4NP 'jump "jump I4 non-positive" (+ 40 1) 5
+ "Jump if the content of rI4 is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J5N 'jump "jump I5 negative" (+ 40 1) 0
+ "Jump if the content of rI5 is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J5Z 'jump "jump I5 zero" (+ 40 1) 1
+ "Jump if the content of rI5 is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J5P 'jump "jump I5 positive" (+ 40 1) 2
+ "Jump if the content of rI5 is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J5NN 'jump "jump I5 non-negative" (+ 40 1) 3
+ "Jump if the content of rI5 is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J5NZ 'jump "jump I5 non-zero" (+ 40 1) 4
+ "Jump if the content of rI5 is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J5NP 'jump "jump I5 non-positive" (+ 40 1) 5
+ "Jump if the content of rI5 is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J6N 'jump "jump I6 negative" (+ 40 1) 0
+ "Jump if the content of rI6 is negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J6Z 'jump "jump I6 zero" (+ 40 1) 1
+ "Jump if the content of rI6 is zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J6P 'jump "jump I6 positive" (+ 40 1) 2
+ "Jump if the content of rI6 is positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J6NN 'jump "jump I6 non-negative" (+ 40 1) 3
+ "Jump if the content of rI6 is non-negative.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J6NZ 'jump "jump I6 non-zero" (+ 40 1) 4
+ "Jump if the content of rI6 is non-zero.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+
+(mixal-add-operation-code
+ 'J6NP 'jump "jump I6 non-positive" (+ 40 1) 5
+ "Jump if the content of rI6 is non-positive.
+Register J is set to the value of the next instruction that would have
+been executed when there was no jump."
+ 1)
+
+(mixal-add-operation-code
+ 'SLA 'miscellaneous "shift left A" 6 0
+ "Shift to A, M bytes left.
+Hero's will be added to the right."
+ 2)
+
+
+(mixal-add-operation-code
+ 'SRA 'miscellaneous "shift right A" 6 1
+ "Shift to A, M bytes right.
+Zeros will be added to the left."
+ 2)
+
+
+(mixal-add-operation-code
+ 'SLAX 'miscellaneous "shift left AX" 6 2
+ "Shift AX, M bytes left.
+Zeros will be added to the right."
+ 2)
+
+
+
+(mixal-add-operation-code
+ 'SRAX 'miscellaneous "shift right AX" 6 3
+ "Shift AX, M bytes right.
+Zeros will be added to the left."
+ 2)
+
+
+(mixal-add-operation-code
+ 'SLC 'miscellaneous "shift left AX circularly" 6 4
+ "Shift AX, M bytes left circularly.
+The bytes that fall off to the left will be added to the right."
+ 2)
+
+
+(mixal-add-operation-code
+ 'SRC 'miscellaneous "shift right AX circularly" 6 4
+ "Shift AX, M bytes right circularly.
+The bytes that fall off to the right will be added to the left."
+ 2)
+
+(mixal-add-operation-code
+ 'MOVE 'miscellaneous "move" 7 'number
+ "Move MOD words from M to the location stored in rI1."
+ '(+ 1 (* 2 number)))
+
+(mixal-add-operation-code
+ 'NOP 'miscellaneous "no operation" 0 'ignored
+ "No operation, M and F are not used by the machine."
+ 1)
+
+(mixal-add-operation-code
+ 'HLT 'miscellaneous "halt" 5 2
+ "Halt.
+Stop instruction fetching."
+ 1)
+
+(mixal-add-operation-code
+ 'IN 'input-output "input" 36 'unit
+ "Transfer a block of words from the specified unit to memory.
+The transfer starts at address M."
+ 1)
+
+(mixal-add-operation-code
+ 'OUT 'input-output "output" 37 'unit
+ "Transfer a block of words from memory.
+The transfer starts at address M to the specified unit."
+ 1)
+
+(mixal-add-operation-code
+ 'IOC 'input-output "input-output control" 35 'unit
+ "Perform a control operation.
+The control operation is given by M on the specified unit."
+ 1)
+
+(mixal-add-operation-code
+ 'JRED 'input-output "jump ready" 38 'unit
+ "Jump to M if the specified unit is ready."
+ 1)
+
+
+(mixal-add-operation-code
+ 'JBUS 'input-output "jump busy" 34 'unit
+ "Jump to M if the specified unit is busy."
+ 1)
+
+(mixal-add-operation-code
+ 'NUM 'conversion "convert to numeric" 5 0
+ "Convert rAX to its numerical value and store it in rA.
+the register rAX is assumed to contain a character representation of
+a number."
+ 10)
+
+(mixal-add-operation-code
+ 'CHAR 'conversion "convert to characters" 5 1
+ "Convert the number stored in rA to a character representation.
+The converted character representation is stored in rAX."
+ 10)
+
+(defvar mixal-describe-operation-code-history nil
+  "History list for describe operation code.")
+
+(defun mixal-describe-operation-code (&optional op-code)
+  "Display the full documentation of OP-CODE."
+  (interactive)
+  ;; we like to provide completition and history, so do it ourself (interactive "?bla")?
+  (unless op-code
+    (let* ((completion-ignore-case t)
+	   ;; we already have a list, but it is not in the right format
+	   ;; transform it to a valid table so completition can use it
+	   (table (mapcar '(lambda (elm)
+			     (cons (symbol-name (car elm)) nil))
+			  mixal-operation-codes-alist))
+	   ;; prompt is different depending on we are close to a valid op-code
+	   (have-default (member (current-word) mixal-operation-codes))
+	   (prompt (concat "Describe operation code "
+			   (if have-default
+			       (concat "(default " (current-word) "): ")
+			     ": "))))
+      ;; as the operation code to the user
+      (setq op-code (completing-read prompt table nil t nil
+				     'mixal-describe-operation-code-history
+				     (current-word)))))
+  ;; get the info on the op-code and output it to the help buffer
+  (let ((op-code-help (assq (intern-soft op-code) mixal-operation-codes-alist)))
+    (when op-code-help
+      (with-output-to-temp-buffer (buffer-name (get-buffer-create "*Help*"))
+	(princ op-code) (princ " is an mix operation code\n\n")
+	(princ (nth 5 op-code-help)) (terpri) (terpri)
+	(princ "      group: ") (princ (nth 1 op-code-help)) (terpri)
+	(princ "  nice name: ") (princ (nth 2 op-code-help)) (terpri)
+	(princ " OPCODE / C: ") (princ (nth 3 op-code-help)) (terpri)
+	(princ "    MOD / F: ") (princ (nth 4 op-code-help)) (terpri)
+	(princ "       time: ") (princ (nth 6 op-code-help)) (terpri)))))
+
+;;;; Running
+(defun mixal-run ()
+  "Run's mixal file in current buffer, assumes that file has been compiled"
+  (interactive)
+  (mixvm (concat "mixvm -r -t -d "
+		 (file-name-sans-extension (buffer-file-name)))))
+
+(defun mixal-debug ()
+  "Starts mixvm for debugging, assumes that file has been compiled with debugging support"
+  (interactive)
+  (mixvm (concat "mixvm "
+		 (file-name-sans-extension (buffer-file-name)))))
+
+;;;###autoload
+(define-derived-mode mixal-mode fundamental-mode "mixal"
+  "Major mode for the mixal asm language.
+\\{mixal-mode-map}"
+  (set (make-local-variable 'comment-start) "*")
+  (set (make-local-variable 'comment-start-skip) "*")
+  (set (make-local-variable 'font-lock-defaults) '(mixal-font-lock-keywords))
+; might add an indent function in the future
+;  (set (make-local-variable 'indent-line-function) 'mixal-indent-line)
+  (set (make-local-variable 'compile-command) (concat "mixasm "
+						      buffer-file-name))
+  ;; mixasm will do strange when there is no final newline,
+  ;; let emacs ensure that it is always there
+  (set (make-local-variable 'require-final-newline) t))
+
+;;;###autoload
+(add-to-list 'auto-mode-alist '("\\.mixal\\'" . mixal-mode))
+
+(provide 'mixal-mode)
+;;; mixal-mode.el ends here
diff --git a/misc/mixvm.el b/misc/mixvm.el
new file mode 100644
index 0000000..c437dfd
--- /dev/null
+++ b/misc/mixvm.el
@@ -0,0 +1,158 @@
+;;; mixvm.el --- mdk's mixvm / Emacs gud interaction
+;; Copyright (C) 2001 Free Software Foundation, Inc.
+     
+;; Author: Philip Ellis King <pking@pdq.net>
+;; Maintainer: Philip Ellis King <pking@pdq.net>
+;; Created: 12 Feb 2001
+;; Version: 0.2
+;; Keywords: tools
+     
+
+;;; Commentary:
+;; mixvm.el provides an interface between mdk's mixvm and Emacs,
+;; via gud.  Place this file in your load-path, optionally adding
+;; the following line to your .emacs file:
+;; (autoload 'mixvm "mixvm" "mixvm/gud interaction" t)
+;; Initiate a mdk/gud session with the command mixvm, gud will
+;; reflect the current line in the source file buffer.
+
+;; (mixvm.el is based on a study of gdb, perldb, and pdb as found
+;; in gud.el, and rubydb3x.el distributed with the source code to
+;; the Ruby language.
+
+;;; Change Log:
+;; Version 0.2
+;; Initial release
+
+
+;;; Code:
+(require 'gud)
+(provide 'mixvm)
+
+;;; History of argument lists passed to mixvm.
+(defvar gud-mixvm-history nil)
+
+;; rubydb3x provided good examples of xemacs/emacs
+;; compatibility (not interested at the moment)
+(defun gud-mixvm-massage-args (file args)
+  (cons "--emacs" args))
+
+;; There's no guarantee that Emacs will hand the filter the entire
+;; marker at once; it could be broken up across several strings.  We
+;; might even receive a big chunk with several markers in it.  If we
+;; receive a chunk of text which looks like it might contain the
+;; beginning of a marker, we save it here between calls to the
+;; filter.
+(defvar gud-mixvm-marker-acc "")
+(make-variable-buffer-local 'gud-mixvm-marker-acc)
+
+(defun gud-mixvm-marker-filter (string)
+  (setq gud-mixvm-marker-acc (concat gud-mixvm-marker-acc string))
+  (let ((output ""))
+
+    ;; Process all the complete markers in this chunk.
+    (while (string-match "\032\032mixvm:\\([^:]+\\):\\([0-9]+\\)"
+                         gud-mixvm-marker-acc)
+      (setq
+
+       ;; Extract the frame position from the marker.
+       gud-last-frame
+       (cons (substring gud-mixvm-marker-acc (match-beginning 1) (match-end 1))
+             (string-to-int (substring gud-mixvm-marker-acc
+                                       (match-beginning 2)
+                                       (match-end 2))))
+
+       ;; Append any text before the marker to the output we're going
+       ;; to return - we don't include the marker in this text.
+       output (concat output
+                      (substring gud-mixvm-marker-acc 0 (match-beginning 0)))
+
+       ;; Set the accumulator to the remaining text.
+       gud-mixvm-marker-acc (substring gud-mixvm-marker-acc (match-end 0))))
+
+    ;; Does the remaining text look like it might end with the
+    ;; beginning of another marker?  If it does, then keep it in
+    ;; gud-mixvm-marker-acc until we receive the rest of it.  Since we
+    ;; know the full marker regexp above failed, it's pretty simple to
+    ;; test for marker starts.
+    ;; (note: \\' matches the end of the string (Perl's '$'))
+    (if (string-match "\032.*\\'" gud-mixvm-marker-acc)
+        (progn
+          ;; Everything before the potential marker start can be output.
+          (setq output (concat output (substring gud-mixvm-marker-acc
+                                                 0 (match-beginning 0))))
+
+          ;; Everything after, we save, to combine with later input.
+          (setq gud-mixvm-marker-acc
+                (substring gud-mixvm-marker-acc (match-beginning 0))))
+
+      (setq output (concat output gud-mixvm-marker-acc)
+            gud-mixvm-marker-acc ""))
+
+    output))
+
+;; See gdb for more comprehensive example
+;; pek: it bugs me that this is run for EVERY interactive
+;; mixvm command, should we cache some info somewhere?
+(defun gud-mixvm-find-file (file)
+  (save-excursion
+    (let* ((buf (find-file-noselect file)))
+      (set-buffer buf)
+      (when (boundp 'gud-make-debug-menu)
+	(gud-make-debug-menu))
+      buf)))
+
+
+(defvar mixvm-minibuffer-local-map nil
+  "Keymap for minibuffer prompting of mixvm startup command.")
+(if mixvm-minibuffer-local-map
+    ()
+  (setq mixvm-minibuffer-local-map (copy-keymap minibuffer-local-map))
+  (define-key
+    mixvm-minibuffer-local-map "\C-i" 'comint-dynamic-complete-filename))
+
+
+(defcustom gud-mixvm-command-name "mixvm"
+  "File name for executing the mixvm debugger.
+This should be an executable on your path, or an absolute file name."
+  :type 'string
+  :group 'gud)
+
+
+;;;###autoload
+(defun mixvm (command-line)
+  "Run mixvm on program FILE in buffer `*gud-FILE*'.
+The directory containing FILE becomes the initial working directory
+and source-file directory for your debugger."
+  (interactive
+   (list (read-from-minibuffer "Run mixvm (like this): "
+                               (if (consp gud-mixvm-history)
+                                   (car gud-mixvm-history)
+                                 (concat gud-mixvm-command-name " "))
+                               mixvm-minibuffer-local-map nil
+                               '(gud-mixvm-history . 1))))
+
+  (gud-common-init command-line 'gud-mixvm-massage-args
+                   'gud-mixvm-marker-filter 'gud-mixvm-find-file)
+
+  (gud-def gud-break  "sbp %l"     "\C-b" "Set breakpoint at current line.")
+  (gud-def gud-remove "cbp %l"     "\C-d" "Remove breakpoint at current line")
+  (gud-def gud-step   "next"         "\C-s" "Step one source line with display.")
+  (gud-def gud-next   "next"         "\C-n" "Step one line.")
+  (gud-def gud-stepi   "next"         "\C-i" "Step one line.")
+  (gud-def gud-cont   "run"     "\C-r" "Continue with display.")
+  (gud-def gud-finish "run"       "\C-f" "Finish executing current function.")
+  (gud-def gud-print  "weval %e"         "\C-p" "Evaluate expression at point.")
+;   (gud-def gud-up     "up"           "<" "Up one stack frame.")
+;   (gud-def gud-down   "down"         ">" "Down one stack frame.")
+;   ;; Is this right?
+;   (gud-def gud-statement "! %e"      "\C-e" "Execute Python statement at point.")
+
+;   (local-set-key [menu-bar debug finish] '("Finish Function" . gud-finish))
+;   (local-set-key [menu-bar debug up] '("Up Stack" . gud-up))
+;   (local-set-key [menu-bar debug down] '("Down Stack" . gud-down))
+  (setq comint-prompt-regexp "^MIX > ")
+  (set (make-local-variable 'paragraph-start) comint-prompt-regexp)
+  (run-hooks 'mixvm-mode-hook))
+
+;;; mixvm.el ends here