@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. @{" 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.1 Registered Software License Agreement ---------------------------------------------- AmIRC 1.1 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.1 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.1 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 including server message parsing ("event trapping") and commandline/script interaction. @{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} TAB messaging to automatically cycle the list of last used nicknames with a /MSG prefix. @{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 interfacing with a web browser.. @{b}*@{ub} Support for DALnet extensions. @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'. You must have OS 3.x in order to use sounds in AmIRC. @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. Please Note, AmIRC uses the DataTypes of OS 3.x for sounds, and you will not be able to use this feature under OS 2.x. @{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}Order@{ub} Cycle gadget allows you to choose if you want new users listed at the top or bottom of the user list, or to sort the list in alphabetical order. 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} text that is configured in the @{"highlight" Link "Lists"} list for 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"} Returns channel joined in active window. @{" GETSELECTEDUSER " Link "RX_GETSELECTEDUSER"} Returns nick of user selected in userlist window. @{" GETUSER " Link "RX_GETUSER"} Returns the nick of user number in userlist window. @{" GETUSERS " Link "RX_GETUSERS"} Returns a string with all users in the current channel. @{" GETUSERSTATE " Link "RX_GETUSERSTATE"} Tells whether the user has Op, Voice, or no privledges. @{" GETLINE " Link "RX_GETLINE"} Waits for the next line and parses it into a stem variable. @{" GETLINECOUNT " Link "RX_GETLINECOUNT"} Tells you how many lines have been entered since you enterd the channel. @{" GETLASTLINE " Link "RX_GETLASTLINE"} Returns the last line, unparsed. @{" GETAWAYSTATE " Link "RX_GETAWAYSTATE"} Checks if you are marked away. @{" GETVERSION " Link "RX_GETVERSION"} Tells you what version AmIRC you are using. @{" PARSELINE " Link "RX_PARSELINE"} Returns the line given in a stem variable. @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: See @{"RX_ECHO" Link "RX_ECHO"}. @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 ---------- Usage: @{b}GETCHANNEL@{ub} DESCRIPTION: Returns the name of the channel currently active in the format: "#channel." EXAMPLES: @{b}options results; getchannel; say result@{ub} RELATED TOPICS: See @{"RX_CHANNELS" Link "RX_CHANNELS"}. @EndNode @Node "RX_GETSELECTEDUSER" "AmIRC.guide/RX_GETSELECTEDUSER" @Toc "ARexx" GETSELECTEDUSER --------------- Usage: @{b}GETSELECTEDUSER@{ub} DESCRIPTION: Returns the Nick the user highlighted in the userlist window. EXAMPLES: @{b}options results; getselecteduser; say result@{ub} RELATED TOPICS: See @{"RX_GETUSER" Link "RX_GETUSER"}, See @{"RX_GETUSERS" Link "RX_GETUSERS"}. @EndNode @Node "RX_GETUSER" "AmIRC.guide/RX_GETUSER" @Toc "ARexx" GETUSER ------- Usage @{b}GETUSER /N@{ub} DESCRIPTION: Returns the nick of the user number given on the active channel userlist. EXAMPLES: @{b}options results; getuser 1; say result@{ub} RELATED TOPICS: See @{"RX_GETSELECTEDUSER" Link "RX_GETSELECTEDUSER"}, See @{"RX_GETUSERS" Link "RX_GETUSERS"}. @EndNode @Node "RX_GETUSERS" "AmIRC.guide/RX_GETUSERS" @Toc "ARexx" GETUSERS -------- Usage @{b}GETUSERS@{ub} DESCRIPTION: Returns a string containing the list of users on the active channel. EXAMPLES: @{b}options results; getusers; say result@{ub} RELATED TOPICS: See @{"RX_GETUSER" Link "RX_GETUSER"}, See @{"RX_GETSELECTEDUSER" Link "RX_GETSELECTEDUSER"}. @EndNode @Node "RX_GETUSERSTATE" "AmIRC.guide/RX_GETUSERSTATE" @Toc "ARexx" GETUSERSTATE ------------ Usage @{b}GETUSERSTATE /N@{ub} DESCRIPTION: Returns the status of user "num" on the active channel. @{b}RC=0 User is online, but has no special status.@{ub} @{b}RC=1 User is Channel Operator.@{ub} @{b}RC=2 User is online and has been "Voiced".@{ub} @{b}RC=5 User # not in the userlist.@{ub} EXAMPLES: @{b}options results; getuserstate 1; say rc@{ub} @EndNode @Node "RX_GETLINE" "AmIRC.guide/RX_GETLINE" @Toc "ARexx" GETLINE ------- Usage @{b}GETLINE@{ub} DESCRIPTION: Waits for a line from the server and returns the following stem variables;. @{b}LINE = The entire, unparsed, line recieved.@{ub} @{b}LINE.PREFIX = The Nick and user@host.@{ub} @{b}LINE.COMMAND= The MSG Type.@{ub} @{b}LINE.DEST = The channel the message was written to.@{ub} @{b}LINE.REST = The message text.@{ub} EXAMPLES: @{b}options results getline text=line prefix=line.prefix comm=line.command dest=line.dest rest=line.rest say text,prefix,comm,dest,rest@{ub} RELATED TOPICS: See @{"RX_PARSELINE" Link "RX_PARSELINE"}, See @{"RX_GETLASTLINE" Link "RX_GETLASTLINE"}. @EndNode @Node "RX_GETLINECOUNT" "AmIRC.guide/RX_GETLINECOUNT" @Toc "ARexx" GETLINECOUNT ------------ Usage @{b}GETLINECOUNT@{ub} DESCRIPTION: Returns the number of lines in the channel buffer for the active window channel. EXAMPLES: @{b}options results; getlinecount; say result@{ub} RELATED TOPICS: See @{"RX_GETLINE" Link "RX_GETLINE"}. @EndNode @Node "RX_GETLASTLINE" "AmIRC.guide/RX_GETLASTLINE" @Toc "ARexx" GETLASTLINE ----------- Usage @{b}GETLASTLINE@{ub} DESCRIPTION: Returns the last private message received in the format;. :nick!~user@host Messagetype Nick :message text. EXAMPLES: @{b}options results; getlastline; say result@{ub} RELATED TOPICS: See @{"RX_PARSELINE" Link "RX_PARSELINE"}, See @{"RX_GETLINE" Link "RX_GETLINE"}. @EndNode @Node "RX_GETAWAYSTATE" "AmIRC.guide/RX_GETAWAYSTATE" @Toc "ARexx" GETAWAYSTATE ------------ Usage @{b}GETAWAYSTATE@{ub} DESCRIPTION: Returns your away status. @{b}rc=0 Not away.@{ub} @{b}rc=5 Away.@{ub} EXAMPLES: @{b}options results; getawaystate; say rc@{ub} @EndNode @Node "RX_GETVERSION" "AmIRC.guide/RX_GETVERSION" @Toc "ARexx" GETVERSION ---------- Usage @{b}GETUSERS@{ub} DESCRIPTION: Returns the Version number of AmIRC. EXAMPLES: @{b}options results; getversion; say result@{ub} @EndNode @Node "RX_PARSELINE" "AmIRC.guide/RX_PARSELINE" @Toc "ARexx" PARSELINE --------- Usage @{b}PARSELINE@{ub} DESCRIPTION: Parses the line specified and returns the following stem variables; @{b}LINE = The entire, unparsed, line recieved.@{ub} @{b}LINE.PREFIX = The Nick and user@host@{ub} @{b}LINE.COMMAND= The MSG Type@{ub} @{b}LINE.DEST = The channel the message was written to.@{ub} @{b}LINE.REST = The message text.@{ub} EXAMPLES: @{b}options results getlastline last=result parseline last text=line prefix=line.prefix comm=line.command dest=line.dest rest=line.rest say text,prefix,comm,dest,rest@{ub} RELATED TOPICS: See @{"RX_GETLINE" Link "RX_GETLINE"}, See @{"RX_GETLASTLINE" Link "RX_GETLASTLINE"}. @EndNode @Node "About MUI" "AmIRC.guide/About MUI" @Next "Credits" @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 "Credits" "AmIRC.guide/Credits" @Next "Bug Reports" @Prev "About MUI" @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}Mike 'Mike' Fitzgerald@{ub} for writing the ARexx Section of the docs @{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} You absolutely MUST install SetPatch 40.16 (or higher), otherwise you will stumble over the broken pool functions in 3.0/3.1 exec @{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} 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 @{" 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