@database AmiComSysMUI.guide
@index ACSindex
@$VER: AmiComSysMUI.guide 1.75 (25.07.98)
@author "Håkan Parting"@(c) "Håkan Parting 1998"
@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 1.19g-MUI"}
                    http://amicomsys.tibb.at
                    Fast mirror at http://surf.to/AmiComSys/
                    Copyright © 1997-1998 Håkan Parting
                    All rights reserved.
                    ShareWare

               Read History for new features ...
               Read upgrade to 1.19g to upgrade.
               @{"Copyright and disclaimer" link "Copyright"} @{HL "This work is mine,
                                        but I'm not responsible for any
                                        damage."}
               @{"ShareWare registration" link "registration"} @{HL "What I want from you"}
               @{"Introduction" link "Intro"} @{HL "What is this?"}
               @{"Requirements" link "Requirements"}

               @{"Installation" link "Install"} @{HL "How to install"}
               @{"Upgrade to 1.19g" link "upgrade"}

               @{"Usage" link "Usage"} @{HL "How to use it."}
               @{"Features" LINK "Features"} @{HL "The user interface ..."}
               @{"Settings" LINK "Settings"} 
               @{"ARexx interface" LINK "ARexx"}
               @{"The rules" LINK "rules"} @{Hl "The rules to follow ..."}
               @{"FAQ" link "faq"} @{HL "Frequently Asked Questions. (updated 98-07-19)"}
               @{"History" link "history"} @{HL "Fixed bugs and improvements."}
               @{"To do" link "todo"} @{HL "Future"}
               @{"Bugs" link "bugg"} :-(
               @{"The Author" link "me"} @{HL "Contact me!"}
               @{"Credits" link "thanks"}
               @{"Updates" link "updates"} @{HL "Where to find updates"}
               @{"Trademarks" link "trademarks"}

               @{"Index" link "ACSindex"}

@endnode

@node "Copyright" "Copyright"

                          @{TI "COPYRIGHT"}

@{b}AmiComSys - Amiga Communicator System Copyright 1997-1998 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 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.

@{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
Coverdiscs.

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 have to register.@{ub}

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

The unregistered AmiComSys has this disadvantages:

* You cannot hide your IP-address/hostname.

* You can't see in the client list if a client is away or busy.

* You cannot ignore certain user's messages sent to you with the Ignore List, but
you could use the less efficient ignore-list in the Network settings instead.
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" link "securitysettings"} is disabled, e.g messages,
SendFile and PChat can not be turned off.  

* @{"Send confirmation" link "settings"} is always enabled.

* A @{"NotifyArexx.amicomsys" link "notifyarexx"} script can not be used.

* A @{"MessageArexx.amicomsys" link "messagearexx"} script can not be used.

* The Busy and Invisible options of the status-button is disabled.

* Message requester cannot be closed automatically after a send.

* The content of the Message History buffer can't be saved automatically when you shutdown
  AmiComSys.

 
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"}.

The registration fee is currently (updated 1998-07-14):
For an uuencoded or MIMEd emailed keyfile:
@{b}120 SEK OR
16 US Dollar OR
10 Great Britain Pound OR
30 D-Mark@{ub}

Discounts are possible if several people register at the same time (5 or more).

Send the fee in @{b}bills@{ub} with a letter telling @{"me" link "me"} that you want to  be a
registered user of AmiComSys. No other currencies than US Dollar,
Swedish Crowns (SEK), Great Britain Pounds or D-Mark are accepted.
@{b}Don't forget to include your name, address and emailaddress.
And don't forget to send me the AmiComSys.key1 you have created with
the AmiComSysRegister program as below.

If you register for someone other than
yourself you most also include his/her name, address and
emailaddress.@{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}Make sure you are reading the latest version of this guide!@{ub}

@{b}Other, more secure and more expensive,  options to send the fee:@{ub}
Notice, you must add to the fee, because my bank is charging me when
I cash the Int.Money Order, Intl. Bank Draft, or when I receive a bank transfer,
from abroad. The amount shown below is what you pay me.

*International Money Order with the amount of @{b}150 SEK or 19 USD@{ub}.

*International Bank Draft with the amount of @{b}150 SEK@{ub}. The receiving bank must be:
Skandinaviska Enskilda Banken, Sweden. And the receipient Håkan Parting.

*Bank-transfer (people not living in Sweden):
Please transfer the fee (180 SEK) to my bank account 5392-00-39742 in the bank 
Skandinaviska Enskilda Banken (SEB), Håkan Parting. My bank charge me 60 SEK!

*Bank-transfer (people living in Sweden):
(in Swedish:)
Mitt Postgiro är 421 38 50-3.
Jag har också ett konto i S-E-Banken om du föredrar det. (Borde inte vara
någon insättningsavgift :) Kontonummer: 5392-00-39742
Registreringsavgiften är 120 kr.

@{b}Eurocheques or any other cheque are NOT accepted!@{ub} They are not cashable in Sweden!

@{b}The registration follows the following steps, step by step:@{ub}
1. Send the fee to me with your name, address, and email address by ordinary
mail.
2. Do you have a public PGP key? 

@{"Yes!" link "yespgp"}    @{"No!" link "nopgp"}


@endnode

@node "yespgp" "Yes"

3. Send @{"me" link "me"} the shareware fee.
4. Email me your Public PGP Key.
5. When I've received your payment I will send you the key PGP-encoded.
6. PGP-decode the file AmiComSys.key you get from me, and copy it to your
AmiComSys directory.
7. It is now ready to use. 

@endnode

@node "nopgp" "No"

3. Send @{"me" link "me"} the shareware fee.
4. Run the AmiComSysRegister program in the AmiComSys/Register directory.
5. The file AmiComSys/Register/AmiComSys.key1 is then created.
6. Email AmiComSys.key1 to me either MIMEd or uuencoded.
7. When I've received your payment I will send you the key MIMEd or uuencoded.
8. When you get the response from me, copy the file AmiComSys.key2 to your
AmiComSys/Register/ directory.
9. Run the program AmiComSysMakeKey in the AmiComSys/Register directory.
10. Your keyfile is now ready to use. It is installed in the AmiComSys directory.
 
@endnode

@node "updates" "Updates"

                             @{TI "Updates"}

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

Latest version is first always available at my homepages:
or http://amicomsys.tibb.at
or http://surf.to/AmiComSys/

Updates of BetterString.mcc can be found on Allan Odgaard's homepage at
http://www.diku.dk/students/duff/

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@makelist.com
to add yourself to the list!

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

@endnode
@node "Intro" "Introduktion"

                          @{TI "Introduction"}

AmiComSys is a 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 and homepages.

Now you can say Hi! to your friends on the net, or just see if they are
connected.

You can:
* send text messages
* send chat requests
* send WEB-requests.
* transfer files.
* have a public chat
* have a private chat, with photos.
* check your Pagoo message box.
* advertise your homepage, ftp-site or IRC-server.

Future updates will include more.

Please put it in your Online-script or WBStartup drawer and enjoy ...

AmiComSys requires amarquee.library v.47+ in LIBS:. Get it from
the AMarquee-package - aminet:comm/net/AMarqueeX.xx.lha

and Magic User Interface (MUI) version 3.8 or higher

and NList.mcc by Gilles Masson, available at Aminet:dev/mui/MCC_NList0_84.lha

and BetterString.mcc by Allan Odgaard. Included in the archive
(MUI/libs/BetterString.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)

Textinput.mcc is required if you are using 68000. You may download
it at the above address.

Note that the above only apply if your friends is using AmiComSys,
and have an Amiga. ( An IBM-PC-version of AMarquee.library would
be nice, or better a JAVA class :-))

Features:

* Send text messages.
* Includes a client 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.cc
and Textinput.mcc
* Show all/Show only frinds/Highlight friends.
* Check you Pagoo message box.
* See a photo of the one you are chatting with.
* Hide you IP-address from others.
* Ignore users in HotLine, Client-List, PChat, SendFile & Messaging.

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

@endnode

@node "Requirements" "Requirements"

			        @{TI "Requirements"}

An Amiga with Kickstart V37+ (WB 2.04+). Se note below for Kickstart 2.04.
A 68020 or better processor. A 68000 version is available at
http://surf.to/AmiComSys/

An tcp/ip-stack like Miami or AmiTCP3.0b2+.
INET225 users should use some kind of bsdsocket.library->socket.library mapper.
Termite TCP users should use some kind of bsdsocket.library->tsocket.library mapper.
(available at the Hisoft support-web-site.)

The shared library AMarquee.library v.47+. Aminet:comm/net/AMarqueex.xx.lha
Magic User Interface (MUI) version 3.8+.
The MUI custom class NList.mcc version 19+. Aminet:dev/mui/MCC_NList0_84.lha
The MUI custom class BetterString.mcc. Included in the archive. (MUI/libs/BetterString.mcc)
Updates of BetterString can be found on Allan Odgaard's homepage located at
http://www.diku.dk/students/duff/

The server to connect to must have AMarqueed 1.49 installed for everything to
work right. Notice that 1.49 isn't currently released. amicomsys.tibb.at is
running it.

NOTE:
Under Kickstart V37 the normal string.mui gadget or Newstring.mcc is used,
and betterstring.mcc and textinput.mcc can't be used.
Photos in PChat won't work, because DataTypes.library is required.

@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.
AmiComSys.MUI is ready to be run. 

If you put AmiComSys in 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 ).

If you're using a multiuser-system that Tooltype could be set to HOME:
 
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, but if it's Daylight Savings Time you must check the checkbox (mostly in
the summer time).

