bp_get_condition: eliminate expr_p2

[ddt180.git] / doc / ddtz-ref-short.txt

ANLEITUNG zum DDTZ\r
Development Debugging Tool for Z80 microcomputers\r
\r
Zusammenfassung der Befehle:\r
\r
> @				examine [and substitute]\r
				the displacement register @\r
> A [startadresse]		Assemble\r
> B				display all Breakpoints\r
  B breakp [breakp..] [:count]	set Breakpoints\r
  BX				clear all Breakpoints\r
  BX adresse [adresse..]	clear Breakpoints\r
>>C[N][J] [befehlsanzahl]	trace over Calls [no list] [jumps only]\r
  C[N][J] W ausdruck		..while..\r
  C[N][J] U ausdruck		..until..\r
>>D [startadr] [endadr] 	Display memory in hex and ascii\r
> F kommandozeile		specify Filename and command line\r
> G [startadr] [;breakp..]	Go [to start] [temporary breakpoints]\r
> H				display High and maximal size of files\r
> H ausdruck			compute Hex and other expressions\r
  H ausdruck ausdruck		Hex and other sum and difference\r
>>I [port]			Input a byte from port\r
>>L [startadr] [endadr] 	List disassembled code\r
> M[V] startadr endadr zieladr	Move memory [and verify]\r
>>O [byte] [port]		Output a byte to port\r
> Q[J] startadr endadr bytes	Qery memory for byte string [justified]\r
> R [displacement]		Read binary or hex file [add displacemt]\r
> S startadr			Substitute memory\r
>>T[N][J] [befehlsanzahl]	Trace [no list] [Jumps only]\r
  T[N][J] W ausdruck		..while..\r
  T[N][J] U ausdruck		..until..\r
> V startadr endadr zieladr	Verify (compare) two memory areas\r
> W startadr endadr		Write a file to disk\r
> X				eXamine all cpu registers\r
  X register			eXamine [and substitute] a register\r
> Y				eXamine all Y variables\r
  Yziffer0bis9			eXamine [and substitute] an Y variable\r
> Z startadr endadr bytes	Zap (fill) memory with a byte string\r
\r
\r
\r
Registernamen:\r
\r
A , F , B , C , D , E , H , L ,BC , DE , HL\r
A', F', B', C', D', E', H', L',BC', DE', HL'\r
IX oder X , IY oder Y , SP oder S , PC oder P , I\r
\r
Flags des F- und des F'-Registers:\r
\r
S    Sign		  Vorzeichen\r
Z    Zero		  Null\r
H    Half carry 	  Uebertrag von bit 3 nach bit 4\r
V    oVerflow/parity	  Ueberlauf/gerade Paritaet\r
N    Negation		  NEG, DEC, SUB o.ae. ausgefuehrt\r
C    Carry		  Uebertrag von bit 7\r
E    interrupt Enabled	  das Interrupt flag wird im DDTZ wie\r
			  ein Flag des F-Registers behandelt.\r
\r
Variablen und Konstanten:\r
\r
L    Low		  Benutzerspeicher-Anfang. Festwert 100H\r
H    High		  Hoechste Adresse der letzten gelesenen File\r
M    Max		  Maximale Adresse aller gelesenen Files\r
T    Top		  Oberes Ende des Benutzerspeichers\r
@			  Displacement Register\r
$			  beim Assemblieren Anfangsadresse des Befehls\r
			  sonst = PC\r
Y0..Y9			  frei verwendbare Variablen\r
^register		  Inhalt eines Registers\r
(adresse)		  Inhalt eines Speicherplatzes (Byte)\r
(adresse).		  Inhalt eines Speicherplatzes (Wort)\r
\r
Aufruf des DDTZ:\r
\r
	DDTZ\r
  oder	DDTZ d:filename.ext\r
