ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/ENTERPRS/CPM/UTILS/A/DZ-NOV86.LZH/DZENGHLP.OVR

Text File | 2000-06-30 | 15KB | 327 lines

                                                                 29 Nov 86
HELP FILE for DazzleStar Disassembler
=====================================
                               Introduction


Thi≤á documen⌠ i≤ thσ filσ DZENGHLP.OV╥ anΣ serve≤ a≤ ß brieµ introductioε ì
t∩ DazzleStar«á  It'≤ provideΣ iε casσ yo⌡ don'⌠ ye⌠ havσ thσ ful∞ manual¼ ì
anΣ as a form of on-line help.

DazzleSta≥á take≤ ß CP/M-8░ binar∙ filσ (fo≥ examplσ ß .CO═ o≥ .OV╥ file)¼ ì
anΣá produce≤ Ziloτ Z8░ mnemonics¼á eithe≥ a≤ ß listinτ oε you≥ printe≥ o≥ ì
a≤ ß .MA├ filσ fo≥ Microsof⌠ M8░ o≥ other assemblers.

Thi≤ filσ serve≤ a≤ aε introduction¼á sufficien⌠ t∩ ge⌠ yo⌡ starteΣ anΣ d∩ ì
usefu∞ work«á  I⌠ caε bσ browseΣ witΦ ^J¼á o≥ printeΣ usinτ WordStar«á  T∩ ì
obtain the full manual, refer to DZ--READ.ME.

--------------------------------------------------------------------------
.cp 25

Fe≈ program≤ contaiε nothinτ bu⌠ instructions¼ s∩ DazzleSta≥ keep≤ ß breaδ ì
table¼á t∩á specif∙ ho≈ eacΦ par⌠ oµ you≥ prograφ i≤ t∩á bσá disassembled«  ì
Therσá i≤á als∩á ß symbo∞ table¼á s∩ tha⌠ label≤ anΣ value≤ caεá bσá giveε ì
whateve≥ name≤ (o≥ phrases¼ even⌐ tha⌠ thσ use≥ wishes.


                      Starting up (the command line)

Thσá filσ t∩ bσ disassembleΣ mus⌠ bσ specifieΣ iε thσ commanΣ tail«á Sincσ ì
thσ .CO═ extensioε i≤ thσ mos⌠ frequent¼á .CO═ i≤ addeΣ iµ n∩ extensioε i≤ ì
explicitl∙ given«á  Fo≥ example¼á t∩ disassemblσ ß filσ THATPROG.COM¼ typσ ì
"D┌ THATPROGó ("D┌ THATPROG.COMó als∩ works)«á  Othe≥ files¼á fo≥á examplσ ì
THATPROG.OVR¼ caε bσ specifieΣ b∙ givinτ thσ namσ iε full«  ┴ drivσ lette≥ ì
in front of the filename is accepted (e.g. "DZ B:THATPROG").

--------------------------------------------------------------------------
.cp 25è                          Windows on the screen

Thσ screeε i≤ arrangeΣ witΦ window≤ whicΦ arσ independentl∙ updated.

            .-------------------------------.
            |          Status Line          |
            |-------------------------------| Experienced users can
            |                               | suppress the menu to
            |          Men⌡ windo≈          | expanΣ thσ othe≥ windows
Info about  |-------------------------------|
nearby      |          Break window         |
breaks      |-------------------------------|
            |                               | You≥ curso≥ i≤ normally
Sometimes   |       Disassembly window      | within this window
these two   |-------------------------------|
windows are |      Hex dump window | Ascii  | If disassembly window
combined    |   or 2nd disassembly | window | is very small, your
            '-------------------------------' curso≥ may be iε thi≤
                                              window
--------------------------------------------------------------------------
.c≡ 25
                           Moving thru the file

Thσ commanΣ key≤ choseε arσ baseΣ oε WordStar¼á s∩ yo⌡ shoulΣ quickl∙ finΣ ì
ß lo⌠ oµ olΣ friend≤ oε you≥ keyboard.

  ^W  Scroll up 1 line           ^E              ^R  Scroll to previous
                              Cursor up              page (or thereabouts)



  ^Z                        ^X                  ^C  Next page
  Scroll down          Cursor down
  1 line

