[hatari-devel] Debugger usage examples?

[Eero Tamminen]

Hi,

On lauantai 18 kesäkuu 2011, Miro Kropáček wrote:
> I've reviewed the manual, it's really nicely written. From my point of
> view, it's ok to keep the current form + add the usage examples, I think
> this is even partially done.

Do you think that some of the examples in to the current documentation
should be copied also to the new "Usage examples" section, or is it
enough to have there that isn't mentioned elsewhere?

From previously mentioned list these are already covered:
* stopping on program startup
* disassembling from PC
* Setting a simple PC breakpoint that triggers after 'n' times

Which leaves these:
* Setting breakpoint where register has a specific values
* Setting breakpoint where memory B/W/L has a specific values
  (with memory being a RAM location or an IO location,
   detect freq change in ff820a for example)
* Setting breakpoint on a specific screen position using 
  VBL/HBL/linecycle counter
* Single stepping
  - with e.g. regs shown after each step
* Listing stack contents
   - that being shown whenever one enters the debugger
* Setting breakpoint on register value change
  - so that instructions leading to it are show
    when the breakpoint is hit
  - without stopping
* Tracing all OS calls between two breakpoints
* Finding in which instruction addresses machine spends
  most of its time if program is e.g. stuck


> To me, there was only one unclear part and that's something I'd call
> "modifiers & operators". I'm really confused by all that ":trace" and
> ":file" and "!" etc syntax, it's only mentioned in its usage, I'd welcome
> some complete list where these "suffixes" can be used, what are all
> options etc... same for operators in general, again there were some
> usage examples but not a complete reference.

Thanks for the review!  Now that I read it again, that part indeed is too
terse and doesn't necessarily proceed in the most logical order.

I did a fairly large update (new Breakpoint options section etc),
are those now explained better / good enough:
http://hg.berlios.de/repos/hatari/raw-file/tip/doc/manual.html#Breakpoints
?


	- Eero

PS. Note that debugger help "help b" and breakpoint help "b help" commands
give different help, former explains the breakpoint command and its options
while latter concentrates on the breakpoint condition syntax.