@database AmiComSys.guide
@index ACSindex
@$VER: AmiComSys.guide 2.3 (08.09.2002)
@author "Håkan Parting"@(c) "Håkan Parting 2002"
@WORDWRAP
@MACRO TI "@{u}@{fg shine}@{b}$1@{fg text}@{ub}@{uu}"
@MACRO HL "@{b}@{i}$1@{ub}@{ui}"
@MACRO HI "@{fg shine}@{i}$1@{ui}@{fg text}"
@MACRO BO "@{b}$1@{ub}"

@node "Main" "Contents"

			   @{TI "Amiga Communicator System 2.3"}
			   http://www.parting.nu
			   amicomsys.2y.net (the central server located in Sweden)
			   Copyright © 1997-2002 Håkan Parting. All rights reserved.
			   Released as ShareWare

			   Read History for new features since last version ...
			   Read upgrade to 2.3 to upgrade.
			   @{"Introduction" link "Intro"}             @{"Requirements" link "Requirements"}
			   @{"Copyright and disclaimer" link "Copyright"} @{"ShareWare registration" link "registration"}
			   @{"Installation" link "Install"}             @{"Upgrade to 2.3" link "upgrade"}

			   @{"Usage" link "Usage"} 
			   @{"Features - the user interface" LINK "Features"}
			   @{"General Settings" LINK "Settings"}         @{"Configure the GUI" LINK "Features"}
			   @{"ARexx interface" LINK "ARexx"}          @{"Plugins" LINK "PLUGINS"}

			   @{"The rules" LINK "rules"}                @{"FAQ" link "faq"}

			   @{"History" link "history"}                  @{"To do" link "todo"}
			   @{"Bugs" link "bugg"} 
			   @{"The Author" link "me"} 
			   @{"Credits" link "thanks"}                  @{"Trademarks" link "trademarks"}
			   @{"Updates" link "updates"}
			   @{"The files in the directory" link "files"}

			   @{"Index" link "ACSindex"}

@endnode

@node "Copyright" "Copyright"

						  @{TI "COPYRIGHT"}

@{b}AmiComSys - Amiga Communicator System Copyright 1997-2002 Håkan Parting@{ub}
@{b}All rights reserved.@{ub}
@{b}The unregistered Amiga Communicator System - AmiComSys is ShareWare@{ub} and may be freely spread, if no files are added, deleted or modified.

If you @{"register" link "registration"} you will get a personalized keyfile which will enable all features.
@{b}That keyfile is private and only the licensee is allowed to use it, on one computer at a time.@{ub} The licensee is not allowed to use his/her keyfile on any public machine - Amiga, or make it available on any download site!

@{b}The AmiComSys keyfile is NOT public domain and may not be spread freely. If you do so it's considered as an act of piracy.@{ub}

The licensee agrees to the license agreement above and the disclaimer below by registering.

Magazines are allowed to distribute the AmiComSys archive on their Cover-discs/CD.

Aminet and Aminet CD have my permission to distribute AmiComSys.

BBS:es are allowed to distribute AmiComSys if they do not take out any download fee.
Nobody but myself are allowed to make any profit from AmiComSys.
PD-companies are allowed to distribute AmiComSys if they only take out the cost of copying and disk (max. 25 SEK, £3, 5 DM).

				 @{u}@{fg shine}@{b}DISCLAIMER@{fg text}@{uu}@{ub}                
									  
   @{b}THIS SOFTWARE IS PROVIDED "AS IS".         
   NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE      
   ACCURACY, RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION      
   OF THIS SOFTWARE, AND ALL USE IS AT YOUR OWN RISK. 

   THE AUTHOR DO NOT ASSUME ANY RESPONSIBILITY OR LIABILITY       
   WHATSOEVER WITH RESPECT TO YOUR USE OF THIS SOFTWARE.

   THE AUTHOR HAS NO RESPONSIBILITY TO HOST A DEFAULT SERVER. ANY
   AMARQUEED SERVER MAY BE USED.

   THE AUTHOR CAN'T BE MADE RESPONSIBLE FOR LOST MONEY SENT BY POST.

@{ub}
@{ub} 
@endnode

@node "registration" "Registration"

						 @{TI "ShareWare registration"}

@{b}If you use AmiComSys regularly and like it you should register.@{ub}

If you register you will receive a personalized keyfile, which will enable all features. That keyfile may not be made available to another part.

The registered version of AmiComSys has this advantages:

* The positions of all the toolbars can be saved. You may "drag & drop" the GUI-components and then save it, so they retain the positions you have set the next time you start AmiComSys.

* In the contact list you could see if a client is away or busy. There will be a "Zzz"-image for Away and a "X"-image for Busy inserted in front of all clients' nick name.

* The content of the Message History buffer will be saved automatically when you disconnect or shutdown AmiComSys (optional).

* You can ignore certain users' messages sent to you with the Ignore List, instead of using the less efficient bann-list in the Network settings.
  Via the registered version's Ignore List you can make it impossible for certain clients to send you messages, and they can't even get your System-info and Version-info.

* All security options is enabled, e.g messages, SendFile and PChat can be turned off.  

* Send confirmation can be disabled.

* A NotifyArexx.amicomsys script can be used.

* A MessageArexx.amicomsys script can be used.

* The Busy and Invisible options of the status-button are enabled. With the invisible status set you can log in without anybody seeing you! And when you don't want to be disturbed you can switch to busy status.

* The message requesters can automatically be closed after you have sent a message.

* You may have more than two plugins installed.

By registering you support the shareware concept and will help me to improve AmiComSys, and in further development on Amiga, the computer we all like so much ...

By registering you also agree with the @{"copyright notice and the disclaimer" link "Copyright"}.

All registrations are done online at http://www.parting.nu/AmiComSys/
Full information are available there.

The fees are currently: (2002-07-28)
@{b}140 SEK, 16 US Dollar, 10 Great Britain Pound or 15 Euro@{ub}.

There are three or four payment options as follows:

ShareIt!/Element 5 AG
---------------------
They accept Credit card-, cheque- and wire transfer.
If you pay by credit card you will get the key file via email within a few minutes!
Please note that an Eurocheque has to be written in a European currency. All cheques has to be bank guaranteed, no personal cheques. Please make all cheques payable to Element 5 AG.

All credit card data are sent securely encrypted using SSL.

Paypal
------
I have a Paypal account, hakan@parting.nu, so you may send the fee to my account. Please make sure that your name, address and email address is sent to me with the payment confirmation mail.

Send it directly to me in bills
-------------------------------
Send the fee in @{b}bills@{ub} with a letter telling me that you want to  be a registered user of AmiComSys.
No other currencies than US Dollar, Swedish Crowns (SEK), Great Britain Pounds or Euro are accepted.
@{b}Don't forget to include your name, address and emailaddress.@{ub}
@{b}This sort of registration shall also be entered in the appropriate form at the registration page at http://www.parting.nu/AmiComSys/ @{ub}

@{b}Be aware of the fact that I can not be held responsible for lost money sent by post. I advice you to send them by registered mail. However no mail have been lost yet.@{ub}

@{b}Options for people living in in Sweden:@{ub}
---------------------------------------
(in Swedish:)
Om du inte vill betala med konto/kredit-kort så kan du betala in pengarna på mitt postgiro eller bankkonto.
Glöm inte att registrera din beställning på registreringssidan på http://www.parting.nu/AmiComSys/
Postgiro 421 38 50-3.
Bankkonto i SEB: 5392-00 39742.

Registreringsavgiften är 140 kr.

@{b}Author:@{ub}

Address:

	  Håkan Parting
	  Organistv. 11
	  SE-175 79 Järfälla
	  SWEDEN

E-mail:
	  hakan@parting.nu

Authorized registration sites:

@{b}ShareIt!
--------@{ub}
The program number for AmiComSys is 132304. Don't forget to mention it in any contact with ShareIt!
They cannot provide any technical information about the program.
Please use the the registration site http://www.parting.nu/AmiComSys/
There you will find the link to our secure server.
They will provide you with information on how they expect you to pay when you have submitted the form on the secure server (their bank account, SWIFT code and so on).

@{b}European office:@{ub}

Address:
	  element 5 AG / ShareIt!
	  Vogelsanger Strasse 78

	  50823 Koeln
	  Germany

Phone:  +49-221-31088-20
Fax:    +49-221-31088-29
E-mail: register@shareit.com

@{b}USA office:@{ub}
Address:
	  ShareIt! Inc.
	  PO Box 844
	  Greensburg, PA 15601-0844
	  USA

Phone: 724-850-8186
Fax:   724-850-8187

@endnode

@node "updates" "Updates"

							 @{TI "Updates"}

The most recent version should always be available from
Aminet:comm/net/AmiComSys.lha
(e.g. ftp://us.aminet.net/pub/aminet/ and ftp://se.aminet.net/pub/aminet/)

Latest version is always first available at my homepage at http://www.parting.nu/AmiComSys/

Updates of Textinput.mcc can always be found at
ftp://ftp.vapor.com/pub/misc/textinput_x.xx.lzx

Please subscribe to the AmiComSys-update-mailing-list to get notification
when a new version is available!
Just send an empty email to amicomsys-update-subscribe@yahoogroups.com
to add yourself to the list!

To subscribe to the AmiComSys discussion mailing list send an empty
email to amicomsys-subscribe@yahoogroups.com

@endnode
@node "Intro" "Introduktion"

						  @{TI "Introduction"}

AmiComSys is an AMarquee client program which you use to communicate with other people on a tcp/ip-net - e.g Internet.
At the same time it make it easier to find people's IP-addresses, for use with for example Internet gaming, and homepages (they are only shown to the people in your Friends book, if you don't want to make it public).

Now you can say Hi! to your Amiga buddies on the net, or just see if they are connected, or why not find new friends? AmiComSys could be the place where the Amiga community stick together.

You can:
* send text messages
* send chat requests
* send WEB-requests.
* transfer files.
* have a public realtime chat
* have a private realtime chat, with photos.
* advertise your homepage, ftp-site, IRC-server, ICQ id and own-made programs.
* use other type of programs inside AmiComSys (plugins)

Future updates will include more.

Please put it in your WBStartup drawer and enjoy ...
Then it will automatically connect to the server when you connect to the Internet.

AmiComSys requires:

* amarquee.library v.54+ in LIBS:. It's included in the archive and will be installed together with AmiComSys.

* Magic User Interface (MUI) version 3.8 or higher

(The third party packages below is most certainly already installed on your Amiga. They are used by many other Internet programs, like for example YAM 2.)

* NList.mcc by Gilles Masson & Sebastian Bauer, available at
http://home.t-online.de/home/sebauer/MCC_NList.lha

* Toolbar.mcc by Benny Kjær Nielsen. Included in the archive
(MUI/libs/Toolbar.mcc).