^^ (up)   also work, which allows use of
^_ (down) cursor arrows on some machines

Actually¼ jus⌠ thσ letter≤ alonσ als∩ worδ ok¼ n∩ neeΣ t∩ usσ <CTRL>.
--------------------------------------------------------------------------
.cp 25è                              Moving further

T∩á movσá ßá shor⌠á distancσ througΦ thσ file¼á usσá thσá scrol∞á command≤ ì
(especiall∙ ^├ anΣ ^R)«á  Ofteε you'l∞ wan⌠ t∩ movσ further¼á s∩ therσ arσ ì
hand∙ way≤ t∩ d∩ this:

Go to address    ^A  hex address <return>
and display      ^F  goes to the address in the 2nd and 3rd bytes of
screenful            the instruction specified by the cursor
                 (to remember: A for Address, F for Follow)

--------------------------------------------------------------------------
.cp 25
                              Command groups

Somσá oµá thσ commanΣ code≤ arσ tw∩ character≤ lonτ (simila≥á t∩á WordSta≥ ì
wherσ analogie≤ arσ possible)«  The∙ arσ loosel∙ grouped¼ accordinτ t∩ thσ ì
firs⌠ characte≥ oµ thσ pair.

Thσ commanΣ group≤ are:

     ^K-  various file commands
     ^O-  Onscreen: how the screen is arranged
     ^D-  Display other information
     ^Q-  Quick: move quickly to another part of the file
     ^S-  build Symbol table
     ^B-  build Break table
     ^P-  inline Parameter definition
     ^J-  Help

"Quickóá i≤á no⌠ ß ver∙ gooΣ mnemoniπ fo≥ thσ ^╤ family¼á bu⌠ man∙ oµá thσ ì
use≤ arσ simila≥ t∩ WordStar¼á fo≥ examplσ ^QR¼ ^QC¼ ^QF¼ ^QA¼ ^Q╓ arσ al∞ ì
inspireΣ b∙ WordStar.
--------------------------------------------------------------------------
.cp 25è                                  HELP!

Wheε thσ firs⌠ characte≥ oµ ß two-characte≥ commanΣ ha≤ beeε typed¼ iµ thσ ì
seconΣá characte≥ i≤ no⌠ typeΣ withiε ß reasonablσ timσ theε thσá use≥á i≤ ì
prompteΣ b∙ thσ displa∙ oµ aε appropriatσ secondar∙ menu.

^JH▓á clear≤ thσ to≡ oµ thσ screeε t∩ makσ morσ rooφ fo≥ displayinτá code¼ ì
bu⌠ turn≤ ofµ thσ menu.

^JH│ turn≤ thσ men⌡ bacδ oε again.

^J <space> returns to the main menu.

^J followed by anything else displays this file.

(Actually¼á JH▓ anΣ JH│ caε bσ abbreviateΣ t∩ J▓ anΣ J3¼á no⌠ s∩ analagou≤ ì
to WordStar, but quicker to type!).

--------------------------------------------------------------------------
.cp 25
                               Break table

DazzleSta≥á build≤á ßá tablσ oµ "breaksó (calleΣ thσá breaδá table⌐á whicΦ ì
decide≤á ho≈ eacΦ par⌠ oµ thσ inpu⌠ filσ i≤ displayed«á  Thi≤á terminolog∙ ì
migh⌠ confusσ yo⌡ iµ you'rσ ß DD╘ o≥ ZSI─ user«á  Don'⌠ misunderstanΣ thi≤ ì
terφ -- i⌠ ha≤ NOTHIN╟ t∩ d∩ witΦ thing≤ likσ DDT breakpoint≤.

Thσá breaδ tablσ caε bσ modifieΣ witΦ ^B° sequences¼á summarizeΣ iε thσ ^┬ ì
menu¼ anΣ morσ full∙ describeΣ iε thσ manual.

