á        Introductioε t∩ DASM

áPrograφ operation
áImportan⌠ notes
áCommand║ ┴ ¡ Attemp⌠ t∩ finΣ DB's
áCommand║ ┬ ¡ BuilΣ symbo∞ table
áCommand║ ├ ¡ Contro∞ tablσ ì
á             modify/display
áCommand║ ─ ¡ Dum≡ hex
áCommand║ D╙¡ Dum≡ symbo∞ table
áCommand║ ┼ ¡ Ente≥ label
áCommand║ ╞ ¡ FinΣ address
áCommand║ ╦ ¡ Kil∞ symbol
áCommand║ ╠ ¡ List
áCommand║ ╧ ¡ Se⌠ Origin
áCommand║ ╨ ¡ Generatσ Prologue
áCommand║ ╤ ¡ Quitσ mode
áCommand║ ╥ ¡ ReaΣ files
áCommand║ ╙ ¡ Savσ files
áCommand║ ╒ ¡ Ummmmmmn...
áCommand║ ╪ ¡ Purgσ symbo∞ ª contro∞ ì
á             tables
áCommand║ ┌ ¡ Writσ enΣ oµ file
áCommand║ ╗ ¡ Enter/displa∙ comment

á            Introduction

á    DAS═ i≤ anothe≥ creatioε oµ ì
áRicharΣ (ZCPR⌐ Conε baseΣ upoε ì
ápreviou≤ effort≤ b∙ WarΣ Christenseε ì
áanΣ Davσ Barker.
á    Thi≤ prograφ i≤ aε interactivσ ì
ádisassemble≥ fo≥ 808░ (TDL)¼ Z80¼ ì
á8048¼ anΣ 650▓ machinσ code¼ ì
ádependinτ upoε whicΦ disassemble≥ ì
ámodulσ i≤ used.
á    Thσ genera∞ objec⌠ i≤ t∩ ì
áregeneratσ ß sourcσ filσ fo≥ thσ ì
áprograφ iε question« Durinτ thσ ì
ádisassembl∙ process¼ threσ ì
áintermediatσ file≤ arσ generateΣ iε ì
áadditioε t∩ thσ .CO═ file« Thesσ are:
á    1⌐ Thσ .CT╠ file« Thi≤ contain≤ ì
áaddresse≤ a⌠ whicΦ datß o≥ table≤ arσ ì
ástoreΣ rathe≥ thaε instructions.
á    2⌐ Thσ .DO├ file« Thi≤ contain≤ ì
ácomment≤ whicΦ yo⌡ enter¼ witΦ thσ ì
áaddres≤ a⌠ whicΦ the∙ appear.
á    3⌐ Thσ .SY═ file« Thi≤ contain≤ ß ì
ális⌠ oµ label≤ anΣ thei≥ ì
ácorrespondinτ addresses.

á    Thσ eventua∞ aiφ i≤ t∩ producσ ß ì
á.AS═ filσ whicΦ caε bσ reassembled« ì
áUsuall∙ thσ AS═ filσ produceΣ b∙ DAS═ ìèácaε bσ assembleΣ t∩ reproducσ thσ ì
áorigina∞ CO═ file¼ bu⌠ t∩ producσ ß ì
árelocateable¼ wel∞ documenteΣ sourcσ ì
áfilσ wil∞ requirσ ß bi⌠ morσ effor⌠ ì
áfroφ you.

á       Majo≥ feature≤ oµ DASM:

á1⌐ Automatiπ recognitioε oµ tex⌠        ì
á   strings
á2⌐ Automatiπ genaratioε oµ symbo∞ ì
á   table.
á3⌐ Interactivσ creatioε-deletioε-ì
á   renaminτ oµ labels.
á4⌐ Interactivσ partitioninτ oµ datß ì
á   anΣ instructioε areas.
á5⌐ Automatiπ generatioε oµ prologuσ ì
á   t∩ source« (OR╟ anΣ EQUs)
á6⌐ Simplσ additioε oµ comment≤ wherσ ì
á   appropriate.
á7⌐ "Featureiti≤ rampartisó ...

á          Prograφ operation

áImportan⌠ notes
á===============

á    Whereve≥ ß he° valuσ i≤ required¼ ì
áyo⌡ ma∙ suppl∙ ß symbo∞ precedeΣ b∙ ß ì
áperiod¼ ie« ".symboló insteaΣ oµ ì
ánnnn.
á    An∙ commanΣ ma∙ bσ precedeΣ b∙ ì
áthσ "Q"uie⌠ prefi° whicΦ wil∞ sto≡ i⌠ ì
áfroφ printinτ t∩ thσ screen« Thi≤ ì
áfeaturσ i≤ mainl∙ intendeΣ t∩ speeΣ ì
áu≡ thσ operatioε oµ thσ "Aó anΣ "Bó ì
ácommands.

áCommand║ ┴ ¡ Attemp⌠ t∩ finΣ DB's

áSyntax║ [Q▌ ┴ [ssss▌ [,eeee]
á(Seσ "Ló commanΣ fo≥ examples)

á    List≤ t∩ thσ screeε froφ sss≤ t∩ ì
áeeeσ a≤ fo≥ "L"¼ bu⌠ iµ an∙ string≤ ì
áoµ ╕ o≥ morσ printablσ ASCI╔ ì
ácharacter≤ arσ encountered¼ theε the∙ ì
áarσ markeΣ a≤ datß iε thσ contro∞ ì
átablσ b∙ placinτ ß "Bó entr∙ a⌠ thσ ì
ástart¼ anΣ aε "Ió entr∙ afte≥ thσ ì
áend« Seσ thσ "Có commanΣ fo≥ morσ ì
áinformatioε oε contro∞ entries.

áCommand║ ┬ ¡ BuilΣ symbo∞ table

èáSynta° ║ [Q▌ ┬ [ssss▌ [,eeee]

á    List≤ t∩ thσ screeε froφ sss≤ t∩ ì
áeeeσ a≤ fo≥ "L"¼ bu⌠ ever∙ ▓ bytσ ì
áoperanΣ encountereΣ i≤ placeΣ int∩ ì
áthσ symbo∞ tablσ a≤ Lxxxx¼ wherσ thσ ì
ávaluσ oµ thσ operanΣ i≤ xxx° iε hex« ì
áSeσ thσ "Eó commanΣ t∩ ente≥ ne≈ ì
álabel≤ o≥ renamσ curren⌠ ones¼ anΣ ì
áthσ "Kó commanΣ t∩ kil∞ label≤ ì
áalread∙ iε thσ table.

áCommand║ ├ ¡ Contro∞ tablσ ì
á             modify/display

áSyntax║ ├  Dum≡ contro∞ table.
á           Cnnnε Dum≡ contro∞ tablσ ì
ástartinτ froφ nnnn.
á           Cnnnn,° Se⌠ modσ t∩ ° ì
á           unti∞ nex⌠ contro∞ ejtry.

á    Thσ firs⌠ tw∩ form≤ oµ thi≤ ì
ácommanΣ allo≈ yo⌡ t∩ examinσ thσ ì
ácontro∞ table¼ thσ thirΣ forφ i≤ useΣ ì
át∩ ente≥ ne≈ entrie≤ int∩ thσ table« ì
áDurinτ thσ listinτ process¼ thi≤ ì
átablσ define≤ wherσ instruction≤ o≥ ì
ádatß arσ t∩ bσ listed« EacΦ entr∙ iε ì
áthσ tablσ define≤ thσ modσ t∩ bσ useΣ ì
áunti∞ thσ nex⌠ contro∞ i≤ reached« ì
áOfteε thσ majorit∙ oµ thσ codσ wil∞ ì
ábσ iε "I"nstructioε mode¼ anΣ datß ì
áarea≤ wil∞ bσ markeΣ b∙ ß "Bó entr∙ ì
áa⌠ thσ star⌠ address¼ anΣ aε "Ió ì
áentr∙ a⌠ thσ nex⌠ addres≤ afte≥ thσ ì
áend.
á    EacΦ entr∙ cause≤ ß "contro∞ ì
ábreak"¼ meaninτ tha⌠ thσ ne≈ modσ ì
ástart≤ oε anothe≥ line¼ s∩ b∙ ì
áenterinτ multiplσ "Bó entrie≤ yo⌡ caε ì
ámake

áD┬ 'TYPESAVEDI╥ ER┴ RE╬ '

áappea≥ as

áD┬ 'TYPE'
áD┬ 'SAVE'
áD┬ 'DI╥ '
áD┬ 'ER┴ '
áD┬ 'RE╬ '

áPossiblσ mode≤ are:

á┬ ╜ D┬ (show≤ printablσ ASCI╔ betweeε ìèáquotes¼ otherwisσ hex)

á├ ╜ D├ (show≤ tex⌠ betweeε quote≤ iµ ì
ápossible¼ las⌠ characte≥ wil∞ havσ hΘ ì
ábi⌠ set¼ otherwisσ print≤ a≤ ß DB)

á─ ╜ D┬ (datß i≤ showε iε decimal)

á┼ ╜ enΣ oµ disassembly

á╚ ╜ D┬ (datß i≤ showε iε hex)

áI = instructions

áK = kill this ctl entry

á╙ ╜ D╙ (u≡ t∩ nex⌠ ct∞ entry)

á╫ ╜ D╫ (attempt≤ label)

áCommand║ ─ ¡ Dum≡ hex

áSyntax║ ─ [=nε [,]▌ [ssss▌ [,eeee]

áDsss≤  Dump≤ 80╚ froφ sss≤ ì
áon.

áDssss,eeeσ  Dump≤ froφ sss≤ ì
áthrougΦ t∩ eeee.
á
áD,eeeσ   Dump≤ froφ curren⌠ locatioε ì
áthrougΦ t∩ eeee.

á─    Dump≤ 80╚ froφ curren⌠ location.

áD=nε   Se⌠ defaul⌠ dum≡ sizσ t∩ nn

áD=nn,ssss  Set default size to nn then dump from ssss.

á┴ dum≡ sizσ oµ 10░ (hex⌐ wil∞ fi⌠ ì
áeasil∙ ont∩ ß 2┤ linσ screen.

áCommand║ D╙¡ Dum≡ symbo∞ table

áSyntax║ D╙ [.symbol]

áD╙  Dump≤ symbo∞ tablσ iε ì
áalphabetica∞ order.

áDS.symbo∞  Dump≤ tablσ startinτ a⌠ ì
ásymbol.

áCommand║ ┼ ¡ Ente≥ label

áSyntax║ Ennnn,.symbol
è
á    Ente≥ symbo∞ ".symboló int∩ symbo∞ ì
átablσ fo≥ addres≤ nnnn« Iµ ß symbo∞ ì
áalread∙ exis⌠ a⌠ tha⌠ addres≤ theε ì
áit≤ namσ i≤ displayeΣ a≤ "Labe∞ ì
á.symbo∞ killed"« Iµ ß labe∞ oµ thσ ì
ásamσ namσ exist≤ a⌠ anothe≥ addres≤ ì
átheε i⌠ i≤ deleted¼ n∩ messagσ i≤ ì
ádisplayeΣ (yet)« 

áCommand║ ╞ ¡ FinΣ address

áSyntax║ Fnnnn[,ssss]

áFinΣ an∙ referencσ t∩ addres≤ nnnn¼ ì
áie« L─ A,(nnnn⌐ or

áCAL╠ nnnn« Thσ addres≤ t∩ star⌠ ì
ásearchinτ froφ caε optionall∙ bσ ì
áspecified.

áCommand║ ╦ ¡ Kil∞ symbol

áSyntax║ K.symbol

áThσ nameΣ symbo∞ i≤ deleteΣ froφ thσ ì
ásymbo∞ table.
á 
áCommand║ ╠ ¡ List

áSyntax║ L[=nn][ssss][,eeee]

á∞ Lis⌠ nex⌠ 2▓ lines
á
álsss≤  Lis⌠ 2▓ line≤ froφ ssss
á
ál,eeeσ   Lis⌠ froφ curren⌠ pπ t∩ eeee

álssss,eeeσ  Lis⌠ froφ sss≤ t∩ eeee

ál=nε   Changσ defaul⌠ numbe≥ oµ line≤ ì
áprinteΣ t∩ nε (nε i≤ iε he° anΣ i≤ ì
ánominall∙ 16Φ o≥ 22dec)

áThi≤ commanΣ wil∞ no⌠ lis⌠ pas⌠ ß ì
ácontro∞ 'eº entry

áCommand║ ╧ ¡ Se⌠ Origin

áSyntax║ Onnnn

á    Thσ basσ addres≤ oµ thσ filσ ì
ábeinτ disassembleΣ i≤ se⌠ t∩ nnnn« ì
áThi≤ iε turε set≤ ß ne≈ valuσ fo≥ thσ ì
áoffset¼ whicΦ i≤ displayeΣ afte≥ ìèágivinτ thi≤ command« Thσ curren⌠ ì
áorigiε i≤ displayeΣ iε thσ '?º lis⌠ ì
áa≤ 'CO═ START'.

áCommand║ ╨ ¡ Generatσ Prologue

áSyntax║ Pssss,eeee

á    Thi≤ commanΣ i≤ useΣ whilσ ì
álistinτ int∩ thσ .MA├ file« I⌠ ì
ágeneratσ aε OR╟ sss≤ statement¼ theε ì
áEQUate≤ fo≥ al∞ symbol≤ whicΦ arσ ì
áoutsidσ thσ rangσ sss≤ t∩ eeee.

áCommand║ ╤ ¡ Quie⌠ mode

áSyntax║ Qcommand

á    Placinτ 'Qº beforσ an∙ othe≥ ì
ácommanΣ wil∞ disablσ al∞ screeε ì
áoutpu⌠ fo≥ thσ duratioε oµ tha⌠ ì
ácommand« Thσ maiε applicatioε oµ thi≤ ì
áfeaturσ i≤ t∩ speeΣ u≡ thσ 'Aº anΣ ì
á'Bº commands

áCommand║ ╥ ¡ ReaΣ files

áSyntax║ Rfilename.ext

áRfilename.CO═  ReaΣ objec⌠ file

áRfilename.CT╠  ReaΣ Contro∞ Table

áRfilename.DO├  ReaΣ Comment≤ Table

áRfilename.SY═  ReaΣ Symbo∞ Table

áRfilename.AL╠  ReaΣ COM¼ CTL¼ DOC¼ ª ì
áSY═ files

áCommand║ ╙ ¡ Savσ files

áSyntax║ S[filename.ext]

áSfilename.CT╠  Savσ Contro∞ Table

áSfilename.DO├  Savσ Comment≤ Table

áSfilename.SY═  Savσ Symbo∞ Table

áSfilename.MA├  Opeε MA├ filσ anΣ ì
áenablσ outpu⌠ t∩ it

áSfilename.AL╠  Savσ al∞ abovσ files

èá╙     Savσ al∞ file≤ usinτ previou≤ ì
áfilename

áCommand║ ╒ ¡ Ummmmmmn...

áSyntax║ Unnnn

áGoΣ know≤ wha⌠ thi≤ does
á 
áCommand║ ╪ ¡ Purgσ symbo∞ ª contro∞ ì
á             tables

áCommand║ ┌ ¡ Writσ enΣ oµ file

áCommand║ ╗ ¡ Enter/displa∙ comment

áSyntax║ ;[nnnn][,[;][comment]]

á╗     Lis⌠ comment≤ table.

á;nnnε  Lis⌠ commen⌠ a⌠ addres≤ nnnn.

á;nnnn¼  Deletσ commen⌠ a⌠ adres≤ ì
ánnnn.

á;addr,commen⌠  Ente≥ commen⌠ a⌠ ì
áaddres≤ nnnε t∩ lis⌠ oε linσ before.

á;addr,;commen⌠  Ente≥ commen⌠ a⌠ ì
áaddres≤ nnnε t∩ lis⌠ oε samσ line.

á;oε  Turε symbo∞ comment≤ on.

á;oµ  Turε symbo∞ comment≤ off.├  ReaΣ Comment≤ Table

áRfilename.SY═  ReaΣ Symbo∞ Table

áRfilename.AL╠  Re