Java for JOI

• Download Java for Windows or linux. Scroll down to Download J2SE v 1.4.2_03 , don't get J2EE!

• Almost all of the programs in Java Outside In use a special program (a class actually) called Terminal to manage output to the screen and input from the keyboard. You must have the Terminal in your environment in order to run those programs.

  The source code (which you do not need to know about) is in file Terminal.java.

  To install the Terminal class, copy file www.cs.umb.edu/joi/terminal/Terminal.jar to folder C:\j2sdk1.4.2_03\jre\lib\ext (or whatever the corresponding folder is for your Java installation).

Getting Xemacs

Xemacs is free software available from XEmacs.org.

To install it

• Go the the download web page www.xemacs.org/Download/

• Click "Install Now!"

• Follow all the defaults. For a download site, try ftp.ca.xemacs.org. (That's Canada. We've had trouble with stealth.net, the first option, and with xemacs.org, the natural second choice.)

• When you are asked to select packages to install, take the default. (In fact you can do without lots of these, but figuring out which ones to leave out is tedious. Do it only if you have disk space problems or a really slow internet connection.)

• The download will take a long time ... You may need to return to the download site and ask it for the packages it hasn't yet delivered. Then run setup again, installing from the local directory that (finally) contains all the packages.

• For the last set of choices, accept the defaults. You may also want to check the box that adds XEmacs to the Start Menu.

Configuring XEmacs for JOI

• create folder site-lisp in C:\Program Files\XEmacs\XEmacs-21.4.13 (or the corresponding directory if you have downloaded a later version of XEmacs).

• Copy file default.el to that folder.

• Test your installation by editing some Java program: perhaps Hello.java. The mode should be JDE . The mode line should display the line number of the current line in the buffer.

  When you compile with ctrl-x ctrl-m or with the Compile selection from the Tools pulldown on the menu bar, the compile command should be javac *java. If you see the standard XEmacs default make -k then you have not properly installed default.el

  If compilation fails because XEmacs can't find javac, the problem is probably with your PATH environment variable, which must go through the bin directory for your Java installation C:\Program Files\Java\j2re1.4.2_03\bin (or the equivalent for your installation). You can make that happen at the system level or by editing default.el at the obvious place in the obvious way.

  If the compilation fails because class Terminal can't be found then you have not properly installed Terminal.jar above. Try to compile EasyHello.java instead, to test XEmacs.

  To run the test program, open a shell buffer in XEmacs, either with Shell->Shell from the Tools pulldown or with ctrl-x ctrl-r. Then type java Hello at the prompt in the shell buffer. Not that the program prompts you for a line to echo after it prints the usual greeting.

  Test printing from XEmacs. The Print selection from the File pulldown on the menu bar should work.

Integrated environments

• Sun's Java IDE (it used to be called Forte). You can find it at http://wwws.sun.com/software/sundev/jde/. The Community Edition (more than adequate for this text!) is free.

• JBuilder, from Borland (http://www.borland.com/) is a popular Java IDE. The personal edition is free.

• Bluej, at http://www.bluej.org/, a Java IDE written specifically for students. It's free too.

• Editplus, at http://www.editplus.com/. This is shareware (that is, use it free for a while and then pay a small fee if you are a moral person).

Some of these environments may come with Java installed, in which case you won't need to get a copy separately.

You will need to find out how to make the Terminal class available in your chosen IDE.