Therσ arσ man∙ type≤ oµ break¼á givinτ yo⌡ grea⌠ flexibility«  Thσ one≤ t∩ ì
tr∙ first¼ satisfyinτ thσ majorit∙ oµ needs¼ are:

     ^BB  Bytes (as in DB or DEFB)
     ^BI  Instructions (the kind of display you get on starting DZ)
     ^BW  Word values, 16-bit numbers (as in DW or DEFW)

--------------------------------------------------------------------------
.cp 25è                              Disk files etc

     ^KS  Write .DZ file (text file containing all symbols, comments,
          and breaks, so disassembly can continue another day)

     ^K╥á ReaΣ .DZ file (produced by ^KS)

     ^KQ  return to CP/M -- nothing is saved

     ^KX  save break & symbol tables (if altered) and return to CP/M

     ^KP  print part or whole disassembly on LST: (or .PRN file)

     ^KW  write part or whole disassembly to disk (.MAC file)

     ^KG  Read "Ken Gielow" .BRK file, from Z80DIS21.

--------------------------------------------------------------------------
.cp 25
REMEMBER║á ^K╙ doe≤ no⌠ takσ long«  Yo⌡ can'⌠ turε bacδ thσ clocδ anΣ typσ ì
^KS after a power cut, or a head crash.

^KP¼á ^KW║á Jus⌠ pres≤ <return╛ t∩ obtaiε thσ mos⌠ sensiblσ default≤á (thσ ì
value≤ displayeΣ withiε squarσ brackets)«
--------------------------------------------------------------------------
.cp 25
                               Symbol table

Thσ symbo∞ tablσ caε bσ though⌠ oµ a≤ severa∞ independen⌠ symbo∞ table≤ -- ì
wheεá aε instructioε i≤ decodeΣ DazzleSta≥ decide≤ wha⌠ kinΣ oµ symbo∞á i≤ ì
involveΣ (fo≥ example¼á ß bytσ reference¼á ß worΣ reference¼á ßá label¼á ß ì
relativσ label¼ etc)«  Wheε thσ instructioε i≤ displayed¼ you≥ symbo∞ namσ ì
i≤á onl∙ useΣ iµ yo⌡ askeΣ fo≥ i⌠ t∩ bσ useΣ fo≥ thi≤ kinΣ oµ symbol«á  S∩ ì
i⌠ i≤ eas∙ t∩ tel∞ DazzleSta≥ t∩ turε this:

                        LD HL,0100         (size of 256 byte block)
                         ...
                        JP 0100            (restart the program)

into:
                        LD HL,blocksize
                         ...
                        JP start

without any confusion between the two uses of 0100.
--------------------------------------------------------------------------
.cp 25èThσá command≤ arσ describeΣ morσ formall∙ iε thσ referencσ sectioε oµá thσ ì
manual¼á anΣ mucΦ fulle≥ example≤ arσ giveε iε thσ tutoria∞ section«á  Fo≥ ì
no≈ let'≤ jus⌠ g∩ througΦ tha⌠ examplσ iε ß littlσ morσ detail:

                         LD HL,0100
                          ...
                         JP 0100

Movσ thσ curso≥ t∩ thσ L─ H╠ line«á  Typσ ^SIblocksize<return>«á  Movσ thσ ì
curso≥á t∩ thσ J╨ line«á  Typσ ^SIstart<return>«á  Now¼á wheε yo⌡á displa∙ ì
somewherσá elsσ iε thσ filσ witΦ ß referencσ t∩ 010░ i⌠ wil∞ sho≈á 'startº ì
o≥ 'blocksizeº a≤ appropriate.

^S╔ stand≤ fo≥ "symbo∞ indirect"«  Les≤ frequentl∙ yo⌡ wil∞ wan⌠ t∩ definσ ì
ßá symbo∞á wherσá yo⌡á arσá now¼á rathe≥ thaεá thσá placσá aεá instructioε ì
references.  There are lots of ^S commands to do this.
--------------------------------------------------------------------------
.cp 25
                    Auto-build breaks and symbol names

     ^SA  auto-builΣ symbo∞ tablσ (name≤ deriveΣ froφ he° addresses)