* optionally you may also use NewString.mcc by Rüdiger Sopp. (found in
the Ibrowse-archive)
or Textinput.mcc by Oliver Wagner (found at ftp://ftp.vapor.com/misc/textinput_13.xx.lzx)
or BetterString.mcc by Allan Odgaard. Included in the archive (MUI/libs/BetterString.mcc).

Note that the above only apply if your friends is using AmiComSys, and have an Amiga. AMarquee.library is ported to JAVA(tm) but AmiComSys is not.

Features:

* Send text messages.
* Includes a contact list, which shows people which have logged in.
* Send WEB- or Chat-requests.
* Uses Magic User Interface (MUI).
* A message history buffer, which saves all the received messages.
* Logging
* Arexx interface
* File transmission.
* Public chat (HotLine)
* Private chat (PChat)
* Friendsbook
* TAB- and ':'-nickname-expansion in chat-fields.
* Every window is iconifiable separately from the MUI-application.
* Send WWW, FTP, IRC -addresses to your WEB-browser, FTP-client respective AmIRC.
* Optional string-gadget class. Choose from Betterstring.mcc, Newstring.mcc and Textinput.mcc
* Show all/Show only friends/Highlight friends.
* See a photo of the one you are chating with.
* Hide you IP-address from others (your friends will se it anyway).
* Ignore users in HotLine, Client-List, PChat, SendFile & Messaging.
* May be put in the WBStartup drawer, and will then automatically connect to the server when you are online.
* Fully configurable GUI with toolbars.
* Will save some memory by freeing the GUI while not online, if "No GUI at startup" is active.
  Nice if you have it in the WB-Startup drawer.
* An advanced plugin interface, which make it possible to extend AmiComSys or run plugin applications inside the AmiComSys GUI.

See @{"To do" link "todo"}.

@endnode

@node "Requirements" "Requirements"

					@{TI "Requirements"}

The requirements are:
---------------------
An Amiga with Amiga OS 3.0+ and a 68020 or better processor

An Internet connection and a TCP/IP-stack like Miami, TermiteTCP, Genesis or AmiTCP3.0b2+.
INET225 users must use some kind of bsdsocket.library->socket.library mapper.
Termite TCP users must use some kind of bsdsocket.library->tsocket.library mapper. (available at the Hisoft support-web-site.)

The shared library AMarquee.library v.52+. It is included in the archive.
Aminet:comm/net/AMarquee.lha

Magic User Interface (MUI) version 3.8+. http://www.sasg.com

The MUI custom class NList.mcc version 20.106+.
http://home.t-online.de/home/sebauer/MCC_NList.lha

If OpenURL.library is installed it will be used for sending a http-adress to your web-browser. It's available at Aminet:comm/www/OpenURL30.lha

The MUI custom class Toolbar.mcc. Included in the archive. (MUI/libs/Toolbar.mcc)

The following string MUI custom classes may be used if available:
BetterString.mcc, Textinput.mcc or Newstring.mcc.
BetterString.mcc is included in the archive. (MUI/libs/BetterString.mcc)

--------
The server to connect to must have AMarqueed V50 or better installed for everything to work right.

@endnode

@node "Install" "Installation"
				@{TI "Installation"}

Just start the Installer program!

If you don't want do that, do this:
Just copy all the files to wherever you want, but please preserve the file structure.

Choose which graphics-set you want to use. Rename the directory MWBImages to Images to use the MagicWB(8-colour)-set. If you want to use the NewIcons(20-colour)-set rename the NIImages directory to Images. The same applies to any image set.

Make sure to update the images for every now version of AmiComSys (some additional images with 2.0).

If your AmiComSys screen has a lower size than 640x512 you shouldn't use the MagicWB-graphics-set. It's probably too big.

If you put AmiComSys in the WBStartup drawer you must set the PROGDIR ToolType to the path of your AmiComSys directory.
If you don't arexx scripts will not work. (SendWEB, SendFTP & SendIRC and the other ones in the rexx/ directory ). Neither will the toolbar images be found.

If you're using a multiuser-system that Tooltype could be set to a directory in your HOME: assign. Please make sure that whole AmiComSys distribution is available there.
 
I recommend you to check the Time Zone settings (under the Program page-Various-tab).
The time zone should be right if you have configured Workbench Locale preferences appropriate.

@{b}If your computer is behind a fire wall, a NAT server, ISDN/ADSL/Broadband router, MLink, Slirp, or a shared Internet connection with another computer, you have to set the FireWall checkbox in the network settings.@{ub}

All the @{"requirements" link "Requirements"} must be satisfied.

@endnode

@node "upgrade" "Upgrade to 1.31"
			@{TI "Upgrade from an earlier version"}

You should use the installation program.

If you don't want to do that, follow the @{"installation" link "Install"} instructions.

New files compared with version 2.2
------------------------------------
AmiComSys
AmiComSys.guide

New files compared with version 2.1
------------------------------------
AmiComSys
AmiComSys.guide
libs/amarquee.library

New files compared with version 2.0
------------------------------------
AmiComSys
AmiComSys.guide
libs/amarquee.library

New files compared with version 1.34
------------------------------------
AmiComSys
AmiComSys.guide
NIIMages
MWBImages
MWBImages2
RomIcons
libs/amarquee.library

@endnode

@node "files" "The files in your AmiComSys directory"
					@{TI "The files in your AmiComSys directory"}

Maybe you wonder what all the files which AmiComSys has created in your AmiComSys directory do. Some of them are obsolete today and may be deleted.

Files of use in AmiComSys version 2.0+
--------------------------------------
.buddybook - The friendsbook is saved into this.
.ignorelistv2 - The Ignore List is saved into this.
.lastinfoupdate - Caches the information in the upper part of main window.
.lastmessageindex - An internal number of the last seen system message.
.mhistory - The message history is saved into this.
/mhistory directory. The message history texts is saved to files in this directory.
AmiComSys.prefs - The settings are saved into this.

Obsoleted with version 2.0 (were used in version 1.25-1.34)
-----------------------------------------------------------
.ignorelist - The Ignore List is saved into this.

Obsoleted with version 1.20 (were used in version 1.19g)
--------------------------------------------------------
.friendsbook - The friendsbook was saved into this.
.friendsbook.bak
.msghistory - The message history was saved into this.
AmiComSys.config - The settings were saved into to this.

Obsolete. (Could safely be deleted).
------------------------------------
AmiComSys.data - Was used by the obsolete Gadtools version a long time ago,
to save the window positions.


@endnode

@node "Usage" "Usage"
								@{TI "Usage"}

@{b}If to use it from Workbench:@{ub}

Just doubleclick the icon.

For settings you should pick the General item in the @{"settings-menu" link "Settings"}.

If you want to read about the features, press {"this" link "features"}.

@{b}TOOLTYPES:@{ub}

CX_POPUP=Yes/No: 
Should AmiComSys open its window at startup? Default is Yes.

CX_POPKEY=lalt shift a :
The hotkey which will cause AmiComSys to Show its Main Window.
Default is lalt shift a.

CX_PRIORITY= -128 - 127 :
The commodities priority. Default is 0.

Server = anyhost.domain.anywhere :
The server which AmiComSys will connect to. Defaults to amicomsys.dhs.org.

Port = amarqueed port:
The AMarqueed port which the server uses. Defaults to 2957, which is the official AMarqueed Port.

MULTIPLE = Yes/No:
If yes, several copies of AmiComSys may be started. Bear in mind that they must connect to different servers for this to work. It's possible to fake this if you connect to localhost and set the environmental variable AMARQUEED_FAKECLIENT to different hostnames.
e.g. setenv AMARQUEED_FAKECLIENT /number.com/AmiComSys
@{b}You should never set this to Yes, unless you like to run AmiComSys connected to a local server on your Amiga, or connect to several servers.@{ub}
Default is No.

REALNAME = Yes/No:
If yes, AmiComSys will read the environmental variable REALNAME and use its value as RealName. Miami sets this variable automatically.
Default is Yes.

USERNAME = Yes/No:
If yes, AmiComSys will read the environmental variables LOGNAME, USER or USERNAME and use its value as Login. Miami sets USERNAME automatically.
Default is Yes.

LOGIN = <username>:
The loginname you want to use in AmiComSys.

NAME = <realname>:
The realname you want to use.

COMMENT = <comment>:
The comment you want to be showed next to your name.

EMAIL = <your email>:
Your email address. It will not be showed for others, if you don't want to, and it is your unique id on the server.

HOMEPAGE = <your homepage address>:

FTPSITE = <your ftp site address>:

RECONNECT = Yes/No:
Specify if you want AmiComSys to try to reconnect when no connection could be established or the connection is lost, or just quit. Useful if you start AmiComSys from an Online-script. Defaults to Yes.
If you put AmiComSys in the WBStartup drawer RECONNECT should be Yes, and if you run AmiComSys from an Online-script RECONNECT should be set to No.
If yes, AmiComSys will try to reconnect one time every minute if connection is lost.
If you run Genesis or Miami your Online status will be checked before trying to connect.
The problem is if you set this to NO, and the server reboots AmiComSys will quit. So probably it's better to set it to YES, and shut it down via Arexx when you go offline.

PROGDIR = <path to your AmiComSys directory>
Set it to the path to your AmiComSys directory if you start AmiComSys from another directory than it's own, e.g. WBStartup drawer.
This is needed so AmiComSys can find the rexx and images directories and the config files.

DISABLEPLUGINS:
Don't start the installed plugins.

@{b}If to use it from Shell:@{ub}

The command line is:

AmiComSys CX_POPUP=Yes/No CX_POPKEY=hotkey CX_PRIORITY=0 Server/S Port/N
MULTIPLE=Yes/No REALNAME=Yes/No 
USERNAME=Yes/No LOGIN=<username> NAME=<realname> COMMENT=<comment>
EMAIL=<your email> RECONNECT=Yes/No HOMEPAGE=<your home page> FTPSITE=<your ftp site>
PROGDIR=<path> DISABLEPLUGINS

All tooltypes above can also be used exactly the same as command
line arguments.
e.g. AmiComSys Server=amicomsys.dhs.org Port=2957 Reconnect=No

@{b}@{b}
For more settings see @{"Settings" LINK "Settings"}.

@endnode

@node "Settings" "Settings"

					   @{TI "Settings"}

The settings window will appear if you pick the menu item Settings/General.
With it you can set the settings which AmiComSys will read in at startup. The settings is saved to the file AmiComSys.prefs
If you start AmiComSys without command line arguments all settings in that file will be used.
Parameters given as TOOLTYPES when you start from WorkBench or as command line arguments from CLI @{b}will override this settings@{ub}.

The GUI-positions will also be saved.

@{b}General@{ub} settings:
Pages:
@{"Personal" link "personalsettings"} - Personal and System Info
@{"Network" link "networksettings"} - Server and Security
@{"Program" link "programsett"} - Program and Various
@{"Windows" link "windowsettings"} - Chat, message, newmsg and History windows
@{"Misc" link "miscsettings"} - Scripts and paths.
@{"Client list" link "clientlistsetting"} - The client list. Show friends/Hide others etc.
@{"Sounds" link "soundssetting"} - Sounds/Samples.
@{"PlugIns" link "pluginsettings"} - Install/Installed plugins.
@{"Tools" link "toolssettings"} - Installed scripts and external programs which will appear in the Tools menu.
@{b}Save@{ub}
Use and save the settings to disk.
@{b}Use@{ub}
Use the new settings without saving it to disk.
@{b}Cancel@{ub}
Forget any changes made to the settings.

@{b}Notice that the TOOLTYPES will override the saved values in the file AmiComSys.prefs. So if you change something in the settings and it does not seem to be changed the next time you start AmiComSys you probably have set the same KEYWORD in the ToolTypes to another value.@{ub}

@endnode

@node "personalsettings" "Personal & System Settings"

			  @{TI "Personal & System info settings"}                   

@{HI "Tab - Personal info"}

@{b}Email@{ub} - Same as TOOLTYPE EMAIL
Your email address. It is your unique name on the server. So it's very important that you enter your real unique email-address.
It will never be showed to another user, if you don't want to. It is just used internally.

@{b}Public@{ub}
If you check this checkbox your email address will be showed in the client info window and other's Friends books.

@{b}Login@{ub} - Same as TOOLTYPE LOGIN 
The Loginname you want to use in AmiComSys.

If the checkbox is unchecked then AmiComSys will get the login name from the environmental variables USER or USERNAME.
Same as ToolType USERNAME.

@{b}RealName@{ub} - Your real name.

If the checkbox is unchecked then AmiComSys will get the real name from the environmental variable REALNAME.
Same as ToolType REALNAME.

@{b}Comment@{ub} - The comment you want to show beside your username in AmiComSys. The maximum numbers of character is currently 150.

@{b}HomePage@{ub} - Same as TOOLTYPE HOMEPAGE
Here you can advertise your homepage. It must start with http://
e.g. http://www.parting.nu

@{b}FTPSite/HomePage2@{ub} - Same as TOOLTYPE FTPSITE
Here you can advertise your FTP-server-address or a second home page address. Set the cycle to http:// for a second homepage and ftp:// for a ftp-site. No need to start the address with ftp:// or http://.
e.g. ftp://amigas.dyn.ml.org
 
@{b}IRCServer-Path@{ub}
Here you can advertise your own IRC-server-address. It must be entered in the following way:
host/#channel
e.g. myownhost.com/#myownchannel
e.g. myownhost.com myIrcTCPport/#myownchannel
@{HI "Don't forget the slash, /, between the host address and channel ..."}

@{HI "Tab - System info"}

Here you may enter some info about your system and yourself.
@{b}Location (country)@{ub}
Enter the country you're living in.

@{b}Configuration@{ub}
Enter your computer configuration.
e.g. Amiga 4000, Cybergfx etc.

@{b}Programs@{ub}
Enter programs you use and like.

@{b}Personal interests@{ub}
Enter your personal interests here.

@{b}Picture (photo) http://@{ub}
Add a link to a photo of yourself here. It must be placed on a web-server.
No need to start with http://
It will be used in the PChat. You can link to the same photo as you use for YAM 2.0. The dimension of it should be 72x100, but could be any size smaller than 400x400 for AmiComSys version 1.31+.
The format of the picture must be JPG, GIF or PNG (for cross platform compatibility).

@{b}ICQ UID@{ub}
Here you can advertise your ICQ UIN. It will be showed in the client info, and people can click it to go to your ICQ message center.

@endnode

@node "networksettings" "Server & Security Settings"

						@{TI "Network settings"}

@{HI "Server tab:"}
@{HI "Server settings group:"}

A list where you may add serveral server names and ports which you then may choose from.

@{b}Server@{ub} - Same as TOOLTYPE Server 
The AMarqueed server AmiComSys will connect to. Defaults to amicomsys.dhs.org. Instead of the hostname the IP-address may be given.

@{b}Port@{ub} -Same as TOOLTYPE Port 
The port which AmiComSys connects to the server. Defaults to 2957, which is the official AMarquee Port.

@{HI "Proxy settings group:"}
Check the checkbox if you want or need to use a HTTP-proxy to download pages or files from web servers. Enter the proxy server name and port in the appropriate text boxes.

@{HI "Security tab"}

@{HI "Banned users (ignore these)"}
Insert people into this list if they harass you. All you have to do is enter their realname and/or nick name. They will then banned from your host, and can't send messages to you. There is a better and more efficient option, see @{"Ignore-List" link "ignorelist"}

@{b}Enable MultiMess@{ub}
This must be checked if you want to receive messages sent with pattern matching (MultiSend).
<Always enabled in the unregistered version>

@{b}Enable Messages@{ub}
This must be checked if you want to receive messages.
<Always enabled in the unregistered version>

@{b}Enable Message-Center@{ub}
This must be checked if you want to receive messages from the message center
at the AmiComSys home page at http://surf.to/AmiComSys/

@{b}Enable SendFile@{ub}
This must be checked if you want to be able to receive files.
<Always enabled in the unregistered version>

@{b}Enable PChat@{ub}
This must be checked if you want to be able to receive Private Chat requests.
<Always enabled in the unregistered version>

@{b}Hide my IP-address/hostname@{ub}
Check this if you don't want other people to see your ip-address or host name via AmiComSys.
On by default. The people which are added to your Friends book will see you host name anyway from version 2.0.

@{b}I'm behind a firewall/Internet sharing@{ub}
Check this if you are behind a firewall, proxy, NAT Server, ISDN/ADSL/Broadband router, Slirp, or are using a shared Internet connection from another computer or don't have a public IP-address for another reason. If not, people can't connect to you via PChat or SendFile.
If you don't know what a firewall is you'd better leave this unchecked, but if you notice that people can't connect to you via PChat or SendFile you could test to check this.

@{b}These ports are redirected to this machine:@{ub}
If you are behind a firewall or Internet sharing and the one which you try to connect to via PChat and SendFile also is behind a firewall or Internet sharing or the other way around it won't work.
Then you have to open two ports in the firewall/router and redirect them to your machine via NAT.
Enter the ports you have chosen in the text boxes below this item.
If you are several hosts using AmiComSys on a LAN you would setup differant ports for either machine.

@endnode

@node "programsett" "Program Settings"

		 @{TI "Various program settings"}

@{HI "Tab - Program"}

@{HI "Program function group"}

@{b}Multiple copies@{ub} - Same as TOOLTYPE MULTIPLE
If checked, Several copies of AmiComSys may be started. Bear in mind that they must connect to different servers for this to work. It's possible to fake this if you connect to localhost and set the environmental variable AMARQUEED_FAKECLIENT to different hostnames.
e.g. setenv AMARQUEED_FAKECLIENT /amiga.com/AmiComSys
@{b}You should never check this, unless you like to run AmiComSys connected to a local server on your Amiga, or want to connect to serveral servers.@{ub}
Default is unchecked.

@{b}Reconnect@{ub} - Same as TOOLTYPE RECONNECT
Specify if you want AmiComSys to try to reconnect when no connection could be established or the connection is lost, or just quit. Useful if you start AmiComSys from an Online-script. Defaults to Yes, i.e. checked.
If you put AmiComSys in WBStartup drawer RECONNECT should be Yes, and if you run AmiComSys from an Online-script RECONNECT could be set to No, but should probably be set anyway, in the event the server is rebooted.
If yes, AmiComSys will try to reconnect one time every minute if connection is lost and Miami or Genesis says you are still Online.

@{fg shine}Iconification group@{fg text}
@{b}CloseGadget iconifies the main window@{ub} - If checked the AmiComSys Main Window will enter iconified state when you press the close button. If not it will quit AmiComSys
The window can be deiconified again by using the hotkey or by clicking the icon.
Default is unchecked.

@{b}No GUI at startup@{ub}
AmiComSys will start iconified and without any allocated GUI.

@{b}Show icon@{ub}
Show an icon on the workbench when a window is in iconified state.

@{b}Show menu@{ub}
Add a menuitem to the workbench tools menu when the window is in iconified state.

@{b}Set icon-position@{ub}
Set the Workbench position of the main AmiComSys icon here. With Amiga OS 3.5+ it's easier to use the "save icon position" menu item in the Workbench icon menu.

@{b}Main Window Hotkey@{ub}
Set the hotkey to use to open up or iconify the main window. If the "HotKey always uniconify" checkbox is checked the hotkey will always uniconify the window, if not it will toggle between uniconified and iconified state.

e.g. lshift lalt a

@{b}Application Hotkey@{ub}
Set the hotkey to use to open up or iconify the whole application, i.e, all windows that is is open or hidden. If the "HotKey always uniconify" checkbox is checked the hotkey will always uniconify the window, if not it will toggle between uniconified and iconified state.

e.g. lshift lalt s


@{HI "Tab - Various"}

@{HI "TimeZone settings group"}

@{b}Get GMT offset from@{ub}
The number of hours from Greenwich Mean Time is read from Locale-preferences by default, but if it is not right you can set it with the popup-menu.

It shall be in hours from GMT. If your time zone for instance is one hour (+0100,MET) east of GMT set it to GMT + 01 Hour. It shall be negative if your time zone is west of GMT, and positive if you live east of GMT.

If you do not set this correctly the time stamp on your messages won't be right.
(The online time will be wrong too ...) (Not for you, but for others ...)

@{HI "Use string class settings group"}
Choose the string-gadget you like best ... It will be used in every stringgadget, except for the comment field in the Friendsbook.
AmiComSys will restart for this setting to take effect.

@{b}BetterString.mcc@{ub}
Use BetterString.mcc (found in AmiComSys's archive)

@{b}Textinput.mcc@{ub}
Use Textinput.mcc (found at ftp://ftp.vapor.com/misc/)

@{b}Newstring.mcc@{ub}
Use Newstring.mcc. (found in the iBrowse archive)

@{b}String.mui@{ub}
This the normal string-gadget which comes with MUI.

@{fg shine}Answerbox settings group@{fg text}
If you want another message than default to be sent to users trying to contact you while you are away you can enter your own text here.
(With away means that you have set the  status popupmenu, found in the main window, to Away.

@{fg shine}Logging group@{fg text}
AmiComSys can log onlines, offline and updates to a file.
@{b}Path@{ub} - The path to where you want to save the log file.

@{b}Level@{ub} - The logging level:
	None - No logging.
	Simple - Onlines and offlines is logged.
	Everything - In addition to above program end and start and client info updates is logged.

@{b}Append date@{ub} - Today's date will be appended to the file name.

@endnode

@node "windowsettings" "Window Settings"
					   @{TI "Window settings"}                   

@{HI "Tab - Chat Windows"}
@{b}Name Column Display:@{ub}
Specify how the username shall be shown.
Realname & username, Realname, or just Username.

@{b}PChat:@{ub}
Put Picture -
to the right, at the bottom or don't show any.
Specify where you want the photo to be placed.

@{b}Add chat lines to the @{"Message History" link messhistory}:@{ub}
Check this box if you want the PChat chat lines to be inserted into the Message History.

@{b}Popup window when message arrives:@{ub}
Check this box if you want the PChat window to popup from iconified state when a new message arrives.

@{HI "Tab - Message History Window"}
@{b}Name Column Display:@{ub}
Specify how the username shall be shown.
Real name, or nick name.

@{b}Auto save history@{ub}
If this is checked the message history will be saved when you quit or disconnect AmiComSys.
It will be restored the next time you start AmiComSys.
<Disabled in the unregistered version>
 
@{b}Flow@{ub}
In what direction should the entries flow. Top to Bottom, or Bottom to Top.

@{HI "Tab - Message requester settings:"}
@{HI "Screen settings group:"}

@{b}Screen to open on@{ub}
Specify which kind of screen you allow the message requesters to open
on.
Default is Front most screen.

@{b}Put screen to front@{ub}
Should the screen which the requester opens on be brought to front.
Default is no.

@{HI "Action group:"}

@{b}Use MUI requester@{ub}
Shall the requester use MUI, or Gadtools. Default is checked.

@{b}Snapshotable requesters@{ub}
Shall the message requester windows be snapshotable, i.e. they retain their last position and size. Default is unchecked. If unchecked AmiComSys will calculate a suitable size.

@{b}Send confirmation (Send-button)@{ub}
Specify if you want a requester to pop up when you send a message asking you if you are sure you want to send it.
<This may only be turned off in the registered version>.

@{b}Send confirmation (Return-key)@{ub}
Specify if you want a requester to pop up when you press the Return key to send a message. Note that the previous setting must be unchecked when you uncheck this. If not it will not take effect.
<This may only be turned off in the registered version>.

@{b}Close requester after send@{ub}
Should the message requester close when you press the send button.
Default is no. <And this feature is only for registered users.>

@{b}Max-horiz-chars@{ub}
Specify the width of the requester in characters.
Defaults to 50 characters.

@{b}Activate delay@{ub}
The time since the last key press you allow a message requester to steal the current focus. Time in seconds.
0=steal the focus whenever it want.
Default is 1 second.
This setting is here to prevent you from accidentally enter information in the wrong window.

@{HI "Tab - New Msg window settings:"}

@{b}Use multiline text field@{ub}
Textinput.mcc v.18+ is required. If checked multiline text fields are used in the New Msg windows.


@endnode

@node "miscsettings" "Misc Settings"

				   @{TI "Misc settings"}                   

@{b}Use NotifyArexx.amicomsys@{ub} - Check this box if you want to use the @{"NotifyArexx feature" link "notifyarexx"}.
<Unregistered users cannot use this feature.>

@{b}Use MessageArexx.amicomsys@{ub} - Check this box if you want to use the @{"MessageArexx feature" link "messagearexx"}.
<Unregistered users cannot use this feature.>

@{b}Replace ACS's requester@{ub}
Should the MessageArexx.amicomsys arexx-script replace ACS requesters if enabled.
Defaults to yes.

@{b}WEB-Browser-Path@{ub} Type in the path to your web-browser (e.g. Ibrowse, Voyager or AWeb) here. It will be used by the SendWeb-function.
If OpenURL.library is installed this will be disabled, and OpenURL is used instead. Then use the OpenURL prefs utility.

@{b}FTP-Program-Path@{ub} Type in the path to your ftp-client (e.g. AmFTP, AmiTradeCenter) here. It will be used by the SendFTP-function.

@{b}IRC-Client-Path@{ub} Type in the path to your irc-client (it must currently be AmIRC) here. It will be used by the SendIRC-function.

@{BO "SendFile Save-path"} Type in the path to the initial directory of the SendFile save requesters.

@{BO "SendFile Load-path"} Type in the path to the initial directory of the SendFile load requesters.

@{BO "Picture directory"} Type in the path to the directory where you want to save photos you download via PChat. This you could be the same directory as you use for YAM 2.0 photos. Defaults to PROGDIR:pictures
 
@endnode

@node "clientlistsetting" "Client List settings"

				   @{TI "Client list settings"}

On this page you may customize your client/contact list.

@{BO "Show list title"}
Check this if you want the client list to have a title.
Checked as default.

@{BO "Show Mode"}
Choose if you want all clients connected to server to show up in your client list.
You may choose from:
@{HI "Show all."}
@{HI "Highlight friends"}. Clients which can be found in your friends book will be highlighted.
How they are highlighted can be specified as presented below.
@{HI "Show only friends"}. If you choose this, only the friends found in your friends book will show up in the client list. There will be three sections in the list:

Online - People which is online.
Offline - Friends of you which is offline.
New friends - People not friends of you who have sent you a message during the current session.
 
@{BO "Show which information"}
What information do you want to see in the client list?
* Loginname, Realname, Host and comment.

@{BO "Way of highlighting"}
How friends are highlighted. Choose from italize, highlight pen or bold. 


@endnode

@node "soundssetting" "Sounds/Sample settings"

				   @{TI "Sounds/Sample settings"}

AmiComSys may play sounds at certain occasions. All sample data types which are supported by your data type installation may be played.

Set the cycle gadget to the type of sound to play. Choose between nothing, beep and sample. If you choose to play a sample enter the filename to where the sample may be found on your disc.

A number of samples are in the sounds directory.

@{b}New Message@{ub}
Sound to play when a new message is received. 

@{b}Go online@{ub}
Sound to play when you go online. 

@{b}Go offline@{ub}
Sound to play when you go offline. 

@{b}Buddy online@{ub}
Sound to play when one of your friends go online. The friends shall be in your Friendsbook.

@{b}PChat request@{ub}
Sound to play when someone wants to PChat with you.

@{b}SendFile request@{ub}
Sound to play when someone sends you a file. 

@{b}PChat New Message@{ub}
Sound to play when a new chat line is inserted into the PChat window.
 
@endnode

@node PLUGINS "Plugins for AmiComSys 2.0"

				  @{TI "PlugIns for AmiComSys 2.0"}

Plugins for AmiComSys are normal Amiga OS executables, which implements a common interface according to the @{"AmiComSys Plugin SDK" link THEPLUGINSDK} (current version is 1.33).
Plugins may extend AmiComSys by adding menu items and menus, and also have their main interface inside AmiComSys main window. You can switch between the AmiComSys GUI and the plugin GUI with the @{"Plugin Selection bar" link Features} or "View/Switch to plugin" menu.
They may be fully integrated inside AmiComSys by utilizing the message requesters, Message history, Task list and the Ignore list.

To install or remove a plugin use the @{"plugins settings" link pluginsettings} in the general settings.

The current plugins available for AmiComSys is:

HL Plugin 1.0 (2001-11-25)
--------------------------
Written by Håkan Parting.

HL-Plugin is an Amiga port of the famous Hotline Client for Mac and Windows.
It is in the same category as AmiComSys, i.e. an online chat program.

It runs as a plugin inside AmiComSys 2.0+.

The Hotline system is made up of:
* The Hotline Client - the client that connects to the server
* The Hotline Server - the server to connect to
* The Hotline Tracker - keeps track of the servers that are available

For more information visit:

http://www.bigredh.com
http://www.vivahx.com

Download it from http://parting.nu/AmiComSys/ (on the download page's plugin tab)

@endnode

@node pluginsettings "PlugIns settings"

				  @{TI "PlugIns settings"}

The list shows all installed plugins with path to the executable and the path to the prefs file for the plugin.

There are two buttons:
@{b}New@{ub}
If you press this button a new entry is added to the list. The plugin directory path is added to the PlugIn-path text field. Enter the full path including filename to the plugin you want to add. You could also press the button to the right of the text field to open up a file requester.
@{b}Delete@{ub}
Press this button to remove the seleced plugin.

Below the buttons there are two text fields:
@{b}PlugIn-path@{ub} - change this to the full path of the plugin executable, either by typing it in or using the file requester.
@{b}Prefs-path@{ub} - change this to the full path to the prefs file for the plugin. This is automatically filled in when you enter a new plugin-path. If you run the same plugin twice they should have two different prefs-files.

<An unregistered version of ACS can only handle two plugins>

@endnode

@node toolssettings "Tools settings"

				  @{TI "Tools settings"}

The tools added to this list will be added to the @{"Tools menu" link arexxmenu}.
It could be utilities or games which needs arguments which AmiComSys can provide, like the IP-address. It could be arexx-scripts but also normal executables.

The list shows the currently configured tools and their arguments.

Below it there are a couple of buttons:
@{b}New@{ub}
If you press this button a new entry is added to the list. The Script path text field is filled with the path to the Rexx direcory. Enter the full path to the script or executable you want to run.
@{b}Delete@{ub}
Press this button to remove the selected entry.

Below the buttons there are two text fields and a cycle gadget:
@{b}Script-path@{ub} - change this to the full path including file name of the script or exectable you want to run.
@{b}Script-arguments@{ub} - enter the arguments to the tool. By opening the popup window you may add placeholders for common items, like host name and user name.
@{b}ARexx/shell@{ub} - Select which type of tool you want to run.

@endnode



@node "Features" "Features"

							@{TI "Features"}

The AmiComSys GUI is rather self explainable as most items implement bubble help. So place the mouse pointer on the button and wait a while to get a description.

There are seven different windows in addition to the main window, from where you can reach all the other ones. Most windows may be opened from the View menu; the About window is found in the Project menu and the General settings window in the Settings menu.

@{HI "The Main Window:"}

The main window is fully configurable; all the bars may optionally be shown or hidden.
Use the View/Toolbars menu to show or hide the bars. The bars are positioned around the client/contact list.

It's possible to drag and drop all the components in the Main Window, to modify its positions. By saving the settings it will stay the same the next time you start AmiComSys.
This won't be saved in the unregistered version.

The client list, the toolbars, and the other GUI-components have their own context menu. Press the right mouse button to see it!

The GUI-components in the same area may be moved down by picking the "Top to Bottom" menu item.

@{b}Client/contact list@{ub}
Shows all the people online. In the "settings menu/show in list" or the @{"Client list settings" link "clientlistsetting"} settings you may set how the people are presented. There are a context menu where you may do a couple of actions on the selected client.
By double clicking on a client a new message window will appear where you may enter a message to send. @{"More info" link clientlist}.

@{b}Big toolbar@{ub}
This toolbar contains a couple of actions:

@{fg fill}PChat@{fg text}
Initiate a personal chat session with the selected client. In difference to the Text Message feature below all messages a shown in the same window. @{"More info" link pchat}.

@{fg fill}Hotline@{fg text}
Opens the Hotline chat window. This is a public chat window. @{"More info" link hotline}.

@{fg fill}Send file (SendF) @{fg text}
Send a file to the selected client. @{"More info" link sendfilebut}.

@{fg fill}Version (Vers) @{fg text}
Used to check the version of AmiComSys the client is using. @{"More info" link versionbut}.

@{fg fill}Friends book (Buddy) @{fg text}
Opens the friends book. @{"More info" link friendsbook}.

@{fg fill}Add selected client (Add) @{fg text}
Adds the selected client to the Friends book. @{"More info" link addbutton}.

@{fg fill}New message (Msg) @{fg text}
Send new message to the selected client. @{"More info" link sendbut}.

@{fg fill}New multi-message (MuMsg) @{fg text}
Send new message to the a pattern of clients. @{"More info" link sendbut}.

@{b}Small toolbar (chat)@{ub}
Contains the Pchat, Hotline, Send file and Version buttons as above.

@{b}Small toolbar (friends)@{ub}
Contains the Friends book, Add selected client, New message and New multi-message buttons as above.

@{b}Status bar@{ub}
Contains the status cycle gadget, where you choose an online or offline state. @{"More info" link statuscyc}.

@{b}Information bar@{ub}
Contains information from the Author. The text is occasionally downloaded from a web server.
If you get HTML tags in here check the HTTP proxy settings. @{"More info" link infobar}.

@{b}Plugin selection bar@{ub}
Switch between AmiComSys and plugins. The lower part of the main window may come from a plugin.

@{b}Send message bar@{ub}
With this bar you may send a text message to the selected client. Optionally select the type of message. Press 'send' or Enter to send the message.
For those that better like the version 1.34 way of sending messages better than the double-click and send a multi-line message procedure introduced with version 2.0+.


@{b}Close Gadget@{ub} Will iconify, or close the window depending on the @{"program settings" link programsett}.

@{HI "Menu "}

@{b}Project @{ub}
@{fg fill}About@{fg text} - Shows info about AmiComSys.
@{fg fill}Iconify Window@{fg text} - Iconifies the main window.
@{fg fill}Iconify application@{fg text} - Iconifies the whole application (all windows).
@{fg fill}Restart@{fg text} - Will restart AmiComSys.
@{fg fill}Kill GUI@{fg text} - Will go into iconified state while the GUI memory is freed. All connections are also closed. Should not be used if online.
@{fg fill}Quit@{fg text} - Will quit AmiComSys.

@{b}View @{ub}
>@{b}Toolbars@{ub}
 @{fg fill}All tools@{fg text} - show or hide all toolbars
 @{fg fill}All scrollers@{fg text} - show or hide all the toolbar scrollbars
 @{fg fill}Big toolbar@{fg text} - show or hide the big toolbar
 @{fg fill}Small toolbar (chat)@{fg text} - show or hide this toolbar
 @{fg fill}Small toolbar (friends)@{fg text} - show or hide this toolbar
 @{fg fill}Status bar@{fg text} - show or hide the Status bar
 @{fg fill}Information bar@{fg text} - show or hide the Information bar
 @{fg fill}Plugin selection bar@{fg text} - show or hide the Plugin selection bar
 @{fg fill}Send message bar@{fg text} - show or hide the Send message bar
>@{b}Switch to plugin@{ub}
 @{fg fill}AmiComSys@{fg text} - show the AmiComSys GUI in the main window
 @{fg fill}<Place for plugin>@{fg text} - switch to the plugin's main GUI in the main window
@{fg fill}Friendsbook@{fg text} - Open the @{"Friends book" link friendsbook}.
@{fg fill}HotLine@{fg text} - Open the @{"HotLine" link hotline}, the AmiComSys public chat window.
@{fg fill}Ignore users@{fg text} - Opens the @{"Ignore users" link "ignorelist"} window
@{fg fill}Message history@{fg text} - Opens the @{"Message history" link messhistory}. All the messages you send and receive is saved to this history buffer.
@{fg fill}The Rules@{fg text} - shows the current @{"rules" link "rules"} anybody must follow on AmiComSys.
@{fg fill}Task List@{fg text} - Opens the @{"Task List" link tasklist} window, which shows all current tasks.

@{b}Tools @{ub} @{"More info" link "arexxmenu"}
@{fg fill}Execute arexx script@{fg text} - Execute an ARexx script
@{fg fill}Add arexx script@{fg text} - Add an ARexx script to the menu.

@{b}Settings @{ub}
@{fg fill}General@{fg text} - Opens up the @{"settings window" link "Settings"}.
>@{b}Show in list@{ub} - Choose if you want to show all, highlight friends, or only
						 show friends in the client list. @{"More info" link clientlistsetting}.
@{fg fill}MUI@{fg text} - Opens up the MUI-Settings.
@{fg fill}Save preferences@{fg text} -  Saves the settings to disc.

@{b}NOTE!@{ub} Plugins may add menus to the right of AmiComSys standard menus, and they may also add menu items to the standard menus.

@{fg shine}Other GUI components not mentioned above:@{fg text}
@{"Message requester" link "messagereq"} AmiComSys has its own requester.
@{"Iconify single windows" link "iconifywin"} You may iconify single windows!

@endnode

@node "clientlist" "Client List"

							@{TI "Client list"}

All visible connected clients shows up in this list. You can select an entry.

@{b}This client list is customizable in the @{"Client list settings" link "clientlistsetting"}.@{ub}

If you double click an entry, a @{"New Msg" link sendbut} window will appear where you may send a message to the selected client.

@{HL "In the first column of the list two different characters may appear:"}
A grey/silver key : The user is testing AmiComSys, and therefore is unregistered.
An orange/yellow/gold key: The user has decided to register.
'zzZ' : The user is away.
'X' : The user is busy.

@{HL "In the second column this character may appear:"}
A bubble : The user has joined the HotLine, i.e. has it opened.

Wait for the help-bubble to see the number of connected clients!

By pressing the right mouse button on the list while a user is selected a context menu will open. From it you may show user info, send a pchat, or version request. You could also send a file, or do another action on the selected user.

If you pick the "info" item a requester will appear, that contains information about the selected client.
(e.g. realname, host, login and comment, homepage, ftpsite and IRC-server)
Two buttons are always in this requester:
@{b}Get System Info@{ub} - Send a request for system info. If available you will receive a message with the client's system info.
@{b}Cancel@{ub} - Do nothing, just close the window.

Links to home pages, ftp sites, irc servers, email adsresses, and ICQ numbers may be pressed:
@{b}Web links@{ub} - Send the homepage address of the selected client to your Web browser, using the arexx script @{"SendWEB.amicomsys" link "SendWEB"} or the OpenURL.library if installed.
@{b}FTP links@{ub} - Send the ftp site of the selected client to your web browser/ftp client, using the arexx script @{"SendFTP.amicomsys" link "SendFTP"}.
@{b}IRC links@{ub} - Send the irc-server-address of the selected client to AmIRC, using the arexx script @{"SendIRC.amicomsys" link "SendIRC"}
@{b}Email links@{ub} - Sends the email address to your email client and opens a new email window, using the arexx script @{"SendEmail.amicomsys" link "SendEmail"}
@{b}ICQ numbers@{ub} - Send the ICQ message center homepage address of the selected client to your Web browser, using the arexx script @{"SendWEB.amicomsys" link "SendWEB"} or the OpenURL.library if installed.

@endnode

@node "versionbut" "Version button"
							@{TI "Version button"}

@{b}Version@{ub} - Sends a Version request to the selected client. You will then receive the version information of the AmiComSys the client is using as a text message.

The Client owner will not notice anything. If the client ignores you via the Ignore List you won't get the Version-info.

@endnode

@node "sendfilebut" "Send File"
							@{TI "Send File button"}

With this feature you can send a file to another client.

Just click the button - Pick a file and press Send.

A transmission window will open showing some statistics.

To Abort the transmission: close the transmission window.

When someone sends a file to you a requester will then open asking you whether you want to download the file or not.
 
The receiver will see a similar window, and can also abort the transmission by closing the window.

You can send or receive up to 40 files simultaneously in diferent transfer windows.

If a file that you are about to receive already is in your download directory, a requester will pop up. From it you may choose to overwrite the file or resume the download.

Every window has a Iconify Window and Close menu item.

All send file sessions are shown in the Task List, where you also may stop a transmission.

@endnode

@node "sendbut" "The Send Msg window"
						   @{TI "The Send Msg Window"}

If you press the Msg- or MuMsg buttons in the @{"Toolbars" link Features} or double click a client in the client list the New Msg window will open.

In the Upper part of the window there are three buttons:

@{b}ClientInfo@{ub} - Opens the @{"Client Info" link clientlist} for the user.
@{b}History@{ub} - Opens the @{"Message History" link messhistory} with the selected user visible.
@{b}More recipients >>@{ub} - Shows or hides the part of the window where you may add or delete recipients. See below for more information.

Below those buttons there is a cycle gadget where you may choose which time of message to send:
@{b}Message@{ub} - A text message.
@{b}IRC request@{ub} - A chat request. Use this if you want to chat with someone using IRC. Type in the IRC channel in the message field.
@{b}WEB request@{ub} - A WEB request. With this you can send a home page address to a client. Type in the home page address in the message field. The receipient will then get a requester asking him/her if he/she wants to show the specified page.
The web address will then be sent to his/her web browser using the arexx script @{"SendWEB.amicomsys" link "SendWEB"}.
Ibrowse, Voyager, AWeb and Amosaic is supported. ARexx must be running. The Arexx-server is started with the RexxMast program found in the SYS:system directory. If your web-browser is not running AmiComSys will start it. See @{"SendWEB.amicomsys" link "SendWEB"}.
If you have installed the new OpenUrl.library it will be used instead. Make sure that the OpenURL prefs is okey.

In the middle there is a text field where you enter your message. There is maximum number of characters limit of 1000.
The @{"Send button" link "sendbut"} is automatically pressed if you press enter in this gadget.
There's a timeout for every client, to protect from bombings. When you have sent a message to a client you must wait 8 seconds before you can send a message to the same client again.

A confirmation requester will pop up before it is sent, asking if you are sure.

The @{"send confirmation" link "programfunction"} may be turned off. (only for registered users.)

@{fg shine}The more recipients >> button@{fg text}
At the top of this area there is a cycle gadget. Use it to specify if you want to send to individual users or to a group of users using a host pattern.

@{fg fill}Individual: @{fg text}
@{b}Add@{ub}
Used to add the recipients for the message.
Adds the selected user in the client list. You could also drag and drop from the @{"client list" link clientlist} to add recipients.

@{b}Delete@{ub}
Deletes the selected user.

@{b}Clear@{ub}
Removes all recipients.

@{fg fill}Pattern: @{fg text}
If you press the MuMsg button in the toolbar the cycle gadget will automatically be set to 'Pattern'.

In the pattern text field you may enter a wildcard that specify which hosts shall receive the message.
e.g. #?.se will send the message to every Swede, which is connected to the server.
#? will send to everyone connected to the server.

Use this sparingly. You are only allowed to send one multi-message every 10 minutes.

@{b}NOTE!@{ub} When this window was opened by pressing the Reply button in the @{"Message requester" link messagereq} the "More recipients >>" buttons won't be there. If this window was opened by a plugin the Client Info button won't be there.

If you like the version 1.34 way of sending messages take a look at the Send message bar found in the toolbars menu.

@endnode

@node "ARexx" "ARexx interface"
							@{TI "ARexx interface"}

With the ARexx interface you can receive information from AmiComSys, like clients hostname, login or name.
AmiComSys's ARexx port is AMICOMSYS, and it understands the following commands:
If several copies of AmiComSys is running they will get the names, AMICOMSYS, AMICOMSYS.1, AMICOMSYS.2 and so on.

@{b}DISCONNECT@{ub} - Log out from server.
@{b}SHOW@{ub} - Shows the main window.
@{b}HIDE@{ub} - Hide the windows.
@{b}ICONIFY@{ub} - Iconify the windows. HIDE and ICONIFY do the same thing in the MUI-version.

@{b}QUIT@{ub} - Quits AmiComSys.

@{b}STEM <var>.@{ub} - Use it with GET to get the result included in structure.
			  e.g. GET STEM info.

@{b}VAR <var>@{ub} - Copy the result to the variable <var>.

@{b}GET@{ub} - Get information from AmiComSys.
		  @{b}Parameters:@{ub}
		  CLIENTLIST - Get info from clientlist.
			  e.g. GET STEM info. CLIENTLIST
		  @{b}Results: info.<name>@{ub}
			  connected - Connected to server. 0 = no, 1 = yes. 
			  browserpath - The path to the web-browser. 
			  ftpprgpath - The path to the ftp-client.  
			  ircprgpath - The path to the irc-client.
			  status     - The current status. ONL, OFF, AWA, BUS or INV
			  numclients - Number of lines in the client list.
			  numconnected - Number of connected clients. May differ from
							 'numclients' if 'listshowmode=2'.
			  listshowmode - The show mode of the contact list. (0=all, 1=highlight
							 friends and 2=show only friends).

			  @{i}The following needs the parameter CLIENTLIST specified@{ui}
			  selected    - The index (the line in client list) of the selected client.
			  hostnames   - An array of the hostnames of the clients.
							e.g. hostnames.0 for the first one.
			  usernames   - An array of the usernames of the clients.
			  realnames   - An array of the realnames of the clients.
			  comments    - An array of the comments of the clients.
			  homepages   - An array of the homepage addresses of the clients.
			  ftpsites    - An array of the ftpsite addresses of the clients.
			  onlinetimes - An array of the onlinetimes of the clients.
			  login       - Your user name.
			  realname    - Your real name.
			  comment     - Your comment.
			  email       - Your email.
			  homepage    - Your homepage.
			  ftpsite     - Your ftpsite.
			  onlinetime  - The time when you went online with AmiComSys.

@{b}SET@{ub} - Set information in AmiComSys.
		  @{b}Parameters:@{ub}
			  LOGIN <username>  - The Login name.
			  REALNAME <name>   - The Real name.
			  COMMENT <comment> - The comment.
			  UPDATE            - Update the information on the server.
 
		To make the changes of the above item apply give the command SET UPDATE.

			  LOGPATH <path>       - The path to the logging file.
			  LOGLEVEL <n>         - The logging level.
			  SELECTED <username>  - Select the user-client.
			  HOTLINE <open/close> - Open or close the HotLine
			  MESSAGEAREXX <0/1>   - Enable/disable messagearexx.amicomsys temporarily.
									 It will not be saved to disc.
			  STATUS               - Set the current status. ONLine, OFFline, AWAy, BUSy, INVisible.
									 e.g. set STATUS AWAY

@{b}REQUEST@{ub} - Open a requester
		  @{b}Parameters:@{ub}
			  TITLE      - The title of the requester
			  BUTTONS    - The buttons. e.g. '"_Ok|_Cancel"'
			  TEXT       - The text

			  Use the rawkey 13, instead of 10 to get a newline
			  e.g.
			  NL='0d'x;
			  thetext='hello'||NL||'there'
			  REQUEST TITLE hello BUTTONS okey TEXT thetext

@{b}REQUESTA@{ub} - Open a non-blocking requester
		  @{b}Parameters:@{ub}
			  TITLE      - The title of the requester
			  BUTTONS    - The buttons. e.g. '"_Ok|_Cancel"'
			  TEXT       - The text
			  HOSTNAME   - A hostname in the format /hostname/AmiComSys
						   If specified the requester will have a string
						   gadget and a Send gadget.
						   It's the same format as the one messagearexx.amicomsys-
						   script gets from AmiComSys.
			  Use the rawkey 13, instead of 10 to get a newline
			  e.g.
			  NL='0d'x;
			  thetext='hello'||NL||'there'
			  REQUEST TITLE hello BUTTONS okey TEXT thetext
 
@{b}SEND@{ub} - Send messages or files.
		  @{b}Parameters:@{ub}
			  MSG        - Send message
			  CHAT       - Send chat request
			  WEB        - Send WEB-request

			  USER <username> - The username
			  TEXT <the text> - The text you want to send

			  FILE       - Send a file to the USER
			  NAME       - File name of the file
			  ASK        - Confirm before sending

			  rc=0 = Message was sent
			  rc=10 = Message was not sent
			  rc=1 = User answered no to the confirmation or time out now finished (15 seconds).

See rexx/AmiComSysTest.rexx for examples.

In the rexx directory there are some arexx scripts which is started at different occasions:

@{"NotifyArexx.amicomsys" link "notifyarexx"} - When the client list change.
@{"MessageArexx.amicomsys" link "messagearexx"} - When a message arrives.
@{"SendWEB.amicomsys" link "sendweb"} - Send homepage address to web-browser.
@{"SendFTP.amicomsys" link "sendftp"} - FTP address to ftp-client.
@{"SendIRC.amicomsys" link "sendirc"} - IRC address to AmIRC.
@{"SendEmail.amicomsys" link "sendemail"} - Email to for example YAM.
							 
The program includes a menu @{"Arexx" link "arexxmenu"}.

@endnode

@node "sendweb" "SendWEB"
							@{TI "SendWEB"}

You send a WEB-request by changing the message type to WEB, type the homepage address in the message field and then press SEND.

When one get a WEB-request message it pops up a requester asking if you want to show the homepage.

When you press the SHOW button the arexx script SendWEB.amicomsys is started. It will try to connect to IBrowse, Voyager, AWeb and AMosiac. If it succed it will send the homepage address to the web-browser.

If your Web-browser is not started this will not succeed.
To start it automatically: enter the path to your web-browser in the Misc-settings.
Make sure you have the latest rexx-scripts. (SendWEB.amicomsys).
Or if you have OpenURL.library installed make sure it's settings is currect. AmiComSys will use it instead. It's kinda faster than an Arexx-script, and is more customizable.
 
@endnode

@node "sendftp" "SendFTP"
							@{TI "SendFTP"}

In the client info requester, which will appear if you doubleclick on a client, you can click on the ftp-server.

When you press this button the arexx script SendFTP.amicomsys is started. It will try to connect to IBrowse, Voyager, AWeb and AMosiac. If it succed it will send the ftp address to the web-browser.

If your Web-browser is not started this will not succed.
To start it automatically: enter the path to your ftp-client in the Misc-settings.
Make sure you have the latest rexx-scripts. (SendFTP.amicomsys).

This could be changed to a real FTP client if you prefer that.
But if a web-browser is started the address will be sent to it, because they are first checked in the arexx script ...

@endnode

@node "sendirc" "SendIRC"
							@{TI "SendIRC"}

In the client info requester, which will appear if you doubleclick on a client, you can click the IRC server address.

When you press this button the arexx script SendIRC.amicomsys will be executed. It will try to connect AmIRC. If it succeds it will connect to the irc-server address.

If it does not succed, make sure you have  entered the path to your AmIRC in the Misc-settings.
Make sure you have the latest rexx-scripts. (SendIRC.amicomsys).

@endnode

@node "sendemail" "SendEmail"
							@{TI "SendEmail"}

In the message requester which pops up on the screen when some one sends you a message via the Message Center at the home page, you can press an Email button to transfer the email address of the sender to your mailer.
If the mailer isn't running it may be started from the script.

@endnode

@node "notifyarexx" "Notify ARexx"
					   
				  @{TI "NotifyARexx"}

The arexx script NotifyARexx.amicomsys is run when:
- Someone is connecting
- Someone has updated his/her info.
- Someone has disconnected.

Use this script to tell other application that the client list is updated.

This command line arguments is sent to the script:
HOST USERNAME con/upd/dis

If the hostname isn't available, i.e. hidden, N/A will be returned for HOST.

You could parse it in Arexx with
PARSE ARG host user action

con= connecting, upd=updating, dis=disconnecting

It's only for registered users.

@{HL "There's a script by Scott Beardwood at Aminet:comm/net/ACS-Notify.lha"}

@endnode

@node "messagearexx" "Message ARexx"
					   
				 @{TI "MessageARexx"}

The arexx script MessageARexx.amicomsys is run when:
- A text (MSG), IRC (CHAT) or WEB -message arrives

If the 'Replace ACS's requesters' is enabled in settings this script it will take over the message handling of AmiComSys.
 
Thess command line arguments is sent to the script:
USER\\0NAME\\0TEXT\\0ACTION

You could parse it in Arexx with
PARSE ARG user '\\0' name '\\0' text '\\0' act

'act' can be msg/chat/web

An example script:

/* MessageArexx.amicomsys example
** You parse the arguments which AmiComSys send to
** this script in the following way:
user=username
name=realname
text=the message text
act= MSG, CHAT or WEB.
*/
PARSE ARG user '\\0' name '\\0' text '\\0' act

Say "User:" user
Say "Name:" name
Say "Text:" text
Say "Act:" act

It's only for registered users.

@endnode

@node "arexxmenu" "Tools menu"

						   @{TI "Tools menu"}

In the Tools menu you can execute arexx scripts or start one of the added tools, for example games, from the fast menu.

@{b}Execute arexx script@{ub} - Executes an arexx script. (An ASL filerequester pops up).
@{b}@{i}fastmenu items ,,,@{ui}@{ub} Pick one of the items and that tool will be executed.

This menu is configurable in the @{"Tools settings" link toolssettings}.

There are some scripts in the rexx/ directory:

Ping.rexx - Pings the selected client. (A window is opened).
Finger.rexx - Fingers the selected client. (A window is opened).
AmiComSysTest.rexx - Outputs the whole client list to a window.

Note that these scripts will not work if you do not have ping or finger
in the AMITCP:bin/ or MiamiXXXXX in the MIAMI: directory.

If you want another program to use the host name of the selected client, just make a copy of the Ping.rexx script and make appropriate changes.
Note that this may be sent as arguments to the program too.

ADDRESS AMICOMSYS;
OPTIONS RESULTS;

GET stem info. CLIENTLIST;
/* "stem info." inserts the results to the structure 'info.'. */
/* "var s" would have inserted all the results to one string in s. */
/* "CLIENTLIST": We want to read the client list information. */
s=info.selected;
ADDRESS COMMAND "AMITCP:bin/Ping " info.hostnames.s;
/* To start another application just change ping to any other
program name */


@endnode

@node "hotline" "Hot Line (Public chat)"

					   @{TI "HotLine (public chat)"}

This is a public chat window.

You only receive chat messages when the HotLine window is opened (to iconify is not to close).

@{b}Topic:@{ub} Here you enter the topic, if you want to change it.
@{b}Say:@{ub} Here you enter what you want to say.
@{b}Online/Offline-button:@{ub} Press this if you want to disconnect while the window is opened. You can reconnect by pressing the Offline-button, which then will change to online-mode.

Note: All people who have their Hotline-window open will have a "bubble" in front of their username in the clientlist.

Messages that are addressed to you (message beginning with your loginname) will be highlighted.

When someone enter or quit the HotLine a notification will be inserted into the list (From <System> and is italized).

The username display is configurable in the @{"Chat-settings." link "windowsettings"}

The chat-textinput-field have some @{"keybindings" link "chatwkeybindnings").

@endnode

@node "pchat" "Private chat"

						 @{TI "Private chat"}

If you press the PChat button you will connect to the one selected in the client list.

A private chat window, which work almost the same as the one in the @{"Hotline" link hotline}, will open.

With this feature you can chat with somebody while looking at a photo, if available, at the one you are talking to.

A request for a private chat will be sent to the remote host. If he/she accept you're connected, and you may exchange text messages.

@{b}Say:@{ub} Here you enter what you want to say.

In the lower part of the window a status text shows up. It will for the most part tell which clients the window is connected to, or if the connection went broken.

The window has a menu:
@{b}Project menu@{ub}
@{fg fill}Iconify window@{fg text} - Iconify this window.
@{fg fill}Save as@{fg text} - Save text buffer.
@{fg fill}Quit@{fg text} - Close the connection and the window.

@{b}Action menu@{ub}
@{fg fill}Clear buffer@{fg text} - Clear the whole text buffer.
@{fg fill}Invite selected user@{fg text} - With this feature you can connect to the client selected in the main window.
Use this item to chat with multiple clients!

If a photo of the remote user is available a button will appear at the top.
Press it to download the photo. Save it the Pictures directory of the AmiComSys home directory or where you have set in the Misc-settings-Picture directory.

One window can be connected to an @{b}unlimited number of clients@{ub}. You will act as a server for the clients you have connected. All you say will be sent to all the others, which you are connected to in that window. What all the clients which you have connected say will be sent to all the others which you have connected.

So if you close the window the others which you have connected will also lose the "connection" to each other.

With this feature it is possible to talk to all your buddies at the same time.
But if the ones you have connected wants to keep talking to eachother when you must break your connection, they must connect to each other. Do this with the "Invite selected client" menu item.

Learn it by testing ...
 
The username display is configurable in the @{"Chat-settings." link "windowsettings"}

The chat-textinput-field have some @{"keybindings" link "chatwkeybindnings").

@endnode

@node "iconifywin" "Iconify Single windows"

					   @{TI "Iconify Single windows"}

Every window has a menu item named Iconify Window in it's project menu. The shortcut is 'Right Amiga i'.
By picking this menu item you may iconify the window which is currently activated.
You can also click the MUI-iconify-button in the upper right corner of the MUI-window-frame (if you have decided to show that button in the MUI-prefs).

By choosing Iconify application in the menu or the MUI-frame-menu item 'Iconifiy' you can iconify the whole application. The MUI-iconify-button iconize only the active window.

The main window or the whole application may also be iconified with their respective hotkey.

If you iconify the main window or the whole application it may be deiconified by:

* pressing the hotkey. (default Left Shift -Left Alt- A for the Main Window)
* pressing the application hotkey.
* double clicking the icon on the workbench. (If show icon is on)
* choosing the menu item in the Workbench tools menu. (if show menu is on)

NOTE: Don't set the HotKey setting in the MUI-prefs. To set the the HotKey for the AmiComSys Main Window, open the ToolTypes and set CX_POPKEY.
Default is CX_POPKEY=lalt lshift a
Hotkey= Left shift, Left Alt and the a-key
It could also be set in the Iconification settings found in the @{"Program settings" link programsett} of AmiComSys.
Note that the Tooltype will override the setting in the AmiComSys settings!
So insert a couple of pharanteses in front and after the "ToolType" CX_POPKEY if you only want to use the setting in the preferences.

@endnode

@node "chatwkeybindnings" "Chat Window's keybindings"

					   @{TI "Keybindings in chat windows"}

There are some keybindings for the chat-textfields in the chat windows (hotline & pchat).
@{b}TAB@{ub}
If you press TAB in the beginning of the line the username of the last seen user in the list will be inserted into the textfield. e.g. <TAB> goes amigafan:
It also has a expansion feature. If you write am and then press the TAB key, AmiComSys will search through the clientlist till it founds a username which is matching, for instance amigafan.

If the search word is ambigous press TAB again and the next client in the list that match the search string will be inserted.

@{b}:@{ub}
If you press ':' in the beginning of the line the last used nickname will be inserted into the textfield.

@{b}Cursor up & cursor down@{ub}
Will browse through the chat text list. Text will be inserted into the textfield.

A smiley may be entered by pressing the CTRL key while pressing the ':'-key.
How you get that ':' may differ from mine, which is "SHIFT ."

@endnode

@node "friendsbook" "Friendsbook"

					   @{TI "Friendsbook"}

You open the Friendsbook by selecting the View/Friendsbook-menuitem or pressing the "Buddy" button in the toolbar.

In it you may insert buddies':
name
username
email
comments
ICQ UIN
The path to a photo of the friend (locally on your computer).

With the 'New' and 'Remove' buttons you may insert a new one respective remove the selected entry.

If you use the Add-button in the main window you may insert the selected client into your friendsbook.
The email address will be hidden if the user has decided to make it not public.
The client will be highlighted if you use "Highlight friends"-show mode.
The email of the client will not be showed if the user have not decided to make it public. It's then hidden. If you try to insert a email in the email-textfield it will be compared against the one got from the server, and if the are the same it will be inserted into the list. If they are not a confirmation dialog will open. You should not write another email here than the one the client is using in AmiComSys, because that email will be used to recognize people.

You may also "drag & drop" a client from the Client List into the Friendsbook list to insert it!

You may also configure a couple of events here (several more is to come ...):

@{b}On the Events-tab:@{ub}
@{b}On Connect:@{ub}

Get a notification when the current user connects.

@{b}On Disconnect:@{ub}

Get a notification when the current use disconnects.

@endnode

@node "addbutton" "Add button"
					   @{TI "Add button"}

With this button found in the main window toolbars you may add clients to your friends book. The email address will be hidden if the user has decided to make it not public.
The client will be highlighted if you use "Highlight friends"-show mode.

@endnode

@node "statuscyc" "Status choice"

					   @{TI "The status popupmenu"}

With the status popupmenu, normally found in the lower part of the main window, in the Status bar, you may set a status :)

@{b}Online:@{ub}
Go online.
@{b}Offline:@{ub}
Go offline.
@{b}Away:@{ub}
You are away. An answerbox will be activated. It will send out a message to people trying to connect to you. And received messages will be saved to the @{"Message History" link messhistory} (in View menu), under "While Away".
Messages received while away will be highlighted.
Number of waiting messages will be showed in the information box at the upper part of the main window.
@{b}Busy:@{ub}
You are busy and don't want to be disturbed. Nobody can connect to you with AmiComSys.
@{b}Invisible:@{ub}
You will be invisible to all other connected. You will see the other connected but they will not see you.
@{b}Free for chat:@{ub}
You are willing to chat.

'Busy' and 'Invisible' do only work if you're a registered user.

@endnode

@node "infobar" "Info box"

					   @{TI "The info box"}

In the information box in the upper part of the main window, various information will be showed.

No text in it is hardcoded into the program. There's a cache for it named .lastinfoupdate, that  may be found in the AmiComSys home directory.
It contains the text which is presented in the Information bar. It is downloaded from a web server.

@endnode

@node "messagereq" "Message requester"

					   @{TI "Message requester"}

When you receive a new message the Message requester will pop up. AmiComSys does not use the standard Amiga OS Easy Requester because it is a modal dialog.

The features of the AmiComSys message requester is:

* It is non-blocking. May optionally be a modal dialog.
* It is centered, except when when you were using the keyboard. Then it will open in the top left corner and is then not activated.
* The buttons have these shortcuts:
	* The right button: ESCape or the underlined character.
	* The left button: The underlined character.
	* The RETURN key will press the selected button. (select with the TAB-key).
	* With the TAB-key you may cycle through the alternatives.
* It doesn't steal the current focus while you are using the keyboard. (customizable in the Window-settings.

The requester is also used to tell you other things then messages from other users.

@{fg shine}When a message from another user arrives @{fg text}

At the upper part of the window there's an icon, the real name and nick name of the sender and the time stamp. There is also a 'History' button. Press it to open the Message History with the senders messages visible.

In the middle the message is shown. It is possible to copy text to clipboard by selecting the text with the mouse.

Below there is a text box, a 'Reply' button and an 'Ok' button:

@{b}Text field@{ub}
Enter a reply and press the Reply button or just Enter.

@{b}Reply@{ub}
When you have entered something in the text field and press the Reply button the text will be sent.
If you haven't entered anything a reply window will appear. It works exactly as the @{"New Message window" link sendbut}.
The requester will not normally close when you press the Reply-button or Enter in the message-field, but it can be configured to do so.

@{b}Ok@{ub}
Closes the message requester.
If you have entered something in the text field a requester will pop up asking you what to do.
A message field and a send button. You can use these to reply, without opening the main window. The requester will not close when you press the Send-button or Enter in the message-field.

From AmiComSys version 1.25 MUI-windows are used for the message requester. You may choose to use the older GadTools one in the Windows-settings - "Use MUI requester". The MUI-requester is not snapshotable by default, i.e. AmiComSys will calculate a suitable size every time. You may change this in the Windows settings - "Snapshotable requester".

@{b}NOTE!@{ub} You don't have to close a requester before you can receive or send another message.

You may configure the requester at @{"Windows settings" link "windowsettings"}

@endnode

@node "ignorelist" "Ignore List"

					   @{TI "Ignore List"}

The Ignore list you find by picking the View/ignore users menu item.

With it you can automatically ignore certain people that harass you.

There are one large list in the window. It shows the current entries in the Ignore List.
By selecting an entry the right list at the bottom will show what is ignored and the left will show what you could ignore.

There are a couple of buttons:
@{b}Add selected client@{ub} - Adds the client which is selected i the client list to the ignore list. Drag and drop from the client list is also implemented.
@{b}Remove@{ub} - Removes the selected entry in the Ignore List.
@{b}Update@{ub} - Uploads the current settings to the server.

In AmiComSys there are the following categories:

@{b}HotLine@{ub} - Ignores any entry in the HotLine from the added client. You won't notice if it changes the Topic either.
@{b}ClientList@{ub} - The client's existance is not showed in the Client List.
@{b}Msg, PChat & SendFile@{ub} - The client may not send you any messages and cannot connect to you via PChat and SendFile. The added client can't even get your System-info and Version-info!
<This is disabled in the un-registered version of AmiComSys>. Unregistered users could use the 'Bann-list (ignore these)' found in the Network settings instead. But with this the message is actually sent to your machine but filtered out. With the feature above it's stopped at the server, so nothing is sent to you!

Use the --> Add and <-- Remove buttons to set the active ignore categories for the selected client.

Plugins may also utilize this Ignore list. The plugins name will be shown as Application in the list, and the ignore categories is chosen by the plugin application.

@endnode

@node messhistory "Message History"

					  @{TI "The Message history"}

By picking the View/Message history menu item the Message history window will appear.

All messages that you send and receive are added to this history. Optionally also the messages sent and received in the PChat may be added to the history.

The three first groups in the left list are special:
@{b}Last ten@{ub} - the last ten messages sent and received
@{b}While away@{ub} - the messages you received while you were away (with status Away)
@{b}System@{ub} - messages from the server or sent from the Message center at the home page

If you are a registered user the history may be saved automatically when you quit AmiComSys or when you disconnect from the server.

The message history may be configured in the @{"Windows - message history settings" link windowsettings}.

At the left there are a list with all users added to the history. There is a context menu:
@{b}Remove@{ub} - remove the selected user from this list
@{b}Clear@{ub} - remove all messages to or from this user in the right list
@{b}Clear All@{ub} remove all users and their messages.

To the right the messages are shown. You may double click a message to show the message in a new window. Sometimes the message is to long to show then you must double click it to see it.

Below the lists there are two text fields. In those you may change the nick name and real name of the selected user.

Below those there are a couple of buttons:
@{b}Remove@{ub} - remove the selected message
@{b}Remove Group@{ub} - remove the selected user and the messages
@{b}Clear@{ub} - remove all messages of the selected user
@{b}Clear All@{ub} - remove all users and messages.

Use the Close gadget to close the window.

@{fg shine}There is a menu: @{fg text}
@{b}Project@{ub}
 @{fg fill}Save as ascii (all)@{fg text} - Save all the messages to an ascii file
 @{fg fill}Save as ascii (selected)@{fg text} - Save the messages of the selected user to a file
 @{fg fill}Iconify Window@{fg text} - Iconify the window
 @{fg fill}Close@{fg text} - Close the window

@{b}Action@{ub}
 @{fg fill}Clear Group@{fg text} - Remove all messages for the selected user
 @{fg fill}Clear All@{fg text} - remove all messages and users

Plugins may also use the message history to save messages.

@endnode

@node tasklist "The Task List"

					  @{TI "The Task list"}

When AmiComSys does an action an entry will be added to this list. When the task is finished it will be removed. While the task is active a context menu could be available at the entry.

For @{"Send File" link sendfilebut} you could break the transmission here.

When you send text messages you may see when the message is received my the other end.

Plugins may also utilize the task list.

@endnode


@node "rules" "The rules"

					   @{TI "The rules"}

The current rules of AmiComSys are: (last updated 990207)

Any breach of policy can and will result in your permanent removal from the central AmiComSys server.
We reserve the right to prevent or remove any connection to or from this server without warning or explanation.

The rules to follow:
We support free speech, but these rules apply everybody while using messaging and the HotLine, whether it be private or public:

§1) NO text that could be offensive or insulting to anybody shall be posted to the HotLine's Topic or Say field.
§2) NO ONE is allowed to post text that is just garbage in the HotLine, or send a MultiMessage or a Private message with such garbage. Not only does it take up unnecessary bandwidth, it also creates anger in the receiving person.
§3) In your comment you may write whatever you find informative or humorous, except for things that break against the other rules. Remember that this is not a place where you are to accuse people for anything. Such comments easily create a bad atmosphere and anger, IMHO.
§4) NO ONE owns the Topic field. If someone modifies your Topic, show them some consideration, and do not change it back to what suits you right away. Currently there is a 10 minutes timer on this field.
§5) Do NOT use rude speech.
§6) Do NOT slander each other.
§7) Do NOT use your comment to spread evil rumours about AmiComSys!
§8) Do NOT talk about pirate software in the HotLine, or by Multi-Messages, except how to combat it.

