Compiling with C# and Java - Downloading the Resource Kit

P.D. Terry, Rhodes University

(9 June 2005)

This directory contains instructions for downloading and installing the Resource Kit for Compiling with C# and Java by P.D. Terry (Pearson Education, 2005).

Software developed by Pat Terry, Rhodes University, Grahamstown, South Africa. (p.terry@ru.ac.za)

The instructions are given from the perspective of a user running a 32-bit version of the Microsoft (tm) Windows operating system, and it is assumed that the user has installed either or both of a .NET SDK (Software Development Kit) or a Java SDK.

Suitable software for developing .NET applications is freely downloadable from Microsoft's site at
```
     http://msdn.microsoft.com/netframework/downloads/
```
This includes the .NET framework with the CLR, the .NET class library, the C# compiler and other tools, and the entire API documentation. (Note that Visual Studio .NET is not included, as the Visual Studio software is not free of charge.)
The latest version of the Java SDK from Sun is available at
```
      http://java.sun.com
```
Another well-known Java compiler that has proved eminently satisfactory is the open source Jikes compiler from IBM's DeveloperWorks at
```
      http://oss.software.ibm.com/developerworks/opensource/jikes/
```

For efficiency, the components of the Resource Kit are supplied in the form of a set of compressed (.zip) files; the files were compressed with the 32-bit version of Info-ZIP's compression utility, but can be decompressed using Info-ZIP's software or some other decompressor such as WinZip.

Info-ZIP's software (Zip, UnZip and related utilities) is free and can be obtained in source or executable form from various anonymous-ftp sites, including ftp://ftp.uu.net/pub/archiving/zip/.
WinZip can be obtained from http://www.winzip.com/.

Before downloading any of the components of the Resource Kit, create a top level directory (folder) into which the compressed files can be saved. In the descriptions that follow it will be assumed that this directory is called

           c:\resource

From a "Dos Window" this directory can be created with a command like

           mkdir c:\resource

It can, of course, also be created from within Windows Explorer.

Once the top level directory has been created, download those of the following files for the components of the Resource Kit that you wish to install:

Source code, Library routines and Batch command files (Sources.zip - 1.02MB) (Updated 25 November 2004)

This is an essential download. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:

      c:\resource                Top level

      c:\resource\chap01         Source code and other files for Chapter 1
      c:\resource\chap02         Source code and other files for Chapter 2
      ....
      c:\resource\chap15         Source code and other files for Chapter 15/16
      c:\resource\command        Instructions and specimen batch files for running the programs
      c:\resource\Library        Library routines

Coco/R for C# (CocoC.zip - 119kB) (Updated 9 June 2005)
This is an essential download if you plan to experiment with the C# version of Coco/R, and is supplied in terms of the GNU GPL licence. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource                 Top level
      c:\resource\cococ           Coco/R for C#  (GNU software)
      c:\resource\cococ\frames    Frame files for Coco/R for C#
      c:\resource\cococ\sources   Source code of Coco/R for C#
```
Coco/R for Java (CocoJ.zip - 124kB) (Updated 9 June 2005)
This is an essential download if you plan to experiment with the Java version of Coco/R, and is supplied in terms of the GNU GPL licence. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource                 Top level
      c:\resource\cocoj           Coco/R for Java  (GNU software)
      c:\resource\cococ\frames    Frame files for Coco/R for Java
      c:\resource\cococ\sources   Source code of Coco/R for Java
```
Joshua Engel's Oolong assembler and Gnoloo disassembler (Engel.zip - 1.53MB)
This is an non-essential download, useful if you wish to experiment further with Oolong and Gnoloo, and is supplied in terms of the GNU GPL licence. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource                 Top level
      c:\resource\engel           Engel's Oolong assembler  (GNU software)
      c:\resource\engel\COM       Class files (in a further hierarchy)
      c:\resource\engel\doc       Documentation
      c:\resource\engel\tests     Engel's test files
```
Modifications for Joshua Engel's Oolong assembler and Gnoloo disassembler (FixEngel.zip - 315kB)
This is an non-essential download, useful if you wish to experiment further with Oolong and Gnoloo, and is supplied in terms of the GNU GPL licence. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource                 Top level
      c:\resource\fixengel        Modifications for Oolong
```
The modifications can be made after reading the documentation. Precompiled versions of Oolong and Gnoloo are supplied in the
```
           c:\resource\command
```
directory, with these modifications already effected.
HTML versions of additional documentation (html.zip - 128kB) (Updated 25 November 2004)
This is an highly recommended download if you wish to read the additional documentation and appendices from within a browser. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource                 Top level
      c:\resource\html            HTML pages (READ.ME files and descriptions of Parva, C#Minor and Coco/R)
```
The documentation can then be located by pointing your browser at
```
           c:\resource\html\index.htm
```
PDF versions of additional documentation (pdf.zip - 1.03MB) (Updated 9 June 2005)
This is an highly recommended download if you wish to read the additional documentation and appendices in PDF form, either directly or from within a browser.
If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource                 Top level
      c:\resource\pdf             PDF files (Descriptions of Parva, C#Minor and Coco/R)
```
You will need to have the Adobe Acrobat reader installed to be able to read these files.
The documentation can then be located by pointing your browser at
```
           c:\resource\pdf\index.htm
```
The Taste compiler case study (Taste.zip - 15kB)
This is an optional download. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource                 Top level
      c:\resource\Taste           The Taste compiler case study
      c:\resource\Taste\Taste     Support files for Taste
```
Coco/R for C# and Java (Linz releases) (Linz.zip - 648kB) (Updated 16 January 2005)
This is an optional download, and is supplied in terms of the GNU GPL licence. If this file is uncompressed from the top level directory it will add the following components to the Resource Kit hierarchy:
```
      c:\resource            Top level
      c:\resource\Linz       Linz releases of Coco/R
```
The c:\resource\Linz directory contains the distributions from Linz in compressed form. Further details may be gleaned by reading the additional documentation.

After downloading and uncompressing the essential components of the Resource Kit some further action must be taken before it can be used:

Familiarize yourself with the extra documentation. This can be done either by viewing the various READ.ME files or, if you have installed the C:\resource\html components, by pointing your browser at the index file in
```
           c:\resource\html\index.htm
```
The PATH environment variable must be modified to include the C:\resource\command directory (or the files in this directory must be moved or copied to a directory on the existing PATH).
The PATH environment variable may be modified in several ways - a simple one being to issue a command like
```
           PATH=%PATH%c:\resource\command
```
from a command prompt. However, it may be preferable to modify the default setting for the PATH so that this change comes into effect automatically each time the system is started.
An environment variable RESOURCE must be defined to point to the top level of the Resource Kit directory hierarchy.
The RESOURCE environment variable may be defined in several ways - a simple one being to issue a command like
```
           set RESOURCE=C:\resource
```
from a command prompt. However, once again it may be preferable to modify the default list of environment variables for your setup so that this variable is defined automatically each time the system is started.
To use the Java versions of the software it will be necessary to arrange for the CLASSPATH environment variable to be set so as to include the top level of the Resource Kit directory hierarchy.
The setting of the CLASSPATH variable will depend on other software that you already have installed, such as the version of the Java runtime system. A command like
```
       set CLASSPATH=.;%RESOURCE%;C:\j2sdk1.4.1_01\jre\lib\rt.jar
```
might suffice (assuming that you have already defined the RESOURCE environment variable).

Disclaimer

While every attempt has been made to ensure that the material in this distribution performs properly, the author can accept no liability for any damage or loss, including special, incidental, or consequential, caused by the use of the software, directly or indirectly.

However, please bring any problems that you may experience to the attention of the author.

Pat Terry
Computer Science Department
Rhodes University
GRAHAMSTOWN 6140
South Africa
Tel: +27-46-603-8292
FAX: +27-46-636-1915
e-mail: p.terry@ru.ac.za

Date of this release: 25 November 2004

Change log

2004/10/07 - CocoC.zip and CocoJ.zip updated with minor bug fix
2004/11/25 - CocoC.zip, CocoJ.zip, Linz.zip, sources.zip updated with minor bug fixes; pdf.zip and html.zip updated to reflect correct dates of publication.
2005/06/09 - CocoC.zip and CocoJ.zip updated with minor bug fix, pdf.zip updated with minor changes to documentation.