search

joncampbell123 / dosbox-x

DOSBox-X fork of the DOSBox project
GNU General Public License v2.0
2.66k stars 377 forks source link

Debugger HELP documentation obsolete #862

Open Sethur opened 6 years ago

Sethur commented 6 years ago

The new debugger design (active windows, switching via , etc.) and the new commands (RUN, RUNWATCH, etc.) are not found in the documentation that comes up with the HELP command.

Users coming from the old / scrolling behavior of the Output window have no way of finding out that these keys will not work any more. They can't even scroll up after the HELP command to find all the entries (in this case it would not have helped any way).

I propose putting some sort of hint (Press to switch active window) somewhere and updating the HELP command.

joncampbell123 commented 6 years ago

Perhaps HELP should bring focus to the output window, and pause once per "page" with a message to hit ENTER to continue, Q to exit HELP.

The HELP command might also mention the giant list I wrote in the README file.

joncampbell123 commented 6 years ago

Just added pagination in the latest commit.

Try it out!

Sethur commented 6 years ago

@joncampbell123 : Just tried the latest version, no complains apart from the fact that the TAB-switching to the registers window does not seem to be of any use at the moment, so skipping it would be more useful until there is something to do in there.

bleuge commented 5 years ago

Today I was checking the debugger, Help command and what is written in the readme are different, for example the PIC commands are not shown in program help. Maybe this needed to be updated.

joncampbell123 commented 5 years ago

@bleuge Agreed. The PIC commands are very helpful in debugging IRQ issues.

bleuge commented 5 years ago

Debug is giving me an error, I am using last version I load dosbox-x, run debug, the debug prompt appears? If I type ?, it says DOS Debug v1.25 help screen But not secondary debug windows appear. If I press alt+pause, debug windows appear. If I type now in dosbox windows debug I get this in debug windows:

17999270 ERROR MISC:DOS:0x37:Call for not supported switchchar 17999463 ERROR DOSMISC:Get SDA, Let's hope for the best!

And in dosbox windows the debug promt appears, but it's running, I guess if I pause it again, I'll debug the debugger, not the app I am trying to debug.

Do you prefer this to open a new issue here?

I dream with an scriptable debugger, with a better GUI/TUI, I read it's done with ncurses, a windowed TUI as TurboDebugger will be great, but it's certainly a lot of work... The scripting part, incorporating string and longint vars, IF and a While or For clause, and the rest of commands right now, and maybe other stuff, could make the debugger completely scriptable.

Regards!