Remember:
If you start talking about religion, you are responsible for what happens. Do NOT mail me about infringements of the above rules in that case! The one who has joined the game must accept the consequences!

If anyone use AmiComSys to find IP-addresses to nuke or flood, do not write to me to tell me. Write to the Internet operator of the host which is flooding you! Notice that you may hide your IP-address. By default it is hidden. You must turn this future off in the network settings if you want to show it.
Remember there are NO "back-doors" in AmiComSys, that any unnamed piracy group could use to steal your files. The only thing they can use AmiComSys for is to find your IP-address and try to connect to some of your ports. If you are running one of their programs, that program could be listening on a port that they could connect to on your host and steal your files. Another security risk is if you are running a FTP-server at port 21, with an unsafe password, or a Samba-server at port 139. I recommend you to use Miami's IP-filter or better Miami Deluxe's fire wall to block access to certain ports, and use the 'netstat' command to found out which connections are established.

These rules should make sure that nobody will feel insulted while they are online and have AmiComSys running. Insulting behaviour create a bad atmosphere that could make people leave AmiComSys and the Amiga community. That is NOT a thing we want to happen!

Users that do not follow these rules may be kicked out of AmiComSys or be disallowed connection to the server.

For your information, the HotLine can be seen by anybody and is logged by the server.

