.______/\     FINALISTS   ./\      /°\
|.     \/___ ._./C \  ._. |_/_____/ ° \_____
|| ____/|   \| |  O \ | | | | __¸/ \/\ \__,/
¦: __/| ¦   ° ¸|   N \| | | ¦ \__\__.__/\__
|· |  | |   :  |    S \ | | |, _ \  |  , _ \
|  |  | |   ¡  |  :  O \l_| | \/ /  |   \/ /
`--'  '-'---'--' / \  L \__}'\__/   |  \__/
              p^r^e^s^e^n^t^s
 (!AMIGa) DEBUG CONSOLE WAREZ V2.F (aMIGA!)
              p^r^e^s^e^n^t^s
[version2.0f/console utility debugger/amiga]
           !hAVE pUN wITH tHIS!


            Debug Console 2.0F

           (c) 1995 FREEUTIL

=============================================


Preface
=======

   DeBUGG 2.0F

Introduction
============

   Many debugging utilities send their output to serial port using simple
communication mechanism embedded in the exec.library -- the RawPutChar
function.This simple utility patches that function, opens a window screen
and redirectswhole debugging output to this window.

   Warning:  DeBUGG uses simple line buffering mechanism to increase speed
whichcauses incomplete lines not to be displayed before a newline
character (or anyother character with code less than 32) is received.
NULs are not stored in thebuffer, but they cause flushing, too (you can
use NUL to empty the buffer).

   If  you're  debugging  a resident module, you can install
DeBUGG as a residentmodule  by the AddModule utility (also included in
this archive).  In this case,priority  of  DeBUGG module is set to 4 by
default, therefore it gets initialized directly after the console device.

   DeBUGG is NOT pure and cannot be made resident (sorry, but if it were pure, it
would be much larger and slower).  The resident module can be used multiple
times, but it's self-modifying and some other tools allowing module installation
could inform you about non-mathing checksums -- these warnings are usually false
alarms and can be ignored.


Requirements
============

   - Kickstart 2.04 or higher

   - ss.library 5.0 or higher (included in this archive)

   - 68000 or higher


Command-line invocation
=======================

   If started from CLI (that means not as a resident module), additional
parameters can be specified according to this template:

   LEFT/N,TOP/N,WIDTH/N,HEIGHT/N,TITLE,SCREEN

   First four parameters define window position, the next one allows to specify
custom window title, the last one forces DeBUGG to use given public screen for
its output.


Other controls
==============

   (1) - Program termination - by clicking the close gadget of DeCon window
or by sending a CTRL-C signal to it.

   (2) - Saving console buffer to T:Debug - press CTRL-W (OK will appear and
last 16K of debug output will be saved).

   (3) - Stopping/restarting of console output - press CTRL-S to stop console
output, use CTRL-Q to restart it.

   (4) - Clearing of console window and all information in the buffer - CTRL-L.