DazzleStar Menus

Basic operational functions are supplied in the menus. Certain menu items are disabled or altered based on context. For example, you can't "Close" a disassembly if none is open.

File->New
Open a submenu for dialogs to load a new program file for disassembly. This will discard any current disassembly. Submenus are:

->Binary (.COM)
Open a binary (e.g. COM) file. Allows override of ORG for file, enter hex value in box on right side of file dialog. The keyboard shortcut is Alt-F-N-B
->PRL File
Opens a PRL file, which contains relocation information used to construct the initial symbol table. Note that it will be necessary to run Disas->Rebuild Symtab (typically after identifying code sections) in order to create symbol entries for relative jumps (which do not appear in the relocation data). The keyboard shortcut is Alt-F-N-P
->SPR File
Opens an SPR file, which contains relocation information used to construct the initial symbol table. Some SPR files (e.g. BNKBIOS3.SPR) contain two program segments. Disas->Rebuild Symtab may be required, same as PRL files. The keyboard shortcut is Alt-F-N-S
->REL File
Opens a REL file, which contains a lot of information that is used to construct the initial symbol table. Note, this version combines all related segment snippets into a single segment, and thus does not reconstruct the original ASM file's interspersing of CSEG, DSEG, etc. This is done to keep the user interface simpler. Also, ASEG data is not loaded - if there was any contents (symbols are still constructed). This is similar to the handling of ASEG in LINK. Disas->Rebuild Symtab may be required, same as PRL files. The keyboard shortcut is Alt-F-N-R

File->Close
This will discard any currently disassembly, effectively "closing" it.
File->Generate ASM
Generates an ASM file for the current disassembly. file is generated in the same folder as the COM file.
File->Generate PRN
Generates a PRN (listing) file for the current disassembly. file is generated in the same folder as the COM file.
File->Save
Open a submenu for dialogs to save current progress. Submenus are:
->Save DZ
Generates a .DZ file for the current disassembly. file is generated in the same folder as the COM file. The keyboard shortcut is Alt-F-S-D
->Save Hints
Save current hints to file (.DZH), overwriting any previous contents. If no hints exist, pops up a warning and does nothing. The keyboard shortcut is Alt-F-S-H
->Save Scan
Save current code-scanner results (.DZS), overwriting any previous contents. If no scanner data exist, pops up a warning and does nothing. The keyboard shortcut is Alt-F-S-S
File->Load
Open a submenu for dialogs to load additional data. Submenus are:
->Load DZ
Open a dialog to loads a DZ file for the current disassembly. This replaces any existing breaks or symbols, effectively discarding those. This does not affect the folder used to generate output files. The keyboard shortcut is Alt-F-L-D
->Load Hints
Load code-scanner hints. See Hint Syntax. The keyboard shortcut is Alt-F-L-H
->Load Scan
Load code-scanner results. The keyboard shortcut is Alt-F-L-S
File->Quit
Discards any current disassembly and exits the program.

Disas->Scan from here
(Re)Start auto-code scan from current location. Note, the keyboard shortcut for this is Alt-D-S
Disas->Scan Hints
Code scan all entry points from hints. Only enabled if some exist.
Disas->Reset scan
Clear all code scan progress markers. Used to start over fresh.
Disas->Apply Hint
Enter and apply a single hint. Typically only useful for declaring inline function params. The single hint will be added to the hints table, and the current code will be scanned and calls to the function will have breaks added for the inline parameters. Note that calls which are hidden by previous mis-aligned breaks will not be fixed. See Hint Syntax.
Disas->Rebuild Symtab
Discards any current symbols and rescans code according to current breaks, building a new symbol table. Note, the keyboard shortcut for this is Alt-D-B
Disas->Show Stats
Compute various statistics on current disassembly, display in pop-up. The keyboard shortcut is Alt-D-T
Disas->Use {MAC80|Zilog}
Change mnemonics used for disassembly of code. Menu reflects the opposite of the current mnemonics, i.e. what the mnemonics will be changed to. Note, the keyboard shortcut for this is Alt-D-U

Help->About
Display basic information and credits
Help->Show Help
Display this help document.