
                                  Desktop debugger
                                 -================-

Version 1.00 (19th September 1993)
Copyright  A. M. Pereira 1993

RISC OS 3 ONLY

Copyright notice:

This program is Freeware. It may be freely distributed under the following conditions:
           - No files are altered in any way
           - You don't claim to have written any part of the code
           - You give me full credit for any parts which you do use
             (and send me a copy of your program before release)
           - You *don't* upload it to TWoC, Arcade or The Digital Databank
             (I wrote it, so I should get the download credits, ok?)
           - PD Libraries don't distribute it without my permission.
             Current PD Libraries with my permission are:
               The DataFile PD,
                  71 Anson Road, Locking, Weston-Super-Mare, Avon, BS24 7DQ
               APDL,
                  39 Knighton Park Road, Sydenham, London SE26 5RN
             If your PD Library wants to distribute it then send me a
             catalogue. Unless I have something against you, I will probably
             allow you to distribute in return for a disc from your catalogue.


This short utility is for debugging desktop programs. The main part is a module, which provides one SWI for programs to report their status, and two for a reporting program.

The SWI chunk is NOT an official Acorn one.

DeskDebug_Report &DA800
----------------
=> r0     -> Report string (up to 255 characters)
   r1-r3  -  Values to pass to reporter

This should be placed in the code to be debugged, eg:

DEFPROCopenwindow(handle)
SYS "DeskDebug_Report","Opening a window",handle
etc.

DeskDebug_PollWordAddress &DA801
-------------------------
<= r0 - address of poll word to pass to Wimp_Poll

Returns the address of the poll word. This is only used by the reporter program.

DeskDebug_ResetPollWord &DA802
-----------------------
Resets the pollword to prevent repeated PollWord Nonzero events.

You can rewrite the reporting program if you want - look at the default one to see how it's done.
If you write a good one send it to me.

The default reporter
--------------------
This merely reports the message, and the three parameters (in both hex and decimal) in a window. There are three writeable icons next to the three variables, so you can type in the variable name being displayed (makes it more readable).

Contacting me:
==============

snail mail:            eMail:

Ainsley Pereira        at my point (fastest) 2:251/16.50 @ fidonet.org
'Al Sirat'
Chapel Road            Ampy (#304) on the Digital Databank BBS (fido 2:254/25)
Swanmore
Hants SO3 2QA          Ampy (#1334) on Arcade (fido 2:252/27)

Feel free to send money, comments, black cherry yoghurt, etc.

ARMFul
======

Yes folks, this is an ARMFul product (a consequence of it being written by me, an ARMFul member).

Modem owners! Don't forget that there is a wonderful ARMFul area on The Digital Databank BBS where you can contact us and get all the latest software and info.

ARMFul members include:
 - Me (Ampy)               Our Programmer
 - Adrian Carpenter        Our Programmer
 - Stephen Hill            Our Programmer
 - Mark Mahieu             Our Programmer
 - Stephen 'Krunk' Crouch  Our Programmer

 - Possibly Colin          Our artist. (We'll have to see some of his work first)

If you can draw pretty pictures on an Arc then WE WANT TO HEAR FROM YOU.
If you can make nice music on an Arc then WE WANT TO HEAR FROM YOU.
Any email should be addressed to my fidonet point (2:251/16.50 in case you missed it) for fastest response. Any snail mail should be addressed to me at the address above, especially if its black cherry yoghurt or money...

Thanks to
=========
    Tim Browse - for writing Glazier. (Fixed those bugs yet?)
    Guttorm Vik - for writing StrongEd
    David Holden - for writing SAsm
    John Stonier - for running Digital Databank
    Daves Coleman & Dade - for running Arcade
    Dave McCartney - for not being serious about thinking I had an Am*ga
    4 Non-blondes - for an incredibly appropriate song - "What's going on?"

Question: Do you have any of the following singles?
Sophie B. Hawkins - Damn, I wish I was your lover
Deborah Blando    - Any song (except Innocence which I already have)
Frente            - Any song (except Ordinary Angels which I already have)
Yothu Yindi       - Any song (except Djapana which I already have)

If so, *please* send them to me. This will entitle you to Level 1 registration of my next major shareware program when it's finished. More details come with it. (An album by any of those artists gives you level 2).

CU /\
  (--)mpy