If you want to say something private you are encouraged to use PChat or Messaging instead of HotLine.

If you feel that someone is insulting you or sending you unwanted messages I advise you to insert that person's login name and/or RealName into your Ignore-list, which you found in the NetWork-security-settings. That person should then be unable to send you any private messages or connect to you through PChat or SendFile. You may also insert him/her into the Ignore-List which you found in the Settings menu. If you do so you may totally remove that person from your client list and the hotline!
Registered users could also use these to ignore messages. Unregistered users use the bann-list found in the network-security settings instead.

You may see this rules again by picking the Window-menu and choosing the 'The Rules' item. Please also check out the home page once in a while. It is located at http://surf.to/AmiComSys/

@endnode

@node "bugg" "Bugs"

							@{TI "Bugs"}

Known bugs:
* Probably some memory leakage. (mostly caused by DICEs library initialization routines)
 
If you find a bug, please first check the @{"FAQ" link "faq"}, then tell @{"me" link "me"}.

Before you send me a bug report make sure that you have the most recent
version of AmiComSys. 
I want to know:
1. description of the bug( when?, how?, what happen?)
2. your name, address and email-address, if you have one.
3. which version of AmiComSys do you use?
4. your computer configuration.

@endnode
@node THEPLUGINSDK "The Plugin SDK"
			@{TI "The AmiComSys Plugin SDK"}

