AmigAIM V0.9365 Beta
By Richard H. Poser II
whomiga@missingpiece.com
Copyright ©2000 Missing Piece Technologies

This BETA is considered as without any warranty as for its
capabilities - and currently has no documentation...other than
this page...(See bottom of page))

Special Note: This version was rushed quickly out the door after AIM decided to change
              the protocol and kill the previous version - it probably will have bugs
              I haven't had time to squash, as well as only partually capable sections.

Current Features:
 - Multiple users
   - Optional saving of password
   - Can change screen names without quitting 
     and restarting program
   - Auto-login can be selected for a default user.
 - Auto Re-login
   - If connection is lost after connecting, a window with a 5 second countdown will
     come up allowing for Auto-reconnection, cancelling or immediately attempting of
     connection.
   - Prevents Buddy List, Docking Window and Buddy Chat windows from being cleared if
     a connection is reestablished.
   - If away when Auto-relogging in, the client should now reset itself as away upon
     successful reconnection.
 - Can be set to auto open several windows on connection
   - Either the Buddy List window or the Docking window have to be opened. Both can
     be opened as well.
 - Opens bsdsocket.library on demand (On login)
   - Allows for Stack and AmigAIM to be started in any order
 - Profile can be set
   - Both normal, as well as directory info
   - If directory info on AIM server is different than in Client, will ask
     for which to use, which will become the normal default for the client.
 - Individual Buddy Chat Windows
   - Newly Functional History System (Automatically does history)
     - Load/Clear/Delete Functions for showing
   - Optional Showing of Timestamps
   - Graphical Smilies (And a disable switch)
     - Now displays all 16 of the AIM 4.0 Smilies
     - Includes a button with dropdown window for inline insertion in textinput
       gadgets in buddy windows
   - URL Clickable Buttons - Inline links
   - Selectable Multi/Single line Textinput gadget
   - Singleline Textinput Gadget has a history buffer controllable with 
     cursor up/down buttons
   - Windows Iconify to Docking window.
   - Can have messages cleared for memory handling during long chats
   - Can be opened for Non-online buddies for review of history buffer
 - Single Window Mode
   - Instructions, as they are, at bottom of this document...
 - Preparser for HTML conversion
   - Converts Textinput Styles (Bold,Italics,etc) to HTML for external message,
     away, profile, etc...
   - Automatically converts "http://" input to HTML links for output
 - Built in HTML Parser
   - Handles most display NList windows for simple HTML display.
   - Primary handler for URL display and Graphical Smilies
 - Use of Context Menus allows for less gadget real estate
   - Context menu in Buddy Chat selects Live Chat or History Modes with their
     own specific context menus
   - Context menu in Buddy Setup allows for Adding/Removing of buddies and also
     renaming of Groups in list
 - Sounds
   - Buddy SignOn/Off
   - Instant Messages - First/Receiving/Sending
   - Default volume can be changed
 - External Scripts
   - Script for URL Clicks (Also OpenURL Capable if none specified)
   - Script for handling on/off line notifications (For IRC and such)
   - Popplaceholder class now used for showing replacement string
     characteristics
 - Selectable Server and Port Numbers
   - don't normally require changing (Don't change unless required)
 - Fully Functional Away System
   - Selectable Auto-response or just profile insertion
   - Selectable Hiding of IM windows while away
   - Selectable Disabling of sounds while away
   - Multiple selectable away messages from Menu item
 - Operational Idle System
   - After 10 minutes of inactivity (Works like screen saver, no mouse or
     keyboard actions)
   - Can be turned off, so other people will not see Idle time
 - Controllable Contact System
   - Allowing all users
   - Allowing only users on Buddy List
   - Allowing only users on Allow List
   - Blocking all users
   - Blocking users on Block List
   - Allow/Block lists are fully controllable
   - Allowing/Blocking other people to search for screenname by E-Mail.
 - Info System
   - Retrieves info on users if they are online
   - Retrieves Directory Info, if set by the user
 - Versatile Buddy List
   - Allows for numerous catagories (Buddies, etc) for classification
     of Buddies.
   - Buddies can be moved and sorted easily between catagories (alphabetized
     within a catagory)
   - Catagories, except the "Buddies" catagory can be moved and sorted
     according to personal preference. (Buddies catagory is set and can't be
     deleted or moved)
   - Has graphical representation for buddies that have just come online or 
     gone offline as well as are in Away status 
   - Iconifies to Docking window
   - Shows info about online buddies as Bubble help when pointed at with mouse
   - Offline catagory in Online list to see who is offline without flipping over
     to setup list
   - Added lines to show status of open catagories in setup listing
 - Docking window
   - Contains buttons for active buddy chat windows and buddy list window.
   - Added more context sensitive menu capabilities for buttons
 - Versatile Snapshotting of Windows
   - Each user (Up to 255) has a different set of snapshot locations for 
     their windows
   - Each buddy under each user can have a different position (currently
     set to 255 buddies) - I'm not even sure that my packet handling
     will even send that many buddies currently :^/
 - Special Functions
   - Change AIM Password
   - Format Screen Name (Add Spaces/Change Capitalization)
   - Update E-Mail Address
   - Confirm Account - Will cause resend of confirming E-Mail to your E-Mail address
     if not currently confirmed (Can tell by status being Trial Internet)
 - Search functions
   - Search for Buddy by E-Mail
   - Search for Buddy by Name and Address
 - Reasonably functional ARexx Port
   - Go online with lastuser, specific user, etc...
   - Return current selected user in Buddy List
   - Switch users by asking to go online with different screenname while currently
     online with one screenname
   - Go offline
   - Send an IM to a buddy
 - Automatically Denies File Requests
   - Only File Sending system yet built for the program
 - Defaults can be edited
   - Allows all users to have a specific default setup before logging on
     for the first time
 
