summaryrefslogtreecommitdiff
path: root/doc/mdk.info
diff options
context:
space:
mode:
authorPeter Pentchev <roam@debian.org>2020-10-25 14:06:17 +0200
committerPeter Pentchev <roam@debian.org>2020-10-25 14:06:17 +0200
commit5422fd264e0ad6144af8fd8a59adca44991220a5 (patch)
treeeaf5b93289ebfb4c5daec11c890e23b2e9c71feb /doc/mdk.info
parent2864b7d715ecf25bfb990fbaa0ed133316d04fac (diff)
New upstream version 1.2.11
Diffstat (limited to 'doc/mdk.info')
-rw-r--r--doc/mdk.info221
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: