PSD - THE PORTABLE SCHEME DEBUGGER 
VERSION 1.0

This is psd, the portable Scheme debugger. It does source code
debugging for any R4RS compliant Scheme interpreter when run in a
GNU Emacs buffer.

TO INSTALL:

	* Copy the *.scm files to a suitable place, for example
	  /usr/local/lib/psd or some such. 

	* Copy the file psd.el to a place where you have the local Emacs Lisp
	  files, for example /usr/local/lib/emacs/local.

	* Make psd-mode autoloadable by putting the following in your
	  .emacs or the global default.el

	   (autoload 'psd-mode
		     "psd"
		     "Minor mode for running psd (the Portable Scheme Debugger) in a cmuscheme buffer."
	    	     t)

	* Make sure that the Emacs variable psd-directory points to 
	  the right place.

	* Look into psd.scm for some things you may have to change.

TO RUN: See the manual.

Psd is known to work with Aubrey Jaffer's scm, but porting to other
Schemes should be easy.  In fact, for a R4RS Scheme you should not
have "port" it at all. It works also with Elk v. 1.5.

Files in the distribution:

 README		this file
 COPYING	the GNU General Public License
 psd.tex	a technical description of psd
 psd.bbl	bibliography for psd.tex
 psd.ps		PostScript file derived from psd.tex
 manual.tex	a user's manual
 manual.bbl	bibliograpy
 manual.ps	user's manual in PostScript

 psd.el		psd minor mode for Emacs

 psd.scm	the main file that takes care of loading psd
 psd-elk.scm	the main file that takes care of loading psd, modified
                to work with elk 1.5
 psd-scm.scm	ditto for scm4a3
 instrum.scm	the instrumentation code
 pexpr.scm	definition of pexps, which are sexps with position
		information 
 read.scm	the reader for psd
 runtime.scm	runtime support for debugging
 primitives.scm runtime support that has to know about primitive
		procedures 
 cmuscheme.el	the CMU Scheme mode for GNU Emacs by Olin Shivers. 
 comint.el	support for cmuscheme.el

Comments, suggestions and bug reports are welcome.

	    Pertti Kellom\"aki (TeX format), pk@cs.tut.fi
		     Tampere Univ. of Technology
			 Software Systems Lab
			       Finland

