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.
*
*/