Greetings Soar users,

Version 0.4 of the Soar Development Environment (SDE) had a few bugs,
one of them rather serious, so I'm issuing an update as SDE version 0.5.
There are no user-visible functional changes in release 0.5, although the
on-line manual a section describing the changes and has version number 0.5.

The update is available in two forms: a file in Unix "diff" format, and as a
complete package.  If you have already obtained and installed 0.4,  and you
have the Unix program "patch" on your system, you should obtain the diffs
file.  If you have not obtained release 0.4, simply get the new release
instead. 

The main problems in 0.4 were: 
  * `C-c 1' would crash Emacs 18 (actually due to a bug in Emacs 18)
  * `C-c 1' would incorrectly shrink windows other than the error window.


OBTAINING AND INSTALLING THE PACKAGE
------------------------------------

The latest version of SDE is available via AFS as the file

    /afs/cs.cmu.edu/project/soar/public/sde.tar.Z

It is also available via anonymous ftp from host ftp.eecs.umich.edu in the
directory "outgoing/hucka" and from host centro.soar.cs.cmu.edu in the
directory "/afs/cs.cmu.edu/project/soar/public".  Again, the file is named
"sde.tar.Z".  If you would like help with using anonymous ftp, feel free to
send me a message and I will explain the procedure.

The diffs file from the previous version is called "sde-0.4-0.5.diff.Z"
and can be obtained from the same directories.

To update your installation using the diff file:

1) Transfer "sde-0.4-0.5.diff.Z" to your SDE installation directory, cd to
   that directory, and do 

            uncompress sde-0.4-0.5.diff.Z

2) Execute the following command:

    	    patch < sde-0.4-0.5.diff

3) Remake SDE by executing "make" in the installation directory. 
   This will compile the .el files.  If GNU emacs at your site is not called
   "emacs", but something else (e.g., some places use "gmacs"), then compile
   the .el files using the alternative command "make EMACS=xxxx" where "xxxx"
   is the name of your emacs program. 

To install the full system:

1) Find a directory where you wish to install the package.  (At U-M we
   currently put it in ~soar/projects/sde.)  If you had a previous version of
   SDE, save your "sde-site.el" file first and later merge its contents into
   the "sde-site.el" file supplied with this update.

2) Transfer sde.tar.Z to your desired directory, cd to that directory, and do

            zcat sde.tar.Z | tar xvf -

3) Execute "make" in that directory.  This will compile the .el files.  If
   GNU emacs at your site is not called "emacs", but something else (e.g.,
   some places use "gmacs"), then compile the .el files using the alternative
   command "make EMACS=xxxx" where "xxxx" is the name of your emacs program.

4) At U-M, where SDE is installed in ~soar/projects/sde, users can set
   up their Emacs to use SDE by adding the following to their ~/.emacs files:

     (setq load-path (cons (expand-file-name "~soar/projects/sde") load-path))
     (load "sde")

   To use SDE at your site, change the pathname "~soar/projects/sde" to
   correspond to the location of the SDE files at your site.  

5) Once you have SDE installed, please read the on-line manual, especially
   the Appendix titled "Changes and Compatibility", for information about SDE.


MISCELLANEOUS
-------------

Please report bugs, problems, questions and suggestions.  There is a command
"ESC x sde-feedback" available especially for this purpose in SDE.  I can't
guarantee immediate response but I promise I won't ignore you.  This first
general release is incomplete and has rough edges; please be patient and
above all, convey your feedback.

Michael Hucka (hucka@engin.umich.edu)
