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