@database AmIRC.guide @Master AMIRC.texi @Width 72 This is the AmigaGuide® file AmIRC.guide, produced by Makeinfo-1.55 from the input file AMIRC.texi. @Node Main "AmIRC.guide" @{b}AmIRC@{ub} ***** Welcome to @{i}AmIRC@{ui}, the AmigaOS IRC client. - Introduction - @{" Copyright " Link "Copyright"} Copyrights, author info and more. @{" Registration " Link "Registration"} Registering AmIRC @{" IRC " Link "IRC"} What is IRC, by the way? @{" IRC Terms " Link "IRC Terms"} Terms you Might Encounter @{" Features " Link "Features"} Features of AmIRC. @{" Requirements " Link "Requirements"} What is needed to use AmIRC? @{" Installation " Link "Installation"} How to setup AmIRC. @{" Connecting " Link "Connecting"} Let's have a start. @{" Operation " Link "Operation"} How do I work this kewl thing? @{" Menus " Link "Menus"} What are these pull-down thingies? - Reference section - @{" CTCP " Link "CTCP"} Sending commands to other people. @{" DCC " Link "DCC"} Getting nearer to your neighbour. @{" Commands " Link "Commands"} Commands built into AmIRC. @{" Configuration " Link "Configuration"} Customize your environment. @{" ARexx " Link "ARexx"} Heavy magic. - Other Stuff: - @{" About MUI " Link "About MUI"} Magic User Interface. @{" Revision History " Link "Revision History"} Developments in AmIRC. @{" Credits " Link "Credits"} Those deserving favour. @{" Bug Reports " Link "Bug Reports"} How to report them. @{" Known Bugs " Link "Known Bugs"} Problems, causes, and cures. @{" AmIRC Support " Link "AmIRC Support"} How to get help and updates. @{" Index " Link "Index"} @EndNode @Node "Copyright" "AmIRC.guide/Copyright" @Next "Registration" @Prev "Main" @Toc "Main" Copyright ********* Copyright ========= AmIRC has been designed, developed and written by @{i}Oliver Wagner@{ui} @{i}Landsberge 5@{ui} @{i}45549 Sprockhövel@{ui} @{i}Germany@{ui} @{i}E-Mail: (owagner@lsd.wupper.de)@{ui} All Rights Reserved. This document compiled by Laurence Walton (lww@pgh.net) ©1996 Oliver Wagner All Rights Reserved Installer Script ©1995,1996 Robert C. Reiswig All Rights Reserved No part of this archive may be redistributed except with the entire contents of the original archive. @EndNode @Node "Registration" "AmIRC.guide/Registration" @Next "IRC" @Prev "Copyright" @Toc "Main" Registering AmIRC ***************** License ======= AmIRC 1.0 Registered Software License Agreement ---------------------------------------------- AmIRC 1.0 is Copyright © 1996 by Oliver Wagner, All Rights Reserved. The producer of this software will grant the Licensee a limited, non-exclusive right to use the program AmIRC 1.0 and it's associated files on a single machine. The producer will hand out a special identification file called the key file to the Licensee. This key file will enable the Licensee to fully use the AmIRC 1.0 package according to the terms of this license. The key file is stricly for personal use by the Licensee only. Any disclosure of they key file will invalidate the license and the key file itself. The Licensee will be held liable of any damage arising out of the disclosure of the key file. The product is provided as is without warranty of any kind, either express or implied, statutory or otherwise, including without limitation any implied warranties of non-infringement, merchantability and fitness for a particular purpose. The entire risk as to use, results and performance of the product is assumed by you and should the product prove to be defective, you assume the entire cost of all necessary servicing, repair or other remediation. In no event shall the producer of this product or it's resellers be liable for any property damage, personal injury, loss of use or other indirect, incidental or consequential damages, including without limitation, any damages for lost profits, business interruption or data which may be lost or rendered inaccurate, even if we have been advised of the possibility of such damages. This agreement shall exclusively be governed by the laws of the Federal Republic of Germany. Registration ============ If you have not registered for AmIRC, it will prompt you to do so upon startup. Registration at the US site requires $25.00 in @{b}US@{ub} funds for an emailed keyfile, or $30.00 for a disk mailed via postal service. The Germany Site requires 35,-DM for an emailed keyfile and 40,-DM for a floppy sent via postal service. @EndNode @Node "IRC" "AmIRC.guide/IRC" @Next "IRC Terms" @Prev "Registration" @Toc "Main" What is IRC, by the way? ************************ Introduction ============ IRC stands for Internet Relay Chat, written by Jarkko Oikarinen (jto@tolsun.oulu.fi). In a nutshell, IRC consists of a network of computers (servers) that are connected to each other via the internet or a LAN, and allow users with proper client software to connect and chat with each other. Within this network, virtual space is divided up into channels, usually with a topic of conversation, where users can talk in groups. #amiga ====== If you are reading this, you are most likely using one of the @{"Amiga" Link "Requirements"} family of computers (if you are not, BUY ONE! :), and will likely want to check out #amiga on IRC. #amiga is one of the most populated channels of IRC, with an average of 30 to 60 users on at any given time. #amiga is often visited by amiga hardware and software developers, and is sometimes a forum for formal discussions held by dignitaries from software/hardware development companies. #amiga Etiquette ---------------- There is a sort of an unwritten code of conduct for IRC, and especially #amiga. This section is included so that you dont find yourself /kicked or /banned and dont understand why. DO's ---- @{b}DO:@{ub} Enjoy your visit to #amiga Offer to help someone @{b}IF@{ub} you know what your talking about. Be polite to other users. DON'T's ------- @{b}DON'T:@{ub} Ask questions about software/hardware problems without reading the manual first (RTFM!). Ask a question more than once. If someone can help you, they will. Ask for latest amiga news or info on new software, see newsgroup comp.sys.amiga.announce for this. Ask for OPs. You won't get it. Pound or slam Amigas. If you don't like them, don't /join #amiga. Pound or slam Amiga Software (the coders might be there :) Offer to help a user with a problem if you don't understand it yourself. Offer or ask for commercial software or the keys to activate demos. Plug developers who appear from time to time with questions and bug reports, use the proper channels for this (i/e, the developer's support address). Note that you might ask first if they are willing to discuss problems/bugs with their product. @EndNode @Node "IRC Terms" "AmIRC.guide/IRC Terms" @Next "Features" @Prev "IRC" @Toc "Main" Terms You Might Encounter ************************* IRC Terms ========= @{b}#amiga@{ub} IRC Channel on @{i}Efnet@{ui} and @{i}Undernet@{ui} for users interested in the Amiga family of Computers. @{b}Action@{ub} @{i}CTCP@{ui} Action command, executed by a /me at the beginning of a message. @{b}ARCnet@{ub} Amiga Relay Chat Network. Served by several Amigas running CLChatServer, forming a small network used by those interested in the Amiga Family of Computers. @{b}Ban@{ub} A @{i}channel mode@{ui} set in order to prevent a @{i}user@{ui} or group of users from joining a @{i}channel@{ui}. @{b}Bot@{ub} Short for Robot, a Bot is a @{i}script@{ui} that acts like a user, and can execute a command upon a certain occurance. @{b}Client@{ub} Software that is written for the purpose of connecting to a @{i}server@{ui}, in this case, an @{i}IRC server@{ui}. @{b}Channel@{ub} A group of users on @{i}IRC@{ui}. A channel will have a name (i/e, #amiga), and may or may not have a @{i}topic@{ui} of conversation. @{b}Channel Mode@{ub} The properties of a @{i}channel@{ui} that allow or disallow certain activities. Channel Modes can only be changed or set by @{i}Channel@{ui} Operators. @{b}Invite Only@{ub} If active, This mode allows users to join if they have been invited by someone in the channel. @{b}Private@{ub} If active, the @{i}channel@{ui} is invisible in the global channel list. @{b}Limit@{ub} If active, Sets a limit on the number of @{i}users@{ui} allowed to join a @{i}channel@{ui}. @{b}Moderated@{ub} If active, only @{i}Channel Operators@{ui} and @{i}users@{ui} with @{i}voice@{ui} may type input to the @{i}channel@{ui}. @{b}No Messaging@{ub} If active, prevents @{i}users@{ui} from sending a message to the @{i}channel@{ui} until they have joined it. @{b}Secret@{ub} If active, the @{i}channel@{ui} is invisible until it is joined. @{b}Topic Protection@{ub} If active, only @{i}Channel Operators@{ui} may set or change the @{i}topic@{ui} of a @{i}channel@{ui}. @{b}Channel Operator (aka, Op)@{ub} A @{i}user@{ui} who has control over a @{i}channel@{ui}. A user who creates a channel is given Op status, and in turn can give it to anyone else in the channel. @{b}Command@{ub} A message to an IRC server or to a local or remote client. Commands generally begin with a /. See @{"Commands" Link "Commands"}. @{b}CTCP@{ub} Client To Client Protocol, A standard for sending commands from one @{i}client@{ui} to another, usually for the purpose of getting information from the remote client. See @{"CTCP" Link "CTCP"}. @{b}DCC@{ub} Direct Client Connection - a standard for creating a direct link between two clients, for the purpose of sending or receiving files, or to carry a more secure conversation. See @{"DCC" Link "DCC"}. @{b}Efnet@{ub} (Eris Free), the largest and "main" @{i}IRC network@{ui}, with an average of about 5000 @{i}users@{ui} on any given day. @{b}Identd@{ub} Identd Is software that can be run on the client, allowing an IRC server to corroberate the identity of a client. AmIRC has an Identd built in, and will automatically disable it if an external Identd is running. @{b}IRC@{ub} Internet Relay Chat - Any @{i}Network@{ui} of Computers that run IRC @{i}servers@{ui} for the purpose of allowing @{i}users@{ui} to connect to it using @{i}client@{ui} software made for IRC. @{b}Kick@{ub} The occurance of a @{i}user@{ui} being removed from a joined @{i}channel@{ui} by a @{i}channel operator@{ui}. @{b}MOTD@{ub} Message Of The Day, A message that may or may not be updated daily, that is meant to be read when connecting to an @{i}IRC server@{ui}. @{b}Netsplit@{ub} An event that occurs when a @{i}server@{ui} goes down that other servers depend on for network packets. Any servers that are dependant on the crashed server will split from the net, that is, they will still be up and running, with active @{i}clients@{ui}, but any clients on the other side of the crashed unit will appear to have all logged off at once. @{b}Nick@{ub} Short for Nickname, this is an alias that you may pick for yourself. @{b}Op@{ub} See @{i}Channel Operator@{ui}. @{b}Server@{ub} A computer that is Running IRC server software, allowing it to be connected to by @{i}IRC clients@{ui} or other servers. @{b}Server Operator@{ub} A person in control of an @{i}IRC server@{ui}. @{b}TLA (Three Letter abreiviations)@{ub} commonly used acronyms, not entirely restricted to 3 letters. @{b}AFAIK@{ub} As Far As I Know @{b}AFK@{ub} Away From Keyboard @{b}BRB@{ub} (I'll) Be Right Back @{b}BBL@{ub} (I'll) Be Back Later @{b}IMHO@{ub} In My Humble|Honest Opinion @{b}LOL@{ub} Laughs Out Loud @{b}MOTD@{ub} Message Of The Day @{b}ROTFL@{ub} Rolls On The Floor Laughing @{b}RTFM@{ub} Read The F***ing Manual @{b}Topic@{ub} A heading for a @{i}channel@{ui} that may or may not have anything to do with the conversation at hand. @{b}Undernet@{ub} The second largest @{i}IRC@{ui} network, considered an 'Alternative' to @{i}EFnet@{ui}. @{b}User@{ub} a person using an @{i}IRC Client@{ui} to connect to a @{i}server@{ui} to chat. @{b}User Mode@{ub} Settings that affect a users properties. @{b}Invisible@{ub} If this mode is set, a @{i}user@{ui} will be invisible in the global user list. The user will still be visible in the user list of any joined channel, however. @{b}Wallops@{ub} When set, this mode will allow receiving of messages from the @{i}server operator@{ui} to all operators. @{b}Userhost@{ub} This is the string that defines a @{i}user@{ui}. It consists of the user's chosen @{i}nick@{ui}, login name and domain name. For example: Wupper!jwupper@monorail.wupper.de | | | | |_ Domain | | | |________ Network | | |_________________ Machine | |_________________________ Login |________________________________ Nick @{b}Voice@{ub} Status a normal (not an operator) user must have to type into a @{i}moderated@{ui} channel. @EndNode @Node "Features" "AmIRC.guide/Features" @Next "Requirements" @Prev "IRC Terms" @Toc "Main" Things that make AmIRC special! ******************************* Features ======== @{b}*@{ub} runs with both AmiTCP and AS225 without additional support libraries. @{b}*@{ub} built-in high speed DCC drivers for SEND and MOVE. Highly optimized with asynchronous file I/O and threaded network handling. Supports Drag&Drop sending of files. @{b}*@{ub} transparent implementation of DCC CHAT. All /MSGs are automatically routed via DCC CHAT if applicable, to save runtime and reduce IRC load. Option to automatically accept DCC CHAT connections. @{b}*@{ub} ultra fast text output and scrolling. Supports Cut&Paste for the list text. Supports proportional fonts. @{b}*@{ub} full support of the "Undernet" IRC extensions, both reply codes and additional IRC commands. @{b}*@{ub} intuitive channel display with userlist and channel mode overview. Channel modes can easily be changed via gadgets. Configurable user action list to perform whatever action you like on users in channel by the press of a mousebutton. @{b}*@{ub} supports QUERY windows for private chat. @{b}*@{ub} supports "smart" banning @{b}*@{ub} versatile AREXX port. @{b}*@{ub} easy command line aliasing. @{b}*@{ub} builtin IdentD (automatically disabled if another IdentD is already installed). @{b}*@{ub} supports nick notification, highlighting, ignoring, and kickban. @{b}*@{ub} versatile event handling allows you to bind sound effects, auto-deiconify or rexx scripts to certain events. @{b}*@{ub} server phonebook. @{b}*@{ub} last nick history. Stores the nicknames of the last nicks you've send MSGs to, received MSGs from or addressed publically with "nick:". Reference can be used in all commands which require nick names, e.g. /MSG, /OP, /DEOP. Automatic nick expansion on public messages with ":". @{b}*@{ub} auto rejoin channel on KICK and auto reconnect server facility. @{b}*@{ub} auto away after idle timeout. Auto unaway after sending public and/or private msgs. @{b}*@{ub} auto update download. Check for and download new releases with a simple click. @{b}*@{ub} URL grabber for copying URLs to clipboard. @{b}*@{ub} netsplit detection. @EndNode @Node "Requirements" "AmIRC.guide/Requirements" @Next "Installation" @Prev "Features" @Toc "Main" What is needed to run AmIRC? **************************** Hardware ======== AmIRC was written for the Amiga family of computers, and has been tested on 1200, 2000, 3000, & 4000 computers in various configurations. Software ======== AmIRC requires @{"MUI" Link "About MUI"} v.3.1 or later in order to run. AmIRC requires KickStart & WorkBench 2.x or later, with setpatch 40.16 installed. AmIRC020 requires a 68020 or higher CPU, OS3.0 or newer, and MUI 3.1 or newer. If you do not have anyone of these, you must use the 68000 version of AmIRC. If you plan to run a TCP/IP stack and MUI and AmIRC, among other Internet applications, you should have at least 2 megabytes of RAM. Finally, You need to have a tcp/ip protocol stack running, such as AmiTCP/IP or Amiga Technology's as225r2 tcp/ip protocol stack, With a slip, cslip, or ppp connection to the internet or an ethernet LAN. Alternatively, AmIRC will work with Multilink and a shell internet account. NOTE: As Mlink does not automatically set the HOSTNAME variable, this must be done when starting mlink. Env:hostname must contain the full domain name for your amiga, i/e 'calci.amiganet.pgh.net'. @EndNode @Node "Installation" "AmIRC.guide/Installation" @Next "Connecting" @Prev "Requirements" @Toc "Main" Getting AmIRC to run ******************** Requirements ============ AmIRC has its own installer script and requires that you have the Amiga installer utility (version 1.24 or later) located in your sys:c directory. To install, just click on the install icon, and answer the questions in the installer's requestors. If you cannot or prefer not to use the installer utility, a manual install is very simple, just move the contents of the archive to a directory of your choice and it's ready to use. If you have met the @{"requirements" Link "Requirements"} for the optimized version of AmIRC, delete the AmIRC file and rename "AmIRC020" as "AmIRC". @EndNode @Node "Connecting" "AmIRC.guide/Connecting" @Next "Operation" @Prev "Installation" @Toc "Main" Connecting to a server ********************** Setup ===== Once you have @{"installed" Link "Installation"} AmIRC, run the AmIRC program from WB by clicking on its icon. After a few moments you will see the server connect requester appear. First type in a nickname in the first text gadget at the top of the requester. If you intend to use a nick that may be common, try typing in some variations in the next three boxes. this way, if your nick is in use by another person, the client will retry with the next nick. Next, enter your real name and your email address or www home page URL in the next text gadget. It is probably a good idea to be truthful here. :) Then, enter a username that will show as «username»@machine.network.org. «username» should be the same as the login ID for your service provider. Now you are ready to connect. Just click on a server from the supplied list or click new server entry and type the address and port number of your favorite server and then click connect. Optionally, you can choose one or a few channels to autojoin, just separate them with a comma. If you are already connected, and wish to connect to a second server, click connect thread to open a second instance of AmIRC. The Delete Server Entry gadget will remove a server entry that you no longer wish to use. @EndNode @Node "Operation" "AmIRC.guide/Operation" @Next "Menus" @Prev "Connecting" @Toc "Main" How Does AmIRC Work? ******************** Using the Interface =================== The AmIRC user interface is laid out in a logical, intuitive manner, making it easy to use. @{b}Text Listview@{ub} The main feature of the interface is the text listview, where incoming text is displayed. @{b}Text Input Gadget@{ub} Directly below this is the text input gadget, labeled with the nickname that you have chosen. Any text entered here will be sent out to the IRC server. @{b}Listview Scroll Gadget@{ub} To the right of the listview is a scroll gadget, which enables you to scroll backward through the text in the listview. @{b}Channel Text String@{ub} At the top left of the listview is a text string that reflects the channel that you have joined. @{b}Topic Input/Display Gadget@{ub} To the right of the channel text string, is the Topic Input/Display gadget, where the topic of a joined channel will be displayed. If you have Channel Operator (Ops) Status, you may change the topic of the channel by entering the topic in this gadget, and hitting the 'enter' key. @{b}Operator Buttons@{ub} To the right of the topic input gadget are the channel mode buttons, which display the current modes for the joined channel. Users with Channel Operator (Ops) status may also use these buttons to change the current channel modes. @{b}T - Topic Protection@{ub} Toggles Topic Protecton on/off. If on, the topic can be changed by Channel Operators (Ops) only. @{b}N - No Messaging@{ub} Toggles Messaging on/off. If active, a user can only write to the channel if they have joined it. @{b}S - Secret@{ub} Toggles Secret mode on/off. If active, the channel is invisible until it is joined. @{b}I - Invite Only@{ub} Toggles Invite Only mode on/off. If active, users can only join after they have been invited. @{b}P - Private@{ub} Toggles Private mode on/off. If active, the channel will be invisible in the global channel list. @{b}M - Moderated@{ub} Toggles Moderated mode on/off. If active, only channel operators (Ops) and users with 'voice' can type to the channel. @{b}L - Limit@{ub} Sets a limited number of users allowed on the channel @{b}K - Keyword@{ub} Toggles Keyword mode on/off. If active, Users can only join the channel if they give the correct keyword. @{b}B - Ban@{ub} Sets/Displays the current Bans active on the channel @{b}User Listview@{ub} Below the channel mode buttons is the User Listview, which shows a current list of users on the joined channel. Double clicking on a users name will perform a /whois on that user. Clicking once on a users name will set that user as the default to perform other operations on, such as an operation from the configurable user buttons. @{b}User Buttons@{ub} Directly below the User Listview are the user buttons. These buttons are configurable from the @{"configuration" Link "GUI"} window, accessable by selecting 'setup...' from the AmIRC @{"settings" Link "Settings"} menu. @{b}Special Functions:@{ub} You can Drag-Hilight text in the listview in order to paste it elsewhere. you will need some type of snap utility such as newedit or powersnap in order to past the text. The text is stored in the clipboard. The @{b}TAB@{ub} key will cycle through the names of people that have previously /msg'ed you, and insert it into the text input gadget. Simply enter your message after the "/msg " in order to /msg them back. Entering ":" first in the text input gadget will automatically publicly address the last person you typed to using the ":" after their nick. @EndNode @Node "Menus" "AmIRC.guide/Menus" @Next "CTCP" @Prev "Operation" @Toc "Main" Pull-Down Menus *************** Reference ========= @{" AmIRC " Link "AmIRC"} AmIRC menu @{" Windows " Link "Windows"} Windows menu @{" User Modes " Link "User Modes"} User Modes menu @{" Settings " Link "Settings"} Settings menu @{" Rexx " Link "Rexx"} Rexx menu @EndNode @Node "AmIRC" "AmIRC.guide/AmIRC" @Toc "Menus" AmIRC Menu ---------- @{b}Select Server...@{ub} Opens a window from which you can select various options for connecting to an IRC server. See @{"Connecting" Link "Connecting"}. @{b}Logging Enabled?@{ub} Toggles logging on/off. @{b}Iconify@{ub} Reduces the AmIRC window to an icon on the Workbench screen. @{b}Help...@{ub} Opens Amirc.guide for reference while using AmIRC. @{b}About...@{ub} Opens a window with information about AmIRC and its Developer. Here you may connect to the AmIRC home page if amosaic is running concurrently, and you may also download the latest version of AmIRC without having to trouble with running a www or ftp client. @{b}Quit@{ub} Will close the current instance of AmIRC, leaving other instances open. @EndNode @Node "Windows" "AmIRC.guide/Windows" @Toc "Menus" Windows Menu ------------ @{b}Channel Windows@{ub} If more than one AmIRC window is opened, You may select one here to pop it to front. @{b}Dialog Windows@{ub} If any dialog windows are open, you may select one her and bring it to front. @{b}Channel List Window...@{ub} This item will produce a requester where you may list channels by min users or pattern matching, or both. Once listed, you may list users on a channel or join it by double-clicking the channel name or selecting 'join channel' gadget. Please note that this function can cause a high load of traffic and may take awhile on slow (14.4 or less) connections. @{b}Notify Window...@{ub} Selecting this item will produce a requester where you may enter nicks of users that you wish to be notified of their entering/leaving IRC. The 'check period' is how often AmIRC will check for the specified users. Add a nick to the list by clicking in the input text gadget, and typing in the nick. delete a nick by clicking on it's entry and then click on 'delete nick' gadget. @{b}DCC-Send Window...@{ub} Brings up a requestor in which you can specify a user and a file to send to them. This requester will also be produced automatically upon hitting the 'DCC send' userbutton on the interface. 'Send Path' is the path and filespec that will be sent to the user. Enter the name of the user in the text input gadget at the bottom of the requestor. The cycle gadget nest to the nick text gadget selects either 'DCC Send' or 'DCC Move' protocols. See @{"DCC Section" Link "DCC"} for details about these protocols. @{b}Remove Job@{ub} gadget will remove a complete send entry or if not complete, one click will abort the send and the second click will remove the entry. @{b}DCC-Receive Window...@{ub} Selecting this item will produce the 'Receive DCC List' requester. This is very similar to the DCC Send Requester. Note that this requester will appear automatically on receiving a DCC request. Enter a path for incoming files to be put in the 'Receive Path' text gadget. After a valid path is entered, click on an entry to receive, then click the 'Get' gadget at the bottom. If you are trying to receive after a failed send, you may use the 'Resume' gadget instead of get. this will attempt to pick up the transfer where it left off. I you wish to rename the incoming file for whatever reason, you may use the 'Rename' gadget to give the file a new name. 'Remove Job' gadget will abort an incoming file and remove a completed or aborted file. See @{"DCC" Link "DCC"}. @{b}DCC-Chat Window...@{ub} Selecting this item will open the 'DCC Chat List' requestor. Do this if you receive a DCC chat request from another user.. Here you may click on the client sending the chat request and click the 'Open' gadget to engage a DCC chat. When finished, you can click "Close' to close the connection. See @{"DCC" Link "DCC"}. @{b}Raw Log Window...@{ub} This will open the Raw Log Window, in which you can view the raw IRC messages as they appear before AmIRC formats them for Easy reading in the AmIRC listview. Here you may also clear the log, and select when the log is active: 'Never', 'Only when raw window open', and 'Always' The log Listview shows the USERHOST, Type of message, Channel Name, and message, in that order. @{b}URL Grabber Window...@{ub} A New feature of AmIRC allows it to recognise WWW URLs and snap them to a window for use with Amosaic Web Browser. Double clicking an entry in the URL grabber Window will automatically send the URL to the Clipboard.. @{b}Private Messages Window...@{ub} This item will open the Private Messages Window. This window holds a history of private messages sent to you, where you can later reference or review them. @{b}Flush Buffer@{ub} This item will clear the history of the main AmIRC listview. @{b}Save Buffer...@{ub} This item allows you to select a filename to save the history buffer to disk. @EndNode @Node "User Modes" "AmIRC.guide/User Modes" @Toc "Menus" User Modes Menu --------------- @{b}Invisible?@{ub} Toggles your client between invisible or not invisible. See @{"IRC Terms" Link "IRC Terms"}. @{b}Receive Wallops?@{ub} Toggles this mode on/off. See @{"IRC Terms" Link "IRC Terms"}. @{b}Receive Server Notices?@{ub} Toggles this mode on/off. @{b}Marked AWAY?@{ub} Toggles AWAY on/off. @{b}Auto rejoin on KICK?@{ub} If set, will automatically attempt to reconnect you to a channel you have been kicked from. Note that if a ban was set with the kick, you will not be able to rejoin. @{b}Auto reconnect to server?@{ub} If set, this will automatically attempt to reconnect you to the server if you are disconnected for any reason. @{b}Auto open Dialog Windows?@{ub} If set, will automatically open chat window upon receipt of a /msg or dcc chat message. @{b}Auto accept dcc chat requests?@{ub} If set, this will automatically accept a dcc chat request. It will not open a chat window for you, however. Do this by opening the DCC chat window in the Windows menu. @{b}Do BEEPS?@{ub} If set, AmIRC will send audio beeps (or samples, if configured in the @{"Events" Link "Events"} page of the settings requester) for certain events. @EndNode @Node "Settings" "AmIRC.guide/Settings" @Toc "Menus" Settings Menu ------------- @{b}Setup...@{ub} Calls the @{"Setup Requester" Link "AmIRC Setup"}, allowing you to change the many settings of AmIRC to suit your needs. @{b}Lists...@{ub} Calls up the @{"Lists Requester" Link "Lists"}, allowing you to configure AmIRC's Alias, Ignore, and Hilite lists. @{b}Function Keys...@{ub} Calls the @{"Function Key settings requester" Link "Function Keys"}, allowing you to configure the function key macros. @{b}Dialog Window Buttons?@{ub} If set, the AmIRC dialog window will contain 4 gadgets in the upper right corner. These are labeled: 'Whois', 'Ping', 'DCC Chat', & 'DCC Send'. These gadgets will perform their respective functions on the user that the dialog window is opened to. @{b}Load Settings...@{ub} Opens a requestor allowing you to recall previously saved non-default AmIRC Configurations. @{b}Load settings from default@{ub} Reloads the last saved default configuration @{b}Save Settings Saves the current configuration under the last name set@{ub} in the 'Save settings as...' menu item. If the settings have not previously been named, they are saved as default. @{b}Save settings as...@{ub} Opens a requester allowing you to choose a filename to save the current AmIRC configuration as other than default. @{b}Save as default@{ub} Saves the current AmIRC configuration as the default startup configuration. @{b}Create icons?@{ub} If Checked, will create icons for saved configuration files, allowing them to be seen on the Workbench. @{b}MUI Settings...@{ub} Opens the MUI Prefs program for altering the MUI Configurable AmIRC configuration. @EndNode @Node "Rexx" "AmIRC.guide/Rexx" @Toc "Menus" Rexx Menu --------- This menu will Display any ARexx scripts that reside in AmIRC/Rexx/ directory. AmIRC ARexx scripts should be named with the .amirx extension. From this menu you may execute any existing AmIRC ARexx script. @EndNode @Node "CTCP" "AmIRC.guide/CTCP" @Next "DCC" @Prev "Menus" @Toc "Main" Sending commands to other people ******************************** Introduction ============ CTCP or @{i}Client To Client Protocol@{ui} --------------------------------- CTCP is a standard for sending commands to other clients on IRC. Basically, CTCP messages are simply private messages that include a code to alert the receiving client (not user) to respond to the command. CTCP commands are typicaly used to get informaton from the receiving client, such as /CTCP time, or /CTCP version. Even @{"/DCC" Link "DCC"} sends a request via CTCP to the receiving client, asking to initiate a direct connection. CTCP Commands ------------- @{b} @{b}*@{ub} ME (CTCP Action)@{ub} @{i}Template: /ME @{ui} This will mark the message as an action and replace the /ME with your nick, for example, '/me hates ice cream' would appear as: @{b}[Action]@{ub} |Fred hates ice cream @{b} @{b}*@{ub} Version@{ub} @{i}Template: /CTCP Version@{ui} Version will ask the client to return information about itsself, which will be in the form of a private message. @{b} @{b}*@{ub} Time@{ub} @{i}Template: /CTCP Time@{ui} Time will return the time of day as it is set on the user's machine. @{b} @{b}*@{ub} Ping@{ub} @{i}Template: /ping @{ui} Ping will send a packet request to the receiving client, which will in turn send back the packet with a timestamp, where the inititating client will compare the time difference and show the result in the listview. @EndNode @Node "DCC" "AmIRC.guide/DCC" @Next "Commands" @Prev "CTCP" @Toc "Main" Direct client connections ************************* What is DCC? ============ DCC or Direct Client Connection is a protocol that IRC clients can use to communicate directly with each other, bypassing the IRC server. The reason for this is to form a faster, more stable and direct connection thru which users can transfer files, or send private messages. Note that AmIRC has its own set of Highly Optimized DCC protocols built-in, and does not require external DCC utilities. DCC File Transfers ================== The most common use of DCC is for transferring files between two clients. The initiating client will send a message through the IRC server, telling the receiver that a connecton is requested. At this time, the receiver will either accept or reject the offer for the connection. If the receiver accepts the connection, the initiating client will proceed to send the information directly to the receiver. If the connecton is refused, the initiating client will simply timeout the attempt to connect. DCC Send -------- @{i}Template: /DCC send @{ui} DCC send will attempt to open a connecton with the specified user's client, and if successful, will proceed to send the specified file. DCC Move -------- @{i}Template: /DCC move @{ui} DCC Move is identical to DCC Send, with the exception that DCC move is capable of resuming an interrupted or failed transfer. DCC Move will look into the receiving directory for existing files, and upon finding a partial file which is the same as the file to be transferred, will initiate a /DCC Resume transfer. @{b}With AmIRC, This process is completely transparent@{ub}. If no partial or whole file exists, then the file will be completely transferred. DCC Get ------- @{i}Template: /DCC get @{ui} DCC get is a transparent operation with AmIRC, and is only mentioned in this document for the sake of being thorough. AmIRC will notify you of an incoming DCC request, and allow you the option to accept or reject the connecton with a simple click. DCC Chat ======== Another use of the DCC standard is DCC chat, which, like DCC Send, will send a CTCP request to the receiving client to set up a direct link. In this case, however, the purpose of the link is for users to send messages to each other. Because the mesages are sent through the direct link, and do not pass through the IRC server, this method of sending messages is much more private than using the IRC's privmsg (/msg). With AmiRC, it must be noted that a DCC Chat request will not open a dialog window for you, instead, when DCC chat is initiated and accepted, all privmsg's (/msg) to the receiving user will be sent through the DCC link. If you wish to have a dialog box for chatting, the best way to go about this is to highlight the users's name in the listview by clicking on it. then click on the 'Query' gadget below the listview. this will open a window that has several options within it. From here, you can 'ping' or 'whois' the other user, or you may inititate a 'DCC Send' or 'DCC chat'. Starting a 'DCC Chat' from this window will allow you to carry on a dialog with the remote user through the window. @EndNode @Node "Commands" "AmIRC.guide/Commands" @Next "Configuration" @Prev "DCC" @Toc "Main" Commands ******** Overview ======== AmIRC has several builtin commands. Some of these commands are processed locally, whereas others are sent to the IRC server. Commands generally start with a / to differentiate them from normal text. If you want to use the / character at the start of normal text, use @{b}//@{ub} instead. Many commands require a channel name as a parameter. AmIRC will automatically fill in the channel name of the current window if you don't specify a channel name on your own. For commands which require a nick name (e.g. @{b}/MSG@{ub} or @{b}/OP@{ub}, there are three special shortcut arguments: @{b}.@{ub} The period is replaced with the nickname of the last person you have send a private message to. @{b},@{ub} The comma is replaced with the nickname of the last person who send a message to you. Be careful with this, since you might easily address the wrong person if someone sends you a message while you are still typing this command! @{b}:@{ub} The colon is replaced with the nickname of the last person which you haved a addressed with a @{b}nick:@{ub} prefix inside a channel. You may easily carry a dialog with a particular user by first clicking on their username in the user list, then anytime you hit the tab key, the input string will be set up with '/msg ', after which you may type in the message and hit return. This will work after initiating a @{"DCC" Link "DCC"} Chat request as well. Please note that if you have configured the user list as a separate window, you must reactivate the message window after clicking on a username. Reference ========= @{" AWAY " Link "AWAY"} Setting an away message @{" INVITE " Link "INVITE"} Invite a user to a channel @{" ISON " Link "ISON"} If a user is on IRC @{" JOIN " Link "JOIN"} Join (or create) a channel @{" KICK " Link "KICK"} Remove a user from a channel @{" LEAVE " Link "LEAVE"} Leave a channel @{" LIST " Link "LIST"} List Channels and their topics @{" LOG " Link "LOG"} Start Log of Chat Window @{" MODE " Link "MODE"} Change a channel mode @{" MSG " Link "MSG"} Send a private message (privmsg) @{" NAMES " Link "NAMES"} Getting a list of names @{" NICK " Link "NICK"} Change your nickname @{" NOTICE " Link "NOTICE"} Send a notice to a user @{" QUIT " Link "QUIT"} End an IRC session @{" RAW " Link "RAW"} Send unprocessed string to the server @{" TIME " Link "TIME"} Query the current time of day @{" TOPIC " Link "TOPIC"} View or change a channel's topic @{" USERS " Link "USERS"} Listing users on a server @{" USERHOST " Link "USERHOST"} Getting USERHOST of a user @{" VERSION " Link "VERSION"} Query the version of the server software @{" WHO " Link "WHO"} Global user pattern matching @{" WHOIS " Link "WHOIS"} Get information about a user @{" WHOWAS " Link "WHOWAS"} Get information on a nick no longer logged in @EndNode @Node "AWAY" "AmIRC.guide/AWAY" @Toc "Commands" AWAY ---- Usage: @{b}/AWAY [message]@{ub} When used with the optional argument, /AWAY will mark you as being away and send the message to any client sending a @{"/MSG" Link "MSG"} to you. otherwise, it will remove a previously set away message. EXAMPLES: @{b}/AWAY eating dinner@{ub} will send the message ' is away: eating dinner', where nick is the nickname of the user that is away. @{b}/AWAY@{ub} will remove a previously set Away Message. @EndNode @Node "INVITE" "AmIRC.guide/INVITE" @Toc "Commands" INVITE ------ Usage: @{b}/INVITE @{ub} Invites a user to the channel given in the argument, regardless of weather the channel exists. If the named channel is @{"invite only(+i)" Link "MODE"}, the user performing the command must be a channel operator for that channel. EXAMPLES: @{b}/INVITE freddie #amiga@{ub} Sends a message to 'freddie', inviting him to join #amiga. @EndNode @Node "ISON" "AmIRC.guide/ISON" @Toc "Commands" ISON ---- Usage: @{b}/ISON {}@{ub} Quickly returns the users nick if it is found, does nothing if it is not. EXAMPLES: @{b}/ISON Kenneth@{ub} Returns: '@{b}@{ub}Kenneth', if nick 'Kenneth' is found on the server. @EndNode @Node "JOIN" "AmIRC.guide/JOIN" @Toc "Commands" JOIN ---- Usage: @{b}/JOIN channel[,channel[,...]] [key[,key[,...]]]@{ub} Usage: @{b}/CHANNEL channel[,channel[,...]] [key[,key[,...]]]@{ub} Join a channel on the IRC. If the channel doesn't exists, it is automatically created. There are two kinds of channels: Channel names starting with an @{i}#@{ui} are global channels and available on all IRC servers which are connected to the net you are currently on. Channels which begin with @{i}&@{ui} are local to the chat server you are connected to. If a channel requires a special keyword to join, you must submit this after the channel name. AmIRC will look for a channel window which isn't currently bound to a channel. If it doesn't find one, a new window will be created and bound to this channel. EXAMPLES: @{b}/JOIN #Amigager@{ub} Join channel @{i}#AmigaGER@{ui} @{b}/JOIN #Amigager,#Amiga@{ub} Join channels @{i}#AmigaGER@{ui} and @{i}#Amiga@{ui} @{b}/JOIN #AmigaGER deutsch@{ub} Join channel @{i}#AmigaGER@{ui} with keyword @{i}deutsch@{ui}. RELATED TOPICS: See @{"LEAVE" Link "LEAVE"}. @EndNode @Node "KICK" "AmIRC.guide/KICK" @Toc "Commands" KICK ---- Usage: @{b}/KICK []@{ub} Forcibly removes a user from the named channel. the user sending the /KICK command must be a channel operator of the named channel. If the optional is given, it will be shown as the reason for the kick. EXAMPLES: @{b}/KICK #amiga Freddie Take it outside!@{ub} forces 'Freddie' from channel #amiga with the reason 'take it outside'. @EndNode @Node "LEAVE" "AmIRC.guide/LEAVE" @Toc "Commands" LEAVE ----- Usage: @{b}/LEAVE [channel[,channel[,...]]@{ub} Leaves a channel. If you don't give a channel name as a parameter, the channel currently bound to the window in which in the command is entered will be left. EXAMPLES: @{b}/LEAVE@{ub} Leave the channel currently bound to this window. @{b}/LEAVE #AmigaGER@{ub} Leave channel @{i}#AmigaGER@{ui}. RELATED TOPICS: See @{"JOIN" Link "JOIN"}. @EndNode @Node "LIST" "AmIRC.guide/LIST" @Toc "Commands" LIST ---- Usage: @{b}/LIST [{,} []]@{ub} Generates a list of current channels and topics. If the argument is given, LIST displays that channel's status and topic. Private channels show as 'Private' and secret channels are not listed, unless the client generating the list is a member of those channels. EXAMPLES: @{b}/LIST@{ub} Shows a list of all current, non-secret channels. @{b}/LIST #amiga,#amigaGER@{ub} List channels #amiga and #amigaGER @EndNode @Node "LOG" "AmIRC.guide/LOG" @Toc "Commands" Logging Options --------------- Usage: @{b}/LOG {[on|off|]}@{ub} /LOG allows you to start/stop logging, as well as setting the log filename and displaying status of logging. EXAMPLES: @{b}/LOG@{ub} Displays current status of logging @{b}/LOG on@{ub} Begins logging to the logfile @{b}/LOG @{ub} Sets the path and name of the logfile. @EndNode @Node "MODE" "AmIRC.guide/MODE" @Toc "Commands" Channel MODE ------------ /MODE allows both users and channels to have their modes changed. Usage: @{b}/MODE {[+|-]|o|p|s|i|t|n|b|v} [] [] []@{ub} Used by Channel Operators to change the modes of 'their' channel. the modes available are: o - give/take channel operator privileges; p - private channel flag; s - secret channel flag; i - invite-only channel flag; t - topic settable by channel operator only flag; n - no messages to channel from clients on the outside; m - moderated channel; l - set the user limit to channel; b - set a ban mask to keep users out; v - give/take the ability to speak on a moderated channel; k - set a channel key (password). EXAMPLES: @{b}/MODE #amiga +tm@{ub} Sets topic protection and makes channel moderated for #amiga. @{b}/MODE #amiga -o Sarek@{ub} Removes channel operator status from user 'Sarek' on channel #amiga. @{b}/MODE #amiga +l 50@{ub} Sets limit of 50 users on #amiga. @{b}/MODE #amiga -l@{ub} Removes the limit form #amiga User MODE --------- Usage: @{b} {[+|-]|i|w|s|o}@{ub} These affect how a client is seen by others or what extra messages a client will receive. User Modes will only take effect if the Nick of the client sending the command, and the nick of the argument are the same. Available User Modes: i - marks a users as invisible; s - marks a user for receipt of server notices; w - user receives wallops; o - operator flag. Note that the @{b}+o@{ub} user mode will not work, however, @{b}-o@{ub} will. EXAMPLES: @{b}/MODE freddie +i@{ub} makes user 'freddie' invisible in the global user list. @{b}/MODE freddie -o@{ub} User 'freddie' removes channel operator status from himself. @EndNode @Node "MSG" "AmIRC.guide/MSG" @Toc "Commands" MSG (PRIVMSG) ------------- Usage: @{b}/MSG {,} @{ub} Sends a Private Message to one or more users. Note that this is different from a @{"/DCC Chat" Link "DCC"}, in that a /MSG (PRIVMSG) is sent thru the IRC server to the recipient. Note that the @{b}TAB@{ub} key will cycle back and forth through the users who have /msg'ed you. This will appear in the input string gadget, and you may simply add your message after it. EXAMPLES: @{b}/MSG Kenneth Heya Dude! How's Florida?@{ub} Send the message: "Heya Dude! How's Florida?" to user 'Kenneth'. @{b}/MSG Kenneth,Aerosoul I am in Pittsburgh@{ub} Sends the message "I am in Pittsburgh" to Kenneth and Aerosoul. @EndNode @Node "NAMES" "AmIRC.guide/NAMES" @Toc "Commands" Names ----- Usage @{b}/NAMES [{,}@{ub}] Gives a list of nicknames on any channel visible to the user(not secret or private, or one actually joined by the user performing the command). EXAMPLES: @{b}/NAMES #amiga,#amigaGER@{ub} Will list all users on channels #amiga and #amigaGER, provided the channels are visible to the user. @{b}/NAMES@{ub} Will return a list of all visible channels and users (Strongly Discouraged!) @EndNode @Node "NICK" "AmIRC.guide/NICK" @Toc "Commands" NICK ---- Usage: @{b}/NICK @{ub} NICK is used to to give yourself or change your current nickname. If the chosen nick is already in use, you wil be notified of this and prompted for a new nick. EXAMPLES: @{b}/NICK Phalanx@{ub} Makes/changes your nickname to 'Phalanx' @EndNode @Node "NOTICE" "AmIRC.guide/NOTICE" @Toc "Commands" NOTICE ------ Usage: @{b}/NOTICE @{ub} Smiilar to /MSG, /NOTICE is usually used by Bots or clients being controlled by scripts. /NOTICE messages must never be responded to by an automatic reply. See @{"/MSG" Link "MSG"} for syntax examples. @EndNode @Node "QUIT" "AmIRC.guide/QUIT" @Toc "Commands" QUIT ---- Usage: @{b}[]@{ub} Used to End an IRC session. The optional is the text that will be displayed upon quitting. EXAMPLES: @{b}/QUIT :Gone to have lunch@{ub} @EndNode @Node "RAW" "AmIRC.guide/RAW" @Toc "Commands" RAW --- Usage: @{b}/RAW text@{ub} Sends text directly to the IRC server without any further processing. @{i}Warning:@{ui} Don't even think about using this command without interior knowledge of the IRC protocol, or you might run into severe trouble. See `RFC 1459' for a description of the IRC protocol. EXAMPLES: @{b}/RAW JOIN #IRC-Heros@{ub} Send the string @{i}JOIN #IRC-Heros@{ui} directly to the IRC server. RELATED TOPICS: `RFC 1459'. @EndNode @Node "TIME" "AmIRC.guide/TIME" @Toc "Commands" TIME ---- Usage: @{b}/TIME []@{ub} Returns the time of day from the server. If the optional argument is given, then that servers local time will be returned. EXAMPLES: @{b}/TIME irc.pitt.edu@{ub} Returns the local time from server 'irc.pitt.edu' @EndNode @Node "TOPIC" "AmIRC.guide/TOPIC" @Toc "Commands" TOPIC ----- Usage: @{b}/TOPIC []@{ub} The topic command alone will display the channels topic. if the optional argument is given, the topic will be changed to the argument given, provided that the topic is not protected, or the user issuing the command is an operator on the channel. See @{"Channel Modes" Link "MODE"}. EXAMPLES: @{b}/TOPIC #amiga@{ub} Will display the current topic on #amiga. @{b}/TOPIC #amiga Amigas Rule!@{ub} Will replace the current topic of #amiga with the topic 'Amigas Rule' @EndNode @Node "USERS" "AmIRC.guide/USERS" @Toc "Commands" USERS ----- Usage: @{b}/USERS []@{ub} Returns a list of users on the server, or, optionally, on the specified server. /USERS may be disabled on most servers for security reasons. EXAMPLES: @{b}/USERS@{ub} Returns a list of users on the current server @{b}/USERS irc.colorado.edu@{ub} Returns a list of users on server 'irc.colorado.edu'. @EndNode @Node "USERHOST" "AmIRC.guide/USERHOST" @Toc "Commands" USERHOST -------- Usage: @{b}/USERHOST {}@{ub} Returns the login@domain for the specified nickname. Up to five nicknames may be specified, each separated by a . EXAMPLES: @{b}/USERHOST DuRaN@{ub} returns: 'DuRaN is DuRaN@calci.amiganet.pgh.net @EndNode @Node "VERSION" "AmIRC.guide/VERSION" @Toc "Commands" VERSION ------- Usage @{b}/VERSION []@{ub} Returns the version of the server's software. If the optional arguement is given, returns the version of the specified server's software. EXAMPLES: @{b}/VERSION *.edu@{ub} Returns server version information for all servers matching '*.edu'. @EndNode @Node "WHO" "AmIRC.guide/WHO" @Toc "Commands" WHO --- Usage: @{b}/WHO [ []]@{ub} Returns a generated list of all users matching the criteria passed to the command, i/e. everyone at a particular site, or on a particular server. If the optional argument is specified, /WHO will only return information on users that are channel operators. EXAMPLES: @{b}/WHO *.cmu.edu@{ub} Will list all users at the cmu.edu domain. @{b}/WHO irc.pitt.edu o@{ub} will list all operators on irc.pitt.edu server @EndNode @Node "WHOIS" "AmIRC.guide/WHOIS" @Toc "Commands" WHOIS ----- Usage: @{b}/WHOIS [] [,[,...]]@{ub} Returns information about the specified user or users, that you are allowed to see. If the optional argument is specified, then information aobut the user in relation to that specified server will be given, i/e idle time. EXAMPLES: @{b}/WHOIS Phalanx@{ub} Returns available information about user 'Phalanx'. @{b}/WHOIS irc.bu.edu Phalanx@{ub} Asks server 'irc.bu.edu' for information on user 'Phalanx @EndNode @Node "WHOWAS" "AmIRC.guide/WHOWAS" @Toc "Commands" WHOWAS ------ Usage @{b}/WHOWAS [ []]@{ub} returns information on a nick that no longer exists, due to the user leaving the server or changing their nick. The optional argument specifies how many previous instances of the nick should be returned. The optional argument specifies a particular server to be searched. EXAMPLES: @{b}/WHOWAS Aerosoul 5@{ub} Checks for and returns available information on the last 5 instances of the nick 'Aerosoul'. @EndNode @Node "Configuration" "AmIRC.guide/Configuration" @Next "ARexx" @Prev "Commands" @Toc "Main" Customizing your environment **************************** Overview ======== Now that you have AmIRC running, you may want to get it to operate the way you want it to, and to look pleasing as well. This is achieved thru both MUI preferences and AmIRC's Menu options. @{" MUI Preferences " Link "MUI Preferences"} Changing MUI Settings @{" AmIRC Setup " Link "AmIRC Setup"} Changing AmIRC Options @{" Function Keys " Link "Function Keys"} AmIRC Functon Key Definitions @EndNode @Node "MUI Preferences" "AmIRC.guide/MUI Preferences" @Toc "Configuration" Changing MUI Settings ********************* MUI Preferences =============== Most of the configuration dealing with how AmIRC's GUI appears can be customized with @{"MUI" Link "About MUI"}. Check the 'MUI Settings...' entry under the 'Settings' menu. This will pop up MUI's interface, allowing you to setup AmIRC's MUI Prefs, without disturbing any of your other MUI configurations. Read the documentation for MUI to Learn more about the operation of MUI Preferences. @EndNode @Node "AmIRC Setup" "AmIRC.guide/AmIRC Setup" @Toc "Configuration" Changing AmIRC Options ********************** AmIRC Setup =========== Most of the setup functions appear in the 'Setup' entry under the 'Settings' & 'Lists' menus. Here you will get a multi-requestor that will allow you to access several pages that deal with configuring AmIRC. @{" Messages " Link "Messages"} Messages Tab @{" Actions " Link "Actions"} Actions Tab @{" Events " Link "Events"} Events Tab @{" GUI " Link "GUI"} GUI Tab @{" Lists " Link "Lists"} Lists Menu @EndNode @Node "Messages" "AmIRC.guide/Messages" @Toc "AmIRC Setup" Messages Page ************* Misc Messages ============= @{b}CTCP Userinfo@{ub} The text in this string is what will be returned to a user who sends '/CTCP userinfo' to your client. @{b}KICK Reason@{ub} If you are a channel operator and /kick another user from the Channel, this test will appear as the reason for the /KICK. Quit Messages ============= @{b}Exit@{ub} This will appear to users in the channel when you exit AmIRC. @{b}New Server@{ub} This text will appear to users in the channel when you select 'Select Server' in the 'AmIRC' menu, and pick a new server to connect to. @{b}System Reset@{ub} This is the text to appear if you reboot your amiga (Crtl- amiga-amiga) while connected to a server. AWAY Messages ============= @{b}Default@{ub} This is the text that will appear when you are set 'away' by selecting the 'Marked Away?' item in the 'User Modes' menu. @{b}AutoAWAY@{ub} text that appears when you are automatically set away due to inactivity. @{b}Timeout@{ub} This sets how much time will pass before AmIRC assumes you are away from the computer and marks you as 'AWAY'. @{b}UnAWAY@{ub} This cycle gadget allows you to choose the conditions of which AmIRC will automatically set you to 'Not AWAY'. @EndNode @Node "Actions" "AmIRC.guide/Actions" @Toc "AmIRC Setup" Actions Page ************ Actions ======= The 12 text gadgets in the 'Label:' column here correspond to the 12 gadgets under the user list on AmIRC's main window. You may set these gadgets to be anything, sort of like macros. AmIRC, however, does include configurable function keys to act as macros, so these gadgets are preset for /ctcp, /dcc, and /mode operations. Below the text gadgets is a quick reference of the placeholders that can be used in the desired operation. @EndNode @Node "Events" "AmIRC.guide/Events" @Toc "AmIRC Setup" Events Page *********** Events ====== Here you may define certain actions to take place upon incoming events. These actions can be as simple as a warning beep from your amiga, or a complex and powerful rexx command. The following text first explains the functions of the columns of this page, and then goes on to explain what each event is. Columns ------- @{b}Event@{ub} The particular event for the action to take place on. @{b}Deiconify@{ub} If AmIRC is iconified, this will uniconify and bring to front the AmIRC window on the occurence of the event. @{b}Beep@{ub} This will perform a system beep on the occurence of the event @{b}Sound@{ub} if a sound sample is preferred for the event, you may use the requestor gadget to pick a sound to play instead of the system beep. @{b}Vol@{ub} This sets the volume for the sound sample. The valid range for the volume is 0 - 64. This is a slider gadget. @{b}Rexx Command@{ub} Here you may configure a rexx script to be run on the occurence of the event. Events ------ @{b}Any Message@{ub} This Event occurs on any incoming public message. @{b}Private Msg@{ub} This event occurs when you receive an incoming private /msg or /dcc chat message @{b}Notice@{ub} This event occurs when an operator sends out a /notice @{b}CTCP request@{ub} This event occures when your client receives any /ctcp request (for example /ctcp time, or /ctcp version @{b}DCC request@{ub} This event occurs on receiving a /dcc file transfer request or chat request. @{b}Join@{ub} This event occurs when anyone /joins the channel you are currently on. @{b}Kick@{ub} This event occurs when anyone is /Kicked from the channel you are currently on. @{b}Mode change@{ub} This event occurs when the channel mode is changed for the channel you are currently on, i/e. if someone is /OPed or /DeOPed, or if the channel is made private, etc. @{b}ISON Notify@{ub} This event occurs when AmIRC 'sees' a user that is configured in your 'Notify' list. @{b}Connection@{ub} This event occurs when AmIRC makes a connection to an IRC server. @{b}Invite@{ub} This event occurs when another user invites you to join a channel that is currently set to /MODE 'Invite Only' @EndNode @Node "GUI" "AmIRC.guide/GUI" @Toc "AmIRC Setup" GUI Configuration ***************** GUI === The GUI configuraton page allows you to control some specific aspects of AmIRC that arent covered in the MUI configuration. Userlist: --------- The userlist cycle gadget allows you to control if the User List is visible or not visible, and if it is visible, if it is a separate window, or a part of the AmIRC window. If the @{b}Sort Gadget@{ub} is check marked, the list will be sorted alphabetically, otherwise, the list will reflect the order that the users have joined the chat. The @{b}Buttons Gadget@{ub} will toggle on & off the gadgets in the User Action List, located below the user list. If the user list is configured as a separate window, the buttons will also appear in that window. The @{b}Userlist win open?@{ub} gadget will control if the userlist is open or closed if configured as a separate window. Misc ---- Here you may select a different pubscreen for the query window to appear on. If no pubscreen is specified, the Query window will open on the AmIRC default screen. Text Colors ----------- In this section, you may configure the colors that certain text will appear in AmIRC. These colors are based on the MUI pen colors that you have configured in MUI. Just click and hold on the cycle gadget to see a list of the MUI Pen colors available. @{b}Normal Text@{ub} Text that is a normal message from a user. @{b}Private Messages@{ub} Text that is a private message from another user to you. @{b}Mode Changes@{ub} Text that shows a mode change for the channel. @{b}Highlighted Text@{ub} Highlighted text is not yet implemented in AmIRC. @{b}Server Messages@{ub} Text that comes from the server, i/e when a user joins or exits the channel. @{b}CTCP/DCC Messages@{ub} Text that informs you of an incoming CTCP or DCC request. Logging ------- Here you may enter the path & name to use for the logfile. @EndNode @Node "Lists" "AmIRC.guide/Lists" @Toc "AmIRC Setup" "Lists..." Menu Item ******************** Lists Configuration =================== Alias Tab --------- Here you can create aliases, or shortcuts for complex IRC commands. Some examples have been created for you, and a reference template appears at the bottom of this page. %p is the place holder for any arguments you may wish to add when using an alias. Ignore Tab ---------- Here you can set which users if any you want to ignore, and what kind of messages from them to ignore. To add an ignore to the list, click the 'Add Ignore' gadget, then type the user's name in the text input gadget labeled 'Ignore'. Next click on the type of messages you want to ignore. Checking the 'text' box will prevent you from seeing any public messages from the user. Setting the 'privmsgs' box will prevent you from seeing /MSGs from that user to you. Likewise, clicking the 'CTCPs' box will prevent you from seeing any CTCP requests from the Ignored user. To delete an ignore, click on the entry you wish to delete, and then click on the 'delete ignore' gadget. Hilite Tab ---------- Here you may set certain text to be highlighted in order to get your attention if that text appears. You may set text to match the nick, Userhost, or any keyword enclosed in double quotes. To add a new pattern, click on the Button labeled "Add new Hilite pattern", and type your pattern into the input gadget. To delete an existing pattern, Click on the entry yo uwish to delete and then click on the button labeled "Delete Hilite pattern". The Hilite patterns will ignore a pattern it recognizes if it was input by you, but will activate on the pattern from other users. Pattern Definitions: -------------------- @{b}Nick@{ub} This will watch the AmIRC listview for the nick that you specify, and highlight the text for that users message. The 'Nick' entry does not require double quotes. @{b}Userhost@{ub} This will watch for messages that originate from a particular Userhost, and highlight the text for that message. Userhost entries may contain wildcards. Examples: @{b}fred!fdoe@doe1.powernet.edu@{ub} This will highlight only messages from fred at that particular address. @{b}fred!*@*@{ub} This will highlight messages from anyone named fred, regardless of address or login name. @{b}Fred!*@*.powernet.edu@{ub} This will highlight messages from anyone named fred on any machine on powernet.edu @{b}*!*@doe1.powernet.edu@{ub} This will highlight any messages from anyone on the doe1 machine at powernet.edu @{b}*!*@*@{ub} This will highlight any messages from any user. @{b}"Keyword"@{ub} This will highlight any message that contains the text enclosed in double quotes. @EndNode @Node "Function Keys" "AmIRC.guide/Function Keys" @Toc "Configuration" Function Key Definitions ************************ Function Keys ============= Here you may define the Amiga's ten functon keys to insert text into the input string gadget of AmIRC. By using the keys normally, or with the 'shift' or 'crtl' modifiers, you may define up to 30 text input macros that can be used at the press of a key. This is similar to the functon key macros found on many popular terminal emulation programs. A @{b}/n@{ub} at the end of a function key definition will send a after the text. The function key definitions also allow placeholders, similar to the @{"user buttons" Link "Operation"}. @EndNode @Node "ARexx" "AmIRC.guide/ARexx" @Next "About MUI" @Prev "Configuration" @Toc "Main" AmIRC's ARexx Port ****************** Overview ======== AmIRC supports a versatile ARexx Port. Reference ========= @{" SAY " Link "RX_SAY"} Treat something just like it was entered in the input string. @{" GETMYNICK " Link "RX_GETMYNICK"} Request current nick name. @{" ISCONNECTED " Link "RX_ISCONNECTED"} Check whether connection is established. @{" GETSERVERNAME " Link "RX_GETSERVERNAME"} Request current server name. @{" USERHOST " Link "RX_USERHOST"} Query Userhost of a nick. @{" ECHO " Link "RX_ECHO"} Echos text to the current listview. @{" RAW " Link "RX_RAW"} Sends raw text to the server. @{" CHANNELS " Link "RX_CHANNELS"} Returns string showing joined channels. @{" GETCHANNEL " Link "RX_GETCHANNEL"} @{" GETSELECTEDUSER " Link "RX_GETSELECTEDUSER"} @{" GETUSER " Link "RX_GETUSER"} @{" GETUSERS " Link "RX_GETUSERS"} @{" GETUSERSTATE " Link "RX_GETUSERSTATE"} @{" GETLINE " Link "RX_GETLINE"} @{" GETLINECOUNT " Link "RX_GETLINECOUNT"} @{" GETLASTLINE " Link "RX_GETLASTLINE"} @{" GETAWAYSTATE " Link "RX_GETAWAYSTATE"} @{" GETVERSION " Link "RX_GETVERSION"} @{" PARSELINE " Link "RX_PARSELINE"} @EndNode @Node "RX_SAY" "AmIRC.guide/RX_SAY" @Toc "ARexx" SAY --- Usage: @{b}SAY TEXT/F@{ub} DESCRIPTION: Treats @{i}TEXT@{ui} just like it has been entered in the string gadget of the current window. EXAMPLES: @{b}say '/JOIN #Amigager'@{ub} RELATED TOPICS: @EndNode @Node "RX_ISCONNECTED" "AmIRC.guide/RX_ISCONNECTED" @Toc "ARexx" ISCONNECTED ----------- Usage: @{b}ISCONNECTED@{ub} DESCRIPTION: Checks whether a connection is currently established. Returns RC 0 if the link is up, RC 5 otherwise. EXAMPLES: @{b}ISCONNECTED; say rc@{ub} RELATED TOPICS: @EndNode @Node "RX_GETMYNICK" "AmIRC.guide/RX_GETMYNICK" @Toc "ARexx" GETMYNICK --------- Usage: @{b}GETMYNICK@{ub} DESCRIPTION: Returns your current nickname. EXAMPLES: @{b}GETMYNICK; say result@{ub} RELATED TOPICS: See @{"RX_GETSERVERNAME" Link "RX_GETSERVERNAME"}. @EndNode @Node "RX_GETSERVERNAME" "AmIRC.guide/RX_GETSERVERNAME" @Toc "ARexx" GETSERVERNAME ------------- Usage: @{b}GETSERVERNAME@{ub} DESCRIPTION: Returns the name of the IRC server you are currently connected to. EXAMPLES: @{b}GETSERVERNAME; say result@{ub} RELATED TOPICS: See @{"RX_GETMYNICK" Link "RX_GETMYNICK"}. @EndNode @Node "RX_USERHOST" "AmIRC.guide/RX_USERHOST" @Toc "ARexx" USERHOST -------- Usage: @{b}USERHOST NICK/A@{ub} DESCRIPTION: Returns the userhost specification belonging to @{i}NICK@{ui}. AMIRC keeps a internal list of the userhosts of every nick that occured yet. You can query this database with this command. Note however that it is possible that the userhost isn't in the database yet; this command will @{i}not@{ui} query the server than, but simply return an error. EXAMPLES: @{b}USERHOST Olli; say result@{ub} RELATED TOPICS: See @{"RX_GETMYNICK" Link "RX_GETMYNICK"}. @EndNode @Node "RX_ECHO" "AmIRC.guide/RX_ECHO" @Toc "ARexx" ECHO ---- Usage: @{b}ECHO P=PREFIX/K, TEXT/F@{ub} DESCRIPTION: Sends text to the listview EXAMPLES: @{b}ECHO P=Kewlja This is echo test@{ub} @EndNode @Node "RX_RAW" "AmIRC.guide/RX_RAW" @Toc "ARexx" RAW --- Usage: @{b}RAW TEXT/F@{ub} DESCRIPTION: Sends text to the server in raw format. EXAMPLES: @{b}RAW PRIVMSG phalanx: heya! whats happening?@{ub} @EndNode @Node "RX_CHANNELS" "AmIRC.guide/RX_CHANNELS" @Toc "ARexx" CHANNELS -------- Usage: @{b}CHANNELS NULL@{ub} DESCRIPTION: returns a list of channels currently joined in the format: "#channel1 #channel2 etc." EXAMPLES: @{b}options results; channels; say result@{ub} @EndNode @Node "RX_GETCHANNEL" "AmIRC.guide/RX_GETCHANNEL" @Toc "ARexx" GETCHANNEL ---------- @EndNode @Node "RX_GETSELECTEDUSER" "AmIRC.guide/RX_GETSELECTEDUSER" @Toc "ARexx" GETSELECTEDUSER --------------- @EndNode @Node "RX_GETUSER" "AmIRC.guide/RX_GETUSER" @Toc "ARexx" GETUSER ------- @EndNode @Node "RX_GETUSERS" "AmIRC.guide/RX_GETUSERS" @Toc "ARexx" GETUSERS -------- @EndNode @Node "RX_GETUSERSTATE" "AmIRC.guide/RX_GETUSERSTATE" @Toc "ARexx" GETUSERSTATE ------------ @EndNode @Node "RX_GETLINE" "AmIRC.guide/RX_GETLINE" @Toc "ARexx" GETLINE ------- @EndNode @Node "RX_GETLINECOUNT" "AmIRC.guide/RX_GETLINECOUNT" @Toc "ARexx" GETLINECOUNT ------------ @EndNode @Node "RX_GETLASTLINE" "AmIRC.guide/RX_GETLASTLINE" @Toc "ARexx" GETLASTLINE ----------- @EndNode @Node "RX_GETAWAYSTATE" "AmIRC.guide/RX_GETAWAYSTATE" @Toc "ARexx" GETAWAYSTATE ------------ @EndNode @Node "RX_GETVERSION" "AmIRC.guide/RX_GETVERSION" @Toc "ARexx" GETVERSION ---------- @EndNode @Node "RX_PARSELINE" "AmIRC.guide/RX_PARSELINE" @Toc "ARexx" PARSELINE --------- @EndNode @Node "About MUI" "AmIRC.guide/About MUI" @Next "Revision History" @Prev "ARexx" @Toc "Main" Magic User Interface ******************** About MUI ========= This application uses MUI - MagicUserInterface (c) Copyright 1993/94 by Stefan Stuntz @{b}Without MUI, AmIRC wouldn't exist.@{ub} If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY Why MUI? ======== Why MUI? you ask... MUI is the most powerful application framework toolkit available for any platform. MUI allows applications to provide their users with a highly usable, fast and configurable user interface which works well on any screen setting, from a 640x200 NTSC display to a 1280x1024 true color graphics board. MUI applications use less memory than comparable applications since they can rely on a huge set of shared class code, which is especially true if several MUI apps are run on the same machine. Plus, MUI's powerful OO class methods allows the application programmer to work on the program's functionality instead of doing repetitive low level tasks, resulting in much more powerful applications given the same development times. MUI's GUI classes overcome the severe design bugs in the ROM internal BOOPSI gadget classes, allowing for complex GUI objects without high priority CPU hogging or potential system deadlocks. MUI compacts over 4 years of development and optimization in a powerful toolkit, an effort no application programmer can afford to invest in his own development. @EndNode @Node "Revision History" "AmIRC.guide/Revision History" @Next "Credits" @Prev "About MUI" @Toc "Main" Developments in AmIRC ********************* Revision History ================ 0.87beta ------- - list class now avoids "plane optimization" if AmIRC runs on a cybergfx chunky mode screen. - made the userlist scroller less jumpy. - fixed a few boolean config settings which weren't properly saved. - fixed screen refresh problems with mark selecting and scrolling. - during config save, "," inside the autojoin channel settings weren't properly escaped, causing the server list to be messed up. - AWAY state will now be visualized by rendering the nick underlined with FILLPEN. - it's now possible to measure the user-server round trip time by issuing the /PING command without parameters. - double clicking on an entry in the URL grabber window will now cause the entry to be copied to the clipboard. 0.86beta ------- - fixed several problems with listview refresh. - cut&paste marking is a bit less flashier now again. - function keys now allow for the same placeholders as user op buttons. - function key assignments ending with a "\n" now cause the input to be directly processed as if the user pressed ENTER manually. - alias definitions now work even if they start with a "/". 0.85beta ------- - sounds and userlist settings weren't updated upon loading the config file. - fixed TAB messaging to properly cycle in both directions. - fixed several bugs regarding cut&paste marking. - reduced screen refresh during cut&paste. 0.84beta ------- - now requires at least MUI 3.1 to work. - replaced the main text list with a custom list object optimized for this particular purpose. This results in about 3 times faster scrolling and generally less CPU usage during text output. Also, the new list class is much more memory efficient and works better during relayout. Note that the speed isn't fully optimized yet. - the main text listview now supports mark/cut to clipboard. - fixed the desynch problems with the ARexx GETLINE command which could cause lines to be missed. Now, GETLINE will buffer the last 50 server lines internally and will use a special counter variable bound to your ARexx script to make sure you receive lines in order. - rewrote the internal prefs handling completely. Decreased AmIRC's memory usage by a few 100k's since now all prefs BOOPSI objects are created dynamically. - AmIRC now saves a textual configuration file for easy editing. - the auto prefs saving during exit can now be turned off with a menu option. - the prefs requesters now have "Use" and "Cancel" buttons. - event sounds are no more loaded twice or more if the same sounds are specified for different events. - fixed NOTIFY to no longer turn recognized nicks into upper case in the list. - TAB now works more like the ircII tab script; cycling through the list of nicks who last send messages to you. SHIFT-TAB cycles forward. - the "," nick destination will now also by set by incoming DCC CHAT messages. - "Connect Thread" didn't work when the executable path contained spaces (i.e. "Ram Disk:" ;) - real long channel names are now cutted before displayed in the channel window and window menu. - the DCC messages generated by DCC sub threads didn't use the color setup for DCC messages. 0.83beta ------- [internal only] 0.82beta ------- - changed kickban window layout to fit on medres screens - fixed a nasty internal bug which caused innocent memory to be overwritten during preference save. Could cause nifty side effects under certain circumstances. - changed yet another bug in the prefs window setup which caused a bad crash when /IGNORE, /HILITE or /ALIAS were used after the list window was opened once. - reduced overall stack usage and default stack size to 24k. - changed several string buffers to fit into boopsi's stringclass shared buffer. - several attempts to reduce overall memory usage, esspecially using new MUI 3.2 features. 0.81beta ------- - startup failure caused a FreeSignal(0) to happen. - added new OP/VOICE icons which should look better on a 4 color screen. - several GUI fixes. - reduced signal bit usage to avoid trouble with certain inet225 versions. - added NORESETHANDLER Tooltype/Shell switch. - finally changed DCC host ip lookup to use getsockname() on the server socket; this should fix ALL kind of ENV:HOSTNAMEish trouble. TIA users still must set TIADCC or change to a real IP provider :) - fixed a severe bug in the DCC CHAT IPC system which caused a non-protected access to a pool from several processes, possibly resulting in a nifty crash. - fixed a few potential crashes when moving objects while dynamically creating prefs windows. - event rexx script parameter extension caused a nice crash with very long messages. - changed behavior of the "DCC Receive Dir" field. From now on, changes in this path will also affect already queued DCC receive requests which haven't be renamed to a different filename and path before. This is the "intuitive" behavior. - added "borderright" tooltype/shell option to have the window size border moved to the right. This should really be an MUI prefs option. 0.80beta ------- - Wallops-Display will now display the source of the Wallops message - fixed a crash when selecting "Sound?" in events menu. - added fixed catalog translations. - the default initialisation of the server list was messed up and caused both enforcer hits and junk in the password entries. - sound volume settings get messed up, causing sounds to be played with volume 0 until the sound options window was opened once. 0.79beta ------- - severe bug in the as225 part of the tcp code caused a AmiTCP LVO to be called on SockBase, resulting in messed up results up to mere crashes. - prefs setup modification caused the sound dt support to not work properly. - prefs setup modification caused /LOG to crash immediately. - did various GUI fixes. 0.78beta ------- - added GETUSERS command which returns a string of all users on a channel of the form "nick1 nick2 nick3"... - %p replacement within EVENT ARexx calls didn't work at all. - some internal & GUI cleanup. - changed DCC port allocation scheme to avoid "reusing" active but delayed DCC requests with different users and to avoid "No socket" errors with MLink. - workaround a few MLink close() bugs in DCC send. - now accepts 422 response as End-Of-MOTD. Fixes problems with IRC servers which started up with "Error MOTD file is missing", causing login, autojoin etc.pp. handling to not work. - topics weren't properly cleared when hopping servers or channels. - rename of DCC-CHAT connections upon NICK didn't work properly. - "Connect Thread" didn't work when no autojoin was specified for the selected server (new instance failed immediately with argument parse error) - private messages output caused %-format-codes to be interpreted instead of being ignored. - "/MSG ," addressed the last PRIVMSG source even if it was a PRIVMSG of an ignored user. - now all ALT-SPACE inside input strings are replaced by simple spaces, to avoid trouble with IRC server parsing. - reduced overall memory usage by making several of the prefs windows dynamic. - added Language Tooltype/Shell-Option to manually select a language catalog, overriding locale prefs. - fixed several GUI quirks. 0.77beta ------- - fixed a potential WaitForEver() problem in DCC Receive threads. - changed user mode parsing to better suit localisation. - event rexx scripts can now take an optional parameter %p which will be replaced with the unparsed server line which caused the event to happen. - added "PARSELINE" ARexx command which will split it's argument line into LINE.PREFIX, LINE.DEST, LINE.REST and LINE.COMMAND just like GETLINE does. - ARexx-Cmd "ISCONNECTED" didn't work at all, but returned 0 always. - added GETAWAYSTATE Arexx command. - fixed HILITE not working properly if the matching word was at the end of a line. - abuse of MUI's label objects caused several dynamic texts to react oddly to "_" within them (most notable the kickban win title). 0.76beta ------- - some tangling Printf() debug statement in the DCC Receive handler caused enforcer hits and severe crashes when several DCC Receive threads were active. - added GETCHANNEL, GETSELECTEDUSER, GETUSER and GETUSERSTATE ARexx commands. All take an optional WINNUM argument, GETUSER and GETUSERSTATE require an user index. GETUSER returns the name of the indexed user of the current window, GETUSERSTATE returns RC=1 if the user is OP, RC=2 if he has voice. - added GETVERSION ARexx command to check AmIRC's version. - added GETLASTLINE, GETLINECOUNT and GETLINE arexx commands. GETLINE will wait(!) for a new line from the server to arrive and return this line into the "LINE" variable. It will also return the parsed line components into LINE.PREFIX (userhost), LINE.COMMAND (either numerical or alpha command), LINE.DEST and LINE.REST. The meaning of the components depends on the specific message. - added new /RXRETURN user command. This is merely to support scripts and ought to be used with /ALIAS. It will return it's first and following parameters with the current GETLINE command in LINE.COMMAND and LINE.REST respectivly. - fixed several mode changes command templates which were messed up. - removed auto turn off of input filtering in string gadgets again. Will now internally accept CTRL-V, CTRL-U (!), CTRL-B, CTRL-G and CTRL-W for entering formatting codes into strings, regardless of the IControl input filtering settings. - lines which contained only control codes messed up the word wrap engine. - fixed a stupid bug in notify which caused ISON request to be not send properly under certain circumstances. 0.75beta ------- - /LIST with a single channel as an argument will no longer cause a complete list to be requested. - fixed "repeat-on-cr-pressed" bug in the string gadgets. - added parsing of 271/272 response codes (Undernet SILENCE list). - windows are properly closed upon close request; no longer waits for the PART message from the IRC server. - vbar rendering in the main listview will now completely be done by MUI for efficency and exact positioning. - added netsplit detection. - string gadget has now turned off input filtering by default. - string gadget accepts up to 1024 chars and splits accordingly 0.74alpha -------- - some MUI3 dependancy slipped in the window creation function. 0.73alpha -------- - pressing TAB returned garbage if no user was referenced in the user listview. - the first window didn't properly show the nickname. - load and save config with file requester failed badly due to misinitalized screen variable. - added RAW, ECHO and CHANNELS arexx commands. - fixed several bugs with cycle chains and keyboard control of gadgets. - raised stack size for DCC CHAT threads. Should fix all kinds of crashes, esspecially with as225/inet. - sound loading was severly messed up and caused about EVENTS^2 datatypes load to happen. - fixed WHO layout a bit. - extended the /LIST command to properly work in "shell mode" with pattern and -MIN arguments. 0.72alpha -------- - switched back to using "GetHostId()" if ENV:HOSTNAME doesn't exist or is invalid. Should fix all kind of DCC trouble with MLink. Make sure that ENV:HOSTNAME is either correct or not existant if you use MLink. - fixed a few typos and IRC response parsing problems. - Topics longer than 127 characters caused a real bad crash. - reduced memory usage a bit. - %p in alias expansion with missing arguments caused garbage to be inserted. - fixed some bugs in the listview setup. - added basic log capability (no filtering yet, only RAW output). - URL grabber messed up news: URLs - seperate user list windows can now be configured to start up opened or closed. - will now properly rename query windows and dcc chat sessions upon receiving of a NICK change message. - misc. fixes. 0.71alpha -------- - something in the optimizer seems to have broken as225r2 compatibility. Now compiled without optimizer again. Subject for further investigation. - didn't work with MUI 2.x due to use of popscreen.mui. Will now display a simple string gadget then. 0.70alpha -------- - changed internal string table layout; internal string access is now much faster, even when strings are taken from a catalog file. - /DCC LIST now works. - /WALLOPS was broken. - Query windows can now be opened on a different public screen. - DCC requests are now also accepted when sent with a "NOTICE" to accomodate for certain buggy DCC implementations. - In non-alphasort mode userlist entries were added to the top, not to the bottom of the list. 0.69alpha (quickfix) ------------------- - subitems for the window sub menu weren't no longer added, making closing windows crash badly. 0.68alpha -------- - CTCP PING didn't work. - holding down ENTER caused the same text to be continously send. - SHIFT-TAB will now insert "Nick: " into the input line. - CTRL-UP/DOWN and ALT-UP/DOWN inside a query window caused instant crash. - String class was, in cooperation with some MUI bug, loosing signal bits. This caused frame gadgets to not work any longer. - The bubble help of the userlist action buttons will now display the real command assigned to the button. - Userlist action buttons now work if no user is selected and no %u was specified. - /ME within dialog windows will now work just like /DESCRIBE. 0.67alpha -------- - DCC windows now use tiny fonts for the lists. - optimized TextFit() wasn't working correctly, cutting of characters depending on the font. - enforcer hits with commands which had a single channel name as a parameter ("/NAMES #Amigager" for example). - /RX will now find commands in PROGDIR:Rexx - Rexx-on-Event didn't work at all - added a few more sound samples by Robert Wilkens - the event manager now has "Test sound" buttons - Connect and Autodownload windows shouldn't cause trouble any more (recycled MUIMasterBase between tasks :) - the "is this mail or news" guess in the URL grabber always assumed mail 0.66alpha -------- - userlist action button rows which contain no labels will now be hidden - the first 10 window selector menu items now have shortcuts from "0" to "9". Allows to easily switch channel windows with Amiga-0..9. - serious bug in DCC-SEND; neither RESUME-ACCEPT nor MOVE-RESUME did work since AmIRC didn't actually seeked to the requested file position. - added support for TIADCC (SetEnv TIADCC "tiahost port"). The variable format is compatible with Tau's DCC implementation. - fixed a few quirks in the string input class. - list class is now more compatible with fonts which have a "obscure" tf_XSize value. - sub processes weren't properly terminated during IPC if the main application was forcefully quit. - fixed drag & drop list sort for server and alias list (MUI3 only). - the button/info row in query windows can now be turned off to save visual space. - fixed activation state of the user list. If the current user PARTs or gets KICKed, selection will turn off completely. If the current user renames himself, the selection will follow accordingly. 0.65alpha quick fix :) --------------------- - String input gadget was dead with MUI 2.3. - added a kludge to avoid MUI 3.0's MUIA_String_MaxLen-1-Bug within the nickname gadgets 0.64alpha -------- - fixed splitting and rejoining of lines in listview (spaces got inserted when a line couldn't be split on a word boundary) - main listview now properly preserves text style attributes upon line splits and relayouts - the ban popup list is now a "real" window which can be dragged and sized - line read buffer pointer wasn't reset when a server link was forcefully terminated. Caused nonsense to appear on next connect. - added support for "DCC RESUME", a method of resuming DCC SENDs originally implemented by the mIRC for Windoze IRC client. It's not recommended to use DCC RESUME between AmIRCs, use MOVE instead. - OP/VOICE now accept up to four nicks - BAN did work with a single nick only. - the command parser assumed that all strings beginning with "*" are channel names, effectivly rendering /BAN useless. - KICKBAN window now has four buttons to setup "standard" types of ban mask (full, userhost, dynamic hostname, dynamic ip) - CTRL-Cursor-Up/Down now allows to select the current user in the user list. - TAB will now enter "/MSG nick " if the input line is empty or just "nick" if there is already something entered in the line. - ALT-Cursor-Up/Down allows to scroll within the main output list. ALT-SHIFT allows to page accordingly. - fixed a few bugs in state managment of the main list class. Could cause enforcer hits when LCM_INSERT was used before MUIM_Show was called; this mainly occured with the new private message log which normally stays closed. - "Auto open Dialog Windows" was not functional at all. - Function key did only work when changed during the session, not after loading. - Rexx script gathering caused entries with "PROGDIR:" to be entered in the list, which didn't work, cause it would have referenced the Rexx master process' PROGDIR: if it would exist :) - several parts of parsing code failed with characters > 127, esspecially the notify option with "strange" nicks. - messages added to the private message log now have a time stamp. - finally got around adding Troy Davis to the thanks list in the about requester. 0.63alpha -------- - the vertical bar in the main listview was messed up. - added VBars on several of the other listviews (MUI3 only) - User list action buttons didn't used MUIA_Font_Tiny as intended. - "Save as" with no config name given could cause erraneous behavior and even crashes with some requester patches. - manually resetting AWAY via menu state didn't restart the auto away timeout. - failure to open "rexxsyslib.library" wasn't catched and could cause serious trouble later on. - fixed a severe bug in the ioctl() call in AS225 which was called with the AmiTCP code for FIONREAD. Caused DCC's to loop dead. - auto reconnect to server now limited to 10 retries. - now checks for duplicates before adding entries to the URL grab window. - nickname gadgets now accept all RFC-1459 allowed nickname characters and even "_" :) - added help bubbles for the channel mode buttons (MUI3 only) 0.62alpha -------- - Click-On-Notify still didn't work - fixed selectwait() call in the as225 tcp interface. DCCs are now properly cancelable :) - /RX did pass parameters, but only the first - /NOTIFY did react on parts of nicknames (e.g. "/NOTIFY OLI" reacted on an "OLIVER" being on) - added URL grabber; incoming text is scanned for URLs and MessageIds, which are presented in a list window. Double clicking on a URL will send them to AMOSAIC.1 via Rexx - Rexx: Using "Say" with no open window caused terrible crash - added privmsg log window which stores all private msgs send to you - added a few Undernet servers to the default server list - added a few useful menu shortcuts 0.61alpha -------- - incoming/outging DCC chat requests will now no longer open the dcc chat list window. - startup errors (in particular wrong arguments passed on a shell startup) caused destructors to be inproperly called, resulting in dead locks. - WHOIS-ON-NOTIFY didn't work when the watched user was logged in (did send "WHOIS +USER"...) - made an attempt to fix the as225 code which seems to be crashing on DCC (sorry, can't check this for myself) - /RX didn't pass arguments. - will now no longer create an empty Rexx menu if no rexx scripts are found (AmIRC looks into PROGDIR:Rexx/ and Rexx: for files ending with *.AMIRX). It's nicer and avoids nasty crashes with certain buggy Menu hacks :) 0.60alpha -------- - channel list didn't worked at all. - double click on an entry in the notify list will now issue an /WHOIS nick command. 0.59alpha -------- - AWAY flag is cleared after connection to a server. - Autojoin channels are now bound to the server configs. This allows you to specify different channels for different servers. - state of the "Create Icons" menuitem is now saved correctly. - "Help" menuitem works. - Bug in the string class caused enforcer hits and made MUIKEYS not working correctly. - when the connection was lost during receive of the channel list, the channel listview stayed deactived. - empty CTCP ACTION requests are no longer displayed. 0.58alpha -------- - the light bulb's transparent color wasn't set correctly so the background got overwritten. - fixed a few MUI object background settings. - program and basename now thoroughly changed from MICROIRC to AMIRC. - light bulb is now a page group to avoid MUIA_Bitmap_Bitmap not being correctly settable. Should also fix a potential crash. - added FKey support. - String gadget is now constantly activated. - added "Invite" event. - default prefs storage location is now "PROGDIR:Default.MIRC" to avoid problems if AmIRC is started from another dir. - now deiconifies upon receiving SIGBREAKF_CTRL_F 0.57alpha -------- (skipped) 0.56alpha -------- - light bulb/mic icon refresh now fixed. - fixed QUERY windows to correctly parse IRC formating codes on output. 0.55alpha (saturday evening release, please don't wonder :-) ----------------------------------------------------------- - fixed missing CTCP ACTION parsing for private PRIVMSGs - added missing /DESCRIBE command. - OP/VOICE status is now displayed with a nice icon (thanks Morden). The implementation of the display sucks, it's gonna fixed in the next release. 0.54alpha -------- - fixed a bug in WALLOPS and ERROR parsing, not outputting anything but causing an enforcer hit instead. - userhost database sometimes caused calls to FreePool() with a mismatched size (len-1). Could screw up pool management severly. - now entering a server name no longer causes the list to be sorted, leaving input focus on an undesired entry. - added missing /BAN, /BANDEL and /BANLIST commands. 0.53alpha -------- - just bumped revision to avoid confusion with a "0.52alpha" floating around. 0.52alpha (not published) ------------------------ - seperated user list now finally works without crashing badly. - the seperated user list windows now have a close gadget, and the channel windows have a pop button to reopen it. - fixed sorting of user list. - changes of GUI settings now happen instantly. Note that MUI 2.x requires closing and reopening of windows for some operations. - kludged around the userlist refresh bug by manually forcing redraw on every JOIN/PART. - Auto-Rejoin-After-Kick now defaults to off due to popular demand. 0.51alpha (not published) ------------------------ - fixed incorrect parsing of 317 extend message (signon time) - fixed a few quirks in DCC SEND aborted output. 0.50alpha -------- - fixed a crash with certain MUI versions on SAVE. - DCC originating sometimes didn't work since GetHostId() reported "127.0.0.1" (localhost). Now falls back to reading ENV:HOSTNAME and doing gethostbyname() on this. - the user list may now be hidden totally or put to a seperate window. Note: This isn't implemented correctly now; i'll change it ASAP. - the user list sorting can now be turned off. 0.49alpha -------- - remote logging of AMIRC usage has been removed completely. 0.48alpha -------- - added event handling. Allows you to deiconify, beep or play a (datatypes) sound on certain events. - some internal stuff. - added processing of the "250" extension message. 0.47alpha -------- - fixed "DCC SEND/MOVE ABORTED" which was screwed in several places. 0.46alpha -------- - added RAW IRC output window. - Auto-Update-Get will now automatically extract AMIRC.ReadMe to T:, display it and offer to automatically unpack the gotten archive to RAM: @EndNode @Node "Credits" "AmIRC.guide/Credits" @Next "Bug Reports" @Prev "Revision History" @Toc "Main" Those Deserving Favour ********************** Thanks to:: =========== The author wishes to thank the following people for their help during AmIRC development: @{b}Karl 'Phalanx' Bellve@{ub} Who provides space, connectivity and cpu time for running the AmIRC support area. He also helped during development, and did alot of encouragement. :-) @{b}Laurence 'DuRaN' Walton@{ub} Who did write the documentation, first installer and also helped alot during development in other respects. @{b}Christopher 'ChrisDi' Dietz@{ub} Who did the German catalog translation. @{b}Philippe 'PhB' Brand@{ub} Who did the french catalog translation. @{b}Fredrik Rambris@{ub} Who did the swedish catalog translation. @{b}Pascal 'arcade' Eeftinck@{ub} Who did the dutch catalog translation. @{b}Juan 'Goliath' Ramirez@{ub} Who did the Spanish translation @{b}Manuel 'CCCP' Giorgini@{ub} Who did the Italian translation @{b}Troy 'Doogie' Davis@{ub} Who helped much with testing and developing the ARexx port, besides reporting bugs and making useful suggestions of other kinds. @{b}Robert 'RobR' Reiswig@{ub} Who did write the installer script. @{b}Olaf 'Olsen' Barthel@{ub} @{b}Michael 'mlelstv' van Elst@{ub} @{b}Kenneth 'Kenneth' Jennings@{ub} @{b}David 'Deathland' Zvekic@{ub} for their help with debugging the as225r2 code. @{b}Klaus 'kmel' Melchior@{ub} for his help with tracking down several MLink problems. @{b}Andreas M. 'bonzo' Kirchwitz@{ub} for useful advice and showing a good load of humor during the //KICKBAN test. @{b}Ralph 'rbabel' Babel@{ub} who helped to track down a nasty bug in slink's constructor priority ordering. @{b}The SAS/C Amiga Development team@{ub} @{b}(Especially Steve Krueger)@{ub} For their continued support of teh SAS/C Compiler @{b}Holger 'hkr' Kruse@{ub} who pointed out the easy solution to the @{i}WTF is my own IP number?@{ui} problem @{b}Jason 'morden' Murray@{ub} @{b}Robert 'Devo' Bradman@{ub} who drew the OP and VOICE icons @{b}Angela 'Nessy' Schmidt@{ub} @{b}Christoph 'Pepo' Feck@{ub} @{b}Sascha 'Master' Lentz@{ub} who helped test several AmIRC features in a real-life environment (say #AmigaGER ;-) @{b}The IRC admin at irc.uni-paderborn.de@{ub} @{b}(Thomas 'Heager' Thissen)@{ub} which served as the primary test site @{b}Brian 'SmknDHerb' Maurino@{ub} @{b}Sandro 'Sandro' Catallo@{ub} @{b}Robert 'Gostrider' Wilkins@{ub} Who created and compiled the demo sounds @{b}Fionn 'Fionn' Behrens@{ub} @{b}Frank 'Daddie' Peters@{ub} @{b}Holger 'Heureka' Jakob@{ub} @{b}Jens 'Jens' Hünerberg@{ub} @{b}Mathias 'Merlin' Mischler@{ub} @{b}Michael 'mickh' Hohmann@{ub} @{b}Nicole 'Talyn' Brandt@{ub} @{b}Peter 'Stoebi' Schulz@{ub} @{b}Roy 'AK' Millican@{ub} @{b}Thomas 'logo' Butter@{ub} for early testing and design suggestions @{b}Christoph 'CeeGee' Gülicher@{ub} @{b}Danny 'Danny' Amor@{ub} @{b}Markus 'Ill' Illenseer@{ub} @{b}Markus 'Lammy' Lamers@{ub} @{b}Matthias 'DrMabuse' Lühr@{ub} who simply bugged me to get on the list :) @{b}Osma 'Tau' Ahvenlampi@{ub} The major inspiration for the IGNORE support in AmIRC This Document Prepared by Laurence Walton ©1995 Oliver Wagner All Rights Reserved @EndNode @Node "Bug Reports" "AmIRC.guide/Bug Reports" @Next "Known Bugs" @Prev "Credits" @Toc "Main" How to Report Bugs ****************** Bug Reports =========== Please send bug reports to @{b}AmIRC@lsd.wupper.de@{ub}, not to my standard mailbox. Include in the report the OS version of your amiga, The version of MUI that you have installed, and the version of AmIRC that you are using. Problems or additions of the AmIRC documentation should be directed to: @{b}lww@pgh.net@{ub} @EndNode @Node "Known Bugs" "AmIRC.guide/Known Bugs" @Next "AmIRC Support" @Prev "Bug Reports" @Toc "Main" Problems, Causes, & Cures ************************* Known Bugs ========== @{b}*@{ub} A patch designed to eliminate requestors, easypatch, will cause AmIRC .88 to crash. @{b}*@{ub} The main window sometimes doesn't refresh properly when SIMPLE_REFRESH is used. Known bug in MUI 2.3's listview refresh sometimes throwing away damage regions. Fixed in MUI 3. @{b}*@{ub} Lockup when using Magic Menu. Install NewObtainGIRPort to cure this. NewObtainGIRPort is available from aminet or from the AmIRC home page. In older readme's, I suggested using SafeGIRPort, but there were reports that this won't really help the problem. Sorry, I don't use Cycle2Menu or MagicMenu and never had any problems with this myself. @{b}*@{ub} The user list get's messed up. Known bug in MUI 2.3's listview's REMOVE method. Fixed in MUI 3. @{b}*@{ub} There are various problems when using AmIRC as a CLChat (ArcNet) client. These are all caused by bugs within CLChatIRCD and can't be fixed on AmIRC's side. @{b}*@{ub} ALT-CURSOR-UP/DOWN doesn't work with MultiCX. MultiCX's "advanced Edithook" will eat Cursor-UP/Down-Inputevent on it's own so they can't be processed by AmIRC. Use a different edit hook. @{b}*@{ub} ZFREQ causes AmIRC to fail upon start. ZFREQ seems to be unable to bear an application allocating a real huge number of ASL_Filerequest structures. Use a different file requester patch. @{b}*@{ub} Neither HILITE nor URL-Grabber work on text written by yourself. This is due to internal reasons, I'm not sure if it is worth changing. @EndNode @Node "AmIRC Support" "AmIRC.guide/AmIRC Support" @Next "Index" @Prev "Known Bugs" @Toc "Main" How to Get Help & Updates ************************* One Click Updates ================= You can easily download the latest version of AmIRC from the official AmIRC support site by choosing the 'About...' Menu item from the 'AmIRC' menu. Here you will Find a gadget Labeled 'Download Latest version of AmIRC'. By clicking this gadget, AmIRC will check the support site for the version of AmIRC there. If it is newer than the version you are using, it will proceed to download it for you. If it is the same version, you will be notified of this, and the download will be aborted. Once the new archive has been downloaded, You will be shown the latest 'AmIRC.readme', and you will be given the option of unarchiving the release to ram. @{b}NOTE:@{ub} You must have LHA in your c: directory for this functon to operate. Once you have done this, just overwrite the old AmIRC files with the new ones. Your configuraton files will remain unchanged. @{b}NOTE:@{ub} The auto update will only download a stripped version of the archives, because this assumes you have already installed the full version of AmIRC. with auto update, you will receive the executables and any updated documents. Support ======= @{b}AmIRC Support Mailing List@{ub} To keep up to date on AmIRC improvements or to get answers to AmIRC problems, Join the AmIRC support mailing list by sending email to: AmIRC-Request@lsd.wupper.de with the text "Add" in the body. @{b}AmIRC FTP Support Site@{ub} For AmIRC Updates & Patches, ftp to: ftp.vapor.com/support/amirc/ @{b}AmIRC Support on the World Wide Web@{ub} Or, Alternatively, Visit the AmIRC WWW Support Site at: http://www.vapor.com/support/amirc/ @EndNode @Node "Index" "AmIRC.guide/Index" @Prev "AmIRC Support" @Toc "Main" Index ***** @Index "Index" @{" #amiga " Link "IRC"} IRC @{" Actions Options " Link "Actions"} Actions @{" Aliases, setting up " Link "Lists"} Lists @{" AmIRC Menu " Link "AmIRC"} AmIRC @{" AmIRC Support " Link "AmIRC Support"} AmIRC Support @{" ARexx Menu " Link "Rexx"} Rexx @{" ARexx Reference " Link "ARexx"} ARexx @{" Away, Setting " Link "AWAY"} AWAY @{" Bugs, Known " Link "Known Bugs"} Known Bugs @{" Bugs, Reporting " Link "Bug Reports"} Bug Reports @{" Channel Modes, changing " Link "MODE"} MODE @{" Commands " Link "Commands"} Commands @{" Configuration Options " Link "AmIRC Setup"} AmIRC Setup @{" Configuration with MUI " Link "MUI Preferences"} MUI Preferences @{" Configuring AmIRC " Link "Configuration"} Configuration @{" Connecting to an IRC server " Link "Connecting"} Connecting @{" Contents, Table of " Link "Top"} Top @{" Copyright Information " Link "Copyright"} Copyright @{" Credits " Link "Credits"} Credits @{" CTCP " Link "CTCP"} CTCP @{" DCC " Link "DCC"} DCC @{" Events Options " Link "Events"} Events @{" Features Of AmIRC " Link "Features"} Features @{" Function Keys, Setting up " Link "Function Keys"} Function Keys @{" GUI Options " Link "GUI"} GUI @{" Hilighting certain text " Link "Lists"} Lists @{" Igoring Users " Link "Lists"} Lists @{" Installing AmIRC " Link "Installation"} Installation @{" Inviting a user to a channel " Link "INVITE"} INVITE @{" IRC " Link "IRC"} IRC @{" IRC Terminology " Link "IRC Terms"} IRC Terms @{" Joining a channel " Link "JOIN"} JOIN @{" Kicking a user from a channel " Link "KICK"} KICK @{" Known Bugs " Link "Known Bugs"} Known Bugs @{" Leaving a channel " Link "LEAVE"} LEAVE @{" LIsting Channels " Link "LIST"} LIST @{" Listing names on IRC " Link "NAMES"} NAMES @{" Listing Users on a server " Link "USERS"} USERS @{" Lists Menu " Link "Lists"} Lists @{" Logging Channel Text " Link "LOG"} LOG @{" Menus " Link "Menus"} Menus @{" Messages options " Link "Messages"} Messages @{" MUI Configuration " Link "MUI Preferences"} MUI Preferences @{" MUI, About " Link "About MUI"} About MUI @{" Net Etiquette " Link "IRC"} IRC @{" Nickname, Changing " Link "NICK"} NICK @{" Nickname, Setting " Link "NICK"} NICK @{" Notice, Sending " Link "NOTICE"} NOTICE @{" Operating AmIRC " Link "Operation"} Operation @{" Pattern matching of users " Link "WHO"} WHO @{" Private message, sending " Link "MSG"} MSG @{" Quitting IRC " Link "QUIT"} QUIT @{" Raw text, sending " Link "RAW"} RAW @{" Registering AmIRC " Link "Registration"} Registration @{" Reporting Bugs " Link "Bug Reports"} Bug Reports @{" Requirements for running AmIRC " Link "Requirements"} Requirements @{" Revision History " Link "Revision History"} Revision History @{" Settings Menu " Link "Settings"} Settings @{" Settings menu: Actions " Link "Actions"} Actions @{" Settings Menu: Events " Link "Events"} Events @{" Settings Menu: GUI " Link "GUI"} GUI @{" Settings Menu: Messages " Link "Messages"} Messages @{" Support for AmIRC users " Link "AmIRC Support"} AmIRC Support @{" Thanks to... " Link "Credits"} Credits @{" Time, getting server's " Link "TIME"} TIME @{" Topic, Changing the " Link "TOPIC"} TOPIC @{" User Modes Menu " Link "User Modes"} User Modes @{" User's, finding more info on " Link "WHOIS"} WHOIS @{" User, checking if on " Link "ISON"} ISON @{" Userhost, finding a user's " Link "USERHOST"} USERHOST @{" Version, server's software " Link "VERSION"} VERSION @{" What is IRC " Link "IRC"} IRC @{" Who Was User " Link "WHOWAS"} WHOWAS @{" Windows Menu " Link "Windows"} Windows @EndNode