\r
Bei beiden Aufrufen laedt das Disk Operating System das DDTZ bei\r
Adresse 100H beginnend in den Speicher. Das DDTZ verlagert sich\r
danach direkt vor das BDOS und ueberschreibt dabei den CCP. Der\r
Adressteil des Befehls JP BDOS auf Adresse 5 wird erniedrigt,\r
um dem Anwenderprogramm die durch das DDTZ verringerte Speichergroesse\r
mitzuteilen. Der urspruenglich vom DDTZ belegte Speicher wird daraufhin\r
mit Nullen geloescht.\r
Wurde im Aufruf ein Filename angegeben, so laedt das DDTZ die File\r
in den Speicher. Nach Ausgabe des Prompt-Zeichens '>' ist das DDTZ\r
betriebsbereit.\r
\r
\r
Allgemeines zum Gebrauch des DDTZ:\r
\r
Ausdruecke:\r
\r
In allen Situationen, in denen Zahlen eingegeben werden koennen, ist\r
auch die Eingabe von Ausdruecken erlaubt.\r
Ausdruecke haben die Form\r
	arithmetischerausdruck\r
  oder	arithmetischerausdruck relationsoperator arithmetischerausdruck\r
Die relationsoperatoren sind\r
=  <>  >  >=  <=  <\r
Der Ausdruck hat den Wert -1, wenn die Relation wahr ist, sonst 0.\r
z.B:	der Ausdruck 1+2=3 hat den Wert -1, und 'A'<'B' den Wert 0\r
Ein arithmetischer Ausdruck hat die allgemeine Form\r
	faktor arithmetikoperator faktor arith... faktor\r
Die Arithmetikoperatoren sind\r
+ - * / %	     Plus, Minus, Multiplikation, Division, Modulo\r
& ! #		     bitweise AND, OR, XOR\r
\r
Ein Faktor hat die Form\r
[ausdruck]	     geklammerter Ausdruck\r
+faktor\r
-faktor 	     Negation\r
~faktor 	     bitweise NOT\r
'a'		     Wert eines ASCII-Zeichens\r
'a'.		     mit gesetztem Bit 7\r
'ab'		     Wert zweier ASCII-Zeichen\r
'ab'.		     das niederwertige mit gesetztem bit 7\r
(ausdruck)	     ein Byte im Speicher\r
(ausdruck).	     ein Wort im Speicher\r
variable	     eine der oben aufgezaehlten Variablen\r
hhhh[H] 	     Hex-Zahl\r
ddddd.		     Dezimal-Zahl\r
bbbbbbbb"bbbbbbbb"   Binaer-Zahl (beliebig mit '"' unterteilt)\r
\r
Enthaelt ein Ausdruck einen Relationsoperator, so werden erst die\r
beiden arithmetischen Ausdruecke berechnet und dann die Relation.\r
Ein arithmetischer Ausdruck wird von links nach rechts berechnet,\r
also ohne Beachtung 'Punktrechnung vor Strichrechnung', die Reihenfolge\r
kann jedoch mit Klammern '[' und ']' geaendert werden.\r
Ausdruecke duerfen keine Blanks enthalten.\r
\r
Befehle:\r
\r
Befehle beginnen mit einem der Zeichen '@' bis 'Z', eventuell gefolgt\r
von weiteren optionalen Buchstaben, sowie Argumenten. Wird eine\r
optionale Anfangsadresse weggelassen, so wird die Adresse benutzt,\r
bei der Befehl zuletzt beendet wurde. Wird eine optionale Endadresse\r
weggelassen, so wird der Befehl (z.B. L oder D) so lange ausgefuehrt,\r
bis etwa ein Bildschirm vollgeschrieben ist. Ein weggelassenes\r
optionales Argument, hinter dem weitere Argumente angegeben werden\r
sollen, muss durch ein Komma ersetzt werden. Zwischen zwei Argumenten\r
muss ein Blank, ein Tab (^I) oder ein Komma stehen.\r
\r
\r
Bei Befehlen, die eine Start- und eine Endadresse erfordern, kann\r
anstelle der Endadresse auch der Buchstabe 'S', gefolgt von einer\r
Laengenangabe verwendet werden.\r
  z.B. bedeutet   D 1000 S 100	oder D1000S100\r
	 das selbe wie	 D 1000 10FF oder D1000,10FF\r
\r