Washington Electronics & Systems Ltd
                                                                 28 Feb 86
HELP FILE for DazzleStar Disassembler
=====================================
                               Introduction


Thió  documenô  ió  thå  filå  DZENGHLP.OVÒ anä serveó  aó  á  brieæ  (buô �
adequate© introductioî tï DazzleStar®  It'ó provideä iî caså yoõ don'ô yeô �
havå thå fulì manual¬ anä wanô tï "trù beforå yoõ buy".

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 and DZ-FORMS.DOC.

--------------------------------------------------------------------------
.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
     ^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

--------------------------------------------------------------------------
.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
     ^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:

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

REMEMBERº  ^KÓ doeó noô takå long®  Yoõ can'ô turî bacë thå clocë anä typå �
^KS after a power cut, head crash, or a DZ "out of memory" bomb-out.
--------------------------------------------------------------------------
.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 or symbol names

     ^BA  auto-builä break tablå
     ^SA  auto-builä symboì tablå (nameó deriveä froí heø addresses)

Botè  oæ  theså  commandó asë foò á starô anä aî enä  address®   Jusô  hiô �
<return¾ tï obtaiî thå mosô sensiblå defaultó (thå valueó displayeä withiî �
squarå brackets)®   Iæ yoõ specifù thå wholå oæ á largå program¬  yoõ  maù �
havå tï waiô á significanô timå (minutes¬  even)®   Morå serious¬  yoõ MAÙ �
RUÎ OUÔ OÆ MEMORÙ (DÚ erroò È oò S)¬  witè nï chancå tï savå youò  earlieò �
worë -- dï uså ^KÓ beforå tryinç eitheò ^BÁ oò ^SA.

Noteº   ^BÁ anä ^SÁ arå foò lazù oò impatienô users®   Aó yoõ geô  smarteò �
witè DÚ you'lì likelù stoð ^SA¬ anä you'lì checë ^BÁ bù browsinç witè ^QB.

--------------------------------------------------------------------------
.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ù 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.

--------------------------------------------------------------------------
.cp 25
Š                        Building the symbol table

^SÁ  askó yoõ tï specifù thå firsô anä lasô addresseó oæ thå regioî tï  bå �
searcheä  (defaulô  ió thå wholå file)®   Á completå disassemblù  ió  donå �
behinä  thå sceneó (sï bå patient!)¬  anä whereveò á symboì ió referenced¬ �
buô noô founä iî thå symboì table¬ á ne÷ symboì ió created.

Thå  namå giveî 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.


--------------------------------------------------------------------------
.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