Instructions for Installing STk, NuTs!, and Java for CSCI-C 201
on Windows98 and Similar Operating Systems

Version 1.0 (9/25/2004).

PRECONDITIONS

These instructions assume that gzip, tar, and Emacs have already
been installed in the following locations, as described in 
win98-install-1.txt, version 1.1 or higher:
"c:\bin\gzip386.exe"
"c:\bin\tar.exe"
"c:\Program Files\emacs-21.3\bin\runemacs.exe"

--------------------------------------------------------

VII.  INSTALLING STK

1.  Copy the file d:\Windows\STk\STkwin32-4.0.1.zip to the
"c:\Program Files" directory:

> copy d:\Windows\STk\STkwin32-4.0.1.zip "c:\Program Files"

2.  Unpack the zip file using WinZip,
using the procedure described for Installing Ciao Prolog
(win98-install-1.txt, III, 2), or another program.

Unpack the zip file D:\Windows\STk\STkwin32-4.0.1.zip
similarly to the way you unpacked the Ciao zip file.

2.  In the STk-win32 folder which this creates, follow the
instructions in the file "install.doc".

3.  As a result of the previous step, you have a new folder
"c:\Program Files\STk-win32".

4.  Verify that you can run STk with the command:
> "c:\Program Files\STk-win32\MS-Win32\STk.exe"

Quit from the STk program.


--------------------------------------------------------

VIII.  INSTALLING NUTS!

1. The NuTs! program on the distributed CD-Rs is so bad, it is better
to start with a new version.  Download "NuTs! for Microsoft Windows"
from http://mypage.iu.edu/~gdweber/software/home.html#nuts

Download the file "NUTS199W.TAZ" to the directory "c:\Program Files".

Use a shell to unpack the archive as follows:
> cd "c:\Program Files"
> c:\bin\gzip386 -d -N NUTS199W.TAZ
> dir
(You should see NUTS199W.TAR in the directory listing.)
> c:\bin\tar xvf NUTS199W.TAR
> dir
(You should see the subdirectory "nuts" in the directory listing.)

2.  We are going to run the NuTs! programs under Emacs, so we need
to help Emacs find them.

The best way to do this is to permanently set the Windows PATH to
include "c:\Program Files\nuts".  PATH is a series of directories,
like in Unix/Linux, except that Microsoft has decided to separate the
directories by semicolons (";") instead of colons (":").

i.  For Windows 98:
    Edit the file "c:\AUTOEXEC.BAT".  Find the PATH command,
or if there isn't one, add it.  Insert the nuts directory
"c:\Program Files\nuts" in the path.  

For example, if there is a line in AUTOEXEC.BAT that says

PATH C:\WINDOWS;C:\WINDOWS\COMMAND

then change it to

PATH C:\WINDOWS;C:\WINDOWS\COMMAND;"c:\Program Files\nuts"

If there is no PATH command in AUTOEXEC.BAT, then insert the line

PATH "c:\Program Files\nuts"

ii.  For Windows NT, 2000, and XP:
     From the Start menu, choose "Settings", "Control Panel", "System".
Select the "Environment" tab for Windows NT; otherwise select the
"Advanced" tab and then "Environment Variables".  Find "Path" in the
"User Variables and System Variables" and change it to include the
NuTs! directory as described above for Windows 98.  Then choose 
"Set", "OK", and/or "Apply".

(These instructions are based on the Installation Notes for Java 1.5 RC
(Release Candidate) JDK on Microsoft Windows at 
http://java.sun.com/j2se/1.5.0/install-windows.html)

3.  Verify that Emacs can now run the three NuTs! programs.

a.  For the path you have set to take effect, it may be
necessary to restart your computer.

b.  Start Emacs and find the file "c:/Program Files/nuts/test-data/loop.s".
c.  Compile with the Emacs command:
M-x compile RET
Emacs will then prompt you for a "compile command".  Backspace to erase
"make -k", and type "nas loop.s RET" (without quotation marks).
A *compilation* buffer should display output similar to this:

cd c:/Program Files/nuts/test-data/
nas loop.s
This is nas, the NuTs! assembler (C) 2004 G. D. Weber.
See COPYING for license information.

C:\Program Files\nuts\test-data>


Compilation finished at Sat Sep 25 22:46:33


d.  Start a shell under Emacs:
M-x shell RET

e.  In the *shell* buffer, type
nuts loop.o RET

Expected output (be patient, it may take several seconds):

C:\Program Files\nuts\test-data>nuts loop.o
nuts loop.o

C:\Program Files\nuts\test-data>

C:\Program Files\nuts\test-data>1 2 3 4 5 6 7 8 9 10 10 9 8 7 6 5 4 3 2 1 
	
f.  In the *shell* buffer, type
ndb loop.od RET

After a few seconds, four new windows should open up:
NuTs! CPU
NuTs! Data (Memory)
NuTs! Code (Memory)
NuTs! Control Panel

Use the NuTs! Control Panel to quit.

--------------------------------------------------------

IX.  INSTALLING JAVA

Download the Java 2 JDK 1.4 from 
http://java.sun.com/j2se/1.4/download.jsp
and follow the installation instructions they give there.

Note: be sure to get the JDK (Java Development Kit?) or SDK (Software
Development Kit?), not the JRE (Java Runtime Environment).  The JRE
will only let you run Java programs, not develop them.