xtdb (xdbx 2.1)
***************

This is xtdb a quick port of the xdbx program as posted to the newsgroup
comp.sources.x.

It changes some of the functions to cope with the differences of tdb and alters
the name of the programs.  Apart from that, the programs are pretty identical.

Compilation
-----------
Hopefully the IMakefile will be OK for your system.  If not, run 'xmkmf' to
generate it.

Then type 'make'.

How to use
----------

To debug part of a parallel program eg
test.par:
	par
	  processor 0 reader.ex8
	  processor 1 writer.ex8
	endpar
Do the following:
1) Compile and link both programs with debugging info (-g).

2) Run the debugger as either 'xtdb reader.ex8' or 'xtdb' followed by
'debug reader.ex8'.  The source should appear in the main window.

3) Set any breakpoints by clicking at the line and select the 'stop at' box

4) Do any other items required eg 'trace' or 'stop in main' etc.

5) Run the system with:
	tdb> run test.par proc0`reader
This tells the debugger to use the given parfile and debug the exe reader on
processor 0.  This has only to be done once.  The next run can be done with
just 'run'.

6) Debug the program:

Step through the program by clicking 'step' or 'next'.

Click on a variable name and select 'display' for the data to be shown
permanently or 'print' for it to appear in the console window.  Use the right
button for a "data popup" to appear with the information.


For further information, read the manual page which has all the above described
as well as other Meiko specific information.  Note that not all of the dbx
functions are implemented in tdb.

David Beckett
(djb1@ukc.ac.uk)
