Description                   
===========                   
                        
This directory contains a library and two applications used for the introductory
programming course at ETH Zurich (Winter semester 2004/2005).
                        
TRAFFIC: Library that supports the reading and display of cities described in
xml file format. Found in the directory "./library/".

FLAT_HUNT: Application that uses the TRAFFIC library. The FLAT_HUNT game is
based on the idea of Scotland Yard, but is set in a different frame. Up to eight
flat hunters try to catch the estate_agent that is running around Zurich to rent
flats to people. The flat hunters are first-semester students of the ETH that
are trying to find an appartment in Zurich. This application is used for a
number of programming exercises during the course. Found in the directory
"./example/flat_hunt/".

TOUCH: Application that uses the TRAFFIC library. The TOUCH application
implements some of the examples from the text book TOUCH OF CLASS that is
currently being written by Professor Meyer. The examples from the book and the
examples in the application don't entirely correspond and not all of them are
yet implemented. Enjoy with caution;-)! Found in the directory
"./example/touch/".

Requirements
============

1. EiffelStudio 5.5
-------------------

To get FLAT_HUNT and/or TOUCH running you need to have EiffelStudio 5.5
installed (EiffelStudio 5.4 should also work, is not officially supported
though).

2. Precompiled libraries
------------------------

Additionally, EiffelBase, EiffelVision2 and WEL/GEL (depending on your operating
system) need to be precompiled.

These libraries can be precompiled either
- during the EiffelStudio installation
- after the EiffelStudio installation by doing the necessary steps with the
precompilation wizard (in EiffelStudio click "Tools->Precompilation Wizard").
Note that you will in most cases need admistrator rights for this.

!!! If you don't want to or can't use the precompiled libraries you will need to
adapt the ace file: delete the line

precompiled ("${ISE_EIFFEL}\precomp\spec\windows\vision2")

Note, however that without precompiled libraries the project will take much
longer to compile and will use much more disk space.

Getting started
===============

1. Start EiffelStudio.
2. Click "File->New project..." and a dialog should show.
3. Choose "Open existing Ace" in the dialog. Click "Next".
4. An open file dialog shows. Go to one of the application directories (either
"./example/flat_hunt" or "./example/touch" and choose "ise55_windows.ace" if
your operating system is Windows, choose "ise55_linux.ace" if your operating
system is linux.
5. The "Choose your directory" dialog pops up. You may choose the place where
the compilation and project files are saved. In most cases, you will just leave
everything as proposed by EiffelStudio. Make sure that the checkbox "Compile the
generated project" is selected. Click "Okay".

Your project will now be compiled.

That's it!!!



--|--------------------------------------------------------
--| This file is Copyright (C) 2004 by ETH Zurich.
--|
--| For questions, comments, additions or suggestions on
--| how to improve it, please write to:
--|
--|     Michela Pedroni <michela.pedroni@inf.ethz.ch>
--|
--|-------------------------------------------------------- 