by Neil Daswani
/*
 * WannaMeet Readme, Version 0.1
 * Wednesday, June 6, 2001
 * Copyright (C) 2001 Neil Daswani (daswani@cs.stanford.edu)
 * All rights reserved.

 * This package is a peer-to-peer collaborative messaging application
 * written by Neil Daswani (daswani@cs.stanford.edu).

 * Background

 * This application was written during a six-hour developer's challenge
 * competition sponsored by Nextel and Motorola during the 2001 JavaOne
 * Developers conference in San Francisco, CA.  Out of over 60 applications
 * submitted at the competition, this application was selected as one out
 * of six finalist applications.  This application was presented to various
 * executives at Motorola and Nextel at the judging of the developers
 * challenge contest at 7pm on Wednesday, June 6, 2001.

 * As this application was written in a very short time period (realistically,
 * 4 hours, since I spent the first two hours of the competition fighting the
 * compiler!), it is meant to serve as a prototype implementation.

 * The application allows users to have a "buddy list" of their friend's phones
 * (their "peers"), and can send out messages to these peers inviting either
 * any or all of the peers to a given place, at a given time, for a particular
 * event (lunch, dinner, drinks).  

 * Requirements
 * - One or more Motorola i85s or i50sx phone(s) with Nextel service
	(it is recommended that you have at least two phones)
	(in addition, each of these phone must have a static IP address)
 * - Windows 2000 / NT / 98 PC
 * - JDK 1.3
 * - J2ME Wireless Toolkit 1.0.2 Early Access
 * - iDEN Update Software Application

 * Setup and installation
 *  1. Install JDK 1.3 Standard Edition (if not already installed)
 *  2. Install the J2ME Wireless Toolkit (if not already installed)
 *  3. Install the iDEN Update Software Application (if not already installed)
 *  4. Unzip the WannaMeet.zip file (if you haven't done so already) 
 *  5. Copy the WannaMeet directory under the apps directory under the J2mewtk
 *	 (J2ME wireless toolkit) directory
 *  6. Edit the initFriendsList() method in the WannaMeet.java file  (in the WannaMeet/src directory)
 *	to put the names and IP addresses of your phones in the dFriends hash table.
 *  7. Open the WannaMeet project with the KToolbar tool, and build the project.
 *  8. Use the iDEN Update application to download the WannaMeet application to
 *	the one or more iDEN phones.
 *  9. Run the wannaMeet application on the one or more phones, and click past
 *	the introductory screen by pressing the "START" softkey.  Once this is
 *	done, the application is ready to accept invitations from other phones,
 *	as well as send out invitations to other phones.
 * 	

 * Known Bugs / Limitiations
 * Please keep in mind that this application was completely written in a 6 hour timeframe,
 * and under the stress of competition!
 * - The ability to add new contacts at run-time in the application currently does not work.
 * - Only the first invitation that is sent out by the application seems to get received
     by other phones.

 * This package and its source code is free for non-commercial use as long as
 * the following conditions are aheared to.  No parts or sub-parts of this
 * package of this package or source code may be used for commercial purposes.
 * The following conditions apply to all code found in this distribution.  
 * The documentation
 * included with this distribution is covered by the same copyright terms.
 * 
 * Copyright remains Neil Daswani's, and as such any Copyright notices in
 * the code are not to be removed.
 * If this package is used in a non-commerical, not-for-profit
 * product, Neil Daswani should be given attribution
 * as the author of the parts of the source code or documentation used.
 * This can be in the form of a textual message at program startup.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted for non-commercial purposes
 * provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the copyright
 * notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *  must display the following acknowledgement:
 *  "This product includes software written by
 *	Neil Daswani (daswani@cs.stanford.edu)."
 * 
 * THIS SOFTWARE IS PROVIDED BY NEIL DASWANI ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * 
 * The licence and distribution terms for any publically available version or
 * derivative of this code cannot be changed.  i.e. this code cannot simply be
 * copied and put under another distribution licence
 * [including the GNU Public Licence.]
 * 
 * The reason behind this being stated in this direct manner is past
 * experience in code simply being copied and the attribution removed
 * from it and then being distributed as part of other packages. This
 * implementation was a non-trivial and unpaid effort.
 *
 */