No Documentation other than the below, currently...

Some Terms...

1) Docked refers to a Buddy Window being currently open on the
   screen, or iconified to the docking window.
2) Opened refers to a Buddy Window that was opened previously
   during this session online, but is currently closed (Not Docked)

 * Single Window Mode allows for Sending/Receiving of messages
   within the single window 
 * The buddy list window has an added message listing and an textinput
   gadget for sending messages to a selected online buddy.(The message
   listing and textinput gadget are shown/hidden dynamically upon 
   selection/unselection of Single Window mode)
 * Noticed that after switching from Single Window to Normal Window, that
   the window can't be sized below a certain size. To size it, just iconify
   the main window and reopen (Not sure how to fix it otherwise yet)
 * Normal Window Mode should still operate the same as previously
 * History is saved in either mode (To see history, the individual window
   must be opened
 * When in Single Window Mode...
    - If Buddy Window is docked, messages sent via Single window will
      be shown in single window while incoming messages will be shown in
      the Buddy Window, same as Normal Window Mode. (Incoming isn't shown
      in the Single Window)
    - If Buddy Window isn't opened, the messages received are only
      shown in the Single Window. Messages sent via Single Window are
      only shown in the Single Window as well.
    - If Buddy Window has been opened, but isn't docked, the messages
      sent via the Single Window and received will be shown in the Single
      Window as well as echoed to the Buddy Window so that the next time
      the Window is docked the Window will contain everything
      sent/received while it was undocked.
    - Any messages sent via a Buddy window will only be shown in the
      Buddy window as during normal window mode.
    - This was made to allow for using of a single window, while still
      allowing for full use of the individual buddy windows.
 * Just experiment :-)

Copyright Statements...

AIM Protocol
   Copyright ©1999 America Online Inc.
Magic User Interface V3.8:
  Copyright ©1992-97 Stefan Stuntz
NList.mcc and NListview.mcc: 
  Copyright ©1996-98 Gilles Masson
Textinput.mcc:               
  Copyright ©1997-99 Oliver Wagner
Popplaceholder.mcc
  Copyright ©1999 Marcin Orlowski