The Aglet Portal Starter Package V1.02
======================================

This archive contains a base set of Aglet classes that should serve
as a useful introduction to Aglet novices, and a good base for those
wishing to investigate aglet technology further.

This package contains the following files:

Readme.txt         - This file
AgletNames.java    - a utility class that produces human readable names
BaseAglet.java     - an abstract class that provides some standard behaviour
BlindAglet.java    - a simple aglet that has no window, and tells you this gracefully
Master.java        - an example of a Master aglet that creates and keeps track of it's slave
MessageWindow.java - a simple AWT window that supports basic messaging facilities
Slave.java	      - an example of a Slave aglet that on dispatch to a new host, 
		        informs it's master of it's new host by returning an updated proxy object
StationaryAglet.java - a simple aglet that uses StationaryAdaptor to make sure it can't move
StationaryAdaptor.java - a utility class that can be used to make aglets stationary
WindowAglet.java   - an aglet that uses MessageWindow to report to the user
WindowCloser.java  - a utility class for closing and releasing MessageWindow resources

Getting Started
===============

1] Create yourself a directory for the Portal Package

For example, put the portal-base.jar file into a new directory C:\Projects\Portal

2] Unpack the archive

You can achieve this with a variety of archiving tools that will make your life easier,
eg. Winzip. However, it is possible to unpack the archive with the jar tool that is part of 
the JDK. Use the following command line when you are in your new directory:

	jar xvf portal-base.jar

You will now have all the source files in your new directory.

3] Compile the Portal Pacakge

As long as you have already set up the ASDK properly, and set all the required
variables, eg AGLET_PATH, etc, you will have no problem with this next step. If
you have not, then refer to getstarted.html that you will find in the doc directory
of your Aglet distribution on how to set these variables for your platform.

You can compile the Portal Package with the command:

	javac -d %AGLET_HOME%\public *.java

If you are a more advanced user then you might want to set up a new project in
your usual IDE, from which to use the package. You can find details of how to do
this at the Portal web site.

You can find the most up to date versions of these sample programs, hints
and tips to using the Aglet Software Development Kit (ASDK) and a FAQ at 
The Aglet Portal:

	http://luckyspc.lboro.ac.uk/Aglets

You can find the Aglet home page at:

	http://www.trl.ibm.co.jp/aglets

The ASDK can be downloaded from:
	
	http://www.trl.ibm.co.jp/aglets/download.html	

If you have any questions about these samples please direct them to
the Aglets Discussion list. Details of how to subscribe can be found at:

	http://www.trl.ibm.co.jp/aglets/intouch.html

This package of aglet classes is maintained and collated by Todd Papaioannou
(T.Papaioannou@lboro.ac.uk). If you wish to submit an updated version
of a sample then please mail it to the above email address. However, if
you have a technical question concerning the samples then please mail
the Aglet List. There is no license for this package, but I would appreaciate
an email from folks who download it =)

This document was last updated on 24/05/99

History
=======
Version 1.02

24/05/99	Added StationaryAglet and StationaryAdapter as an example of how to keep
		Aglets in one context.
		Updated the distribution to include the Javadoc's for the package. 
Version 1.01

15/04/99	Updated the README file to be more explicit in its instructions. Fixed
		a minor compilation bug with SlaveAglet.

16/03/99	Added the linked Master and Slave aglets to the portal package.

Version 1.0

15/12/98	Initial version of the Portal Package!