home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / program / compiler / pbug1_21 / utillity / readme < prev    next >
Encoding:
Text File  |  1994-05-24  |  3.0 KB  |  56 lines
  1.      **********************************************************************
  2.      *                                                                    *
  3.      *                 PEACEBUG, Utilities                                *
  4.      *                 -------------------                                *
  5.      *                                                                    *
  6.      * written by:     Emanuel Möcklin                                    *
  7.      *                 Zschokkestrasse 7                                  *
  8.      *                 CH-8037 Zürich                                     *
  9.      *                 FREDDY@ezrz1.vmsmail.ethz.ch                       *
  10.      *                                                                    *
  11.      * written with:   Turboassembler 1.xx                                *
  12.      *                                                                    *
  13.      **********************************************************************
  14.  
  15.  
  16.      These utilities are examples of how the interface of the debugger can
  17.      be programmed. Only CALLPBUG and USERTRAC are really useful because
  18.      PBUGCONF can perform the rest of the functions.
  19.  
  20.      - CACHEADD: adds a certain number of entries to the two caches. In the
  21.        source you can fix how many additional entries you want.
  22.  
  23.      - CALLPB_1: calls the debugger by CALL_DEBUGGER_1. If you want to
  24.        start programs from the debugger, you should always call the debug-
  25.        ger that way.
  26.  
  27.      - CALLPB_2: calls the debugger by CALL_DEBUGGER_2. If you want to call
  28.        OS functions from the debugger, you should always call the debugger
  29.        that way. The difference between the two call routines is, that
  30.        CALL_DEBUGGER_1 sets all stack pointers to own memory areas.
  31.        CALL_DEBUGGER_2 does not change any registers.
  32.  
  33.      - GETREZ: sets the resolution of the debugger according to Getrez
  34.        (XBIOS 4). This is useful if you are working with virtual
  35.        resolutions (e.g. with protos or bigscreen). As the debugger has its
  36.        own screen, the screenexpander cannot come into action and the
  37.        screen will be messed up. This can be fixed with this program, as it
  38.        urges the debugger to use the real (physical) resolution.
  39.  
  40.      - HISTORY: adds certain number of entries to the history buffer. It is
  41.        bytes=entries*length of one line.
  42.  
  43.      - INIT_SCR: if a gfx board driver installs after the debugger, the
  44.        debugger won't recognize it. With this program PEACEBUG allocates
  45.        a new screen.
  46.  
  47.      - INVERT: inverts the color palette of the debugger.
  48.  
  49.      - NEWFONT: installs a new screen font. The font is included in the
  50.        program when it's assembled. If you prefer another font, you have to
  51.        assemble it once again.
  52.  
  53.      - USERTRAC: installs a user trace routine and calls the debugger
  54.        afterwards. You have to change the break condition in the source
  55.        code. It's set to D0.l=-1 by way of trial and error. By the way,
  56.        you have to trace with t+/t-/t*.