README


This directory contains miscellaneous tools created as part of the debugger
project.

umakerom: This is a primitive program that serves much the same function
	as makerom, but used the simpler UNIX ld linker instead of nld
	with its associated .spec files. It converts a UNIX executable
	to a ROM image that can be loaded into an Indy running IPOS.

mdump: This is a utility that displays information about the .mdebug 
	section of an ELF file. Sort of like stdump, but provides
	different information. Not better, not worse, just different.
	Originally written as an aide to debugging the following.

rsp2elf: This program converts the myriad outputs of rspasm into an
	ELF file that the debugger (and elfdump, and stdump) finds
	acceptable. Synthesizes proc information from include files
	if desired.

lst2imem: Duplicates the similarly named program, with a little less
	info. A trivial C++ program that I wrote before I knew
	lst2IMEM existed, this is probably more useful as an example
	of how C++ programs look. It also can process multiple lst
	files in a single command, making one big IMEM image out of
	them, which I don't know for sure that lst2IMEM can do. Yes,
	I really wanted to do this once.