diff options
author | Peter Pentchev <roam@debian.org> | 2020-10-25 14:06:17 +0200 |
---|---|---|
committer | Peter Pentchev <roam@debian.org> | 2020-10-25 14:06:17 +0200 |
commit | 5422fd264e0ad6144af8fd8a59adca44991220a5 (patch) | |
tree | eaf5b93289ebfb4c5daec11c890e23b2e9c71feb /doc/mdk.info | |
parent | 2864b7d715ecf25bfb990fbaa0ed133316d04fac (diff) |
New upstream version 1.2.11
Diffstat (limited to 'doc/mdk.info')
-rw-r--r-- | doc/mdk.info | 221 |
1 files changed, 119 insertions, 102 deletions
diff --git a/doc/mdk.info b/doc/mdk.info index 1710a16..3579f97 100644 --- a/doc/mdk.info +++ b/doc/mdk.info @@ -1,4 +1,4 @@ -This is mdk.info, produced by makeinfo version 6.5 from mdk.texi. +This is mdk.info, produced by makeinfo version 6.7 from mdk.texi. This manual is for GNU MDK (version 1.2.9, November, 2015), a set of utilities for developing programs using Donald Knuth's MIX mythical @@ -1158,19 +1158,21 @@ have at your disposal the following instructions: unit. In all the above instructions, the 'MOD' subfile must be in the range 0-20, since it denotes the operation's target device. The 'IOC' -instruction only makes sense for tape devices ('MOD' = 0-7 or 20): it -shifts the read/write pointer by the number of words given by 'M' (if it -equals zero, the tape is rewound)(1) (*note Input-output -operators-Footnote-1::). +instruction makes sense for magnetic tape devices ('MOD' = 0-7): it +shifts the read/write pointer by the number of blocks given by 'M' (if +it equals zero, the tape is rewound), paper tape devices ('MOD' = 20): +'M' should be 0, the tape is rewound, and disk/drum devices ('MOD' = +8-15): it moves the read/write pointer to the block specified in rX and +'M' should be 0(1) (*note Input-output operators-Footnote-1::). File: mdk.info, Node: Input-output operators-Footnotes, Up: Input-output operators (1) In Knuth's original definition, there are other control operations available, but they do not make sense when implementing the -block devices as disk files (as we do in MDK simulator). For the same -reason, MDK devices are always ready, since all input-output operations -are performed using synchronous system calls. +devices as disk files (as we do in MDK simulator). For the same reason, +MDK devices are always ready, since all input-output operations are +performed using synchronous system calls. File: mdk.info, Node: Conversion operators, Next: Shift operators, Prev: Input-output operators, Up: MIX instruction set @@ -1380,7 +1382,7 @@ where 'OPERAND' is of the form 'MNEMONIC' is a literal denoting the operation code of the instruction (e.g. 'LDA', 'STA'; see *note MIX instruction set::) or an assembly - pseudoinstruction (e.g. 'ORG', 'EQU'), + pseudoinstruction (e.g. 'ORIG', 'EQU'), 'ADDRESS' is an expression evaluating to the address subfield of the instruction, @@ -3238,6 +3240,15 @@ executing, using the following commands: Line 6: HLT MIX > + -- debug command: sbt [NUMBER] + This command changes the limit for the backtrace of executed + instructions. If the number is omitted, the command prints the + current limit. If you use a 0, backtraces are turned off. This + can improve performance. If you wish for all the instructions to + be logged, a -1 will enable that. The amount of memory required + for unlimited backtraces can be substantial for long-running + programs. + -- debug command: pbt [INS_NUMBER] This command prints a backtrace of executed instructions. Its optional argument INS_NUMBER is the number of instructions to @@ -5849,7 +5860,7 @@ Instructions and commands * pall: State commands. (line 27) * pasm: Configuration commands. (line 47) -* pbt: Debug commands. (line 156) +* pbt: Debug commands. (line 165) * pc: State commands. (line 20) * pddir: Configuration commands. (line 63) @@ -5882,6 +5893,7 @@ Instructions and commands * sbpm: Debug commands. (line 76) * sbpo: Debug commands. (line 88) * sbpr: Debug commands. (line 65) +* sbt: Debug commands. (line 156) * scmf: Scheme commands. (line 19) * scmp: State commands. (line 62) * sddir: Configuration commands. @@ -5902,7 +5914,7 @@ Instructions and commands * SRB: Shift operators. (line 23) * SRC: Shift operators. (line 14) * sreg: State commands. (line 25) -* ssym: Debug commands. (line 217) +* ssym: Debug commands. (line 226) * STA: Storing operators. (line 12) * STi: Storing operators. (line 16) * stime: Configuration commands. @@ -5917,8 +5929,8 @@ Instructions and commands (line 43) * Toolbar(s): Menu and status bars. (line 49) -* w2d: Debug commands. (line 234) -* weval: Debug commands. (line 205) +* w2d: Debug commands. (line 243) +* weval: Debug commands. (line 214) @@ -5952,94 +5964,99 @@ Node: Address transfer operators37268 Node: Comparison operators39441 Node: Jump operators40595 Node: Input-output operators43460 -Node: Input-output operators-Footnotes44749 -Ref: Input-output operators-Footnote-144837 -Node: Conversion operators45161 -Node: Shift operators46562 -Node: Miscellaneous operators48125 -Node: Execution times48785 -Node: MIXAL50655 -Node: Basic structure52273 -Node: Basic structure-Footnotes54878 -Ref: Basic structure-Footnote-154952 -Ref: Basic structure-Footnote-255014 -Node: MIXAL directives55222 -Node: MIXAL directives-Footnotes60050 -Ref: MIXAL directives-Footnote-160126 -Node: Expressions60407 -Node: W-expressions61995 -Node: Local symbols64940 -Node: Local symbols-Footnotes66568 -Ref: Local symbols-Footnote-166638 -Node: Literal constants66754 -Node: Getting started67606 -Node: Writing a source file68447 -Node: Writing a source file-Footnotes71470 -Ref: Writing a source file-Footnote-171556 -Ref: Writing a source file-Footnote-271729 -Node: Compiling72175 -Node: Running the program73198 -Node: Non-interactive mode74987 -Node: Non-interactive mode-Footnotes77383 -Ref: Non-interactive mode-Footnote-177467 -Ref: Non-interactive mode-Footnote-277757 -Node: Interactive mode77911 -Node: Interactive mode-Footnotes81572 -Ref: Interactive mode-Footnote-181648 -Node: Debugging81763 -Node: Using mixguile85333 -Node: The mixguile shell86094 -Node: Additional functions87826 -Node: Defining new functions89524 -Node: Hook functions92773 -Node: Command hooks93277 -Node: Break hooks98196 -Node: Break hooks-Footnotes99350 -Ref: Break hooks-Footnote-199416 -Node: Scheme scripts99688 -Node: Using Scheme in mixvm and gmixvm101519 -Node: Emacs tools103207 -Node: MIXAL mode103999 -Node: MIXAL mode-Footnotes104699 -Ref: MIXAL mode-Footnote-1104763 -Node: Basics104839 -Node: Help system105875 -Node: Compiling and running106770 -Node: GUD integration107681 -Node: GUD integration-Footnotes108417 -Ref: GUD integration-Footnote-1108491 -Node: mixasm108707 -Node: Invoking mixasm109342 -Node: mixvm111192 -Node: Invocation112086 -Node: Commands114635 -Node: Commands-Footnotes116300 -Ref: Commands-Footnote-1116360 -Ref: Commands-Footnote-2116481 -Node: File commands116686 -Node: Debug commands119779 -Node: State commands129289 -Node: Configuration commands132742 -Node: Scheme commands135614 -Node: Devices136718 -Node: gmixvm140137 -Node: Invoking gmixvm140978 -Node: MIXVM console144840 -Node: MIX virtual machine146434 -Node: MIXAL source view147743 -Node: MIX devices view148580 -Node: Menu and status bars149656 -Node: mixguile153716 -Node: Invoking mixguile154352 -Node: Scheme functions reference156787 -Node: mixvm wrappers157794 -Node: Hooks161871 -Node: Additional VM functions164690 -Node: Problems169049 -Node: Copying169570 -Node: GNU General Public License169900 -Node: GNU Free Documentation License207468 -Node: Concept Index229867 -Node: Instructions and commands239177 +Node: Input-output operators-Footnotes44939 +Ref: Input-output operators-Footnote-145027 +Node: Conversion operators45345 +Node: Shift operators46746 +Node: Miscellaneous operators48309 +Node: Execution times48969 +Node: MIXAL50839 +Node: Basic structure52457 +Node: Basic structure-Footnotes55063 +Ref: Basic structure-Footnote-155137 +Ref: Basic structure-Footnote-255199 +Node: MIXAL directives55407 +Node: MIXAL directives-Footnotes60235 +Ref: MIXAL directives-Footnote-160311 +Node: Expressions60592 +Node: W-expressions62180 +Node: Local symbols65125 +Node: Local symbols-Footnotes66753 +Ref: Local symbols-Footnote-166823 +Node: Literal constants66939 +Node: Getting started67791 +Node: Writing a source file68632 +Node: Writing a source file-Footnotes71655 +Ref: Writing a source file-Footnote-171741 +Ref: Writing a source file-Footnote-271914 +Node: Compiling72360 +Node: Running the program73383 +Node: Non-interactive mode75172 +Node: Non-interactive mode-Footnotes77568 +Ref: Non-interactive mode-Footnote-177652 +Ref: Non-interactive mode-Footnote-277942 +Node: Interactive mode78096 +Node: Interactive mode-Footnotes81757 +Ref: Interactive mode-Footnote-181833 +Node: Debugging81948 +Node: Using mixguile85518 +Node: The mixguile shell86279 +Node: Additional functions88011 +Node: Defining new functions89709 +Node: Hook functions92958 +Node: Command hooks93462 +Node: Break hooks98381 +Node: Break hooks-Footnotes99535 +Ref: Break hooks-Footnote-199601 +Node: Scheme scripts99873 +Node: Using Scheme in mixvm and gmixvm101704 +Node: Emacs tools103392 +Node: MIXAL mode104184 +Node: MIXAL mode-Footnotes104884 +Ref: MIXAL mode-Footnote-1104948 +Node: Basics105024 +Node: Help system106060 +Node: Compiling and running106955 +Node: GUD integration107866 +Node: GUD integration-Footnotes108602 +Ref: GUD integration-Footnote-1108676 +Node: mixasm108892 +Node: Invoking mixasm109527 +Node: mixvm111377 +Node: Invocation112271 +Node: Commands114820 +Node: Commands-Footnotes116485 +Ref: Commands-Footnote-1116545 +Ref: Commands-Footnote-2116666 +Node: File commands116871 +Node: Debug commands119964 +Node: State commands129934 +Node: Configuration commands133387 +Node: Scheme commands136259 +Node: Devices137363 +Node: gmixvm140782 +Node: Invoking gmixvm141623 +Node: MIXVM console145485 +Node: MIX virtual machine147079 +Node: MIXAL source view148388 +Node: MIX devices view149225 +Node: Menu and status bars150301 +Node: mixguile154361 +Node: Invoking mixguile154997 +Node: Scheme functions reference157432 +Node: mixvm wrappers158439 +Node: Hooks162516 +Node: Additional VM functions165335 +Node: Problems169694 +Node: Copying170215 +Node: GNU General Public License170545 +Node: GNU Free Documentation License208113 +Node: Concept Index230512 +Node: Instructions and commands239822 End Tag Table + + +Local Variables: +coding: utf-8 +End: |