     **********************************************************************
     *                                                                    *
     *                 PEACEBUG, Utilities                                *
     *                 -------------------                                *
     *                                                                    *
     * written by:     Emanuel Mcklin                                    *
     *                 Zschokkestrasse 7                                  *
     *                 CH-8037 Zrich                                     *
     *                 FREDDY@ezrz1.vmsmail.ethz.ch                       *
     *                                                                    *
     * written with:   Turboassembler 1.xx                                *
     *                                                                    *
     **********************************************************************


     These utilities are examples of how the interface of the debugger can
     be programmed. Only CALLPBUG and USERTRAC are really useful because
     PBUGCONF can perform the rest of the functions.

     - CACHEADD: adds a certain number of entries to the two caches. In the
       source you can fix how many additional entries you want.

     - CALLPB_1: calls the debugger by CALL_DEBUGGER_1. If you want to
       start programs from the debugger, you should always call the debug-
       ger that way.

     - CALLPB_2: calls the debugger by CALL_DEBUGGER_2. If you want to call
       OS functions from the debugger, you should always call the debugger
       that way. The difference between the two call routines is, that
       CALL_DEBUGGER_1 sets all stack pointers to own memory areas.
       CALL_DEBUGGER_2 does not change any registers.

     - GETREZ: sets the resolution of the debugger according to Getrez
       (XBIOS 4). This is useful if you are working with virtual
       resolutions (e.g. with protos or bigscreen). As the debugger has its
       own screen, the screenexpander cannot come into action and the
       screen will be messed up. This can be fixed with this program, as it
       urges the debugger to use the real (physical) resolution.

     - HISTORY: adds certain number of entries to the history buffer. It is
       bytes=entries*length of one line.

     - INIT_SCR: if a gfx board driver installs after the debugger, the
       debugger won't recognize it. With this program PEACEBUG allocates
       a new screen.

     - INVERT: inverts the color palette of the debugger.

     - NEWFONT: installs a new screen font. The font is included in the
       program when it's assembled. If you prefer another font, you have to
       assemble it once again.

     - USERTRAC: installs a user trace routine and calls the debugger
       afterwards. You have to change the break condition in the source
       code. It's set to D0.l=-1 by way of trial and error. By the way,
       you have to trace with t+/t-/t*.