2020-05-31 15:11:43 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
< html >
< head >
< title > AppleWin Debugger Tutorial< / title >
< meta http-equiv = "CONTENT-TYPE" content = "text/html; charset=windows-1252" >
< / head >
< body style = "DIRECTION: ltr" lang = "en-US" >
< h1 > Bookmarks< / h1 >
< p > Bookmarks allow you to "tag" an address and consequently jump back to them.< br >
2020-06-03 19:26:06 +00:00
They appear as a number with a circle around them between where address and opcodes are listed (where the : separator is).
2020-05-31 15:11:43 +00:00
< / p >
< img src = "img/debugger-bookmarks-annotated.png" hspace = "5" vspace = "5" >
< br >
< p > < font size = "4" > < b > Notes< / b > :< / font > < / p >
< ul >
2020-06-03 19:26:06 +00:00
< li > Set a bookmark at the current disassembly cursor, use Ctrl-Shift-#, ie:
2020-05-31 15:11:43 +00:00
< ul >
2021-09-17 20:16:24 +00:00
< li > Ctrl-Shift-0 set bookmark 0 (by default Windows blocks this key sequence - see < a href = "Troubleshooting.html" > Troubleshooting< / a > to resolve this)
2020-05-31 15:11:43 +00:00
< li > Ctrl-Shift-1 set bookmark 1
< li > Ctrl-Shift-2 set bookmark 2
< li > ...
< li > Ctrl-Shift-9 set bookmark 9
< / ul >
< / li >
< br >
2020-06-03 19:26:06 +00:00
< li > To jump to an existing bookmark, if it exists, press Ctrl-#, ie:
2020-05-31 15:11:43 +00:00
< ul >
< li > Ctrl-0 to jump to bookmark 0
< li > Ctrl-1 to jump to bookmark 1
< li > Ctrl-2 to jump to bookmark 2
< li > ...
< li > Ctrl-9 to jump to bookmark 9
< / ul >
< / li >
< br >
< li > NB.
< ul >
< li > Bookmarks can appear in any order that you set - not just contiguous.
< li > An address can only have ONE bookmark assigned to it. If you try setting a new bookmark over an existing one, the old one will become free for use.
< / ul >
< / li >
< / ul >
< p >
< / p >
< p > < font size = "4" > < b > Commands to manipulate bookmarks:< / b > < / font > < / p >
< table border = "1" cellpadding = "2" cellspacing = "0" width = "75%" >
< COLGROUP >
< col width = "64" >
< col width = "192" >
< tbody >
< tr bgcolor = "#000000" >
< td width = "25%" >
< p > < font color = "#ffffff" > < b > Command< / b > < / font > < / p >
< / td >
< td >
< p > < font color = "#ffffff" > < b > Description< / b > < / font > < / p >
< / td >
< / tr >
< tr >
< td width = "25%" >
< p > help bookmarks< / p >
< / td >
< td >
< p > Lists all bookmark related commands< / p >
< / td >
< / tr >
< tr >
< td width = "25%" >
< p > help bma< / p >
< / td >
< td >
< p > Lists specific help about the bma command< / p >
< / td >
< / tr >
< tr >
< td width = "25%" >
< p > bma < address|label> < / p >
< / td >
< td >
< p > Add a bookmark at an address or label< / p >
< / td >
< / tr >
< tr >
< td width = "25%" >
< p > bmc #< / p >
< / td >
< td >
< p > Clear a specific bookmarks, for example 'bmc 1' clears bookmark 1< / p >
< / td >
< / tr >
< tr >
< td width = "25%" >
< p > bmc *< / p >
< / td >
< td >
< p > Clears all bookmarks< / p >
< / td >
< / tr >
< tr >
< td width = "25%" >
< p > bml< / p >
< / td >
< td >
< p > Lists all boommarks< / p >
< / td >
< / tr >
< tr >
< td width = "25%" >
< p > bmsave< / p >
< / td >
< td >
< p > Not implemented yet< / p >
< / td >
< / tr >
< / tbody >
< / table >
< / body >
< / html >