Mail @{"me" link me} if you want to create a plugin for AmiComSys. I will then try to provide you with the information you need.

@endnode


@node "me" "Contact me"
			@{TI "The author"}

If you have suggestions, want to report a bug, just want to say something, or want to register write to me at the address below:

Always make sure that you have the latest .guide before you report a bug or register.

   Snail-mail:
				Håkan Parting
				Organistv. 11
				SE-17579 Järfälla
				Sweden

   E-mail: hakan@parting.nu

   Homepage: http://www.parting.nu
			 http://parting.nu/hakan/
			 http://parting.nu/AmiComSys/
			 http://parting.nu/amarquee/

There are two AmiComSys mailing lists:

@{b}AmiComSys-update@{ub}
----------------
Subscribe to this mailing list if you want to get a notification when a new version of AmiComSys have been released.
You cannot send anything to this mailing list.

@{b}Subscribe by sending an empty email to amicomsys-update-subscribe@yahoogroups.com

@{b}AmiComSys Mailing list@{ub}
------------------------
Use this mailing list for discussions of future updates and bugs. You are allowed to send to this one!

Subscribe by sending an empty email to amicomsys-subscribe@yahoogroups.com
The mailing list email address is amicomsys@yahoogroups.com


My computer system is:
Amiga 1200Tower/68030/50MHz/18MB/2.1GB/CD-Drive/USR Sportster Voice 33.6/ADSL

Other programs by me is:

VersionWB ****** Current Version is 2.16 (17.03.2001)
aminet:util/sys/VersionWB.lha
An AmigaDos Version replacement which supports XFD and shows version info in a requester.

***AMarquee for Java*********
A port of the amarquee.library, by Jeremy Friesner, to Java 1.0.2.
This Java-package makes it possible to connect to an AMarqueed-server and exchange data.
It's home page may be found at http://www.parting.nu/jamarquee/

***AMarquee for Amiga********
I have taken over the development of amarquee.library and AMarqueed.
Latest version of amarquee.library is 54 (4th of May 2002)
It's home page is located at http://www.parting.nu/AMarquee/

**********GlossTask********** Current version is 1.73 (29.07.98).
aminet:misc/edu/GlossTask.lha

The GlossTask is the program with which you do your glossary home work with. It can test you from one language to another.
The program is managed by mouse, has many features and is very easy to use :-). Of course you can save your vocabulary list for use at another occasion.
Now in a GTLayout-version!

@endnode

@node "trademarks" "Trademarks"

			@{TI "Trademarks"}

AmiComSys and Amiga Communicator System is copyright by Håkan Parting.

AMarquee is copyright by Jeremy Friesner and Håkan Parting.

Amiga and Workbench is a registered trademark of Amiga Inc.

ICQ is copyright by Mirabilis and AOL.

Pagoo is copyright by Pagoo Communications, Inc.

AmIRC is copyright by Oliver Wagner.

AmiTradeCenter is copyright by Matthias Böcker.

Betterstring.mcc is copyright by Allan Odgaard.

Newstring.mcc is copyright by Rüdiger Sopp.

Textinput.mcc is copyright by Oliver Wagner.

Toolbar.mcc is copyright by Benny Kjær Nielsen.

NList.mcc, NListview.mcc & NFloattext.mcc is copyright by Gilles Masson.

Ibrowse is copyright by Omnipresence Intl.

Voyager is copyright by Oliver Wagner, Vaporware.

AWeb is copyright by Yvon Rozijn.

Miami is copyright by Nordic Global Inc.

YAM is copyright by Marcel Beck.

Busy.mcc is copyright by Klaus Melchior.

OpenURL.library is copyright by Troels Walsted Hansen.

Trademarks mentioned are owned by their respective owners.

@endnode

@node "todo" "To do"

			@{TI "To do"}

Future versions will include:

Search feature. (Seen)

File server features.

Localization.

Possibility to load preferences from disc.
 
Possibility to use bold, italic, center etc. in messages.

Send emails.

User-list in the HotLine

Possibly show photo of friend in the Friendsbook.

more ?

* = new in this version

Is anything missing, tell @{"me" link "me"}.

@endnode

@node "faq" "FAQ"
					  @{TI "FAQ"}

@{b}The hide IP function doesn´t work@{ub}

It does. With ACS 2.0 and up your hostname is shown to all people that are in your
Friends book, including your self. The reason is to make tools and games work between
friends.

@{b}I can't save the position and size of the MUI-message requesters and the System info window. Why?@{ub}

AmiComSys will calculate a new suitable size and position every time it's opened. The System Info window is a message requester.

If you want to snapshot the size and position go to the settings, select the Windows page - message requester tab. Then check the checkbox "snapshotable requester". Then you will be able to snapshot the requesters like any other MUI-window.

@{b}Where do I enter the message to send?@{ub}

Double click a client in the client list.
Enter your message in the text field of the new window and press return or the Send button to send the message to the selected client.
If you have a multi line text box you have to press Send to send it.

@{b}Can I use the NewIcons graphics set even though I don't have the NewIcons version 3 or 4 installed?@{ub}

Yes, NewIcons is not required. I call them NewIcons-style-images because they have more colours than 8, indifference to the MagicWB-style graphics set.

@{b}The number of connected people is no more in the About box. Where do I find it?@{ub}

Place the mouse pointer on the Client List and then wait until the bubble help appear. There you will see it. Make sure that you have enabled bubble help in the MUI-System-prefs.

@{b}Why do the window borders get corrupted, or overwritten when I place a window in front of the Main Window, PChat window, and the HotLine window, or resize the ditto.@{ub}

Should not happened in AmiComSys version 1.25+. This MUI-bug have been worked around.

@{b}When I try to resize the Rules Window and the IgnoreList window my computer crashes.@{ub}

Should not happened in AmiComSys version 1.25+. This MUI-bug have been worked around.

@{b}How do I enter a Smiley :-) in the HotLine?@{ub}
In addition to the keys you usually press to get that ':', press the CTRL-key.

@{b}Usually the message-requesters appear at the centre of the screen, but sometimes they appear in the upper left. How come?@{ub}

AmiComSys detects keypresses. So it knows when you are using the keyboard.
If it has detected a keypress within one second before the requester is to open, it will open in the upper left instead of centered. This prevents it from being opened in front of the text you are working with. You usually aren't typing in the upper left, are you?

At the same time it also opened unactivated to prevent it from stealing the current focus. See below.

@{b}How do I create my own chat room, with only people I have invited?@{ub}

Press the PChat button while one of them you want to chat with is selected in the client list. Then when you are connected you can pick the menu item 'invite selected client' in the Action menu of the PChat window. That client will then be added to your PChat window. Read more about this @{"here" link "pchat"}.

@{b}Sometimes the message requesters stoles the current focus. So when I think I am typing text in one text field I'm actually not. And if I press Return the message requester is accidently closed. What to do?@{ub}

AmiComSys has a feature which try to avoid these situations. It listens on your key-presses. If you haven't pressed a key for one second AmiComSys thinks it's safe to pop up an active window, but for some people that time is to short. You can increase it in the Windows-settings - Message Requester tab - Activate Delay. Test to increase it with one second steps and see if that is long enough.

@{b}Will AmiComSys be able to connect to ICQ in the future?@{ub}

Maybe. It depends on if the current ICQ protocol version 7 will be known and someone develops an ICQ plugin for AmiComSys. If there are another client which works for Amiga there is possible to make a working plugin for AmiComSys.

@{b}How can friends not using an Amiga contact me when I'm online. And how can I contact them?@{ub}

First how people can contact you:
* Tell them to go to the AmiComSys Message Center at the AmiComSys home page
http://www.parting.nu/AmiComSys/messagecenter.html
There they need to enter your nick-name and can send you an instant message. They can see
if you are online by looking at http://www.parting.nu/AmiComSys/clientlist.html

* If you have a Pagoo user id they can send you a message via Pagoo.

* Via email.

* Using one of the illegal ICQ clones for Amiga ...

Second, how you may contact them:

* If they are using ICQ, you can visit their message center,
located at http://wwp.mirabilis/ICQUIN/
and send a message. Exchange ICQUIN with their ICQ #.

* Use one of the illegal ICQ clones for Amiga in parallel with AmiComSys ...

* If they use another AOL clone, I don't know what to do. Maybe they also have some kind
of Home Page Message Center. Tell me!


@endnode

@node "history" "History of changes"
					  @{TI "HISTORY"}

@{TI "2.3 (08.09.2002)"}
NEW: A send message bar was added to the Toolbar menu. In addition to the normal message send
procedure you may now use this bar. Select the one to send a message to, enter the message
in the text field and press enter. Optionally select the type of message. This is the way
it worked in ACS 1.34. The bar may be moved to the upper area by draging it with the mouse.
Registered users can save the bar position.
To enter a multi-line message use the normal procedure, i.e. double-click the client you want
to send a message.
NEW: Send File now increases the transfer buffer when it recognizes that the connection is
fast enough. There by increasing the transfer rate.
NEW: Tab-expansion in hotline and pchat now match all clients online instead of just those
having hotline open.

BUGFIX: From version 2.2 events and sounds were not hit when a buddy went online and the
"Show in list" was set to "All".
BUGFIX: If the "Show in list" menu item was changed to "All" from "Only friends" the contact
list went empty.
BUGFIX: If you changed the string class setting from Textinput to any other while having a pchat
or hotline window open it crashed.
BUGFIX: The current cps in Send File wasn't accurate. When the system was heavy loaded it
was too high.

@{TI "2.2 (28.07.2002)"}
NEW: The default server name is now amicomsys.2y.net
NEW: Requires v.54 of amarquee.library which is included.
NEW: Requires v.20.106+ of NList.mcc (release 0.92).
NEW: New Firewall section in the network/security settings named "Firewall/Internet sharing".
If you are behind a "firewall/Internet sharing" and the one you are connecting to via PChat or
Sendfile also is behind a "firewall/Internet sharing" it would not work.
The solution is to you setup a pair of ports in the firewall which are forwarded via NAT to
the machine which is running AmiComSys. Enter the ports in the settings and it should work
as if you were not behind a firewall. If there are several hosts running AmiComSys behind
a single "firewall/Internet sharing" those would use different ports.
NEW: AmiComSys is now able to connect via PChat and Sendfile to hosts on the same LAN.
	 V.2.2+ is required on both ends.
NEW: Removed the group border from the Message History settings page.

BUGFIX: AmiComSys could crash after the Friends book had been modified.
BUGFIX: If you are behind a "firewall/Internet sharing" and someone which is also behind a
firewall was connecting to you via PChat a message about refused connection appeared.
BUGFIX: There was a double set of menus in the Client Info, PChat Image Download and Sendfile
windows.
BUGFIX: There was a screen locking issue with the PChat, PChat Image Download and Sendfile windows,
which could make the public screen it opened on to freeze and also ACS to either freeze or open
windows on the workbench screen.
BUGFIX: After a certain type of message was received and closed AmiComSys would freeze sooner
or later.
BUGFIX: There was a number of instability issues with the Message History window.
BUGFIX: It wasn't possible to delete the last user from the banned list on the network
settings page.
BUGFIX: Enforcer hits occured when:
1. Right-click in an empty Task List window.
2. Press "cursor up" or "cursor down" when in PChat or Hotline.
3. Select "Save As" from the PChat or Hotline menus.
BUGFIX: The following didn't work since version 2.0 of ACS:
1. Cursor up/down in PChat/Hotline.
2. Tab expansion in PChat/Hotline.
3. Away message count appears in Information bar at top of ACS when a message was received
   while away.
