@database AmiComSysMUI.guide @master AmiComSysMUI.guide @index ACSindex @$VER: AmiComSysMUI.guide 1.39 (25.01.98) @author "Håkan Parting"@(c) "Håkan Parting 1998" @FONT times.font 15 @WORDWRAP @node "Main" "Contents" @{b}@{fg shine}Amiga Communication System 1.16a-MUI@{ub}@{fg shine}@{fg back}@{fg text} http://amicomsys.tibb.at Copyright © 1997-1998 Håkan Parting All rights reserved. ShareWare Read History for new features ... Read upgrade to 1.16 to upgrade. @{"Copyright and disclaimer" link "Copyright"} @{fg shine}This work is mine, but I'm not responsible for any damage.@{fg text} @{"ShareWare registration" link "registration"} @{fg shine}What I want from you@{fg text} @{"Introduction" link "Intro"} @{fg shine}What is this?@{fg text} @{"Requirements" link "Requirements"} @{"Installation" link "Install"} @{fg shine}How to install@{fg text} @{"Upgrade to 1.16" link "upgrade"} @{"Usage" link "Usage"} @{fg shine}How to use it.@{fg text} @{"Features" LINK "Features"} @{fg shine}The user interface ...@{fg text} @{"Settings" LINK "Settings"} @{"ARexx interface" LINK "ARexx"} @{"History" link "history"} @{fg shine}Fixed bugs and improvements.@{fg text} @{"To do" link "todo"} @{fg shine}Future@{fg text} @{"Bugs" link "bugg"} :-( @{"The Author" link "me"} @{fg shine}Contact me!@{fg text} @{"Credits" link "thanks"} @{"Updates" link "updates"} @{fg shine}Where to find updates@{fg text} @{"Trademarks" link "trademarks"} @{"Index" link "ACSindex"} @endnode @node "Copyright" "Copyright" @{b}@{u}@{fg shine}COPYRIGHT@{uu}@{fg text} @{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" @{b} @{fg shine}@{u}ShareWare registration@{uu}@{fg text}@{ub} @{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: * 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. 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 ... The registration fee is currently: For an uuencoded or MIMEd emailed keyfile: @{b}120 SEK OR 16 US$@{ub} Send the fee in bills with a letter telling me that you want to be a registered user of AmiComSys. No other currencies than US Dollar or Swedish Crowns (SEK) 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}Other options to send the fee:@{ub} *International Money Order with the amount of 120 SEK or more ;) *Bank-transfer (people not living in Sweden): Then you must first contact me by email, or directly in AmiComSys for current conditions. This is probably the most expensive option, cause you must add 30 SEK to the registration fee (total amount of 150 SEK) and probably you have to pay a high fee to your bank too. Please transfer the fee (150 SEK) to my bank account 5392-00-39742 in the bank "Skandinaviska Enskilda Banken (SEB)" of Sweden, Håkan Parting. *Bank-transfer (people living in Sweden): (in Swedish:) Mitt Postgiro är 421 38 50-3. Jag har också ett konto i SE-Banken om du föredrar det. (Borde inte vara någon insättningsavgift :) Kontonummer: 5392-00-39742 Registreringsavgiften är minst 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 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 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" @{b}@{fg shine}@{u}Updates@{ub}@{uu}@{fg text} The most recent version can always be found on Aminet:comm/net/AmiComSysMUI.lha (e.g. us.aminet.net, se.aminet.net/pub/aminet) Latest version always available at my homepage: http://hem.passagen.se/hparting/amigapa.html or http://amicomsys.tibb.at @endnode @node "Intro" "Introduktion" @{b}@{fg shine}@{u}Introduction@{ub}@{fg text}@{uu} 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. Future updates will include more. Please put it in your Online-script or wbstartup drawer and enjoy ... AmiComSys requires amarquee.library v.45+ 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_75.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 Kickstart 2.04. 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 See @{"To do" link "todo"}. @endnode @node "Requirements" "Requirements" @{b}@{fg shine}@{u}Requirements@{ub}@{fg text}@{uu} 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://hem.passagen.se/hparting/amigapa.html An tcp/ip-stack like Miami, AmiTCP3.0b2+. INET225 users should use some kind of bsdsocket.library->socket.library mapper. The TCP: device must be available. (It is in Miami and AmiTCP and possibly more stacks) The shared library AMarquee.library v.45+. 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_75.lha The MUI custom class BetterString.mcc. Included in the archive. (MUI/libs/BetterString.mcc) NOTE: If you have Kickstart 2.04, the MUI costum class Textinput.mcc is required, and BetterString.mcc can't be used. @endnode @node "Install" "Installation" @{b}@{fg shine}@{u}Installation@{ub}@{fg text}@{uu} 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). AMarquee v.45+ 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.15a" @{b}@{fg shine}@{u}Upgrade from an earlier version@{ub}@{fg text}@{uu} @{b}New files since version 1.14abc are:@{ub} AmiComSys/AmiComSys.MUI AmiComSys/AmiComSys.MUI.info AmiComSys/AmiComSysMUI.guide AmiComSys/Contrib/AmiComSys.dock AmiComSys/Rexx/SendWEB.amicomsys AmiComSys/Rexx/SendFTP.amicomsys @{b}New files since version 1.15 are:@{ub} AmiComSys/AmiComSys.MUI AmiComSys/AmiComSysMUI.guide AmiComSys/Rexx/SendWEB.amicomsys AmiComSys/Rexx/SendFTP.amicomsys @{b}New files since version 1.15a are:@{ub} AmiComSys/AmiComSys.MUI AmiComSys/AmiComSysMUI.guide @{b}New files since version 1.15b are:@{ub} AmiComSys/AmiComSys.MUI AmiComSys/AmiComSysMUI.guide AmiComSys/Rexx/SendWEB.amicomsys AmiComSys/Rexx/SendFTP.amicomsys AmiComSys/Rexx/SendIRC.amicomsys AmiComSys/Rexx/Ping.rexx AmiComSys/Rexx/Finger.rexx AmiComSys/Rexx/Talk.rexx AmiComSys/Contrib/MenuImages/ AmiComSys/Contrib/ReadMe @endnode @node "Usage" "Usage" @{b}@{fg shine}@{u}Usage@{ub}@{fg text}@{uu} @{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 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 = : The loginname you want to use in AmiComSys. NAME = : The realname you want to use. COMMENT = : The comment you want to be showed next to your name. EMAIL = : Your email address. It will not be showed for others. It will has a usage in a future version. HOMEPAGE = : FTPSITE = : 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 = 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 ICONIFIED=Yes/No MULTIPLE=Yes/No REALNAME=Yes/No USERNAME=Yes/No LOGIN= NAME= COMMENT= EMAIL= RECONNECT=Yes/No HOMEPAGE FTPSITE PROGDIR= 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" @{fg shine}@{u}@{b}Settings@{ub}@{uu}@{fg text} 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. @{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" @{fg shine}@{u}@{b}Personal & System info settings@{ub}@{uu}@{fg text} @{fg shine}Tab - Personal info@{fg text} @{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}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@{ub} - Same as TOOLTYPE FTPSITE Here you can advertise your FTP-server-address. It must start with ftp:// 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 @{fg shine}Tab - System info@{fg text} 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. @endnode @node "networksettings" "Server & Security Settings" @{fg shine}@{u}@{b}Server settings@{ub}@{uu}@{fg text} @{fg shine}Server settings group:@{fg text} @{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. @{fg shine}Security group@{fg text} @{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. @{b}Banned@{ub} With this option you can disable messages from specified users, with patternmmatching (wildcard). e.g. (badguy|ibmfan) will not allow badguy and ibmfan to send messages to you. @{b}Enable Messages@{ub} This must be checked if you want to receive messages. @{b}Enable MultiMess@{ub} This must be checked if you want to receive messages sent with pattern matching (MultiSend). @{b}Enable SendFile@{ub} This must be checked if you want to be able to receive files. @{b}Enable PChat@{ub} This must be checked if you want to be able to receive Private Chat requests. @endnode @node "programsett" "Program Settings" @{fg shine}@{u}@{b}Various program settings@{ub}@{uu}@{fg text} @{fg shine}Tab - Program@{fg text} @{fg shine}Program function group@{fg text} @{b}IconifyWhenClose@{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 disiconified again by using the hotkey. Default is unchecked. @{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 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 should be set to No. If yes, AmiComSys will try to reconnect one time every minute if connection is lost. @{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} - The date will be appended to the file name. @{fg shine}Tab - Various@{fg text} @{fg shine}TimeZone settings group@{fg text} 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 normal time, and therefore chould be unchecked. @{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 ...) @{fg shine}Use string class settings group@{fg text} Choose the string-gadget you like best ... It will be used in every stringgadget, except for the comment field in the Friendsbook. You must restart AmiComSys for the setting to take effect. @{b}Try NewString, then Betterstring@{ub} This is default. If NewString.mcc is found it will be used. If not BetterString.mcc will be used. AmiComSys requires BetterString.mcc @{b}Newstring.mcc@{ub} Use Newstring.mcc. @{b}BetterString.mcc@{ub} Use BetterString.mcc @{b}Textinput.mcc@{ub} Use Textinput.mcc @{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" @{fg shine}@{u}@{b}Window settings@{ub}@{uu}@{fg text} @{b}Tab - Chat Windows@{ub} @{b}Column name Display:@{ub} Specify how the username shall be shown. Realname & username, Realname, or only Username. @{b}Tab - Message History Windows@{ub} @{b}Column name Display:@{ub} Specify how the username shall be shown. Realname & username, Realname, or only Username. @{b}Tab -Message requester settings:@{ub} @{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 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. . @{b}Close requester after send@{ub} Should the message requester close when you press the send button. Default is no. @{b}Max-horiz-chars@{ub} Specify the width of the requester in characters. Defaults to 50 characters. @endnode @node "miscsettings" "Misc Settings" @{fg shine}@{u}@{b}Misc settings@{ub}@{uu}@{fg text} @{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) 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. @endnode @node "Features" "Features" @font Courier.font 15 @{b}@{fg shine}@{u}Features@{ub}@{fg text}@{uu} 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. @{b}Menu@{ub} @{b}@{fg shine}Project/@{fg text}@{ub} @{b}About@{ub} - Shows info about AmiComSys. @{b}Iconify Window@{ub} - Iconifies the main window. @{b}Iconify@{ub} - Iconifies the whole application (all windows). @{b}Quit@{ub} - Will quit AmiComSys. @{b}@{fg shine}Windows/@{fg text}@{ub} @{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}@{fg shine}@{"ARexx/" link "arexxmenu"}@{fg text}@{ub} @{b}Execute arexx script@{ub} - Execute an ARexx script @{b}Add arexx script@{ub} - Add an ARexx script to the menu. @{b}@{fg shine}@{"Settings/" link "Settings"}@{fg text}@{ub} @{b}General ...@{ub} - Opens up the @{"settings window" link "Settings"}. @{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" @{b}@{fg shine}@{u}Client list@{ub}@{fg text}@{uu} All connected clients are showed in this list. You can select an entry. If you doubleclick an entry, an requester will appear, which contains information about that client. (i.e realname, host, login and comment) 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. Cancel - Do nothing, just continue. In front of the clientname three different characters may appear: ^ : The user has his HotLine-window open. # : The user is testing AmiComSys, and therefore is unregistered. * : The user has decided to register, and therefore have possibiblity to turn off messagehandling and bann users and more. @endnode @node "versionbut" "Version button" @{b}@{fg shine}@{u}Version button@{ub}@{fg text}@{uu} @{b}Version@{ub} Sends an Version request to the selected client. You will then get the version information of the AmiComSys the client is using, send as message to you. The Client owner will not notice anything. @endnode @node "sendfilebut" "Send File" @{b}@{fg shine}@{u}Send File button@{ub}@{fg text}@{uu} 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 will 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" @{b}@{fg shine}@{u}Pattern field@{ub}@{fg text}@{uu} 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. @endnode @node "MultiSend" "MultiSend button" @{b}@{fg shine}@{u}MultiSend button@{ub}@{fg text}@{uu} 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"}. @endnode @node "Messtype" "Message type cycle" @{b}@{fg shine}@{u}Message type popup-menu@{ub}@{fg text}@{uu} There are three kind of messages. With this cycle 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. Of course a Web-browser must be running too. If it is not the system will ask for a path to your web browser. The path included in the SendWEB.amicomsys script is not right. You have to change this ... See @{"SendWEB.amicomsys" link "SendWEB"}. @endnode @node "Messagestr" "Message text field" @{b}@{fg shine}@{u}Message field@{ub}@{fg text}@{uu} 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. @endnode @node "sendbut" "Send button" @{b}@{fg shine}@{u}Send button@{ub}@{fg text}@{uu} 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" @{b}@{fg shine}@{u}ARexx interface@{ub}@{fg text}@{uu} 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 .@{ub} - Use it with GET to get the result included in structure. e.g. GET STEM info. @{b}VAR @{ub} - Copy the result to the variable . @{b}GET@{ub} - Get information from AmiComSys. @{b}Parameters:@{ub} CLIENTLIST - Get info from clientlist. e.g. GET STEM info. CLIENTLIST @{b}Results: info.@{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 @{i}The following needs the parameter CLIENTLIST specified@{ui} numclients - Number of connected clients. selected - The index 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 - The Login name. REALNAME - The Real name. 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 - The path to the logging file. LOGLEVEL - The logging level. SELECTED - Select the user-client. HOTLINE - 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 - The username 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. 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. The program includes a menu @{"Arexx" link "arexxmenu"}. @endnode @node "sendweb" "SendWEB" @{b}@{fg shine}@{u}SendWEB@{ub}@{fg text}@{uu} 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" @{b}@{fg shine}@{u}SendFTP@{ub}@{fg text}@{uu} In the client info requester, which will appear if you doubleclick on a client, there is a FTP button. 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" @{b}@{fg shine}@{u}SendIRC@{ub}@{fg text}@{uu} In the client info requester, which will appear if you doubleclick on a client, there is a IRC button. 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 your AmIRC is not started this will not succed. To start it automatically: enter the path to your AmIRC in the Misc-settings. Make sure you have the latest rexx-scripts. (SendIRC.amicomsys). @endnode @node "notifyarexx" "Notify ARexx" @{b}@{fg shine}@{u}NotifyARexx@{ub}@{fg text}@{uu} 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 You could parse it in Arexx with PARSE ARG host user action con= connecting, upd=updating, dis=disconnecting It's only for registered users. There's a script by Scott Beardwood at Aminet:comm/net/ACS-Notify.lha @endnode @node "messagearexx" "Message ARexx" @{b}@{fg shine}@{u}MessageARexx@{ub}@{fg text}@{uu} The arexx script MessageARexx.amicomsys is run when: - A text, chat or WEB -message arrives If the 'Replace ACS's requsters' is enabled in settings this script will take over the message handling of AmiComSys. This 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" @{b}@{fg shine}@{u}Arexx menu@{ub}@{fg text}@{uu} 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)" @{b}@{fg shine}@{u}HotLine (public chat)@{ub}@{fg text}@{uu} 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. 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" @{b}@{fg shine}@{u}Private chat@{ub}@{fg text}@{uu} 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. A request for a private chat will be sent to the remote host. If he/she accept you're connected, and may exchange text messages. @{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. 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. 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 in that window. 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 inidividual windows" @{b}@{fg shine}@{u}Iconify individual windows@{ub}@{fg text}@{uu} 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. By choosing Iconify in menu or some MUI-button in the Window-frame you can iconify the whole application. If you iconify the main window or the whole application it can be deiconified by pressing the hotkey. (default Left Shift -Left Alt- A) @endnode @node "chatwkeybindnings" "Chat Window's keybindings" @{b}@{fg shine}@{u}Keybindings in chat windows@{ub}@{fg text}@{uu} 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. 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 is online, am will be expanded to amigafan: @{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" @{b}@{fg shine}@{u}Friendsbook@{ub}@{fg text}@{uu} You open the Friendsbook by selecting the Windows-Friendsbook-menuitem. In it you may insert name, username, email and comments of buddies. 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. It's hidden. If you try to insert a email in the email-textfield it will be compared agaist 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 reqognize people in a future version of AmiComSys. @endnode @node "statuscyc" "Status choice" @{b}@{fg shine}@{u}The status popupmenu@{ub}@{fg text}@{uu} 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" @{b}@{fg shine}@{u}The info box@{ub}@{fg text}@{uu} In the information box in upper part of the main window, various information will be showed. No text in it is hardcoded in the program. @endnode @node "messagereq" "Message requester" @{b}@{fg shine}@{u}Message requester@{ub}@{fg text}@{uu} 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. 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. You can configure the requester at @{"Windows settings" link "windowsettings"} @endnode @node "bugg" "Bugs" @{b}@{fg shine}@{u}Bugs@{ub}@{fg text}@{uu} Known bugs: * Probably some memory leakage. (most 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" @{b}@{fg shine}@{u}The author@{ub}@{fg text}@{uu} 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: Snail-mail: Håkan Parting Organistv. 11 SE-17579 Järfälla Sweden E-mail: hparting@hem.passagen.se id96_har@isk.kth.se Homepage: http://hem.passagen.se/hparting http://www.isk.kth.se/~id96_har FidoNet: Hakan Parting@2:204/255 Don't send your mail to both the email-addresses. Mail sent to one of them is forwarded to the other. My computer system is: Amiga 1200Tower/68030/50MHz/18MB/540MB/CD-Drive/USR Sportster Voice 33.6. Other programs by me is: VersionWB ****** Current Version is 2.9c (31.12.97) aminet:util/sys/VersionWB An AmigaDos Version replacement which supports XFD and shows version info in a requester. **********GlossTask********** Current version is 1.71 (08.01.97). 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. @endnode @node "trademarks" "Trademarks" @{b}@{fg shine}@{u}Trademarks@{ub}@{fg text}@{uu} Amiga and Workbench is a registered trademark of Amiga International Inc., Gateway 2000. AmIRC is copyrighted by Oliver Wagner. Trademarks mentioned are owned by their respective owners. @endnode @node "todo" "To do" @{b}@{fg shine}@{u}To do@{ub}@{fg text}@{uu} Future versions will include: Search feature. File server features. Localization. Notification when someone with a specified email address connects. Possibility to load preferences from disc. Possibility to hide/show specified users. Sounds when anything happen. Your own ChatRooms. Multiselections. Plug-ins. (Registered Arexx-scripts) Context menu. (clientlist) Possibility to use bold, italic, center etc. in messages. more ? Is anything missing, tell @{"me" link "me"}. @endnode @node "history" "History of changes" @{b}HISTORY@{ub} @{fg shine}1.16a (25.01.1998) ------------------@{fg text} NEW: Added arexx command SET STATUS. With it you may set the current status. (OFFline, ONLine, AWAy etc.). It's also possible to get the current status. To get a newline with the rexx commands REQUEST and REQUESTA you now must insert the rawkey code 13. (10 can't be used). BUGFIX: Some icons was just squares if you were not using Newicons. Reported by Jeremy Friesner. Thanks! Several fixes to make it work with Kickstart 2.04. Betterstring.mcc does only work with kickstart 3.0+, therefore Textinput.mcc is required for Kickstart 2.0 users. Thanks to Fredrik Zetterlund and Jeremy Freisner for helping me to find these bugs! Forgot to close asl.library. SendIRC.amicomsys now always open a new copy of AmIrc. @{fg shine}1.16 (18.01.1998) ------------------@{fg text} NEW: Online, Offline, Away, Busy and Invisible status implemented. Current status for a client is showed in the client info requester. When you are away, arriving messages will be saved to the Message History buffer. Received messages while away will be highlighted. Number of waiting messages is showed in the info-text-area in the upper part of the window. The message which is sent to connecting clients, while away, is costumizable in the Program-settings-page-various tab. The Settings-window now have a MUI 3.0 look ... The arexx script "Rexx/MessageArexx.amicomsys" may now be executed automatically by AmiComSys when a message arrives. It could totally replace AmiComSys's message-requsters. You may do a rexx-script which show the message text somehow, or play a sound. If you just want to play a sound the checkbox "Replace ACS's requester", found in the Misc-settings-page, shall be unchecked. With the Arexx command SET MESSAGEAREXX 0/1 you can enable or disable this script. Added some keybindings to the Chat-window-textinput-fields. TAB-nickname-expansion and ':'-nickname-expansion. You may browse through the message in the list with the cursor keys. The text will be inserted into the textinput-fields. AmiComSys does not support the old String.mui-class anymore. The mui-costum-class BetterString.mcc is required. It's included in the archive. You may choose the string-class you like best. (BetterString.mcc, Newstring.mcc or Textinput.mcc) Private chat is now implemented. Press the PChat-button, while a client is selected. It's also possible to connect one chat window to several clients. Added ASK parameter to the Arexx SEND command. A confirmation requester will come up if specified. (Always if unregistered version). Added arexx commands REQUEST and REQUESTA. With it you can use AmiComSys's two kinds of message requesters. Changed layout in About-requester. Added number of connected clients. Added friendsbook. (windows menu). Idea by Rolf Bollmann. Thanks! Added Add button to main window. With it you add entries to the friends- book. You must open and close the friendsbook window for it to be saved. Added System-info to client info and settings. It's now possible to adjust the maximum width of the requesters. (windows- settings-Message requester tab-Max horiz chars). Added IRCServer-path to personal settings and client info. You may advertise your IRC-server. Any window may now be iconified separately! Just the window, not the whole application. Optimized for MC68020. 68000 version available at my homepage. BUGFIXES: The status-popup-menu was not working right. The info-textbox got an extra new line after the window was updated. AmiComSys did not remove broken connections from the server when the same client went online again, but with another IP-address. Reported by Thomas Steinbichler. Thanks! Removed enforcer flood, which happened when the Arexx command GET CLIENTLIST was used :-( @{fg shine}1.15b (21.12.1997) ------------------@{fg text} BUGFIX: The filerequesters now open the front most screen, if it's public. NEW: The sendFile tcp-server-port is now reused. BUGFIX: Message could open on any screen, even though they were not public. Bug reported by Fredrik Zetterlund. Thanks! NEW: Removed the iconified-option in program settings. You may set this in the MUI-system-settings. NEW: Added Arexx command SEND FILE NAME. Where NAME is the filename of the file you want to send. NEW: Renamed chat-settings-tab to Windows. NEW: Added possible to specify what you want to be showed in the Message History under the Windows-tab. NEW: Added message requester public screen setting. And whether the screen the requester shall pop up on should be brought to front, or not. Default is front-most-screen and therefore not bring screen to front. NEW: Moved 'beep when new message' and 'Send confirmation' to Windows-Mess-requester tab. NEW: Added possibility to let the message requester close when you press the send-button in the requester. See Windows-Mess-requuester-tab. Disabled for unregistered users. Suggested by Fredrik Zetterlund. NEW: Added info field above the clientlist. NEW: Added possibility to go offline or online with a cycle gadget above the clientlist. Away, Busy and Invisible status will come later ... NEW: The TCP: device is now required. Mounted automatically by most TCP/IP-stacks (ie. Miami, AmiTCP). @{fg shine}1.15a (7.12.1997) ------------------@{fg text} BUGFIX: There could be a memory curruption with the Hotline, when long texts were sent. The maximum transmission length was set to low. hm :-( so the block was truncated. Thanks to Sonat Böler and Fredrik Zetterlund for helping me to track this bug down. NEW: NotifyArexx.amicomsys is now excuted with arg string 'loginname hostname dis/con/upd' NEW: Added Arexx Command SEND MSG/S CHAT/S WEB/S FILE/S USER TEXT, with which you can send messages and files through Arexx. Suggested by Scott Beardwood. NEW: Dropped support for AmiComSys version 1.14 and lower. This means that clients using version 1.14- won't be seen in the clientlist. For now they will see you. Therefore the gadtools version of AmiComSys is unsupported and should be removed from AmiNet & website. NEW: Added Arexx Command SET SELECTED NEW: Added Arexx Command SET HOTLINE open/closed NEW: Modified the clientlist refresh to a smarter one. NEW: Added Chat-tab to settings window. NEW: You now can specify whether you want the HotLine-window to show Realname & username, Realname or username. Suggested by Sonat Böler. BUGFIX: The message requesters now open on the front most screen, if it's a public screen. Hm. where is the Public Screen Manager, Commodore are talking about in the autodocs ... @{fg shine}1.15 (16.11.1997) -----------------@{fg text} NEW: AmiComSys now requires AMarquee.library version 45+. NEW: The Daylight Savings Time setting in TimeZone-settings is now off by default. It should be off for now (it's normal time you know). BUGFIX: Problems if you have put AmiComSys in your WBStartup. Entries in the list from the last time you were online is still there when you go online again. Bug reported by Thomas Svenson and Sonat Böler. Thanks! BUGFIX: If you have noticed that you are still logged in to server some minutes after you went offline with your tcp/ip-stack, without first quit AmiComSys: Just save your settings, and you want notice doublicates, anymore. Actually the old copies of your client is removed from server when you log in again. NEW: As I said above you stay logged in to server for 10 minutes if you do not quit AmiComSys before shutting down your Internet-connection. Now it is possible to tell AmiComSys to log out from server, without quiting. There's a new arexx command DISCONNECT. Insert the following to your offline.script if you don't want to quit AmiComSys before going offline. rx "ADDRESS AMICOMSYS; DISCONNECT" BUGFIX: The message "Could not send message" could pop up without reason. Reported by Thomas Steinbichler. Thanks! BUGFIX: The HotLine-textbuffer could be saved with some text doubled up. Reported by Pete (isnibs). Thanks! NEW: Browserpath and ftp-program-path added to Misc-settings. NEW: Arexx commands GET BROWSERPATH and GET GET FTPPRGPATH added. NEW: The rexx-scripts, in the rexx-directory, SendWEB.amicomsys and SendFTP.amicomsys were updated. You should now enter the path to your webbrowser and ftp-program in the Misc-settings. NEW: The data (YYMMDD) can now be automatically appended to logging path. Optional via the Program-settings. NEW: Obsolete message handling is removed. This means you can't send or receive messaged with/from users of version 1.10-. NEW: Implemented support for AMarquee-System-message. Can only be sent by the server operator from an admin-application. BUGFIX: "Connection broken by sender" was showed when the tcp-ip-stack was shut down. NEW: SendFile feature is now multithreaded. This means you don't have to wait for a file to be sent before you can send another. You can also receive several files at once. BUGFIX: IconifyWhenClose setting was not active directly after the setting had been altered. Reported by Sonat Böler. Thanks! NEW: Now it's possible to see who has the HotLine-window open. A ^ is inserted in front of the client name when the window is open. NEW: Did some changes which is invisible for the user, but will make it possible to implement features in the future. NEW: A dock-picture is now included in the archive. Thanks to Dirk Tietke for giving it to me! NEW: The former icon was saved faulty. NewIcons allocated very much pens to show it. So please exchange it with the new one. @{fg shine}1.14c (12.10.1997) -----------------@{fg text} BUGFIX: The File-transmission feature (SendFile) should work well now. BUGFIX: The message requesters now fall back to a recoverable Alert if the window could not be created. (Like AmigaOS-EasyRequest should do, but still does not :-() NEW: Replaced more Easy-requesters with my own one. @{fg shine}1.14b (30.09.1997) -----------------@{fg text} BUGFIX: MUI-requesters does not open up when the main window is iconified. So the Send feature in message requester did not work, if send confirmation was on. (Only registered users can set it off). @{fg shine}1.14a (30.09.1997) -----------------@{fg text} NEW: Does now check the version number of NList.mcc. It must be 19+. NEW: Added a notice at the settings save button. When you put AmiComSys in WBStartup you must set the ToolType PROGDIR in the icon to the path of your AmiComSys directory, where your settings are saved. BUGFIX: The messagerequester didn't check the button texts height. NEW: Inserted a message-field and a Send-button into the message requester. Now it's possible to reply, without open the ACS main window. @{fg shine}1.14 (27.09.1997) ----------------@{fg text} NEW: Nonblocking message requesters implemented. They does not block other traffic. @{"See ..." link "messagereq"} BUGFIX: Incompatability with Reqtools filerequesters fixed. Reported by Richard Lake. Thanks! NEW: Does now use the public MUI class NList.mcc, which fully replace the MUI lists, by Gilles Masson. It's @{"required" link "requirements"}. BUGFIX: Crashed when there were start-errors (no mem, couln't open library). Reported by Darius Mazurkiewicz. Thanks! NEW: HotLine implemented (Windows menu). Now you can have a public chat with others logged into server. @{"See ..." link "hotline"} BUGFIX: MUI-window is now refreshed while a file requester is open. NEW: Fonts turned tiny when a long text appeared in clientinfo. Now wordwraps the text. (Possible MUI-bug?) BUGFIX: There were no beep when a sendfile message arrived. NEW: The pre-AmiComSys version 1.11 message format is now considered obsolete. This means that the support for pre-1.11 will be romoved. NEW: Changed time zone settings to a better one (like Gadtools version). @{"See ..." link "timezonesettings"} NEW: Changed the settings tab names: New: Personal, Misc , Security->Network, Function->Program. NEW: Moved security settings to the Network tab. NEW: The client select marker now stay on the selected one when someone logout or login. NEW: Username & Realname chaos solved. New realname and username settings. @{"See ..." link "personalsettings"} NEW: NotifyArexx.amicomsys script is now settable in the Misc-tab in general settings. It's now registered only. @{fg shine}1.13a (18.08.1997) ----------------@{fg text} BUGFIX: The stack size in AmiComSys's icon was to low (4096). It shall be 8192 bytes. If the icon stack size is to low it should be set automatically, but a link object file had disappeared from my make file, so this was not the case :-() You noticed this bug if you couldn't start AmiComSys or if it crashed. @{fg shine}1.13 (17.08.1997) MUI ----------------@{fg text} NEW: The mui-version and the Gadtools version is now divided into two archives: AmiComSys.lha and AmiComSysMUI.lha. NEW: To start AmiComSys with Run >NIL: AmiComSys had it's disadvantages, the output from the arexx-scripts were sent to NIL:. This led to problems because mostly you start it that way in a login-script ... Now AmiComSys has its own console window both when started from Workbench and from CLI. NEW: A new Tooltype PROGDIR. 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. NEW: @{"New arexx commands" link "Arexx"}. RealName, Login, comment, logpath, loglevel and onlinetime. NEW: File transmission. NEW: Set the time offset to Greenwich Mean Time in Program funcion settings. This makes the time values (in client info and message headers) right. If you for example live one time zone east of GMT you set this to -60. (-60 minutes), which is Central Europe Time (CET). You really don't need to set this, because it's read from your Locale-preferences. If it's Daylight Savings Time you must check the checkbox. NEW: The executable is smaller now :) @{fg shine}1.12a (04.08.1997) ----------------@{fg text} BUGFIX: Could hang the computer when the settings window were closed :-( BUGFIX: Could log onlines twice (I hope it's fixed now ...). NEW: The GadTools-version in smaller now :-) @{fg shine}1.12 (02.08.1997) ----------------@{fg text} NEW: ARexx support added. These commands are available: SHOW, HIDE, ICONIFY, QUIT. (ICONIFY and HIDE has no differance in MUI-version). GET. See @{"ARexx Support" link "arexx"}. NEW: New menu, Arexx, where you can execute and add arexx scripts. BUGFIX(MUI-version): When three or more clients were logged in the client list went totally messed up. One client pointed to another's information. Messages could there fore be sent to wrong client. By mistake I used an undocumented feature of MUI (the listview entries were moved like in a queue). But fortunately the GadTools-version worked okey. Bug reported by Alex Tucker, Singapore. Thanks! BUGFIX(MUI-version): WEB-Request did not work. NEW: The client list is now only updated once when a client log in. NEW: A new logglevel, Everything. Simple logs onlines and offlines, and Everything logs start, end and client info updates too. NEW: Added homepage and ftpsite to Settings and tooltypes. NEW: Added HTTP and FTP buttons to Client Info (Double click on the client in the Client list). NEW: Added Send Confirmation to settings. You can specify if you want the confirmation requester when you press the SEND button. (only registered version) BUGFIX(MUI-version): Enforcer hit when it recieved a message. BUGFIX: Enforcer hit when someone logged out. NEW: New users are now inserted at the bottom of the client list. NEW: An Arexx-script: NotifyArexx.amicomsys is executed when the client list is updated. @{fg shine}1.11b (01.07.1997) -----------------@{fg text} BUGFIX: Ooops!!! Sending messages did not work. Unfortunately I can't stop the last update to appear on aminet :-( This is the result when one works days and night ... @{fg shine}1.11a (01.07.1997) -----------------@{fg text} BUGFIX: V1.11 crashed after you, or somone other who are logged in, have changed your/their command line to a length longer 50 charachers. :-( Maximum length is 150 characters. Removed some debugging output. .-) @{fg shine}1.11 (29.06.1997) ----------------@{fg text} NEW: AmiComSys homepage is at http://amicomsys.tibb.at NEW: Inputs in MainWindow is not freezed when settings window is open. BUGFIX: Stack overflow led to a crash. A stack of 4096 bytes shall now be sufficient for the GadTools version. The MUI-version's stack is automatically set to 8192 bytes. NEW: The settings is now divided into several windows for the GadTools version. NEW: The main window is now resizable. NEW: Logging implemented. Can be set in the logging settings. NEW: Message history implemented. Can be found in the Windows/Message History menu. NEW: The SEND button is automatically pressed when you press ENTER/TAB in the message string gadget. NEW: When a new message arrives the Amiga beeps. Can be set on/off in Program function settings. NEW: The send-off time for a message will be showed in title of the message requester. NEW: The client user's online time is now showed in the client info. NEW: The positions and sizes of the main and history window are saved to disc. @{fg shine}1.10 (01.06.1997) ----------------@{fg text} BUGFIX: Messages from amarquee.lib was not always freed, causing Enforcer-hits. Thanks Jeremy Friesner, USA, who reported this bug! NEW: Users can now be banned, which means that they can not send messages to you. NEW: NAME and COMMENT added to arguments and ToolTypes. e.g AmiComSys "COMMENT=No comment!" NEW: Send messages with patternmatching. e.g. #?.com, send to all .com-hosts. NEW: Multi messages (sent with patternmatching) can be turned off. (registered) NEW: Will try to reconnect one time every minute if connection is lost. Notice that it will connect immediately if the main window is activated. Useful if you put AmiComSys in WBStartUp drawer. NEW: New tooltype and setting: Reconnect=Yes/No. Specify if you want AmiComSys to try to reconnect when connection is lost or just quit. Useful if you start AmiComSys from an Online-script. NEW: New layout in settings window. NEW: MUI-version. BUGFIX: Settings were not read correctly. BUGFIX: There was a little trouble to find the arexx-script. NEW: New AMarquee/AmiComSys-server hosted by Thomas Steinbichler at amicomsys.tibb.at. NEW: Email-settings, both as a TOOLTYPE and in general settings. Your email will not be showed for others, but will have a usage in a later version. @{fg shine}1.9 (18.04.1997) ----------------@{fg text} BUGFIX: When starting a new copy of AmiComSys when another already is running an "error:" was showed. BUGFIX: It was very instable when connected to Internet. It worked good when connected to localhost. Strange :-( Hope it's better now. BUGFIX: Rewrote the hide, show and iconify handling. BUGFIX: Some memory leakage is fixed, but there is still some left, but it seems to be in amarquee.library :-( NEW: AmiComSys's window now appear directly. The wait for connect is no longer there thanks to amarquee.library v.41. NEW: Messages has now a limit of 900 characters. NEW: Wordcutting feature implemented, which means that a the messages will be divided into several lines if it exceeds the req_maxchars parameter. NEW: Message access setting implemented. Give an ordinal Amiga wildcard in Config/MessAccess describing 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.) (registered). BUGFIX: AMarquee Client TCP Handler must use a higher task priority than AmiComSys. If you use Executive you must set AMarquee Client TCP Handler to TASK-NOSCHEDULE-ABOVE. If not AmiComSys will get a Server error, when its window is activated, and AmiComSys will quit. This is fixed in amarquee.library V42. NEW: Messaging may be turned off. (registered). NEW: The web-address sent in a WEB-message can be sent to your WEB-browser: Ibrowse, Voyager, AWeb and Amosaic is supported. ARexx must be running and 'rx' must be in the current path. Insert "Path ADD" if it is not. 'rx' should be in the SYS:rexxc directory. @{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 Rüdiger Sopp for Newstring.mcc 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. @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"} @{"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"} @{"Menus" link "features"} @{"Message requester" link "messagereq"} @{"Public chat" link "hotline"} @{"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