If your computer is behind a fire wall, set that setting in the network
settings.

AMarquee v.47+ must be installed on your system. Can be found on
aminet:comm/net/Amarqueex.xx.lha

BetterString.mcc and NList.mcc must also be installed in your LIBS:mui/ drawer.

@endnode

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

@{b}New files since version 1.19 are:@{ub}
AmiComSys/AmiComSys
AmiComSys/AmiComSysMUI.guide
AmiComSys/Rexx/SendEmail.amicomsys
AmiComSys/Rexx/AmiComSystest.rexx
AmiComSys/Rexx/MessageArexx.amicomsys

@{b}New files since version 1.19d are:@{ub}
AmiComSys/AmiComSys
AmiComSys/AmiComSysMUI.guide

@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"}.

@{b}TOOLTYPES:@{ub}

CX_POPUP=Yes/No: Not for MUI-version, can be set in MUI-Prefs.
Should AmiComSys open its window at startup? Default is Yes.

CX_POPKEY=lalt shift a :
The hotkey which will cause AmiComSys to Show its 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.tibb.at.

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.@{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. It will has a usage
in a future version.

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.

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 directory and the config files.
If you have a multiuser-system you could set this to HOME:

@{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 FTPSITE PROGDIR=<path>

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

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

@endnode

@node "Settings" "Settings"

                       @{TI "Settings"}

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

@{b}General@{ub} settings:
Pages:
@{"Personal" link "personalsettings"} - Personal and System Info
@{"Network" link "networksettings"} - Server and Security
@{"Program" link "programsett"} - Various
@{"Windows" link "windowsettings"} - Chat, message and History windows
@{"Misc" link "miscsettings"} - Scripts and pathes.
@{"Client list" link "clientlistsetting"} - The client list. Show friends/Hide others etc.
@{"Pagoo/ICQ" link "pagooicqsetting"} - Set your PagooID.
@{b}Save preferences@{ub}
Save the settings to disk.

@{b}Notice that the TOOLTYPES will override the saved values in the file
AmiComSys.config. 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. 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://amicomsys.tibb.at

@{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 home page.
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 must be 72x100.
The format of the picture must be JPG or GIF (for cross platform compatibility).

@endnode

@node "networksettings" "Server & Security Settings"

                        @{TI "Server settings"}                   

@{HI "Server settings group:"}

@{b}Server@{ub} - Same as TOOLTYPE Server 
The AMarqueed server AmiComSys will connect to. Defaults
to amicomsys.tibb.at. Instead of the hostname the IP-address can 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 "Security group"}

@{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}I'm behind a firewall@{ub}
Check this if you are behind a firewall or are using Slirp or don't have a
"real 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 poeple can't
connect to you via PChat or SendFile you could test to check this.

@{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.
<Disabled in the unregistered version>

@{b}MessAccess@{ub}
With this you can enable or disable messages from specified host with an
ordinal Amiga wildcard pattern.
With this wildcard you  describe the authorized hosts which are allowed to send
you a message. Default is #?, which means that anybody may send you a message. 
(e.g #?.se, means that only Swedish host may send you messages.)
(#?.se|#?.com|#?.edu) gives message access to host with .se, .com or .edu domains.
{HI "If you found that people can't send messages to you. Set this to #?"}
<Disabled in the unregistered version>

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

@{b}Enable MultiMess@{ub}
This must be checked if you want to receive messages sent with pattern matching (MultiSend).
<Disabled 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://amicomsys.tibb.at.

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

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

@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.@{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.

@{fg shine}Iconification group@{fg text}
@{b}CloseGadget iconify main window@{ub} - If checked 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.

@{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.

@{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.

@{HI "Tab - Various"}

@{HI "TimeZone settings group"}

The only thing you must set here is the Daylight Savings Time checkbox.

@{b}Daylight Savings Time@{ub}
If it is Daylight Savings Time (DST) check this. Currently it's daylight savings time.
, and therefore should be checked.

@{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. Note that BetterString.mcc can't
be used on a Kickstart V37 Amiga.
You must restart AmiComSys for the 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.

@endnode

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

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

@{HI "Tab - Message History Windows"}
@{b}Column name Display:@{ub}
Specify how the username shall be shown.
Realname & username,
Realname,
or only Username.

@{b}Autosave history@{ub}
If this is checked the message history will be saved to the file
.msghistory in the AmiComSys root directory, when you quit or
disconnect AmiComSys. Please clear this list after a period of time.
If you not it could take while before the list is drawn, and while
it is drawing AMiComSys is locked ... The Message History will be
reworked in a future version.
It will be restored next time you start AmiComSys.
<Disabled in the unregistered version>
 
@{HI "Tab -Message requester settings:"}

@{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 requster opens on be brought to front.
Default is no.

@{b}Beep when new message@{ub}
Beep and flash the screen when a new message is received. Default is checked; Yes.

@{b}Send confirmation@{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}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.

@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 can not use this feature.

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

@{b}Replace ACS's requester@{ub}
Should the 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.

@{b}FTP-Program-Path@{ub} Type in the path to your ftp-client (e.g. AmFTP,
AmiFTP) 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 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 chosen as below.
@{HI "Show only friends"}. If you chose 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 "Way of highlighting"}
How friends are highlighted. Choose from italize, highlight pen or bold. 

@{BO "Show which information"}
What information do you want to see in the client list?
* Loginname, Realname, Host and comment.

@endnode

@node "pagooicqsetting" "Pagoo/ICQ settings"

                   @{TI "Pagoo/ICQ settings"}

AmiComSys can check your Pagoo message box at regular intervals, so you don't
have to waste your time looking at your online center manually.
Look at http://www.pagoo.com for more info about Pagoo.
When a new message arrives a message will pop up after a while (depends
on your settings) asking you to visit your Online Pagoo Message Box.
Pagoo already provide you with the service to send you an email asking
you to visit your Message Box online. If you want you can switch that service
off and use AmiComSys instead, but it is you choice. Personally I like this
better, I don't want my in-box in YAM filled with Pagoo-notifications. I'm
too lazy to delete them :)

You can advertise you ICQ # in the client info.

@{b}PagooID@{ub}
Enter you Pagoo ID here!

@{b}Pagoo Password@{ub}
Enter you Pagoo password here!

@{b}Show ID in client list@{ub}
Do you allow people to see you Pagoo ID in the client info?
This defaults to no, i.e, unchecked.

@{b}Check for messages when going online@{ub}
Check this if you want AmiComSys to check your Pagoo Message Box when you go
online.

@{b}Check for messages with interval@{ub}
Select in which intervals you want AmiComSys to visit you Online Message Box
to search for new messages. Select this according to the possibility of you
getting a Pagoo message. For most of us 'Never' and 'check when going offline'
is suitable.

@{b}Show this ICQ U# in my client info@{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 "Features" "Features"
@font Courier.font 15

                            @{TI "Features"}

AmiComSys contains a information bar, a status-popup-menu, a listview,
some buttons and a menu.

@{"           Info                 " link "infobar"}@{"  Status-menu  " link "statuscyc"}
@{"         C l i e n t l i s t/Client Info       " link "clientlist"}
@{"   Add   " link "addbutton"}@{"   PChat   " link "friendsbook"}@{"   SendFile    " link "sendfilebut"}@{" Version  " link "versionbut"}
Pattern @{"              " link "Patternstr"}@{"MultiSend" link "MultiSend"}@{" Message type " link "messtype"}
Message @{"                            " link "Messagestr"}@{"   Send   " link "sendbut"}

@{b}Close Gadget@{ub} Will iconify, or close the window.

@{HI "Menu"}

@{HL "Project/"}  
@{b}About@{ub} - Shows info about AmiComSys.
@{b}Iconify Window@{ub} - Iconifies the main window.
@{b}Iconify application @{ub} - Iconifies the whole application (all windows).
@{b}Quit@{ub} - Will quit AmiComSys.

@{HL "Windows/"}  
@{b}Message history@{ub} All the messages you send and receive is saved to
this history buffer.
@{b}@{"HotLine" link "hotline"}@{ub} Public chat.
@{b}@{"Friendsbook" link "friendsbook"}@{ub} Friends list.
@{b}@{"Pagoo" link "pagoo"}@{ub} Pagoo.
The rules - shows the current @{"rules" link "rules"} anybody must follow on AmiComSys.

@{"ARexx/" link "arexxmenu"}  
@{b}Execute arexx script@{ub} - Execute an ARexx script
@{b}Add arexx script@{ub} - Add an ARexx script to the menu.

@{"Settings/" link "Settings"}  
@{b}General ...@{ub} - Opens up the @{"settings window" link "Settings"}.
@{"Ignore users" link "ignorelist"} - Ignore users.
@{b}Show in list >@{ub} Choose if you want to show all, highlight friends, or only
                        show friends in the client list.
@{b}MUI ...@{ub} - Opens up the MUI-Settings.
@{b}Save preferences@{ub} Saves the settings to disc.

@{"Message requester" link "messagereq"} AmiComSys has its own requester.
@{"Iconify individual windows" link "iconifywin" You may iconify windows!

@endnode

@node "clientlist" "Client List"

                            @{TI "Client list"}

All visible connected clients are showed in this list. You can select an entry.

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

If you doubleclick an entry, a requester will appear, which contains information about that client.
(i.e realname, host, login and comment, homepage, ftpsite and IRC-server)
There are five buttons in this requester:
HTTP - Send the homepage address of the selected client to your Web browser, using the arexx script @{"SendWEB.amicomsys" link "SendWEB"}.
FTP - Send the ftp site of the selected client to your web browser/ftp client, using the arexx script @{"SendFTP.amicomsys" link "SendFTP"}.
IRC - Send the irc-server-address of the selected client to AmIRC, using the arexx script @{"SendIRC.amicomsys" link "SendIRC"}
System Info - Send a request for system info. If available you will receive a message with the client's system info.
Close - Do nothing, just continue.

@{HL "In the first column of the list two different characters may appear:"}
# : The user is testing AmiComSys, and therefore is unregistered.
* : The user has decided to register, and therefore are able
to turn off messagehandling and more.
& : The user is away.
% : The user is busy.

@{HL "In the second column this character may appear:"}
^ : The user has his HotLine-window open.


@endnode

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

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

The Client owner will not notice anything. If the client ignores 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.

@{b} When someone sends a file to you@{ub}
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.

With AmiComSys 1.15+ this feature is multithreaded. You can send several
files simultaneously.

There's a maximum of 40 simultaneously open transmission windows.
 
Every window has a Iconfify Window- menu item.

@endnode

@node "Patternstr" "Pattern field"
                            @{TI "Pattern field"}

In the string gadget "Pattern:" you specify which hosts shall get your message when you transmit them by pressing the @{"MultiSend-button" link "MultiSend"}.
e.g. #?.se will send the message to every swede, which is connected to the server.
#? will send to everyone connected to server.
 
@endnode

@node "MultiSend" "MultiSend button"
                            @{TI "MultiSend button"}

If you press this button the message will be sent to every client, which host name match with the specified wild card in the @{"Pattern field" link "Patternstr"}.
Use this sparingly. You are only allowed to send one message every 10 minutes.

@endnode

@node "Messtype" "Message type cycle"
                          @{TI "Message type popup-menu"}

There are three kind of messages. With this choice gadget you specify which you want to use:

@{b}Message@{ub} - A text message.
@{b}Chat 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 page 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"}.

@endnode

@node "Messagestr" "Message text field"
                            @{TI "Message field"}

All messages are typed into this field. There is maximum number of character 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.

@endnode

@node "sendbut" "Send button"
                           @{TI "Send button"}

Sends the message in the message field to the selected client in the client list.

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

The @{"send confirmation" link "programfunction"} can be turned off when press the Send button. ( Not when you press enter in the client field.)

@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:

@{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"} - 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).
 
@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 ...

@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.
Currently only YAM 1.3.x and YAM2.0p5+ is supported.
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, 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\\0HOST\\0TEXT\\0ACTION

You could parse it in Arexx with
PARSE ARG user '\\0' name '\\0' host '\\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
host=the host
act= MSG, CHAT or WEB.
*/
PARSE ARG user '\\0' name '\\0' host '\\0' text '\\0' act

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

It's only for registered users.

@endnode

@node "arexxmenu" "ARexx menu"

                           @{TI "Arexx menu"}

In the ARexx menu you can execute arexx scripts and add arexx scripts to the fast menu.

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

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.

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 ^ in front of
their username in the clientlist.

Messages which is 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, will
open.

With this feature you can chat with somebody while looking at a photo
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}Topic:@{ub} Here you enter a topic, if you want to change it.
@{b}Say:@{ub} Here you enter what you want to say.

In the bottom 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}
@{b}Iconify window@{ub}
Iconify this window.
@{b}Save as ...@{ub}
Save text buffer.
@{b}Quit@{ub}
Close the connection and the window.

@{b}Action menu@{ub}
@{b}Clear buffer@{ub}
Clear the whole text buffer.
@{b}Invite selected user@{ub}
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 bottom.
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 a @{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
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. It's not so easy for me to describe how it's working in just
text. Maybe I should draw a picture.
 
The username display is configurable in the @{"Chat-settings." link "windowsettings"}

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

@endnode

@node "iconifywin" "Iconify individual windows"

                       @{TI "Iconify individual windows"}

Every window has a menu item Iconify Window in it's project menu.
The shortcut is 'Right Amiga i'.
By picking this menu item you may iconify just that window which is 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 some MUI-frame-menu in you can iconify
the whole application. The MUI-iconify-button iconize only the individual window.

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

* pressing the hotkey. (default Left Shift -Left Alt- A)
* 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 AmiComSys, open the ToolTypes and set CX_POPKEY.
Default is CX_POPKEY=lalt lshift a
Hotkey= Left shift, Left Alt and the a-key

@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. For example if you write am and then press
the TAB key, AmiComSys will search through the clientlist till it founds
a username which is matching. If amigafan has joined the Hotline, am will be expanded to 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.

@endnode

@node "friendsbook" "Friendsbook"

                       @{TI "Friendsbook"}

You open the Friendsbook by selecting the Windows-Friendsbook-menuitem.

In it you may insert buddies':
name
username
email
comments
Pagoo ID
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 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.

@endnode

@node "pagoo" "Pagoo"
                       @{TI "Pagoo Menu"}

In the Pagoo menu, a sub menu of Windows menu, you find:

@{b}Check Messages@{ub}
Let AmiComSys check your Online Pagoo Message Box, and tell you if it could found any new
messages.

@{b}Send Message@{ub}
A link to the Pagoo Send Message Home Page.

@endnode

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

With this button found in the main window 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 in the upper right corner of the mainwindow 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 (in Window menu).
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 others connected
but they will not see you.

The last two do only work if you're a registered user.

@endnode

@node "infobar" "Info box"

                       @{TI "The info box"}

In the information box in 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, and may be found in the AmiComSys home directory.

@endnode

@node "messagereq" "Message requester"

                       @{TI "Message requester"}

AmiComSys uses its own message requester.

It does not block other traffic, like the usual AmigaOS one.
It is always centered.
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. (costumizable
in the Window-settings.

You don't have to close a requester before you can get or send another
message.

The message text requesters also has this:
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. 

This requester could also include other features later.

AmiComSys will use MUI-windows for this in a future version, but this GadTools
version will probably be optional.

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

@endnode

@node "ignorelist" "Ignore List"

                       @{TI "Ignore List"}

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

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

There are @{b}one list@{ub} in the window. It shows the curren entries in the Ignore List.
By selecting an entry the checkboxes at the right of the list will show what
what is ignored.

With the button, @{b}"Add selected client"@{ub}, you add a client to the list. That client
will then be deleted from the Client List.

The button, @{b}"Remove"@{ub}, removes the selected entry in the Ignore List.

With the three checkboxes, named "HotLine", "ClientList" and "Msg, PChat & SendFile,
you may specify what is to be ignored for every entry individually.

@{b}HotLine@{ub} - By checking this you won't see any entry in the HotLine from
the added client. You won't notice if it changes the Topic either.

@{b}ClientList@{ub} - By checking this you prevent the client to show its existance
in your Client List.

@{b}Msg, PChat & SendFile@{ub} - By checking this you prevent the added client
to send you messages and 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!

Finally the @{b}Update@{ub} button, which uploads the current settings to the server.

@endnode

@node "rules" "The rules"

                       @{TI "The rules"}

Here is the current rules of AmiComSys: (last updated 980708)

These rules everybody is supposed to follow while using messaging and the HotLine, either it be private or public:

I support free speech, but these rules apply:

§1) NO text that could be offensive or insulting for anybody should be posted to the HotLine's Topic or Say field.
§2) NOONE is allowed to post text which is just garbage in the HotLine, or send a MultiMessage or a Private message with such garbage. Except from taking up unnecessary bandwith it also creates anger by the receiving part.
§3) In your comment you may write whatever you find informative or funny, but remember that this is not a place where you are supposed to accuse people for anything. Such comments easily create a bad atmosphere, and anger, IMHO.
§4) NOONE owns the Topic field. If someone modifies your Topic, show him/she some consideration, and do not change it back to what suits you, right away.
§5) Do NOT use a rude speech.
§6) Do NOT slander eachother.
§7) Do NOT use your comment to spread rumours about AmiComSys!
§8) Do NOT talk about pirate software in the HotLine, or by Multi-Messages, except from how to combat it.
 
Remember:
If you start talking about religion, you are responsible for what happen. Do NOT mail me about infringements of the rules above then! The one who has joined the game must take the consequences!

If anyone use AmiComSys to find IP-addresses to nuke or flood, do not write to me to tell me that, write to the Internet operator of the host which is flooding you! By registering AmiComSys you may hide your IP-address. And 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 out your IP-address and trying to connect to some of your ports. Maybe 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 stealing your files. Another security risc is if your are running a FTP-server at port 21, with an unsecure password, or a Samba-server at port 139. I recommend you to use Miami's IP-filter to block access to certain ports, and use the 'netstat' command to found out which connections that are established.

This rules should make sure that nobody would feel insulted while they are online, and have AmiComSys running. Insulting could also create a bad atmosphere that could make people leave AmiComSys, and that is NOT a thing I want to happen!

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

For your information I also want to tell you that the HotLine is a place that anybody can see, and that 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 advice you to insert that person's login name and/or RealName into your Ignore-list, which you find in the NetWork-security-settings. Then that person should be unable to send you any private message or connect to you via PChat or SendFile.

@endnode

@node "bugg" "Bugs"

                            @{TI "Bugs"}

Known bugs:
* Probably some memory leakage. (mostly caused by amarquee.lib.)
 
If you find a bug, please 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 "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: hparting@hem.passagen.se (permanent)
           id96_har@isk.kth.se (temporary, don't save to address books ...)
           hparting@swipnet.se (last until February year 2001)

   Homepage: http://hem.passagen.se/hparting
             http://www.isk.kth.se/~id96_har
             http://amicomsys.tibb.at
             Faster mirror at http://surf.to/AmiComSys/
   FidoNet: Hakan Parting@2:204/255

Don't send your mail to all the email-addresses. Mail sent to one of them
is forwarded to the other.

NEW! 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 can't send anything to this mailing list.

@{b}Subscribe by sending an empty email to amicomsys-update-subscribe@makelist.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@makelist.com
The mailing list email address is amicomsys@makelist.com


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

Other programs by me is:

VersionWB ****** Current Version is 2.9d (01.04.98)
aminet:util/sys/VersionWB
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.
Now released!. May be found at http://hem.passagen.se/hparting/jamarquee/


**********GlossTask********** Current version is 1.72 (04.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.

Amiga and Workbench is a registered trademark of Amiga International, Amiga Inc.,
Gateway.

ICQ is copyright by Mirabilis.

Pagoo is copyright by Pagoo Communications, Inc.

AmIRC is copyright by Oliver Wagner.

Betterstring.mcc is copyright by Allan Odgaard.

Newstring.mcc is copyright by Rüdiger Sopp.

Textinput.mcc is copyright by Oliver Wagner.

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

Ibrowse is copyright by Omnipresence Intl.

Voyager is copyright by Oliver Wagner.

AWeb is copyright by Yvon Rozijn.

Miami is copyright by Nordic Global Inc.

YAM is copyright by Marcel Beck.

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.

Notification when someone with a specified email address connects.

Possibility to load preferences from disc.
 
Sounds when anything happen.

Multiselections.

Plug-ins. (Registered Arexx-scripts)

Context menu. (clientlist)

Possibility to use bold, italic, center etc. in messages.

Image buttons.

Send emails.

Separate message histories (one for every friend)

User-list in the HotLine

more ?


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

@endnode

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

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

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. I 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 small. You can increase it in the Windows-settings - Message Requester
tab - Activate Delay. Test with increasing it with one second steps and see
if that is enough.

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

This is a very difficult question. Currently it is not possible to do
an Amiga version of ICQ legally. Therefore I won't implement ICQ into AmiComSys,
even though it would be nice!

What will happen in the future I can't tell. Maybe Mirabilis, or the new owners, release
the ICQ protocol, and then I will of course add it to 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://amicomsys.tibb.at/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://amicomsys.tibb.at/clientlist.html

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

* Via email.

Second, how you 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 #.

* If they use Pagoo you can send a message by picking the Windows/Pagoo/Send Message
menu item in AmiComSys. You will then be taken to the Pagoo Send Message Home Page.

* 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 "1.19g (25.07.1998)"}
From 1.19f the PagooID was sent to the server, which makes it show up in your client info, even
though you had set it not do that :( 
Reported by Jonas Davidsson. Thanks!

If one pressed the New button in the Friendsbook, and then directly closed
the window, there will be an empty entry, with just the text New entry in the
name field. This is still the case, but now no Enforcer hits are thrown when
the list is saved to disc. But why would anybody wanting to do that?


@{TI "1.19f (22.07.1998)"}

BUGFIX: Couldn't connect to people that had hidden their IP-address, via PChat
and SendFile :(

When you changed the hide-ip option from ON to OFF the clients didn't
notice it. You had to reconnect to make the server notice that you don't
want to hide your IP-address anymore.
Reported by Frederik Thiesen. Thanks!

Didn't get any message when the receipient of a SendFile request denied
access.

Didn't output any error message when something went wrong while starting
AmiComSys. Probably crashed instead.

Shouldn't put screen to front while you are using the keyboard.

NEW:
Moved the host-column in the client list to the right of the comments.
Created two mailing-lists. Read Contact author in guide for more info.


@{TI "1.19e (19.07.1998)"}

BUGFIX: Corrupted memory list detected in free mem-GURUs could be shown,
meaning there was a LibFreePooled() with the wrong size in the source code.

Some buttons in the AmiComSysMUI.guide (rules and ignore-list) were not working.

Garbage could be shown in the info-box in the upper part of main window,
the first time you were using AmiComSys. (especially under kick 2.0)

Topic changed-notes should not be inserted into the HotLine when
the user hasn't joined the HotLine.

@{TI "1.19d (16.07.1998)"}

BUGFIX: If AmiComSys made your system instable from version 1.19 I hope it's
fixed now. I found one possible cause, but can't be sure if that was the real
cause ... That problem could easily be fixed by removing the .friendsbook file,
though.

The rexx/notifyrexx.amicomsys script got wrong information from version 1.19,
causing for example ACS-Notify showing wrong information.
Reported by the author of ACS-Notify, Scott Beardwood. Thanks!

TAB should not insert ">>>" and "<System>" in a ChatWindow (HotLine and PChat).

Fixed some other bugs in the TAB-completion-mechanism. Hope it fixes the crashes
some users have encountered. Now also works with Textinput.mcc again ...

Fixed some bugs in the ':'-completion of a Chat-Window.

Does no longer insert a space after ':' when you have never addressed
a chat line to anybody.

The HotLine's TAB-expansion and ':'-last nick inserter was very incompatible
to Textinput.mcc, because Textinput.mcc obviously has dropped support for
further string.mui tags :( It also returns strange values when string.mui-tags
are used, which probably caused AmiComSys to crash for some users.

The <System> messages in HotLine was not properly removed from the history
you can cycle through with the cursor up and down keys.

Sometimes when you entered the HotLine you could see the chat lines you have
entered coming back to you. I haven't been able to reproduce this, but I
suspect that it happened when you had the HotLine open while connecting to
the server. There was a race-condition then.
Bug reported by Frederik Thiesen and Alex Tucker. Thanks!

Fixed some security features, which I can't tell you about.

Fixed some layout errors in the Settings window.

Removed the CPS from the SendFile windows.

The old copy of the client data on the server was not removed immediately
when the same client connected again, but this time with another IP-address.
Happen when your host crashed and you have to call up your Internet provider again.

NEW: Only users who have joined the HotLine will be possible to get
with TAB-completion.

Managed to tweak the CPU-usage while in sleeping state back to 0.0%, and
reduced the CPU-usage while the program is used, by stop using MUI's timer.

Added a window with the current rules of AmiComSys. Window menu-The Rules.

When someone modifies the Topic in Hotline a message is inserted into the
list.

The SendEmail.amicomsys script was updated. It now works with both YAM 1.3.x
and YAM2.0p5. The text is now also inserted into the mail editor.

It's no longer possible to send messages to clients you have on your ignore-list.

Added "Super-Ignore". You can ignore clients in the ClientList, HotLine
and messaging by adding an entry to The AmiComSys Ignore List found
in the Settings menu ->"Ignore users". By activating all options you may remove
a certain client entirely from AmiComSys. Only registered users may ignore
client messaging via the Ignore-List in the Ignore-list-window, but the
less efficient one in the Network-settings still works. When Message ignore
is activated the ignored client can't even get your Version-info or System-Info!

@{TI "1.19c (23.06.1998)"}
NEW: Changed the internal addressing scheme to make AmiComSys more efficient
on the server side and by the same time added support for several users
connecting from the same fire wall. This could lead to incompatibility problems
with older versions of AmiComSys. So please update your copy of AmiComSys now!

BUGFIX: Memory leakage in Pagoo-checking

The information line in the upper part of the main window wasn't updating anymore.

It should now be possible to send normally long URLs, beginning with http://,
with WEB-messages.

An Enforcer hit was thrown when the "Send" gadget was pressed in the
Message Requesters.

Bug in the word length counter which forced you to use words with a length
less than 50 characters. Now 65 i maximum length.

@{TI "1.19b (17.06.1998)"}
BUGFIX: HotList online/offline status was not updated after a reconnect.
Reported by Rolf Bollmann. Thanks!
NEW: Updated Pagoo-check to the current standard. (to make it work again ...)

@{TI "1.19a (08.06.1998)"}
BUGFIX:
The hotline were not working. Hm. last second fix.
The TAB-completion weren't working as intended.
The ICQ # were not saved.
MUI-codes were saved in the Chat-window's save function, that
was not intended. User enterned and user left is also not saved anymore.
Thanks Frederik Thiesen for reporting this!

@{TI "1.19 (06.06.1998)"}

NEW:
Now you are able to connect to clients behind a firewall with PChat
and SendFile fully transparently, if you are not behind a firewall yourself.
Set the setting "I'm behind a firewall" in the network settings if
your are behind a firewall or have very restricted access in Miami-IP-filter
(if port 1024-32767 is rejected).

AmiComSys now can check your Pagoo message box at regular intervals, so you don't
have to waste your time looking at your online center manually.
Look at http://www.pagoo.com for more info about Pagoo.
When a new message arrives a message will pop up after a while (depends
on your settings) asking you to visit your Online Pagoo Message Box.
Pagoo already provide you with the service to send you an email asking
you to visit your Message Box online. If you want you can switch that service
off and use AmiComSys instead, but it is you choice. Personally I like this
better, I don't want my in-box in YAM filled with Pagoo-notifications. I'm
too lazy to delete them :)

You can set the position of the iconify-icon of the mainwindow in
the Iconification-settings at the Program-settings-page.
Suggested by Asha. Thanks!

Add a link to a photo of yourself in the Personal-settings-System tab, so
the one your are chatting with, via PChat, may download the photo and
having it inserted into the PChat window.

Friendsbook relayouted.

One can see if a client is away or busy by looking into the client info
window, but now registered users can see it directly in the list. The letter
# or * at the beginning of each client in the list will change to a '&' for away
status and a '%' for busy status.
Thanks to Alex Tucker for the suggestion!

The message history is now automatically saved when the connection
to the server is lost, instead of when the program quit. If found out that
if you have AmiComSys in SYS:WBStartup you never quit it!
AutoSave must still be set to on in the Windows-settings - Message History tab.
This is disabled in the unregistered version of AmiComSys.

The message you enter in the Hotline will be inserted into the list
directly, without first waiting for it to come back from server. It think
this is better and I think most of the IRC clients for Amiga are using this
technique.

Messages which is for you is now highlighted in the HotLine.

If you are using Tab-completion in the HotLine and seek word entered is
ambigous the first entry in the client list will be inserted. If this
is not the right one, just press Tab again and the next entry in the list will
be inserted!

The Tab-completion is now case-independent.
Last two are suggested by Frederik Thiesen. Thanks!

It's now possible to hide your IP-address/host name from the client-list.
Settable in the security settings at the network-settings-page. This is
only working for registered users.

If you have an ICQ # you can insert it into the Pagoo/ICQ settings. Then
people can see you ICQ# in the client-list, and it will also link to your
personal ICQ Message center.

You can now enter a second home page in the personal settings. Choose
between a ftp-site or a second homepage.

Added settings "Enable Message Center" at the network-security settings
page. Default is checked, i.e, enabled. If you disable it people can't send
you messages from the AmiComSys Message Center at the AmiComSys home page.
Last two suggested by David Hamilton. Thanks!

Messages sent to a multiple number of clients now have the word "Multi" in
the window title.

Added nick names to the SendFile windows.
Also suggested by Fredrik Thiesen.

Updated the Message-Center, and the message requester in AmiComSys.
Thanks for the suggestions David Hamilton!

If you add a client to the Friends book, via the Add-button, the client
list will be updated.
Suggested by Alex Tucker. Thanks!

BUGFIX:
The icon was buggy. Resaved it with another program

Connection refused was showed in pchat when one of the people connected
broke the connection (only in multi-PChat (Invite selected client)).

Only the registered version of AmiComSys received messages sent
from the AmiComSys-server, i.e. messages sent from the Message-Center
and other important messages from the author (the permissions weren't set
right) :(

Only the first user in the ignore list was actually ignored, the rest
was ignored by AmiComSys :(

If going from offline status to invisible status, info about the client
was sent. Therefore it was showed in the list for a while in the list before
it was deleted.
Bug reported by David Hamilton. Thanks!

The info in the upper part of the window sometimes were printed on top of the
list! Should be fixed now.

AmiComSys freezed if the message requester failed to open due to
unsufficient memory.

@{TI "1.18d (09.05.1998)"}
BUGFIX: The settings were not saved correctly, which lead to clients having
the wrong information at wrong places in the client list. I appologize for
the inconvenience if your settings file "amicomsys.config" is totally corrupted.
This bug first appeared in version 1.18b.
Bug reported by Alex Tucker. Thanks!

The PChat was not working at all :(

@{TI "1.18c (06.05.1998)"}
BUGFIX: AmiComSys crashed, with guru #8100 005? or something else, when a connection
with PChat was refused by the host. Should only happen if the one one tries to connect to
is behind a firewall. Now a "Connection refused" message shows up. In the future version, 1.19,
it will be possible to connect with PChat and SendFile to hosts behind a firewall.

The icon now has a transparant background colour.

@{TI "1.18b (29.04.1998)"}
NEW: Does no longer use TCP device. Made real network code instead, which
     now makes it work with Termite TCP without problems. Some problems with
     hanging TCP-device-tasks should now also have disappeared.

BUGFIX: Another corrupted memory list error (guru #8100 0005) when using
        TAB-completion in PChat and Hotline.
        Bug reported by Kenneth Craig. Thanks! If Gurus in PChat reported by
        others also disappeared after this fix is unknown, cause I could never
        reproduce them.

@{TI "1.18a (21.04.1998)"}
BUGFIX: If you used Textinput.mcc as string gadget there was actually a
        limit of about 46 characters in the PChat and HotLine.
        That limit is now removed.

        Kickstart v37 users now use string.mui

        A couple of freemem with the wrong length (guru #80000005).
        Thanks to all who reported this bug! (wonder why it never happened
        on my Amiga ...)

        Removed a null pointer access when noone was selected in the
        client list and you tried to send a message or requesting version
        info.

        Fixed incompatibility with A4000.
        Thanks to Håkan Magnusson and Steven Lyon for helping me finding
        the cause.

        The AmiComSysRegister and AmiComSysMakekey liked to crash your
        amiga (stack overflow) :(

        Fixed 68000 incompatibility in PChat and HotLine. You can now chat
        with people with this kind of processor without causing
        his/her computer to crash.

        The Betterstring.mcc now works with 68000 CPU.

        Workaround so PChat and Hotline will work without any crashes on
        68000, whether of not the one your are chatting with are using
        AmiComSys 1.18a or lower.
        Bug reported by Mike Constantine. Thanks!

        Kickstart v37 owners should use NList.mcc version 19.86+ (1998-04-13)

        Replaced the kick 37-replacement of the poolmem-functions, because it
        was broken somehow (led to crashes at exit).

NEW: To make it possible to use MUI-windows for the message requesters
     in future you have to set the MUI-iconification at startup to off.
     AmiComSys has it's own iconification-facility at the program
     settings page, the program tab - Iconification group.
     "No GUI at startup" is the same as MUI-prefs system-settings -
     Iconify at start up. You can also decide if an icon should appear on
     the Workbench and/or an AppMenu should be added to the Workbench
     tools menu when AmiComSys is in iconified state.
	 See @{"Program settings ..." link "programsett"}

     The MUI-iconify button which can be showed in the upper right corner
     of each window iconize just the window which you pressed the button in.
     Then there are a menu item in AmiComSys Project menu - Iconify application:
     It will use the MUI settings for Iconification and hides the whole application,
     i.e. all windows.

     The ToolType CX_POPUP now works again. (CX_POPUP=YES opens the main
     window at startup.)

@{TI "1.18 (12.04.1998)"}
BUGFIX: Message requester: The light gray background fill entered the string
        gadget's domain.
        Reported by Allan Odgaard. Thanks!
        
        Message History: Texts with new lines were truncated.

        Information box in upper part of main window: Stopped working, due to
        server software update. It also crashed if the server had crashed :(

NEW: Added MUIA_String_AdvanceOnCR to all the string gadgets, so return now
     behaves like TAB.

     If you forget to send a text you have entered into the text field in the
     message requester AmiComSys will notify you.

     Removed limit of message length in HotLine and Private Chat (PChat).
     (If you are using Newstring.mcc as textfield gadget there is a limit of 500
     characters.)

     Added smart activate, which means that the message requesters don't steal the
     current focus while you are using the keyboard. The time since the last key
     press and when it is okey to open in active state is settable in the window
     settings page - Message requester tab (Activate delay). @{"See ..." link "windowsettings"}
     Above sugguested by Allan Odgaard. Thanks!

     Empty messages are not sent anymore.

     Changed string-class settings, so you have to set it again. Betterstring.mcc
     is now default for the 68020+/WB3.0+ version.

     If the default public screen is to small for the message requester a new screen
     will open.

     The message requester handles new lines in a better way. It is now also able to
     show text in bold, italic and underlined style. Also added justification (left,
     right and center). Notice that you currently cannot send such a message ...

     You can now choose if the email entered into the settings should be showed to
     the public, in the personal settings (Public).

     Added a banned user setting on the network-settings-page, due to popular demand.
     Insert nick names or real names of people who harass you or you don't want to
     talk with. @{"See ..." link "networksettings"}

     The old banned users setting for registered users was removed. The Autosave-
     history feature is now registered users only.

     Removed Topic text field from the PChat-windows.

     Made the Client Info requester a MUI-window. To send the home page to your
     browser you now have to press the http://domainname button.

<removed version 1.17 to 1.9>

@{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 AMarquee.library.
Thomas Steinbichler for the full-time AmiComSys server site at
amicomsys.tibb.at.
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)

For bug reports and suggestions:
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, USA.
Frederik Thiesen, Sweden.
Jonas Davidsson, Sweden.

@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"}

@{"Daylight Savings Time" link "timezonesettings"}

Gadgets in main window:
    @{"Clientlist" link "clientlist"}
    @{"Message field" link "Messagestr"}
    @{"Message type" link "messtype"}
    @{"MultiSend" link "MultiSend"}
    @{"Pattern field" link "Patternstr"}
    @{"Send" link "sendbut"}
    @{"SendFile" link "sendfilebut"}
    @{"Version" link "versionbut"}

@{"HotLine" link "hotline"}

@{"Ignore clients (completly)" link "ignorelist"}

@{"Ignore clients" link "networksettings"}

@{"Menus" link "features"}

@{"Message requester" link "messagereq"}

@{"PChat" link "pchat"}

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

@{"Public chat" link "hotline"}

@{"Rules" link "rules"}

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

Settings:
    @{"Chat" link "windowsettings"}
    @{"Logging" link "programsettings"}
    @{"Message History" link "windowsettings"}
    @{"Message requsters" link "windowsettings"}
    @{"Program function" link "programsettings"}
    @{"Personal info." link "personalsettings"}
    @{"Security" link "networksettings"}
    @{"Server" link "networksettings"}
    @{"TimeZone" link "programsettings"}

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

@endnode