^S┴á i≤ thσ fastes⌠ wa∙ t∩ builΣ ß gooΣ disassembly«á  Positioε thσ curso≥ ì
t∩á thσá star⌠á oµá thσ prograφ (^QR⌐á anΣá usσá ^SA«á  DazzleSta≥á start≤ ì
disassembling¼á anΣ add≤ name≤ t∩ thσ symbo∞ tablσ a≤ i⌠ goes«  Iµ aε areß ì
follow≤áá aεá unconditiona∞á transfer¼áá i⌠á i≤á provisionall∙á markeΣá a≤ ì
unreachablσá anΣ no⌠ disassembleΣ (t∩ avoiΣ enterinτ falsσ label≤á iεá thσ ì
symbo∞á table)«á  EacΦ timσ ß cal∞ t∩ ß ne≈ routinσ i≤á found¼á DazzleSta≥ ì
give≤á yo⌡ bacδ ful∞ control«á  Thi≤ enable≤ advanceΣ user≤ t∩ examinσ thσ ì
routine¼á anΣá perhap≤á usσ thσ ^╨ family«á  EacΦ timσ ß referencσá t∩á aε ì
undefineΣá T-symbo∞á (withiεá thσ prograφ area⌐ i≤á founΣá yo⌡á als∩á gaiε ì
control¼ agaiε givinτ advanceΣ user≤ finσ control«  T∩ continuσ auto-builΣ ì
froφ wherσ i⌠ wa≤ halted¼ pres≤ ".ó (a≤ iε "t∩ bσ continued...").

--------------------------------------------------------------------------
.c≡ 25èThσá namσá giveεá b∙ ^S┴ use≤ thσ lette≥ appropriatσ fo≥ thσá usσá oµá thσ ì
symbo∞ anΣ thσ fou≥ he° digit≤ oµ it≤ value«á  Fo≥ example¼ decodinτ C│ 3┤ ì
1▓á iε aε areß startinτ witΦ aε "Ió breaδ (Instructions⌐ woulΣ generatσá ß ì
symbo∞ L1234.

Wheεá n∩ morσ passe≤ arσ requireΣ thσ curso≥ wil∞ sta∙ a⌠ thσ enΣá oµá thσ ì
prograφá wheε '.º i≤ pressed«á  Cleaε u≡ thσ breaδ tablσ witΦ ^BY«á  Fo≥ ß ì
largσ disassembl∙ thi≤ wil∞ takσ somσ time.
ì
--------------------------------------------------------------------------
.cp 25
                         Fine tuning the display

^OF¼ ^OS¼ anΣ ^O╒ givσ yo⌡ fine≥ contro∞ ove≥ thσ wa∙ iε whicΦ thσ displa∙ ì
i≤á presented«á  Thi≤á i≤á discusseΣ furthe≥á iεá thσá manual«á  Moreover¼ ì
DZINSTA╠á allow≤á yo⌡á t∩ specif∙ thσ initia∞ setting≤ oµ thesσá anΣá man∙ ì
othe≥ thing≤ t∩ you≥ liking.

Iµá yo⌡ havσ thσ manual¼á anΣ yo⌡ stil∞ can'⌠ ge⌠ thσ display¼á printouts¼ ì
anΣ file≤ exactl∙ thσ wa∙ yo⌡ likσ theφ (minu≤ pickles¼ extrß ketchup¼ anΣ ì
73┤á sesamσá seed≤á oε eacΦ bun⌐ theε you'rσ harΣ t∩ pleaseíá  Mai∞á mσá ß ì
lette≥ anΣ I'l∞ bσ happ∙ t∩ seσ iµ ╔ caε satis∙ you≥ gourme⌠ demand≤á nex⌠ ì
timσá around«á  Ver∙ fe≈ peoplσ takσ u≡ thi≤ offe≥ -- s∩ don'⌠ jus⌠ sa∙ t∩ ì
yourself "someone is bound to have pointed THAT out already".

--------------------------------------------------------------------------
.cp 25
                               Comments

Therσá arσ tw∩ sort≤ oµ comment¼á thosσ betweeε line≤ anΣ thosσá alongsidσ ì
the code.  I like to call them major comments and minor comments.

Inserting a major comment:

     Move the cursor to the line following where you want the comment.
     Pres≤ <semicolon>«  (Thσ screeε wil∞ bσ redisplayed¼ witΦ ß ga≡ fo≥
                        your new comment).
     Type comment, terminating with <return>

Backspacσ i≤ implemented¼á anΣ caε bσ useΣ beforσ <return╛ ha≤ beeε typed¼ ì
bu⌠ otherwisσ thσ commen⌠ canno⌠ bσ edited«  However¼ yo⌡ caε late≥ retypσ ì
i⌠ completely¼á anΣ deletσ thσ olΣ one«  There'≤ n∩ limi⌠ t∩ thσ numbe≥ oµ ì
line≤ oµ commen⌠ a⌠ an∙ point«  Comment≤ caε bσ inserteΣ iε an∙ order.

Inserting a minor comment:  much the same, but start by pressing <slash>.

--------------------------------------------------------------------------
.c≡ 25è                Moving forward or back by just a few bytes

┴ digi⌠ (DON'╘ pres≤ thσ <CTRL╛ ke∙ a⌠ thσ samσ time¼á somσ computer≤á ge⌠ ì
upse⌠á iµá yo⌡ do⌐ cause≤ redispla∙ froφ thσ addres≤ oµ thσá curren⌠á linσ ì
plu≤ thσ valuσ oµ thσ digi⌠ yo⌡ typed«

Fo≥á example¼á movσá thσá curso≥ t∩ ß linσ (perhap≤ thσ firs⌠á linσá oµá ß ì
routine⌐á anΣ typσ '0'«á  Thσ addres≤ oµ thi≤ linσ (plu≤ ░ ╜á nothing⌐á i≤ ì
useΣá a≤ thσ firs⌠ linσ oµ thσ screeε anΣ thσ wholσ screeε i≤ redisplayed«  ì
S∩ '0º slide≤ you≥ windo≈ dowε thσ codσ ß bi⌠ (dependinτ wherσ you≥ curso≥ ì
is⌐á bu⌠á no⌠ a≤ mucΦ a≤ ^├ woulΣ (unles≤ you≥ curso≥ wa≤á oεá thσá bottoφ ì
line¼ iε whicΦ casσ thσ resul⌠ woulΣ bσ identical).

'1ºá i≤á usefu∞á iµá yo⌡ thinδ you'rσ lookinτá a⌠á instructions¼á bu⌠á thσ ì
decodinτ i≤ "ou⌠ oµ sync".

'-º followeΣ b∙ ß digi⌠ causes..«  (yo⌡ guessed?)

Thesσ digi⌠ command≤ arσ particularl∙ usefu∞ wheε yo⌡ usσ ^QA.
--------------------------------------------------------------------------
.c≡ 25
                                 WARNING


╔ woulΣ bσ ver∙ surpriseΣ iµ DazzleSta≥ overwrotσ you≥ systeφá tracks¼á o≥ ì
arbitrar∙á part≤ oµ thσ disδ (anΣ woulΣ VER┘ mucΦ wan⌠ t∩ hea≥ abou⌠ i⌠ iµ ì
i⌠ happened)«á  Thσ mos⌠ likel∙ causσ oµ accident≤ i≤ througΦ thσ lacδá oµ ì
an∙á warninτ beforσ overwritinτ aε existinτ file¼á fo≥ example¼á usinτ ^K╫ ì
wheε ß .MA├ filσ oµ tha⌠ namσ alread∙ exists«

N∩á precaution≤á agains⌠á compute≥á o≥á disδá erro≥á arσáá included«áá  Iε ì
particular¼á DazzleSta≥á wil∞á fai∞ iµ thσ disδ i⌠ i≤ writinτá t∩á become≤ ì
full«á  A≤ witΦ an∙ othe≥ software¼ makσ BACK-U╨ COPIE╙ O╞ AN┘ FILE╙ YOU'─ ì
REGRE╘ LOSING«  D∩ i⌠ REGULARLY«  Nothinτ caε eliminatσ heaΣ crashes«

--------------------------------------------------------------------------
.c≡ 25è





                          -- End of Help File --

                            -- NOW PRESS ^U --


--------------------------------------------------------------------------
.c≡ 25