BUGFIX: The "Iconify Application" menu item didn't always affect the "Client Info" window.
BUGFIX: The layout of the "GMT Offset" gadget on the program settings page could look strange.
BUGFIX: Changed the "More recipients" button text in the "new message" windows to:
"Show recipients >>" and "<< Hide recipients".
BUGFIX: "Start X-coord" and "Start Y-coord" on the program settings page was mis-spelled.
BUGFIX: When the PChat window pops up from an iconified state (ie. "Popup window when
message arrives") the scrollbar was not at the very bottom to display the newest message.
BUGFIX: If you picked the Close menuitem from the SendFile and the Chat Image Download windows
to abort the transmission AmiComSys locked up.
BUGFIX: If you tried to break the AmiComSys process while it was showing a modal message dialog
it could lock up.
BUGFIX: When the message requesters are set to close after replying a message, it was possible
to press enter in the text field again initiating a new send before it had been closed, causing
it to close twice and deallocating memory twice.
BUGFIX: When using the default public screen setting for Message requesters all windows now
open on the current default screen after they have been deiconified too.
BUGFIX: When having the Message History window opened while switching between several groups and
sending and receiving messages the display hook function of the history list sometimes get an
invalid pointer (0x1) from NList.mcc which caused an Enforcer-hit and lockup. I have no idea why
this happen but I implemented a check on this.
BUGFIX: The reply button (Email/ICQ) in messages sent from the message center was not shown.
BUGFIX: If not "Last ten" was selected in the Message History and the items were wordwraped
then there were trouble to remove the last or the first item to keep it to ten items when a
new message was sent or received. The routine tried to remove items to make it ten but failed,
and there by creating a busy loop, i.e making ACS freeze.

@{TI "2.1 (01.12.2001)"}
BUGFIX: When all the checkboxes in the Client list settings/Show which information were checked the computer crashed.
So if you had that setting in v. 1.34 and tried 2.0 the computer just crashed.
BUGFIX: It didn't work to install plugins directly from the plugin installer, by setting
the environmental variable ACS_INSTALLPLUGIN.

@{TI "2.0 (25.11.2001)"}
The .guide is now more complete. Please read it even if you have used AmiComSys before.
NEW: Removed the message bar. You now send a message by double clicking the client
in the list or by pressing the Msg or MuMsg buttons and drag and drop the recipients to
the "Recipients list". The multi-selection in the client list is removed because it is
not of use anymore.

NEW: The message requesters are redesigned. An image shows which type of message it is.
There's a History button which opens the Message History for the sender. Reply by
typing in the text in the textbox and press "Reply", or just press Reply to open up
the New Message Window to see the reply text better.

NEW: In the New Message window you enter a message to send. In the upper part of the window
three buttons are located, Client Info, History and More recipients. If you press the client
Info button the Client Info will appear. The history button opens the Message history
with the user's section visible. With the More recipients button you hide or show the list
where you may add recipients. The message type cycle was also moved to this window.

NEW: With plugins you may exend the functionality of AmiComSys. The plugin could have
it's main GUI inside the main window of AmiComSys. It could also add it's own menus or
append menuitems to the AmiComSys ones. It could fully integrate with AmiComSys by using
the Message requesters, Message History, Ignore List and Task List. You add and remove
plugins in the plugins settings.

NEW: The "Window" menu have changed name to "View". In the Toolbars sub menu you may show
or hide the bars. All windows may be opened from the View-menu. All the "merge and divide"
context menu items on the bars were removed.
In the "switch to plugin" sub menu you may choose which plugin's interface that shall be visible
in the main window.

NEW: Rewrote the ARexx menu. It's name is now Tools menu. You may add or remove arexx scripts
or other tools with the Tools settings.

NEW: There are a pair of new images for the new settings pages (prefs_plugins and prefs_arexx).

NEW: The Config window is rewritten. Memory for the window is not allocated before it is
opened. If you press the Cancel button all the changes made in the window is forgotten.
All the pages of the window are not layouted before the window is opened anymore, it's only
layouted before shown. Values set with Tooltypes will now also be visible in the Config window.
The Pagoo/ICQ page was removed. You may now enter your ICQ UIN, to show in Client info, under the
System info in the Personal settings.

NEW: AmiComSys now checks with you tcp/ip-stack if you are online before trying to connect to
the server. Both Genesis and Miami(Dx) are supported. If you use another stack AmiComSys will
go into the online state as soon as bsdsocket.library can be opened. With this change it
should be possible to enable the Auto-Connect feature in Miami Deluxe without problems caused
by AmiComSys. You don't need to be online to connect to 'localhost'.

NEW: The Pchat feature was rewritten. Every window doesn't need a new process anymore and the
feature should now be more stable.

NEW: Those who are in your Friends book will see you host name and ip address even though
you have activated the "Hide my ip" setting in the Network/security settings.
The reason is to make it possible for your friends to connect to you with Internet games and
other tools like AmTalk just like QAmitrack once did.

NEW: Status bar is a new bar which contains the old status cycle. Another new bar is the
"Plugin selection bar" which shows which plugin that is active in the main window. It
contains a pop up window wo you may change which plugin is the active one.

NEW: Some things have changed in the client list. You cannot anymore double click a client
to open the Client Info, but you may send a new message that way. In the context menu you
can do a number of actions on the selected client, like connecting with PChat, Sendfile or
an external tool like AmTalk or just show the Client info. The first two vertical lines in
the list have been removed.

NEW: The Send File and PChat windows now also open on the front most screen if this is
specified for the message requesters in the Windows settings.

NEW: Added Popup-option to the Windows->Chat->PChat settings. Check this to let AmiComSys
automatically popup the iconified PChat window when a new message arrive.

NEW: Added support for a HTTP-proxy. So if you have to or want to use a proxy server to
to download pages or files from web servers check the Network/Proxy-server settings. If
you see HTML tags in the Information bar or cannot download pictures in the PChat
you probably need to use a proxy.

NEW: The Ignore list, opened by the View->Ignore users menu item is rewritten. It now is
fully dynamic which makes it possible for plugins to use it to ignore other categories than
AmiComSys.

NEW: Added support for plugins in the Message History also.

NEW: A new window named Task List shows the current tasks. May also be used by plugins.

NEW: Removed support for Pagoo because it didn't work any more and it was not possible
and worth it to fix it.

NEW: Moved the "restart" menu item to the Project menu and added a new menu item named
"Kill GUI". Use it free some memory allocated to be able to show the GUI. The GUI will
be iconified. If you are online it will the memory will be allocated again to be able
to connect to the server.

SECURITYFIX: Fixed the MUI Escape-code exploit, which did let users to run any program on your
computer if you had APIPE: or AWNPIPE: mounted by sending a special escape code sequence.
If you had PIPE: mounted users could manage to get your computer to crash.

@{TI "1.34 (26.05.2001)"}
The Installer script was updated:
You could get "object in use" errors when you tried to update a former version which
recently was running. Now the installer script makes a couple of "avail flush":es to
flush the lock on the toolbar images.
The icon-file was always overwritten.

@{TI "1.34 (24.05.2001)"}
NEW: The central server name is amicomsys.dhs.org and it is now located in Sweden.
This version will connect to that site if you don't change it in the settings.
NEW: Recompiled the whole project to be certain there are no trouble with the compiled code.
NEW: The latest libraries are included in the distribution.
NEW: New images in 16 colours using the RomIcons palette by Andreas Kuerzinger.

@{TI "1.33 (12.07.2000)"}
NEW: Now play full samples if sound.datatype version 40 or better is installed.
If not it still plays maximum 1.8 seconds.
BUG: It didn't work to connect with SendFile to a computer in
the internal network from the Internet router, i.e. the computer having
the actual Internet connection. Reverse it did work and PChat
worked both directions. Outside your network there were no problems to
connect to your computer.
To make it possible for computers on Internet to connect with PChat and SendFile
to your computer which has an internal network ip address, i.e. is behind a firewall
or Internet router you have to enable the "I'm behind a firewall" checkbox in
the AmiComSys network settings.
It still isn't possible to connect with PChat and SendFile between two machines
both having only an internal ip-address, i.e. when the Internet router isn't
involved. This is a feature for AmiComSys 2.0 which still is in development.

@{TI "1.32 (25.03.2000)"}
NEW: New home page with secure online registration opened at http://www.parting.nu/AmiComSys/
NEW: Removed the 'new'-message button. The message text field is now located in the lower
part of the main window, as it originally was in pre 1.25 versions of AmiComSys.
I didn't like the 'new'-button implementation and I don't know anyone which actually did.
BUG: removed a MuForce hit which did happen while a picture was displayed in the PChat window.
BUG: It was not possible to click the status cycle box button to switch the active status,
because it was draggable.
NEW: New AmiComSysRegister utility in the Register drawer. Use this to register AmiComSys
and decrypt the response you will receive by email when your registration have been processed.
NEW: New version of amarquee.library (V50) included.
NEW: New version of Toolbar.mcc and Toolbar.mcp (V15.6) included.
NEW: New version of imagepool.library used by Toolbar.mcc included.

@{TI "1.31 (01.02.2000)"}
NEW:
Fixed the PChat picture so whole the picture is visible if it has a size of
400x400 or less. Pictures bigger than 200x210 get scrollers. High quality dither is
used (AmigaOS 3.5). Status text show "loading picture ..." while loading and decoding
the picture.

The message requesters take the real font size in account when calculating
the window size. 

Changed the layout of the new message window.

Added "don't show any" to the
"Put picture" cycle button in the Windows->Chat-settings. Select it to disable
pictures in the PChat.

The PChat picture is now put on the top right if it's set to to be put to the
right in the settings.

BUGFIX:
In low memory situations when AmiComSys failed to open the main window it tried to change
the toolbar layout. Removed it because it is of no use anymore when the toolbars is inside scrollers.

The Show/Toolbars did not hide/show the toolbars under AmigaOS 3.5.

Very rare the error message "Connection broken by sender" could
show up at the end of a SendFile session.

Sometimes it was not possible to click the "Download"-picture
button in the PChat. At least on AmigaOS3.5 systems.

Packed with a Y2K fixed LHA/LZX.

The download of pictures in the PChat did not work on fast Amigas, like 68060 or so.

There was a problem with the CPS-counter in the SendFile on 68060 machines. Had to change presentation
to bytes/s instead of kbytes/s.

<removed version 1.9 to 1.30a>

@{fg shine}1.8 (08.04.1997)
----------------@{fg text}

First Official release on Aminet.

@endnode
@node "thanks" "Thanks to"
				 @{apen 2}@{b}I would like to thank@{ub}@{apen 1}

Jeremy Friesner for the AMarquee.library.

Benjamin Larsson for the current full-time AmiComSys server at amicomsys.2y.net located in Sweden.

Jay Swackhamer for the second full-time AmiComSys server at acs.hostile.cx located in Canada (not online anymore).

Thomas Steinbichler for the first full-time AmiComSys server site (not online anymore).

Michael Balzer for ARexxBox. It makes Arexx much simpler.
Gilles Masson for NList.mcc. It makes the lists userfriendly.
Dirk Tietke for the AmiComSys.dock.
Mark Denholm for the AmiComSys-clips for ScreenTAB & StartMenu.
Allan Odgaard for the BetterString.mcc (optional string type in AmiComSys)
Rüdiger Sopp for Newstring.mcc (optional string type in AmiComSys)
Oliver Wagner for Textinput.mcc (optional string type in AmiComSys)
Mads 'Yedo' Jensen for the MagicWB-2-graphics(1998-99).
Brecht 'Darklite' Machiels for the NewIcons-graphics.
Steven G. Wilson, Jr. for the help with the English grammar of the Rules section.
Troels Walsted Hansen for OpenURL.library.
Andreas Kuerzinger for the MagicWB-1-graphics(2000) and the RomIcons-1-graphics(2001).

For bug reports, suggestions and beta testing:

Thank you very much to:

Jeremy Friesner, USA
Thomas Steinbichler, Austria.
Alex Tucker, Singapore
Richard Lake, UK.
Darius Mazurkiewicz.
Thomas Svenson, Sweden.
Sonat Böler, Sweden.
Pete (isnibs), Canada
Scott Beardwood, UK.
Fredrik Zetterlund, Sweden.
Neil Sedger, UK.
Rolf Bollmann, Germany.
Stefan Öggemar, Sweden
Alexander Wild, Germany
Michael Praschl, Austria
Allan Odgaard, Denmark
Håkan Magnusson, Sweden
Mike Constantine.
Steven Lyon.
Kenneth Craig, USA.
David Hamilton, Canada.
Asha DeVelder, USA.
Frederik Thiesen, Sweden.
Jonas Davidsson, Sweden.
Philippe van Calsteren, The Netherlands.
Nico.
Pietro Leone.
Todd A. Oberly, USA
Jeff Gilpin, USA

@endnode

@node "ACSindex" "Index"

@{"Arexx Interface" link "ARexx"}

Arexx-scripts:
	@{"NotifyArexx.amicomsys" link "notifyarexx"}
	@{"SendWEB.amicomsys" link "sendweb"}
	@{"SendFTP.amicomsys" link "sendftp"}
	@{"SendIRC.amicomsys" link "sendirc"}
	@{"SendEmail.amicomsys" link "sendemail"}

@{"Bann clients" link "networksettings"}

@{"Buttons" link "features"}

@{"Beep()" link "windowsettings"}

@{"Client Info" link "clientlist"}

@{"Command line parameters" link "usage"}

@{"Crashes" link "faq"}

@{"Friendsbook" link friendsbook}

Gadgets in main window:
	@{"Clientlist" link "clientlist"}
	@{"MuMsg" link "sendbut"}
	@{"Msg" link "sendbut"}
	@{"SendFile" link "sendfilebut"}
	@{"Version" link "versionbut"}

@{"Garbage in the window border" link "faq"}

@{"HotLine" link "hotline"}

@{"Ignore users (completely)" link "ignorelist"}

@{"Ignore users" link "networksettings"}

@{"Menus" link "features"}

@{"Message requester" link "messagereq"}

@{"PChat" link "pchat"}

@{"PChat with multiple clients" link "pchat"}

@{"Plugins" link plugins}

@{"Public chat" link "hotline"}

@{"Rules" link "rules"}

@{"Send a file" link "sendfilebut"}

Settings:
	@{"Chat" link "windowsettings"}
	@{"Logging" link "programsett"}
	@{"Message History" link "windowsettings"}
	@{"Message requsters" link "windowsettings"}
	@{"Personal info." link "personalsettings"}
	@{"Plugin settings" link "pluginsettings"}
	@{"Program function" link "programsett"}
	@{"Security" link "networksettings"}
	@{"Server" link "networksettings"}
	@{"TimeZone" link "programsett"}
	@{"Tools settings" link "toolssettings"}

@{"Smileys in the HotLine" link "faq"}

@{"Start web browser" link "SendWEB"}

@{"TaskList" link tasklist}

@endnode

