diff --git a/help/Table of Contents.hhc b/help/Table of Contents.hhc index 727bd493..03703693 100644 --- a/help/Table of Contents.hhc +++ b/help/Table of Contents.hhc @@ -151,6 +151,10 @@ +
  • + + +
  • diff --git a/help/dbg-entering-debugger.html b/help/dbg-entering-debugger.html index 159eb150..9e80b7c0 100644 --- a/help/dbg-entering-debugger.html +++ b/help/dbg-entering-debugger.html @@ -5,12 +5,12 @@ -

    Entering the Debugger

    +

    Entering the Debugger

    Start AppleWin, and press F7 to enter the debugger.

    The first thing you'll probably notice is the new syntax coloring in the disassembly view, and info panel.  All the colors can be customized to - your liking.  See the Colors section for details.

    + your liking.  See the Colors section for details.

    Since the mini-console isn't the full width of the screen, you can toggle between the full-screen console with the tilde '~' key. This style of table will be used to designate which keys the debugger will recognize.

    @@ -122,7 +122,7 @@

    -

    Exiting the Debugger

    +

    Exiting the Debugger

    In general, press F7 to exit the debugger.
    NB. If you have breakpoints set then you will exit the debugger in 'stepping' mode.

    Other ways to exit the debugger and force 'stepping' mode are: @@ -152,7 +152,7 @@ -

    g

    +

    G

    yes

    @@ -169,7 +169,7 @@ -

    gg

    +

    GG

    no

    diff --git a/help/dbg-execution.html b/help/dbg-execution.html index e47da644..b1350b86 100644 --- a/help/dbg-execution.html +++ b/help/dbg-execution.html @@ -202,8 +202,8 @@ -

    G [StopAddress] -

    +

    G [StopAddress]
    + GG [StopAddress]

    Resume execution until PC = StopAddress.

    @@ -211,7 +211,8 @@ -

    G [StopAddress] [SkipAddress,Length]

    +

    G [StopAddress] [SkipAddress,Length]
    + GG [StopAddress] [SkipAddress,Length]

    Resume execution until PC = StopAddress.
    @@ -224,11 +225,13 @@

    ####G

    -

    Alias for: R PC [=] address.

    +

    Alias for: R PC [=] address and then G.

    +


    NB. The GG command resumes execution in full-speed. See Exiting the Debugger. +



    diff --git a/help/dbg-flags.html b/help/dbg-flags.html index ce58cb3d..abb5b7af 100644 --- a/help/dbg-flags.html +++ b/help/dbg-flags.html @@ -6,13 +6,14 @@

    Flags

    -

    Each flag can individually be set or cleared on the Processor Status Register ('P').  +

    Each flag can individually be set or cleared in the Processor Status Register ('P').  Cleared flags will show up with a normal background.  Set flags will show with an inverse background.


    Notes:

      +
    • Shift+Left mouse button can be used to toggle the state of individual flags.

    • The legacy commands R? and S?, where? is a flag name (C,Z,I,D,B,R,V,N) has been left in.

      diff --git a/help/dbg-screen-layout.html b/help/dbg-screen-layout.html new file mode 100644 index 00000000..dd83acd8 --- /dev/null +++ b/help/dbg-screen-layout.html @@ -0,0 +1,56 @@ + + + + AppleWin Debugger Tutorial + + + +

      Debugger Screen Layout

      +

      This section gives an overview of the debugger's screen layout.

      + +

      Here's a typical debugger view (with annotations describing the parts):

      + + + +

      Soft-switches

      +

      This encodes information about the video and MMU soft-switches.

      + +

      The first 5 rows describe the current video settings and can be interpreted as follows: +

        +
      • 50: $C050 - GR /TEXT (inverse indicates which is active) +
      • 52: $C052 - FULL/MIX (inverse indicates which is active) +
      • 54: $C054 - PAGE 1/2 (inverse indicates which is active) +
      • 56: $C056 - LO/HIRES (inverse indicates which is active) +
      • 5E: $C05E - DHGR/HGR (inverse indicates which is active) +
      +

      + +

      The next 6 rows describe the current MMU settings and can be interpreted as follows: +

        +
      • 00: $C000 - 80Sto0/1 (inverse indicates state of 80STORE) +
      • 02: $C002-C005: Rm/xWm/x (NB. 'R' is blue and 'W' is red for readability) +
          +
        • Rm Read from main mem for $0200-$BFFF; Use OUT C002 to enable +
        • Rx Read from aux mem for $0200-$BFFF; Use OUT C003 to enable +
        • Wm Write to main mem for $0200-$BFFF; Use OUT C004 to enable +
        • Wx Write to aux mem for $0200-$BFFF; Use OUT C005 to enable +
        +
      • 0C: $C00C - Col40/80 (inverse indicates state of 80COL) +
      • 0E: $C00E - ASC/MOUS (inverse indicates state of ALTCHARSET) +
      • 80: $C080-C087: B2/M R/W (Language Card Bank2) +
      • 88: $C088-C08F: B1/M rNN (Language Card Bank1 and RAMworks 64K bank number) +
          +
        • 'B2' or 'B1' is inverse when that LC bank is enabled. +
        • If 'M' is inverse: ROM is active for reading. +
        • If 'M' is not inverse: LC2 or LC1 RAM is active. +
        • If 'W' is inverse: RAM is write enabled. +
        • If 'W' is not inverse: RAM is write protected. +
        • 'rNN' will appear if a RAMworks 64K bank is active. +
        +
      +

      + +


      +

      + + diff --git a/help/dbg-toc-intro.html b/help/dbg-toc-intro.html index c387665e..95ea6c03 100644 --- a/help/dbg-toc-intro.html +++ b/help/dbg-toc-intro.html @@ -10,49 +10,29 @@

      Revision 3.  Mar 12, 2006.

      Table of Contents

      diff --git a/help/dbg-windows.html b/help/dbg-windows.html index 6fece85e..ec6d8275 100644 --- a/help/dbg-windows.html +++ b/help/dbg-windows.html @@ -5,9 +5,9 @@ -

      Windows

      +

      Windows

      Due to the amount of information available, the debugger now features - "windows."  You can switch to th full screen console to read the help, or + "windows".  You can switch to the full screen console to read the help, or to the data window to view memory.



      diff --git a/help/img/debugger-layout-annotated.png b/help/img/debugger-layout-annotated.png new file mode 100644 index 00000000..2929acb2 Binary files /dev/null and b/help/img/debugger-layout-annotated.png differ diff --git a/help/resources/Debugger-screen-layout.pptx b/help/resources/Debugger-screen-layout.pptx new file mode 100644 index 00000000..6ecf273c Binary files /dev/null and b/help/resources/Debugger-screen-layout.pptx differ diff --git a/help/resources/debugger-layout.png b/help/resources/debugger-layout.png new file mode 100644 index 00000000..fee994c6 Binary files /dev/null and b/help/resources/debugger-layout.png differ