From 0b298f3995943779d5759eb7cced4f94c4d6c985 Mon Sep 17 00:00:00 2001 From: michaelangel007 Date: Fri, 20 Apr 2018 10:49:10 -0700 Subject: [PATCH] Moved debugger wanted features to docs/Debugger_Wishlist.txt --- docs/Debugger_Wishlist.txt | 170 +++++++++++++++++++++++++++++++++++++ docs/Wishlist.txt | 71 +--------------- 2 files changed, 171 insertions(+), 70 deletions(-) create mode 100644 docs/Debugger_Wishlist.txt diff --git a/docs/Debugger_Wishlist.txt b/docs/Debugger_Wishlist.txt new file mode 100644 index 00000000..d54420f6 --- /dev/null +++ b/docs/Debugger_Wishlist.txt @@ -0,0 +1,170 @@ +Requests (Wishlist): +==================== + +- 0:1 Doesn't work + Work-around, use two hex digits for the address: + 00:1 + +- Debugger: wildcard search support for symbols + SYMBASIC MICRO* + +- Debugger: Ability to hide Regs panel + DISASM REGS 0 // Hide Regs and Breakpoints + DISASM REGS 1 // Show Regs only + DISASM REGS 2 // Show Breakpoints only + DISASM REGS 3 // Show Regs and Breakpoints (DEFAULT) + +- Debugger: SPRITE [SPAN] + +- Debugger: HGRX + view address as HGR + i.e. HGRX 6000 + i.e. HGRX 8000 + +- Debugger: Color code commands in light blue + Currently, everything is in white, making it hard to see input and output + +- Debugger: Command history + Once any non-whitespace character has been entered, Up arrow and Down arrow + should scroll through prev and next command history respectively + +- Debugger: Command line editing + Left Arrow Move Cursor Left + Right Arrow Move Cursor Right + Ctrl-A Beginning of Line + Ctrl-D Delete Character + Ctrl-E End of Line + +- Debugger: List symbol table + SYMASM LIST + SYMUSER1 LIST + +- Debugger: Document: Add help example to list all symbol tables + HELP SYMMAIN + SYMMAIN * + +- Debugger: Markup Byte with C_ prefix instead of B_ + DB 123 + Will auto-generate symbol in SYMASM + B_123 + This should be: + G_123 + +- Debugger: ANALYSE + Utility to help in automatic disassembly. + Like "Sourcer" or "BrkDown" + Automatically markup labels for + * JSR + * JMP + * RTS + * Branches + * LD? abs + * LD? abs,X + * LD? abs,Y + * etc. + Should respect existing `X ` as data + + Auto-generated labels: + + B_#### = Branch target address + F_#### = Function (or F_, or J_, or L_), new command: DF + G_#### = Global Byte + P_#### = Pointer + R_#### = Function return + Z_## = Zero Page + + Don't know how to generate: + A_#### = Data Address + W_#### = Data Word + +- Debugger: Document: SYMASM and SYMUSER differences + SYMASM data symbols placed here via DB Foo = 100 + SYMUSER func symbols placed here via SYM Bar = 200 + +- Debugger: Symbol tables for DOS 3.3 and ProDOS + SYMUSER2 -> SYMDOS33 + SYMSOURCE2 -> SYMPRODOS + +- Debugger: Autoexec ! + .AWD = Microsoft Fax + .A2D = Apple 2 Debug + .AW2 = AppleWin Disk = icon of app, disk image(s) + + RUN AppleWin.a2d // Official AppleWin Supplied Debug Config + RUN Debugger.a2d // User supplied AppleWin Debug Config + +- Debugger: Custom Soft switches + + SOFT CLEAR + SOFT ADD C050 + SOFT ADD 50 + SOFT LIST + SOFT LOAD + SOFT SAVE + +- New Debugger features: + > 1 SCR shows what the Apple monitor should look like at the current point + > 2 MDS same as ME but shows strings (ie "ABC" instead of "c1 c2 c3" + > 3 TS text search (and may be a hex search function too ?" + +- Incorporate Laine Houghton's modifications to debugger (?) + +- Source level debugging using WordPad & Merlin asm output (tell WordPad to FIND / GOTO line). + + + +Implemented: +============ + +. DONE: v16.0.0.0 DEBUGGER: (use F7): RESET button to break into the Monitor (preserving memory). + +. DONE: v16.0.0.0: DEBUGGER: Ability to search and modify for a value in memory in order to cheat in some games. + +. DONE: v16.0.0.0: DEBUGGER: Hex search in debugger + +* [x] Version: ? + Debugger: Turn off target columns in dis-assembly + Use: + DISASM TARGET 0 // off + DISASM TARGET 1 // show target byte + DISASM TARGET 2 // show target address + DISASM TARGET 3 // Show target address and byte (DEFAULT) + +. Debugger: BLOAD with no arguments should print current save path +. Debugger: FIX BLOAD with bad path!! (should use path of last disk load!) +. Debugger: FIX BSAVE with bad path!! (should use path of last disk load!) +. Debugger: merlin "filename",S6,D1 +. Debugger: COLOR RESET +. Debugger: COLOR SAVE ["filename"] +. Debugger: COLOR LOAD ["filename"] + +. DONE: help f +. DONE: help m +. DONE: BC:## +. DONE: BD:## +. DONE: BE:## +. DONE: help f +. DONE: help m +. DONE: EA:## +. DONE: E8:## +. DONE: a:## +. DONE: d:## +. DONE: Debugger 2.6.1.19: ADD: AppleSoft symbols to Symbol Table + +. DONE: v16.0.0.0: Video: PrintScreen (save to disk with auto file numbering.) +. DONE: v16.0.0.0: Debugger: TEXT show current 40-col text page +. DONE: v16.0.0.0: Debugger: TEXT80 show current 80-col text page +. DONE: v16.0.0.0: Debugger: GR show current lo-res graphics page +. DONE: v16.0.0.0: Debugger: HGR show current hi-res graphis page +. DONE: v16.0.0.0: Debugger: DGR show current double hi-res graphics page +. DONE: v16.0.0.0: Debugger: TEXT1 Show 40 Column Text Page 1 +. DONE: v16.0.0.0: Debugger: TEXT2 Show 40 Column Text Page 2 +. DONE: v16.0.0.0: Debugger: TEXT81 1 Show 40 Column Text Page 1 +. DONE: v16.0.0.0: Debugger: TEXT82 2 Show 40 Column Text Page 1 +. DONE: v16.0.0.0: Debugger: HGR1 show Hi-Res Page 1 +. DONE: v16.0.0.0: Debugger: HGR2 show Hi-Res Page 2 +. DONE: v16.0.0.0: Debugger: DHGR1 show Double Hi-Res Page 1 +. DONE: v16.0.0.0: Debugger: DHGR2 show Double Hi-Res Page 2 +. DONE: Debugger: shift+ins to paste from clipboard (use Ctrl-V to paste.) + + diff --git a/docs/Wishlist.txt b/docs/Wishlist.txt index 1e344e73..676c9d66 100644 --- a/docs/Wishlist.txt +++ b/docs/Wishlist.txt @@ -1,27 +1,6 @@ Requests (Wishlist): ==================== -- Debugger: Symbol tables for DOS 3.3 and ProDOS - SYMUSER2 -> SYMDOS33 - SYMSOURCE2 -> SYMPRODOS - -- Debugger: Autoexec ! - .AWD = Microsoft Fax - .A2D = Apple 2 Debug - .AW2 = AppleWin Disk = icon of app, disk image(s) - - RUN AppleWin.a2d // Official AppleWin Supplied Debug Config - RUN Debugger.a2d // User supplied AppleWin Debug Config - -- Debugger: Custom Soft switches - - SOFT CLEAR - SOFT ADD C050 - SOFT ADD 50 - SOFT LIST - SOFT LOAD - SOFT SAVE - . DONE Hard Disk light/indicator Right now the "- Caps" in the bottom right wastes too much space. @@ -29,9 +8,6 @@ Requests (Wishlist): This would free up room to add a hard drive light indicator to the right. https://groups.google.com/d/msg/comp.emulators.apple2/grpSWHii8Ak/IorwTvbLxtgJ -. Debugger: wildcard search support for symbols - SYMBASIC MICRO* - . Video: Full Screen Debugger Colors Amber, F7, F7 - wrong palette? @@ -41,43 +17,6 @@ Requests (Wishlist): - Disk map!!! http://www.lazilong.com/apple_II/adfs/screenshots/beagle_block.html -. Debugger: BLOAD with no arguments should print current save path -. Debugger: FIX BLOAD with bad path!! (should use path of last disk load!) -. Debugger: FIX BSAVE with bad path!! (should use path of last disk load!) -. Debugger: merlin "filename",S6,D1 -. Debugger: COLOR RESET -. Debugger: COLOR SAVE ["filename"] -. Debugger: COLOR LOAD ["filename"] - -. DONE: help f -. DONE: help m -. DONE: BC:## -. DONE: BD:## -. DONE: BE:## -. DONE: help f -. DONE: help m -. DONE: EA:## -. DONE: E8:## -. DONE: a:## -. DONE: d:## -. DONE: Debugger 2.6.1.19: ADD: AppleSoft symbols to Symbol Table - -. DONE: v16.0.0.0: Video: PrintScreen (save to disk with auto file numbering.) -. DONE: v16.0.0.0: Debugger: TEXT show current 40-col text page -. DONE: v16.0.0.0: Debugger: TEXT80 show current 80-col text page -. DONE: v16.0.0.0: Debugger: GR show current lo-res graphics page -. DONE: v16.0.0.0: Debugger: HGR show current hi-res graphis page -. DONE: v16.0.0.0: Debugger: DGR show current double hi-res graphics page -. DONE: v16.0.0.0: Debugger: TEXT1 Show 40 Column Text Page 1 -. DONE: v16.0.0.0: Debugger: TEXT2 Show 40 Column Text Page 2 -. DONE: v16.0.0.0: Debugger: TEXT81 1 Show 40 Column Text Page 1 -. DONE: v16.0.0.0: Debugger: TEXT82 2 Show 40 Column Text Page 1 -. DONE: v16.0.0.0: Debugger: HGR1 show Hi-Res Page 1 -. DONE: v16.0.0.0: Debugger: HGR2 show Hi-Res Page 2 -. DONE: v16.0.0.0: Debugger: DHGR1 show Double Hi-Res Page 1 -. DONE: v16.0.0.0: Debugger: DHGR2 show Double Hi-Res Page 2 -. DONE: Debugger: shift+ins to paste from clipboard (use Ctrl-V to paste.) - Priority: . Shift keys map to button#2 . DONE: Right-click on drive icon to eject disk @@ -108,10 +47,7 @@ Post 1.12.6.0: Post 1.12.5.0: - Option to associate (or not) file types with AW. - Option for the emulator to not lock the disks while they are in the (virtual) drives. -- New Debugger features: - > 1 SCR shows what the Apple monitor should look like at the current point - > 2 MDS same as ME but shows strings (ie "ABC" instead of "c1 c2 c3" - > 3 TS text search (and may be a hex search function too ?" + - Default monochrome mode to green - Associate .aws with AppleWin. @@ -125,25 +61,20 @@ Post 1.12.4.2: Post 1.12.4.1: - Option to make any pc joystick button working as the 'Turbo' (i.e. Scroll Lock). -. DONE: v16.0.0.0: DEBUGGER: Ability to search and modify for a value in memory in order to cheat in some games. - FastMath card support. - Ability to view page1/2 & switch mode (Text/GR/HGR/DHGR) - Add an 80 X 80 or 40X40 text mode - Send data back and forth between emu apple 2 and VisualBasic - Resizeable , scalable window -- Incorporate Laine Houghton's modifications to debugger (?) - Make a documented interface so others can program Apple II peripheral card Emu plugins. -- Source level debugging using WordPad & Merlin asm output (tell WordPad to FIND / GOTO line). - Emulate a video capture card: get an image from a webcam, de-rez it to HGR, and display it on the HGR screen. - AppleCrate emulation between several open AppleWin emulators. - Access PC files from PRODOS or DOS instead of DSK images? : Not doing (user CiderPress instead) -. DONE: v16.0.0.0: DEBUGGER: Hex search in debugger Post 1.12.4.0: - Ability to send files to the PC from a disk image in AppleWin : Not doing (user CiderPress instead) - Ability to load files from the PC to a disk image in AppleWin : Not doing (user CiderPress instead) - When you are using the mouse as a cursor / joystick, as well as the markers on the screen border, enable the user to also add a dot (or cross hair) to the screen wherever the mouse pointer is. -. DONE: v16.0.0.0 DEBUGGER: (use F7): RESET button to break into the Monitor (preserving memory). - Ability to send Apple's stdout to clipboard or file (and vice versa). Initial: