home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / a / ami_irc / amircv1.5breg.lha / amirc / AmIRC.doc < prev    next >
Text File  |  1996-03-10  |  96KB  |  2,754 lines

  1.  
  2.  
  3. AmIRC
  4. *****
  5.  
  6. Welcome to AmIRC, the AmigaOS IRC client.
  7.  
  8. Copyright
  9. *********
  10.  
  11. Copyright
  12. =========
  13.  
  14. AmIRC has been designed, developed and written by
  15.  
  16.          Oliver Wagner
  17.      Landsberge 5
  18.      45549 Sprockhövel
  19.      Germany
  20.      E-Mail: (owagner@lsd.wupper.de)
  21.      
  22.      
  23.      All Rights Reserved.
  24.      
  25.      This document compiled by Laurence Walton (lww@pgh.net)
  26.      ©1996 Oliver Wagner
  27.      All Rights Reserved
  28.      
  29.      Installer Script
  30.      ©1995,1996 Robert C. Reiswig
  31.      All Rights Reserved
  32.      
  33.      No part of this archive may be redistributed except with the entire
  34.      contents of the original archive.
  35.  
  36. Registering AmIRC
  37. *****************
  38.  
  39. License
  40. =======
  41.  
  42. AmIRC 1.0 Registered Software License Agreement
  43. ----------------------------------------------
  44. AmIRC 1.0 is Copyright © 1996 by Oliver Wagner, All Rights Reserved.
  45. The producer of this software will grant the Licensee a limited,
  46. non-exclusive right to use the program AmIRC 1.0 and it's associated
  47. files on a single machine. The producer will hand out a special
  48. identification file called the key file to the Licensee. This key file
  49. will enable the Licensee to fully use the AmIRC 1.0 package according
  50. to the terms of this license.  The key file is stricly for personal use
  51. by the Licensee only. Any disclosure of they key file will invalidate
  52. the license and the key file itself. The Licensee will be held liable
  53. of any damage arising out of the disclosure of the key file.  The
  54. product is provided as is without warranty of any kind, either express
  55. or implied, statutory or otherwise, including without limitation any
  56. implied warranties of non-infringement, merchantability and fitness for
  57. a particular purpose. The entire risk as to use, results and
  58. performance of the product is assumed by you and should the product
  59. prove to be defective, you assume the entire cost of all necessary
  60. servicing, repair or other remediation.  In no event shall the producer
  61. of this product or it's resellers be liable for any property damage,
  62. personal injury, loss of use or other indirect, incidental or
  63. consequential damages, including without limitation, any damages for
  64. lost profits, business interruption or data which may be lost or
  65. rendered inaccurate, even if we have been advised of the possibility of
  66. such damages.  This agreement shall exclusively be governed by the laws
  67. of the Federal Republic of Germany.
  68.  
  69. Registration
  70. ============
  71.  
  72. If you have not registered for AmIRC, it will prompt you to do so upon
  73. startup. Registration at the US site requires $25.00 in US funds for
  74. an emailed keyfile, or $30.00 for a disk mailed via postal service.
  75. The Germany Site requires 35,-DM for an emailed keyfile and 40,-DM for
  76. a floppy sent via postal service.
  77.  
  78. What is IRC, by the way?
  79. ************************
  80.  
  81. Introduction
  82. ============
  83.  
  84. IRC stands for Internet Relay Chat, written by Jarkko Oikarinen
  85. (jto@tolsun.oulu.fi).  In a nutshell, IRC consists of a network of
  86. computers (servers) that are connected to each other via the internet
  87. or a LAN, and allow users with proper client software to connect and
  88. chat with each other.  Within this network, virtual space is divided up
  89. into channels, usually with a topic of conversation, where users can
  90. talk in groups.
  91.  
  92. #amiga
  93. ======
  94.  
  95. If you are reading this, you are most likely using one of the
  96. Requirements family of computers (if you are not, BUY ONE! :), and will
  97. likely want to check out #amiga on IRC.  #amiga is one of the most
  98. populated channels of IRC, with an average of 30 to 60 users on at any
  99. given time. #amiga is often visited by amiga hardware and software
  100. developers, and is sometimes a forum for formal discussions held by
  101. dignitaries from software/hardware development companies.
  102.  
  103. #amiga Etiquette
  104. ----------------
  105.  
  106. There is a sort of an unwritten code of conduct for IRC, and especially
  107. #amiga.  This section is included so that you dont find yourself
  108. /kicked or /banned and dont understand why.
  109.  
  110. DO's
  111. ----
  112.  
  113.     DO:
  114.  
  115.      Enjoy your visit to #amiga
  116.      
  117.      Offer to help someone IF you know what your talking about.
  118.      
  119.      Be polite to other users.
  120.  
  121. DON'T's
  122. -------
  123.  
  124.     DON'T:
  125.  
  126.      Ask questions about software/hardware problems without reading the
  127.      manual first (RTFM!).
  128.      
  129.      Ask a question more than once. If someone can help you, they will.
  130.      
  131.      Ask for latest amiga news or info on new software, see newsgroup
  132.      comp.sys.amiga.announce for this.
  133.      
  134.      Ask for OPs.  You won't get it.
  135.      
  136.      Pound or slam Amigas.  If you don't like them, don't /join #amiga.
  137.      
  138.      Pound or slam Amiga Software (the coders might be there :)
  139.      
  140.      Offer to help a user with a problem if you don't understand it
  141.      yourself.
  142.      
  143.      Offer or ask for commercial software or the keys to activate
  144.      demos.
  145.      
  146.      Plug developers who appear from time to time with questions and bug
  147.      reports, use the proper channels for this (i/e, the developer's support
  148.      address).  Note that you might ask first if they are willing to discuss
  149.      problems/bugs with their product.
  150.  
  151. Terms You Might Encounter
  152. *************************
  153.  
  154. IRC Terms
  155. =========
  156.  
  157. #amiga
  158.      IRC Channel on Efnet and Undernet for users interested in the
  159.      Amiga family of Computers.
  160.  
  161. Action
  162.          CTCP Action command, executed by a /me at the beginning of a
  163.      message.
  164.  
  165. ARCnet
  166.      Amiga Relay Chat Network. Served by several Amigas running
  167.      CLChatServer, forming a small network used by those interested in
  168.      the Amiga Family of Computers.
  169.  
  170. Ban
  171.      A channel mode set in order to prevent a user or group of users
  172.      from joining a channel.
  173.  
  174. Bot
  175.      Short for Robot, a Bot is a script that acts like a user, and
  176.      can execute a command upon a certain occurance.
  177.  
  178. Client
  179.      Software that is written for the purpose of connecting to a
  180.      server, in this case, an IRC server.
  181.  
  182. Channel
  183.      A group of users on IRC. A channel will have a name (i/e,
  184.      #amiga), and may or may not have a topic of conversation.
  185.  
  186. Channel Mode
  187.      The properties of a channel that allow or disallow certain
  188.      activities.  Channel Modes can only be changed or set by
  189.      Channel Operators.
  190.  
  191.     Invite Only
  192.           If active, This mode allows users to join if they have been
  193.           invited by someone in the channel.
  194.  
  195.     Private
  196.           If active, the channel is invisible in the global channel
  197.           list.
  198.  
  199.     Limit
  200.           If active, Sets a limit on the number of users allowed to
  201.           join a channel.
  202.  
  203.     Moderated
  204.           If active, only Channel Operators and users with
  205.           voice may type input to the channel.
  206.  
  207.     No Messaging
  208.           If active, prevents users from sending a message to the
  209.           channel until they have joined it.
  210.  
  211.     Secret
  212.           If active, the channel is invisible until it is joined.
  213.  
  214.     Topic Protection
  215.           If active, only Channel Operators may set or change the
  216.           topic of a channel.
  217.  
  218. Channel Operator (aka, Op)
  219.      A user who has control over a channel.  A user who creates a
  220.      channel is given Op status, and in turn can give it to anyone else
  221.      in the channel.
  222.  
  223. Command
  224.      A message to an IRC server or to a local or remote client.
  225.      Commands generally begin with a /.  See Commands.
  226.  
  227. CTCP
  228.      Client To Client Protocol, A standard for sending commands from
  229.      one client to another, usually for the purpose of getting
  230.      information from the remote client.  See CTCP.
  231.  
  232. DCC
  233.      Direct Client Connection - a standard for creating a direct link
  234.      between two clients, for the purpose of sending or receiving
  235.      files, or to carry a more secure conversation.  See DCC.
  236.  
  237. Efnet
  238.      (Eris Free), the largest and "main" IRC network, with an average
  239.      of about 5000 users on any given day.
  240.  
  241. Identd
  242.      Identd Is software that can be run on the client, allowing an IRC
  243.      server to corroberate the identity of a client.  AmIRC has an
  244.      Identd built in, and will automatically disable it if an external
  245.      Identd is running.
  246.  
  247. IRC
  248.      Internet Relay Chat - Any Network of Computers that run IRC
  249.      servers for the purpose of allowing users to connect to it
  250.      using client software made for IRC.
  251.  
  252. Kick
  253.      The occurance of a user being removed from a joined channel by
  254.      a channel operator.
  255.  
  256. MOTD
  257.      Message Of The Day, A message that may or may not be updated
  258.      daily, that is meant to be read when connecting to an IRC
  259.      server.
  260.  
  261. Netsplit
  262.      An event that occurs when a server goes down that other servers
  263.      depend on for network packets. Any servers that are dependant on
  264.      the crashed server will split from the net, that is, they will
  265.      still be up and running, with active clients, but any clients on
  266.      the other side of the crashed unit will appear to have all logged
  267.      off at once.
  268.  
  269. Nick
  270.      Short for Nickname, this is an alias that you may pick for
  271.      yourself.
  272.  
  273. Op
  274.      See Channel Operator.
  275.  
  276. Server
  277.      A computer that is Running IRC server software, allowing it to be
  278.      connected to by IRC clients or other servers.
  279.  
  280. Server Operator
  281.      A person in control of an IRC server.
  282.  
  283. TLA (Three Letter abreiviations)
  284.      commonly used acronyms, not entirely restricted to 3 letters.
  285.  
  286.     AFAIK
  287.           As Far As I Know
  288.  
  289.     AFK
  290.           Away From Keyboard
  291.  
  292.     BRB
  293.           (I'll) Be Right Back
  294.  
  295.     BBL
  296.           (I'll) Be Back Later
  297.  
  298.     IMHO
  299.           In My Humble|Honest Opinion
  300.  
  301.     LOL
  302.           Laughs Out Loud
  303.  
  304.     MOTD
  305.           Message Of The Day
  306.  
  307.     ROTFL
  308.           Rolls On The Floor Laughing
  309.  
  310.     RTFM
  311.           Read The F***ing Manual
  312.  
  313. Topic
  314.      A heading for a channel that may or may not have anything to do
  315.      with the conversation at hand.
  316.  
  317. Undernet
  318.      The second largest IRC network, considered an 'Alternative' to
  319.      EFnet.
  320.  
  321. User
  322.      a person using an IRC Client to connect to a server to chat.
  323.  
  324. User Mode
  325.      Settings that affect a users properties.
  326.  
  327.     Invisible
  328.           If this mode is set, a user will be invisible in the global
  329.           user list.  The user will still be visible in the user list
  330.           of any joined channel, however.
  331.  
  332.     Wallops
  333.           When set, this mode will allow receiving of messages from the
  334.           server operator to all operators.
  335.  
  336. Userhost
  337.      This is the string that defines a user.  It consists of the
  338.      user's chosen nick, login name and domain name.  For example:
  339.      Wupper!jwupper@monorail.wupper.de
  340.      |      |       |        |      |_ Domain
  341.      |      |       |        |________ Network
  342.      |      |       |_________________ Machine
  343.      |      |_________________________ Login
  344.      |________________________________ Nick
  345. Voice
  346.      Status a normal (not an operator) user must have to type into a
  347.      moderated channel.
  348.  
  349. Things that make AmIRC special!
  350. *******************************
  351.  
  352. Features
  353. ========
  354.  
  355.    * runs with both AmiTCP and AS225 without additional support
  356.      libraries.
  357.  
  358.    * built-in high speed DCC drivers for SEND and MOVE.  Highly
  359.      optimized with asynchronous file I/O and threaded network
  360.      handling. Supports Drag&Drop sending of files.
  361.  
  362.    * transparent implementation of DCC CHAT. All /MSGs are
  363.      automatically routed via DCC CHAT if applicable, to save runtime
  364.      and reduce IRC load. Option to automatically accept DCC CHAT
  365.      connections.
  366.  
  367.    * ultra fast text output and scrolling. Supports Cut&Paste for the
  368.      list text. Supports proportional fonts.
  369.  
  370.    * full support of the "Undernet" IRC extensions, both reply codes and
  371.      additional IRC commands.
  372.  
  373.    * intuitive channel display with userlist and channel mode overview.
  374.      Channel modes can easily be changed via gadgets. Configurable user
  375.      action list to perform whatever action you like on users in channel
  376.      by the press of a mousebutton.
  377.  
  378.    * supports QUERY windows for private chat.
  379.  
  380.    * supports "smart" banning
  381.  
  382.    * versatile AREXX port.
  383.  
  384.    * easy command line aliasing.
  385.  
  386.    * builtin IdentD (automatically disabled if another IdentD is already
  387.      installed).
  388.  
  389.    * supports nick notification, highlighting, ignoring, and kickban.
  390.  
  391.    * versatile event handling allows you to bind sound effects,
  392.      auto-deiconify or rexx scripts to certain events.
  393.  
  394.    * server phonebook.
  395.  
  396.    * last nick history.  Stores the nicknames of the last nicks you've
  397.      send MSGs to, received MSGs from or addressed publically with
  398.      "nick:".  Reference can be used in all commands which require nick
  399.      names, e.g.  /MSG, /OP, /DEOP. Automatic nick expansion on public
  400.      messages with ":".
  401.  
  402.    * auto rejoin channel on KICK and auto reconnect server facility.
  403.  
  404.    * auto away after idle timeout. Auto unaway after sending public
  405.      and/or private msgs.
  406.  
  407.    * auto update download.  Check for and download new releases with a
  408.      simple click.
  409.  
  410.    * URL grabber for copying URLs to clipboard.
  411.  
  412.    * netsplit detection.
  413.  
  414. What is needed to run AmIRC?
  415. ****************************
  416.  
  417. Hardware
  418. ========
  419.  
  420. AmIRC was written for the Amiga family of computers, and has been
  421. tested on 1200, 2000, 3000, & 4000 computers in various configurations.
  422.  
  423. Software
  424. ========
  425.  
  426. AmIRC requires About MUI v.3.1 or later in order to run.
  427.  
  428. AmIRC requires KickStart & WorkBench 2.x or later, with setpatch 40.16
  429. installed.
  430.  
  431. AmIRC020 requires a 68020 or higher CPU, OS3.0 or newer, and MUI 3.1 or
  432. newer.  If you do not have anyone of these, you must use the 68000
  433. version of AmIRC.
  434.  
  435. If you plan to run a TCP/IP stack and MUI and AmIRC, among other
  436. Internet applications, you should have at least 2 megabytes of RAM.
  437.  
  438. Finally, You need to have a tcp/ip protocol stack running, such as
  439. AmiTCP/IP or Amiga Technology's as225r2 tcp/ip protocol stack, With a
  440. slip, cslip, or ppp connection to the internet or an ethernet LAN.
  441.  
  442. Alternatively, AmIRC will work with Multilink and a shell internet
  443. account.  NOTE: As Mlink does not automatically set the HOSTNAME
  444. variable, this must be done when starting mlink. Env:hostname must
  445. contain the full domain name for your amiga, i/e
  446. 'calci.amiganet.pgh.net'.
  447.  
  448. Getting AmIRC to run
  449. ********************
  450.  
  451. Requirements
  452. ============
  453.  
  454. AmIRC has its own installer script and requires that you have the Amiga
  455. installer utility (version 1.24 or later) located in your sys:c
  456. directory.  To install, just click on the install icon, and answer the
  457. questions in the installer's requestors.
  458.  
  459. If you cannot or prefer not to use the installer utility, a manual
  460. install is very simple, just move the contents of the archive to a
  461. directory of your choice and it's ready to use.  If you have met the
  462. Requirements for the optimized version of AmIRC, delete the AmIRC file
  463. and rename "AmIRC020" as "AmIRC".
  464.  
  465. Connecting to a server
  466. **********************
  467.  
  468. Setup
  469. =====
  470.  
  471. Once you have Installation AmIRC, run the AmIRC program from WB by
  472. clicking on its icon. After a few moments you will see the server
  473. connect requester appear. First type in a nickname in the first text
  474. gadget at the top of the requester.  If you intend to use a nick that
  475. may be common, try typing in some variations in the next three boxes.
  476. this way, if your nick is in use by another person, the client will
  477. retry with the next nick.
  478.  
  479. Next, enter your real name and your email address or www home page URL
  480. in the next text gadget. It is probably a good idea to be truthful
  481. here. :)
  482.  
  483. Then, enter a username that will show as
  484. «username»@machine.network.org.  «username» should be the same as the
  485. login ID for your service provider.
  486.  
  487. Now you are ready to connect.  Just click on a server from the supplied
  488. list or click new server entry and type the address and port number of
  489. your favorite server and then click connect. Optionally, you can choose
  490. one or a few channels to autojoin, just separate them with a comma.  If
  491. you are already connected, and wish to connect to a second server,
  492. click connect thread to open a second instance of AmIRC. The Delete
  493. Server Entry gadget will remove a server entry that you no longer wish
  494. to use.
  495.  
  496. How Does AmIRC Work?
  497. ********************
  498.  
  499. Using the Interface
  500. ===================
  501.  
  502. The AmIRC user interface is laid out in a logical, intuitive manner,
  503. making it easy to use.
  504.  
  505. Text Listview
  506.      The main feature of the interface is the text listview, where
  507.      incoming text is displayed.
  508.  
  509. Text Input Gadget
  510.      Directly below this is the text input gadget, labeled with the
  511.      nickname that you have chosen. Any text entered here will be sent
  512.      out to the IRC server.
  513.  
  514. Listview Scroll Gadget
  515.      To the right of the listview is a scroll gadget, which enables you
  516.      to scroll backward through the text in the listview.
  517.  
  518. Channel Text String
  519.      At the top left of the listview is a text string that reflects the
  520.      channel that you have joined.
  521.  
  522. Topic Input/Display Gadget
  523.      To the right of the channel text string, is the Topic
  524.      Input/Display gadget, where the topic of a joined channel will be
  525.      displayed.  If you have Channel Operator (Ops) Status, you may
  526.      change the topic of the channel by entering the topic in this
  527.      gadget, and hitting the 'enter' key.
  528.  
  529. Operator Buttons
  530.      To the right of the topic input gadget are the channel mode
  531.      buttons, which display the current modes for the joined channel.
  532.      Users with Channel Operator (Ops) status may also use these
  533.      buttons to change the current channel modes.
  534.  
  535.     T - Topic Protection
  536.           Toggles Topic Protecton on/off.  If on, the topic can be
  537.           changed by Channel Operators (Ops) only.
  538.  
  539.     N - No Messaging
  540.           Toggles Messaging on/off.  If active, a user can only write
  541.           to the channel if they have joined it.
  542.  
  543.     S - Secret
  544.           Toggles Secret mode on/off.  If active, the channel is
  545.           invisible until it is joined.
  546.  
  547.     I - Invite Only
  548.           Toggles Invite Only mode on/off.  If active, users can only
  549.           join after they have been invited.
  550.  
  551.     P - Private
  552.           Toggles Private mode on/off.  If active, the channel will be
  553.           invisible in the global channel list.
  554.  
  555.     M - Moderated
  556.           Toggles Moderated mode on/off.  If active, only channel
  557.           operators (Ops) and users with 'voice' can type to the
  558.           channel.
  559.  
  560.     L - Limit
  561.           Sets a limited number of users allowed on the channel
  562.  
  563.     K - Keyword
  564.           Toggles Keyword mode on/off.  If active, Users can only join
  565.           the channel if they give the correct keyword.
  566.  
  567.     B - Ban
  568.           Sets/Displays the current Bans active on the channel
  569.  
  570. User Listview
  571.      Below the channel mode buttons is the User Listview, which shows a
  572.      current list of users on the joined channel.  Double clicking on a
  573.      users name will perform a /whois on that user.  Clicking once on a
  574.      users name will set that user as the default to perform other
  575.      operations on, such as an operation from the configurable user
  576.      buttons.
  577.  
  578. User Buttons
  579.      Directly below the User Listview are the user buttons.  These
  580.      buttons are configurable from the GUI window, accessable by
  581.      selecting 'setup...' from the AmIRC Settings menu.
  582.  
  583. Special Functions:
  584.      You can Drag-Hilight text in the listview in order to paste it
  585.      elsewhere.  you will need some type of snap utility such as
  586.      newedit or powersnap in order to past the text.  The text is
  587.      stored in the clipboard.
  588.  
  589.      The TAB key will cycle through the names of people that have
  590.      previously /msg'ed you, and insert it into the text input gadget.
  591.      Simply enter your message after the "/msg <user> " in order to
  592.      /msg them back.
  593.  
  594.      Entering ":" first in the text input gadget will automatically
  595.      publicly address the last person you typed to using the ":" after
  596.      their nick.
  597.  
  598. Pull-Down Menus
  599. ***************
  600.  
  601. Reference
  602. =========
  603.  
  604. AmIRC Menu
  605. ----------
  606.  
  607. Select Server...
  608.      Opens a window from which you can select various options for
  609.      connecting to an IRC server. See Connecting.
  610.  
  611. Logging Enabled?
  612.      Toggles logging on/off.
  613.  
  614. Iconify
  615.      Reduces the AmIRC window to an icon on the Workbench screen.
  616.  
  617. Help...
  618.      Opens Amirc.guide for reference while using AmIRC.
  619.  
  620. About...
  621.      Opens a window with information about AmIRC and its Developer.
  622.      Here you may connect to the AmIRC home page if amosaic is running
  623.      concurrently, and you may also download the latest version of
  624.      AmIRC without having to trouble with running a www or ftp client.
  625.  
  626. Quit
  627.      Will close the current instance of AmIRC, leaving other instances
  628.      open.
  629.  
  630. Windows Menu
  631. ------------
  632.  
  633. Channel Windows
  634.      If more than one AmIRC window is opened, You may select one here
  635.      to pop it to front.
  636.  
  637. Dialog Windows
  638.      If any dialog windows are open, you may select one her and bring
  639.      it to front.
  640.  
  641. Channel List Window...
  642.      This item will produce a requester where you may list channels by
  643.      min users or pattern matching, or both. Once listed, you may list
  644.      users on a channel or join it by double-clicking the channel name
  645.      or selecting 'join channel' gadget.  Please note that this
  646.      function can cause a high load of traffic and may take awhile on
  647.      slow (14.4 or less) connections.
  648.  
  649. Notify Window...
  650.      Selecting this item will produce a requester where you may enter
  651.      nicks of users that you wish to be notified of their
  652.      entering/leaving IRC.  The 'check period' is how often AmIRC will
  653.      check for the specified users.  Add a nick to the list by clicking
  654.      in the input text gadget, and typing in the nick.  delete a nick
  655.      by clicking on it's entry and then click on 'delete nick' gadget.
  656.  
  657. DCC-Send Window...
  658.      Brings up a requestor in which you can specify a user and a file
  659.      to send to them.  This requester will also be produced
  660.      automatically upon hitting the 'DCC send' userbutton on the
  661.      interface.  'Send Path' is the path and filespec that will be sent
  662.      to the user.  Enter the name of the user in the text input gadget
  663.      at the bottom of the requestor.  The cycle gadget nest to the nick
  664.      text gadget selects either 'DCC Send' or 'DCC Move' protocols.
  665.      See DCC for details about these protocols.  Remove Job gadget
  666.      will remove a complete send entry or if not complete, one click
  667.      will abort the send and the second click will remove the entry.
  668.  
  669. DCC-Receive Window...
  670.      Selecting this item will produce the 'Receive DCC List' requester.
  671.      This is very similar to the DCC Send Requester.  Note that this
  672.      requester will appear automatically on receiving a DCC request.
  673.      Enter a path for incoming files to be put in the 'Receive Path'
  674.      text gadget.  After a valid path is entered, click on an entry to
  675.      receive, then click the 'Get' gadget at the bottom.  If you are
  676.      trying to receive after a failed send, you may use the 'Resume'
  677.      gadget instead of get.  this will attempt to pick up the transfer
  678.      where it left off.  I you wish to rename the incoming file for
  679.      whatever reason, you may use the 'Rename' gadget to give the file
  680.      a new name.  'Remove Job' gadget will abort an incoming file and
  681.      remove a completed or aborted file. See DCC.
  682.  
  683. DCC-Chat Window...
  684.      Selecting this item will open the 'DCC Chat List' requestor.  Do
  685.      this if you receive a DCC chat request from another user..  Here
  686.      you may click on the client sending the chat request and click the
  687.      'Open' gadget to engage a DCC chat.  When finished, you can click
  688.      "Close' to close the connection.  See DCC.
  689.  
  690. Raw Log Window...
  691.      This will open the Raw Log Window, in which you can view the raw
  692.      IRC messages as they appear before AmIRC formats them for Easy
  693.      reading in the AmIRC listview.  Here you may also clear the log,
  694.      and select when the log is active: 'Never', 'Only when raw window
  695.      open', and 'Always' The log Listview shows the USERHOST, Type of
  696.      message, Channel Name, and message, in that order.
  697.  
  698. URL Grabber Window...
  699.      A New feature of AmIRC allows it to recognise WWW URLs and snap
  700.      them to a window for use with Amosaic Web Browser.  Double
  701.      clicking an entry in the URL grabber Window will automatically
  702.      send the URL to the Clipboard..
  703.  
  704. Private Messages Window...
  705.      This item will open the Private Messages Window.  This window
  706.      holds a history of private messages sent to you, where you can
  707.      later reference or review them.
  708.  
  709. Flush Buffer
  710.      This item will clear the history of the main AmIRC listview.
  711.  
  712. Save Buffer...
  713.      This item allows you to select a filename to save the history
  714.      buffer to disk.
  715.  
  716. User Modes Menu
  717. ---------------
  718.  
  719. Invisible?
  720.      Toggles your client between invisible or not invisible. See IRC
  721.      Terms.
  722.  
  723. Receive Wallops?
  724.      Toggles this mode on/off.  See IRC Terms.
  725.  
  726. Receive Server Notices?
  727.      Toggles this mode on/off.
  728.  
  729. Marked AWAY?
  730.      Toggles AWAY on/off.
  731.  
  732. Auto rejoin on KICK?
  733.      If set, will automatically attempt to reconnect you to a channel
  734.      you have been kicked from. Note that if a ban was set with the
  735.      kick, you will not be able to rejoin.
  736.  
  737. Auto reconnect to server?
  738.      If set, this will automatically attempt to reconnect you to the
  739.      server if you are disconnected for any reason.
  740.  
  741. Auto open Dialog Windows?
  742.      If set, will automatically open chat window upon receipt of a /msg
  743.      or dcc chat message.
  744.  
  745. Auto accept dcc chat requests?
  746.      If set, this will automatically accept a dcc chat request.  It
  747.      will not open a chat window for you, however. Do this by opening
  748.      the DCC chat window in the Windows menu.
  749.  
  750. Do BEEPS?
  751.      If set, AmIRC will send audio beeps (or samples, if configured in
  752.      the Events page of the settings requester) for certain events.
  753.  
  754. Settings Menu
  755. -------------
  756.  
  757. Setup...
  758.      Calls the AmIRC Setup, allowing you to change the many settings of
  759.      AmIRC to suit your needs.
  760.  
  761. Lists...
  762.      Calls up the Lists, allowing you to configure AmIRC's Alias,
  763.      Ignore, and Hilite lists.
  764.  
  765. Function Keys...
  766.      Calls the Function Keys, allowing you to configure the function
  767.      key macros.
  768.  
  769. Dialog Window Buttons?
  770.      If set, the AmIRC dialog window will contain 4 gadgets in the
  771.      upper right corner.  These are labeled: 'Whois', 'Ping', 'DCC
  772.      Chat', & 'DCC Send'.  These gadgets will perform their respective
  773.      functions on the user that the dialog window is opened to.
  774.  
  775. Load Settings...
  776.      Opens a requestor allowing you to recall previously saved
  777.      non-default AmIRC Configurations.
  778.  
  779. Load settings from default
  780.      Reloads the last saved default configuration
  781.  
  782. Save Settings Saves the current configuration under the last name set
  783.      in the 'Save settings as...' menu item.  If the settings have not
  784.      previously been named, they are saved as default.
  785.  
  786. Save settings as...
  787.      Opens a requester allowing you to choose a filename to save the
  788.      current AmIRC configuration as other than default.
  789.  
  790. Save as default
  791.      Saves the current AmIRC configuration as the default startup
  792.      configuration.
  793.  
  794. Create icons?
  795.      If Checked, will create icons for saved configuration files,
  796.      allowing them to be seen on the Workbench.
  797.  
  798. MUI Settings...
  799.      Opens the MUI Prefs program for altering the MUI Configurable AmIRC
  800.      configuration.
  801.  
  802. Rexx Menu
  803. ---------
  804.  
  805. This menu will Display any ARexx scripts that reside in AmIRC/Rexx/
  806. directory. AmIRC ARexx scripts should be named with the .amirx
  807. extension.  From this menu you may execute any existing AmIRC ARexx
  808. script.
  809.  
  810. Sending commands to other people
  811. ********************************
  812.  
  813. Introduction
  814. ============
  815.  
  816. CTCP or Client To Client Protocol
  817. ---------------------------------
  818.  
  819. CTCP is a standard for sending commands to other clients on IRC.
  820. Basically, CTCP messages are simply private messages that include a
  821. code to alert the receiving client (not user) to respond to the command.
  822.  
  823. CTCP commands are typicaly used to get informaton from the receiving
  824. client, such as /CTCP time, or /CTCP version. Even DCC sends a request
  825. via CTCP to the receiving client, asking to initiate a direct
  826. connection.
  827.  
  828. CTCP Commands
  829. -------------
  830.  
  831.          
  832.  
  833.    * ME (CTCP Action)
  834.               Template: /ME <action>
  835.      This will mark the message as an action and replace the /ME with
  836.      your nick, for example, '/me hates ice cream' would appear as:
  837.          [Action]  |Fred hates ice cream
  838.  
  839.          
  840.  
  841.    * Version
  842.               Template: /CTCP <user> Version
  843.      Version will ask the client to return information about itsself,
  844.      which will be in the form of a private message.
  845.  
  846.          
  847.  
  848.    * Time
  849.               Template: /CTCP <user> Time
  850.      Time will return the time of day as it is set on the user's
  851.      machine.
  852.  
  853.          
  854.  
  855.    * Ping
  856.               Template: /ping <user>
  857.      Ping will send a packet request to the receiving client, which
  858.      will in turn send back the packet with a timestamp, where the
  859.      inititating client will compare the time difference and show the
  860.      result in the listview.
  861.  
  862. Direct client connections
  863. *************************
  864.  
  865. What is DCC?
  866. ============
  867.  
  868. DCC or Direct Client Connection is a protocol that IRC clients can use
  869. to communicate directly with each other, bypassing the IRC server.  The
  870. reason for this is to form a faster, more stable and direct connection
  871. thru which users can transfer files, or send private messages.
  872. Note that AmIRC has its own set of Highly Optimized DCC protocols
  873. built-in, and does not require external DCC utilities.
  874.  
  875. DCC File Transfers
  876. ==================
  877.  
  878. The most common use of DCC is for transferring files between two
  879. clients.  The initiating client will send a message through the IRC
  880. server, telling the receiver that a connecton is requested.  At this
  881. time, the receiver will either accept or reject the offer for the
  882. connection.  If the receiver accepts the connection, the initiating
  883. client will proceed to send the information directly to the receiver.
  884. If the connecton is refused, the initiating client will simply timeout
  885. the attempt to connect.
  886.  
  887. DCC Send
  888. --------
  889.  
  890.     Template: /DCC send <user> <filespec>
  891.      DCC send will attempt to open a connecton with the specified user's
  892.      client, and if successful, will proceed to send the specified file.
  893.  
  894. DCC Move
  895. --------
  896.  
  897.     Template: /DCC move <user> <filespec>
  898.      DCC Move is identical to DCC Send, with the exception that DCC move
  899.      is capable of resuming an interrupted or failed transfer.  DCC Move
  900.      will look into the receiving directory for existing files, and upon
  901.      finding a partial file which is the same as the file to be transferred,
  902.      will initiate a /DCC Resume transfer.  With AmIRC, This process
  903.      is completely transparent.  If no partial or whole file exists, then
  904.      the file will be completely transferred.
  905.  
  906. DCC Get
  907. -------
  908.  
  909.     Template: /DCC get <user sending file>
  910.      DCC get is a transparent operation with AmIRC, and is only mentioned
  911.      in this document for the sake of being thorough.  AmIRC will notify
  912.      you of an incoming DCC request, and allow you the option to accept
  913.      or reject the connecton with a simple click.
  914.  
  915. DCC Chat
  916. ========
  917.  
  918. Another use of the DCC standard is DCC chat, which, like DCC Send, will
  919. send a CTCP request to the receiving client to set up a direct link.  In
  920. this case, however, the purpose of the link is for users to send
  921. messages to each other.  Because the mesages are sent through the
  922. direct link, and do not pass through the IRC server, this method of
  923. sending messages is much more private than using the IRC's privmsg
  924. (/msg).
  925. With AmiRC, it must be noted that a DCC Chat request will not open a
  926. dialog window for you, instead, when DCC chat is initiated and accepted,
  927. all privmsg's (/msg) to the receiving user will be sent through the DCC
  928. link.  If you wish to have a dialog box for chatting, the best way to go
  929. about this is to highlight the users's name in the listview by clicking
  930. on it.  then click on the 'Query' gadget below the listview.  this will
  931. open a window that has several options within it. From here, you can
  932. 'ping' or 'whois' the other user, or you may inititate a 'DCC Send' or
  933. 'DCC chat'.  Starting a 'DCC Chat' from this window will allow you to
  934. carry on a dialog with the remote user through the window.
  935.  
  936. Commands
  937. ********
  938.  
  939. Overview
  940. ========
  941.  
  942. AmIRC has several builtin commands. Some of these commands are
  943. processed locally, whereas others are sent to the IRC server.
  944.  
  945. Commands generally start with a / to differentiate them from normal
  946. text. If you want to use the / character at the start of normal text,
  947. use // instead.
  948.  
  949. Many commands require a channel name as a parameter. AmIRC will
  950. automatically fill in the channel name of the current window if you
  951. don't specify a channel name on your own.
  952.  
  953. For commands which require a nick name (e.g. /MSG or /OP, there
  954. are three special shortcut arguments:
  955.  
  956. .
  957.      The period is replaced with the nickname of the last person you
  958.      have send a private message to.
  959.  
  960. ,
  961.      The comma is replaced with the nickname of the last person who
  962.      send a message to you. Be careful with this, since you might
  963.      easily address the wrong person if someone sends you a message
  964.      while you are still typing this command!
  965.  
  966. :
  967.      The colon is replaced with the nickname of the last person which
  968.      you haved a addressed with a nick: prefix inside a channel.
  969.  
  970. You may easily carry a dialog with a particular user by first clicking
  971. on their username in the user list, then anytime you hit the tab key,
  972. the input string will be set up with '/msg <user> ', after which you
  973. may type in the message and hit return.  This will work after
  974. initiating a DCC Chat request as well.  Please note that if you have
  975. configured the user list as a separate window, you must reactivate the
  976. message window after clicking on a username.
  977.  
  978. Reference
  979. =========
  980.  
  981. AWAY
  982. ----
  983.  
  984. Usage: /AWAY [message]
  985.  
  986. When used with the optional <message> argument, /AWAY will mark you as
  987. being away and send the message to any client sending a MSG to you.
  988. otherwise, it will remove a previously set away message.
  989.  
  990. EXAMPLES:
  991.  
  992. /AWAY eating dinner
  993.      will send the message '<nick> is away: eating dinner', where nick
  994.      is the nickname of the user that is away.
  995.  
  996. /AWAY
  997.      will remove a previously set Away Message.
  998.  
  999. INVITE
  1000. ------
  1001.  
  1002. Usage: /INVITE <nickname> <channel>
  1003.  
  1004. Invites a user to the channel given in the argument, regardless of
  1005. weather the channel exists.  If the named channel is MODE, the user
  1006. performing the command must be a channel operator for that channel.
  1007.  
  1008. EXAMPLES:
  1009.  
  1010. /INVITE freddie #amiga
  1011.      Sends a message to 'freddie', inviting him to join #amiga.
  1012.  
  1013. ISON
  1014. ----
  1015.  
  1016. Usage: /ISON <nickname>{<space><nickname>}
  1017.  
  1018. Quickly returns the users nick if it is found, does nothing if it is
  1019. not.
  1020.  
  1021. EXAMPLES:
  1022.  
  1023. /ISON Kenneth
  1024.      Returns: '<ISON>Kenneth', if nick 'Kenneth' is found on the
  1025.      server.
  1026.  
  1027. JOIN
  1028. ----
  1029.  
  1030. Usage: /JOIN channel[,channel[,...]] [key[,key[,...]]]
  1031. Usage: /CHANNEL channel[,channel[,...]] [key[,key[,...]]]
  1032.  
  1033. Join a channel on the IRC.  If the channel doesn't exists, it is
  1034. automatically created.
  1035.  
  1036. There are two kinds of channels:  Channel names starting with an
  1037. # are global channels and available on all IRC servers which
  1038. are connected to the net you are currently on.  Channels which begin
  1039. with & are local to the chat server you are connected to.
  1040.  
  1041. If a channel requires a special keyword to join, you must submit this
  1042. after the channel name.
  1043.  
  1044. AmIRC will look for a channel window which isn't currently bound to a
  1045. channel. If it doesn't find one, a new window will be created and bound
  1046. to this channel.
  1047.  
  1048. EXAMPLES:
  1049.  
  1050. /JOIN #Amigager
  1051.      Join channel #AmigaGER
  1052.  
  1053. /JOIN #Amigager,#Amiga
  1054.      Join channels #AmigaGER and #Amiga
  1055.  
  1056. /JOIN #AmigaGER deutsch
  1057.      Join channel #AmigaGER with keyword deutsch.
  1058.  
  1059. RELATED TOPICS:
  1060.  
  1061. See LEAVE.
  1062.  
  1063. KICK
  1064. ----
  1065.  
  1066. Usage: /KICK <channel> <user> [<comment>]
  1067.  
  1068. Forcibly removes a user from the named channel.  the user sending the
  1069. /KICK command must be a channel operator of the named channel.  If the
  1070. optional <comment> is given, it will be shown as the reason for the
  1071. kick.
  1072.  
  1073. EXAMPLES:
  1074.  
  1075. /KICK #amiga Freddie Take it outside!
  1076.      forces 'Freddie' from channel #amiga with the reason 'take it
  1077.      outside'.
  1078.  
  1079. LEAVE
  1080. -----
  1081.  
  1082. Usage: /LEAVE [channel[,channel[,...]]
  1083.  
  1084. Leaves a channel. If you don't give a channel name as a parameter, the
  1085. channel currently bound to the window in which in the command is
  1086. entered will be left.
  1087.  
  1088. EXAMPLES:
  1089.  
  1090. /LEAVE
  1091.      Leave the channel currently bound to this window.
  1092.  
  1093. /LEAVE #AmigaGER
  1094.      Leave channel #AmigaGER.
  1095.  
  1096. RELATED TOPICS:
  1097.  
  1098. See JOIN.
  1099.  
  1100. LIST
  1101. ----
  1102.  
  1103. Usage: /LIST [<channel>{,<channel>} [<server>]]
  1104.  
  1105. Generates a list of current channels and topics.  If the <channel>
  1106. argument is given, LIST displays that channel's status and topic.
  1107. Private channels show as 'Private' and secret channels are not listed,
  1108. unless the client generating the list is a member of those channels.
  1109.  
  1110. EXAMPLES:
  1111.  
  1112. /LIST
  1113.      Shows a list of all current, non-secret channels.
  1114.  
  1115. /LIST #amiga,#amigaGER
  1116.      List channels #amiga and #amigaGER
  1117.  
  1118. Logging Options
  1119. ---------------
  1120.  
  1121. Usage: /LOG {[on|off|<Filespec>]}
  1122.  
  1123. /LOG allows you to start/stop logging, as well as setting the log
  1124. filename and displaying status of logging.
  1125.  
  1126. EXAMPLES:
  1127.  
  1128. /LOG
  1129.      Displays current status of logging
  1130.  
  1131. /LOG on
  1132.      Begins logging to the logfile
  1133.  
  1134. /LOG <filespec>
  1135.      Sets the path and name of the logfile.
  1136.  
  1137. Channel MODE
  1138. ------------
  1139.  
  1140. /MODE allows both users and channels to have their modes changed.
  1141.  
  1142. Usage: /MODE <channel> {[+|-]|o|p|s|i|t|n|b|v} [<limit>] [<user>] [<ban
  1143. mask>]
  1144.  
  1145. Used by Channel Operators to change the modes of 'their' channel.  the
  1146. modes available are:
  1147.  
  1148.      o - give/take channel operator privileges;
  1149.      p - private channel flag;
  1150.      s - secret channel flag;
  1151.      i - invite-only channel flag;
  1152.      t - topic settable by channel operator only flag;
  1153.      n - no messages to channel from clients on the outside;
  1154.      m - moderated channel;
  1155.      l - set the user limit to channel;
  1156.      b - set a ban mask to keep users out;
  1157.      v - give/take the ability to speak on a moderated channel;
  1158.      k - set a channel key (password).
  1159.  
  1160. EXAMPLES:
  1161.  
  1162. /MODE #amiga +tm
  1163.      Sets topic protection and makes channel moderated for #amiga.
  1164.  
  1165. /MODE #amiga -o Sarek
  1166.      Removes channel operator status from user 'Sarek' on channel
  1167.      #amiga.
  1168.  
  1169. /MODE #amiga +l 50
  1170.      Sets limit of 50 users on #amiga.
  1171.  
  1172. /MODE #amiga -l
  1173.      Removes the limit form #amiga
  1174.  
  1175. User MODE
  1176. ---------
  1177.  
  1178. Usage: <nickname> {[+|-]|i|w|s|o}
  1179.  
  1180. These affect how a client is seen by others or what extra messages a
  1181. client will receive. User Modes will only take effect if the Nick of
  1182. the client sending the command, and the nick of the <nickname> argument
  1183. are the same.
  1184.  
  1185. Available User Modes:
  1186.      i - marks a users as invisible;
  1187.      s - marks a user for receipt of server notices;
  1188.      w - user receives wallops;
  1189.      o - operator flag.
  1190.  
  1191. Note that the +o user mode will not work, however, -o will.
  1192.  
  1193. EXAMPLES:
  1194.  
  1195. /MODE freddie +i
  1196.      makes user 'freddie' invisible in the global user list.
  1197.  
  1198. /MODE freddie -o
  1199.      User 'freddie' removes channel operator status from himself.
  1200.  
  1201. MSG (PRIVMSG)
  1202. -------------
  1203.  
  1204. Usage: /MSG <receiver>{,<receiver>} <text to be sent>
  1205.  
  1206. Sends a Private Message to one or more users. Note that this is
  1207. different from a DCC, in that a /MSG (PRIVMSG) is sent thru the IRC
  1208. server to the recipient.  Note that the TAB key will cycle back and
  1209. forth through the users who have /msg'ed you.  This will appear in the
  1210. input string gadget, and you may simply add your message after it.
  1211.  
  1212. EXAMPLES:
  1213.  
  1214. /MSG Kenneth Heya Dude! How's Florida?
  1215.      Send the message: "Heya Dude! How's Florida?" to user 'Kenneth'.
  1216.  
  1217. /MSG Kenneth,Aerosoul I am in Pittsburgh
  1218.      Sends the message "I am in Pittsburgh" to Kenneth and Aerosoul.
  1219.  
  1220. Names
  1221. -----
  1222.  
  1223. Usage /NAMES [<channel>{,<channel>}]
  1224.  
  1225. Gives a list of nicknames on any channel visible to the user(not secret
  1226. or private, or one actually joined by the user performing the command).
  1227.  
  1228. EXAMPLES:
  1229.  
  1230. /NAMES #amiga,#amigaGER
  1231.      Will list all users on channels #amiga and #amigaGER, provided the
  1232.      channels are visible to the user.
  1233.  
  1234. /NAMES
  1235.      Will return a list of all visible channels and users (Strongly
  1236.      Discouraged!)
  1237.  
  1238. NICK
  1239. ----
  1240.  
  1241. Usage: /NICK <nickname>
  1242.  
  1243. NICK is used to to give yourself or change your current nickname.  If
  1244. the chosen nick is already in use, you wil be notified of this and
  1245. prompted for a new nick.
  1246.  
  1247. EXAMPLES:
  1248.  
  1249. /NICK Phalanx
  1250.      Makes/changes your nickname to 'Phalanx'
  1251.  
  1252. NOTICE
  1253. ------
  1254.  
  1255. Usage: /NOTICE <nickname> <text>
  1256.  
  1257. Smiilar to /MSG, /NOTICE is usually used by Bots or clients being
  1258. controlled by scripts.  /NOTICE messages must never be responded to by
  1259. an automatic reply.  See MSG for syntax examples.
  1260.  
  1261. QUIT
  1262. ----
  1263.  
  1264. Usage: [<Quit message>]
  1265.  
  1266. Used to End an IRC session.  The optional <quit message> is the text
  1267. that will be displayed upon quitting.
  1268.  
  1269. EXAMPLES:
  1270.  
  1271. /QUIT :Gone to have lunch
  1272. RAW
  1273. ---
  1274.  
  1275. Usage: /RAW text
  1276.  
  1277. Sends text directly to the IRC server without any further processing.
  1278. Warning: Don't even think about using this command without interior
  1279. knowledge of the IRC protocol, or you might run into severe trouble.
  1280. See `RFC 1459' for a description of the IRC protocol.
  1281.  
  1282. EXAMPLES:
  1283.  
  1284. /RAW JOIN #IRC-Heros
  1285.      Send the string JOIN #IRC-Heros directly to the IRC server.
  1286.  
  1287. RELATED TOPICS:
  1288.  
  1289. `RFC 1459'.
  1290.  
  1291. TIME
  1292. ----
  1293.  
  1294. Usage: /TIME [<server>]
  1295.  
  1296. Returns the time of day from the server.  If the optional <server>
  1297. argument is given, then that servers local time will be returned.
  1298.  
  1299. EXAMPLES:
  1300.  
  1301. /TIME irc.pitt.edu
  1302.      Returns the local time from server 'irc.pitt.edu'
  1303.  
  1304. TOPIC
  1305. -----
  1306.  
  1307. Usage: /TOPIC <channel> [<topic>]
  1308.  
  1309. The topic command alone will display the channels topic. if the optional
  1310. <topic> argument is given, the topic will be changed to the argument
  1311. given, provided that the topic is not protected, or the user issuing
  1312. the command is an operator on the channel. See MODE.
  1313.  
  1314. EXAMPLES:
  1315.  
  1316. /TOPIC #amiga
  1317.      Will display the current topic on #amiga.
  1318.  
  1319. /TOPIC #amiga Amigas Rule!
  1320.      Will replace the current topic of #amiga with the topic 'Amigas
  1321.      Rule'
  1322.  
  1323. USERS
  1324. -----
  1325.  
  1326. Usage: /USERS [<server>]
  1327.  
  1328. Returns a list of users on the server, or, optionally, on the specified
  1329. server.  /USERS may be disabled on most servers for security reasons.
  1330.  
  1331. EXAMPLES:
  1332.  
  1333. /USERS
  1334.      Returns a list of users on the current server
  1335.  
  1336. /USERS irc.colorado.edu
  1337.      Returns a list of users on server 'irc.colorado.edu'.
  1338.  
  1339. USERHOST
  1340. --------
  1341.  
  1342. Usage: /USERHOST <nickname>{<space><nickname>}
  1343.  
  1344. Returns the login@domain for the specified nickname.  Up to five
  1345. nicknames may be specified, each separated by a <space>.
  1346.  
  1347. EXAMPLES:
  1348.  
  1349. /USERHOST DuRaN
  1350.      returns: 'DuRaN is DuRaN@calci.amiganet.pgh.net
  1351.  
  1352. VERSION
  1353. -------
  1354.  
  1355. Usage /VERSION [<server>]
  1356.  
  1357. Returns the version of the server's software.  If the optional <server>
  1358. arguement is given, returns the version of the specified server's
  1359. software.
  1360.  
  1361. EXAMPLES:
  1362.  
  1363. /VERSION *.edu
  1364.      Returns server version information for all servers matching
  1365.      '*.edu'.
  1366.  
  1367. WHO
  1368. ---
  1369.  
  1370. Usage: /WHO [<name> [<o>]]
  1371.  
  1372. Returns a generated list of all users matching the criteria passed to
  1373. the command, i/e. everyone at a particular site, or on a particular
  1374. server.  If the optional <o> argument is specified, /WHO will only
  1375. return information on users that are channel operators.
  1376.  
  1377. EXAMPLES:
  1378.  
  1379. /WHO *.cmu.edu
  1380.      Will list all users at the cmu.edu domain.
  1381.  
  1382. /WHO irc.pitt.edu o
  1383.      will list all operators on irc.pitt.edu server
  1384.  
  1385. WHOIS
  1386. -----
  1387.  
  1388. Usage: /WHOIS [<server>] <nickmask>[,<nickmask>[,...]]
  1389.  
  1390. Returns information about the specified user or users, that you are
  1391. allowed to see.  If the optional <server> argument is specified, then
  1392. information aobut the user in relation to that specified server will be
  1393. given, i/e idle time.
  1394.  
  1395. EXAMPLES:
  1396.  
  1397. /WHOIS Phalanx
  1398.      Returns available information about user 'Phalanx'.
  1399.  
  1400. /WHOIS irc.bu.edu Phalanx
  1401.      Asks server 'irc.bu.edu' for information on user 'Phalanx
  1402.  
  1403. WHOWAS
  1404. ------
  1405.  
  1406. Usage /WHOWAS <nickname> [<count> [<server>]]
  1407.  
  1408. returns information on a nick that no longer exists, due to the user
  1409. leaving the server or changing their nick. The optional <count> argument
  1410. specifies how many previous instances of the nick should be returned.
  1411. The optional <server> argument specifies a particular server to be
  1412. searched.
  1413.  
  1414. EXAMPLES:
  1415.  
  1416. /WHOWAS Aerosoul 5
  1417.      Checks for and returns available information on the last 5
  1418.      instances of the nick 'Aerosoul'.
  1419.  
  1420. Customizing your environment
  1421. ****************************
  1422.  
  1423. Overview
  1424. ========
  1425.  
  1426. Now that you have AmIRC running, you may want to get it to operate the
  1427. way you want it to, and to look pleasing as well.  This is achieved
  1428. thru both MUI preferences and AmIRC's Menu options.
  1429.  
  1430. Changing MUI Settings
  1431. *********************
  1432.  
  1433. MUI Preferences
  1434. ===============
  1435.  
  1436. Most of the configuration dealing with how AmIRC's GUI appears can be
  1437. customized with About MUI.  Check the 'MUI Settings...' entry under the
  1438. 'Settings' menu.  This will pop up MUI's interface, allowing you to
  1439. setup AmIRC's MUI Prefs, without disturbing any of your other MUI
  1440. configurations. Read the documentation for MUI to Learn more about the
  1441. operation of MUI Preferences.
  1442.  
  1443. Changing AmIRC Options
  1444. **********************
  1445.  
  1446. AmIRC Setup
  1447. ===========
  1448.  
  1449. Most of the setup functions appear in the 'Setup' entry under the
  1450. 'Settings' & 'Lists' menus. Here you will get a multi-requestor that
  1451. will allow you to access several pages that deal with configuring AmIRC.
  1452.  
  1453. Messages Page
  1454. *************
  1455.  
  1456. Misc Messages
  1457. =============
  1458.  
  1459. CTCP Userinfo
  1460.      The text in this string is what will be returned to a user who
  1461.      sends '/CTCP userinfo' to your client.
  1462.  
  1463. KICK Reason
  1464.      If you are a channel operator and /kick another user from the
  1465.      Channel, this test will appear as the reason for the /KICK.
  1466.  
  1467. Quit Messages
  1468. =============
  1469.  
  1470. Exit
  1471.      This will appear to users in the channel when you exit AmIRC.
  1472.  
  1473. New Server
  1474.      This text will appear to users in the channel when you select
  1475.      'Select Server' in the 'AmIRC' menu, and pick a new server to
  1476.      connect to.
  1477.  
  1478. System Reset
  1479.      This is the text to appear if you reboot your amiga (Crtl-
  1480.      amiga-amiga) while connected to a server.
  1481.  
  1482. AWAY Messages
  1483. =============
  1484.  
  1485. Default
  1486.      This is the text that will appear when you are set 'away' by
  1487.      selecting the 'Marked Away?' item in the 'User Modes' menu.
  1488.  
  1489. AutoAWAY
  1490.      text that appears when you are automatically set away due to
  1491.      inactivity.
  1492.  
  1493. Timeout
  1494.      This sets how much time will pass before AmIRC assumes you are
  1495.      away from the computer and marks you as 'AWAY'.
  1496.  
  1497. UnAWAY
  1498.      This cycle gadget allows you to choose the conditions of which
  1499.      AmIRC will automatically set you to 'Not AWAY'.
  1500.  
  1501. Actions Page
  1502. ************
  1503.  
  1504. Actions
  1505. =======
  1506.  
  1507. The 12 text gadgets in the 'Label:' column here correspond to the 12
  1508. gadgets under the user list on AmIRC's main window.  You may set these
  1509. gadgets to be anything, sort of like macros.  AmIRC, however, does
  1510. include configurable function keys to act as macros, so these gadgets
  1511. are preset for /ctcp, /dcc, and /mode operations.
  1512.  
  1513. Below the text gadgets is a quick reference of the placeholders that
  1514. can be used in the desired operation.
  1515.  
  1516. Events Page
  1517. ***********
  1518.  
  1519. Events
  1520. ======
  1521.  
  1522. Here you may define certain actions to take place upon incoming events.
  1523. These actions can be as simple as a warning beep from your amiga, or a
  1524. complex and powerful rexx command.  The following text first explains
  1525. the functions of the columns of this page, and then goes on to explain
  1526. what each event is.
  1527.  
  1528. Columns
  1529. -------
  1530.  
  1531. Event
  1532.      The particular event for the action to take place on.
  1533.  
  1534. Deiconify
  1535.      If AmIRC is iconified, this will uniconify and bring to front the
  1536.      AmIRC window on the occurence of the event.
  1537.  
  1538. Beep
  1539.      This will perform a system beep on the occurence of the event
  1540.  
  1541. Sound
  1542.      if a sound sample is preferred for the event, you may use the
  1543.      requestor gadget to pick a sound to play instead of the system
  1544.      beep.
  1545.  
  1546. Vol
  1547.      This sets the volume for the sound sample.  The valid range for
  1548.      the volume is 0 - 64.  This is a slider gadget.
  1549.  
  1550. Rexx Command
  1551.      Here you may configure a rexx script to be run on the occurence of
  1552.      the event.
  1553.  
  1554. Events
  1555. ------
  1556.  
  1557. Any Message
  1558.      This Event occurs on any incoming public message.
  1559.  
  1560. Private Msg
  1561.      This event occurs when you receive an incoming private /msg or /dcc
  1562.      chat message
  1563.  
  1564. Notice
  1565.      This event occurs when an operator sends out a /notice
  1566.  
  1567. CTCP request
  1568.      This event occures when your client receives any /ctcp request (for
  1569.      example /ctcp time, or /ctcp version
  1570.  
  1571. DCC request
  1572.      This event occurs on receiving a /dcc file transfer request or chat
  1573.      request.
  1574.  
  1575. Join
  1576.      This event occurs when anyone /joins the channel you are currently
  1577.      on.
  1578.  
  1579. Kick
  1580.      This event occurs when anyone is /Kicked from the channel you are
  1581.      currently on.
  1582.  
  1583. Mode change
  1584.      This event occurs when the channel mode is changed for the channel
  1585.      you are currently on, i/e. if someone is /OPed or /DeOPed, or if
  1586.      the channel is made private, etc.
  1587.  
  1588. ISON Notify
  1589.      This event occurs when AmIRC 'sees' a user that is configured in
  1590.      your 'Notify' list.
  1591.  
  1592. Connection
  1593.      This event occurs when AmIRC makes a connection to an IRC server.
  1594.  
  1595. Invite
  1596.      This event occurs when another user invites you to join a channel
  1597.      that is currently set to /MODE 'Invite Only'
  1598.  
  1599. GUI Configuration
  1600. *****************
  1601.  
  1602. GUI
  1603. ===
  1604.  
  1605. The GUI configuraton page allows you to control some specific aspects
  1606. of AmIRC that arent covered in the MUI configuration.
  1607.  
  1608. Userlist:
  1609. ---------
  1610.  
  1611. The userlist cycle gadget allows you to control if the User List is
  1612. visible or not visible, and if it is visible, if it is a separate
  1613. window, or a part of the AmIRC window.  If the Sort Gadget is check
  1614. marked, the list will be sorted alphabetically, otherwise, the list
  1615. will reflect the order that the users have joined the chat.
  1616.  
  1617. The Buttons Gadget will toggle on & off the gadgets in the User
  1618. Action List, located below the user list.  If the user list is
  1619. configured as a separate window, the buttons will also appear in that
  1620. window.
  1621.  
  1622. The Userlist win open? gadget will control if the userlist is open or
  1623. closed if configured as a separate window.
  1624.  
  1625. Misc
  1626. ----
  1627.  
  1628. Here you may select a different pubscreen for the query window to appear
  1629. on.  If no pubscreen is specified, the Query window will open on the
  1630. AmIRC default screen.
  1631.  
  1632. Text Colors
  1633. -----------
  1634.  
  1635. In this section, you may configure the colors that certain text will
  1636. appear in AmIRC.  These colors are based on the MUI pen colors that you
  1637. have configured in MUI.  Just click and hold on the cycle gadget to see
  1638. a list of the MUI Pen colors available.
  1639.  
  1640. Normal Text
  1641.      Text that is a normal message from a user.
  1642.  
  1643. Private Messages
  1644.      Text that is a private message from another user to you.
  1645.  
  1646. Mode Changes
  1647.      Text that shows a mode change for the channel.
  1648.  
  1649. Highlighted Text
  1650.      Highlighted text is not yet implemented in AmIRC.
  1651.  
  1652. Server Messages
  1653.      Text that comes from the server, i/e when a user joins or exits the
  1654.      channel.
  1655.  
  1656. CTCP/DCC Messages
  1657.      Text that informs you of an incoming CTCP or DCC request.
  1658.  
  1659. Logging
  1660. -------
  1661.  
  1662. Here you may enter the path & name to use for the logfile.
  1663.  
  1664. "Lists..." Menu Item
  1665. ********************
  1666.  
  1667. Lists Configuration
  1668. ===================
  1669.  
  1670. Alias Tab
  1671. ---------
  1672.  
  1673. Here you can create aliases, or shortcuts for complex IRC commands.
  1674. Some examples have been created for you, and a reference template
  1675. appears at the bottom of this page. %p is the place holder for any
  1676. arguments you may wish to add when using an alias.
  1677.  
  1678. Ignore Tab
  1679. ----------
  1680.  
  1681. Here you can set which users if any you want to ignore, and what kind of
  1682. messages from them to ignore.  To add an ignore to the list, click the
  1683. 'Add Ignore' gadget, then type the user's name in the text input gadget
  1684. labeled 'Ignore'.  Next click on the type of messages you want to
  1685. ignore. Checking the 'text' box will prevent you from seeing any public
  1686. messages from the user.  Setting the 'privmsgs' box will prevent you
  1687. from seeing /MSGs from that user to you.  Likewise, clicking the
  1688. 'CTCPs' box will prevent you from seeing any CTCP requests from the
  1689. Ignored user.  To delete an ignore, click on the entry you wish to
  1690. delete, and then click on the 'delete ignore' gadget.
  1691.  
  1692. Hilite Tab
  1693. ----------
  1694.  
  1695. Here you may set certain text to be highlighted in order to get your
  1696. attention if that text appears.  You may set text to match the nick,
  1697. Userhost, or any keyword enclosed in double quotes. To add a new
  1698. pattern, click on the Button labeled "Add new Hilite pattern", and type
  1699. your pattern into the input gadget.  To delete an existing pattern,
  1700. Click on the entry yo uwish to delete and then click on the button
  1701. labeled "Delete Hilite pattern".  The Hilite patterns will ignore a
  1702. pattern it recognizes if it was input by you, but will activate on the
  1703. pattern from other users.
  1704.  
  1705. Pattern Definitions:
  1706. --------------------
  1707.  
  1708. Nick
  1709.      This will watch the AmIRC listview for the nick that you specify,
  1710.      and highlight the text for that users message.  The 'Nick' entry
  1711.      does not require double quotes.
  1712.  
  1713. Userhost
  1714.      This will watch for messages that originate from a particular
  1715.      Userhost, and highlight the text for that message. Userhost
  1716.      entries may contain wildcards.  Examples:
  1717.  
  1718.     fred!fdoe@doe1.powernet.edu
  1719.           This will highlight only messages from fred at that
  1720.           particular address.
  1721.  
  1722.     fred!*@*
  1723.           This will highlight messages from anyone named fred,
  1724.           regardless of address or login name.
  1725.  
  1726.     Fred!*@*.powernet.edu
  1727.           This will highlight messages from anyone named fred on any
  1728.           machine on powernet.edu
  1729.  
  1730.     *!*@doe1.powernet.edu
  1731.           This will highlight any messages from anyone on the doe1
  1732.           machine at powernet.edu
  1733.  
  1734.     *!*@*
  1735.           This will highlight any messages from any user.
  1736.  
  1737. "Keyword"
  1738.      This will highlight any message that contains the text enclosed in
  1739.      double quotes.
  1740.  
  1741. Function Key Definitions
  1742. ************************
  1743.  
  1744. Function Keys
  1745. =============
  1746.  
  1747. Here you may define the Amiga's ten functon keys to insert text into
  1748. the input string gadget of AmIRC. By using the keys normally, or with
  1749. the 'shift' or 'crtl' modifiers, you may define up to 30 text input
  1750. macros that can be used at the press of a key. This is similar to the
  1751. functon key macros found on many popular terminal emulation programs.
  1752.  
  1753. /n at the end of a function key definition will send a <CR> after
  1754. the text.  The function key definitions also allow placeholders,
  1755. similar to the Operation.
  1756.  
  1757. AmIRC's ARexx Port
  1758. ******************
  1759.  
  1760. Overview
  1761. ========
  1762.  
  1763. AmIRC supports a versatile ARexx Port.
  1764.  
  1765. Reference
  1766. =========
  1767.  
  1768. SAY
  1769. ---
  1770.  
  1771. Usage: SAY TEXT/F
  1772.  
  1773. DESCRIPTION:
  1774.  
  1775. Treats TEXT just like it has been entered in the string gadget of the
  1776. current window.
  1777.  
  1778. EXAMPLES:
  1779.  
  1780.     say '/JOIN #Amigager'
  1781.  
  1782. RELATED TOPICS:
  1783.  
  1784. ISCONNECTED
  1785. -----------
  1786.  
  1787. Usage: ISCONNECTED
  1788.  
  1789. DESCRIPTION:
  1790.  
  1791. Checks whether a connection is currently established. Returns RC 0 if
  1792. the link is up, RC 5 otherwise.
  1793.  
  1794. EXAMPLES:
  1795.  
  1796.     ISCONNECTED; say rc
  1797.  
  1798. RELATED TOPICS:
  1799.  
  1800. GETMYNICK
  1801. ---------
  1802.  
  1803. Usage: GETMYNICK
  1804.  
  1805. DESCRIPTION:
  1806.  
  1807. Returns your current nickname.
  1808.  
  1809. EXAMPLES:
  1810.  
  1811.     GETMYNICK; say result
  1812.  
  1813. RELATED TOPICS: See RX_GETSERVERNAME.
  1814.  
  1815. GETSERVERNAME
  1816. -------------
  1817.  
  1818. Usage: GETSERVERNAME
  1819.  
  1820. DESCRIPTION:
  1821.  
  1822. Returns the name of the IRC server you are currently connected to.
  1823.  
  1824. EXAMPLES:
  1825.  
  1826.     GETSERVERNAME; say result
  1827.  
  1828. RELATED TOPICS: See RX_GETMYNICK.
  1829.  
  1830. USERHOST
  1831. --------
  1832.  
  1833. Usage: USERHOST NICK/A
  1834.  
  1835. DESCRIPTION:
  1836.  
  1837. Returns the userhost specification belonging to NICK.
  1838. AMIRC keeps a internal list of the userhosts of every nick that occured
  1839. yet. You can query this database with this command.  Note however that
  1840. it is possible that the userhost isn't in the database yet; this
  1841. command will not query the server than, but simply return an error.
  1842.  
  1843. EXAMPLES:
  1844.  
  1845.     USERHOST Olli; say result
  1846.  
  1847. RELATED TOPICS: See RX_GETMYNICK.
  1848.  
  1849. ECHO
  1850. ----
  1851.  
  1852. Usage: ECHO P=PREFIX/K, TEXT/F
  1853.  
  1854. DESCRIPTION:
  1855.  
  1856. Sends text to the listview
  1857.  
  1858. EXAMPLES:
  1859.  
  1860.     ECHO P=Kewlja This is echo test
  1861.  
  1862. RAW
  1863. ---
  1864.  
  1865. Usage: RAW TEXT/F
  1866.  
  1867. DESCRIPTION:
  1868.  
  1869. Sends text to the server in raw format.
  1870.  
  1871. EXAMPLES:
  1872.  
  1873.     RAW PRIVMSG phalanx: heya! whats happening?
  1874.  
  1875. CHANNELS
  1876. --------
  1877.  
  1878. Usage: CHANNELS NULL
  1879.  
  1880. DESCRIPTION:
  1881.  
  1882. returns a list of channels currently joined in the format: "#channel1
  1883. #channel2 etc."
  1884.  
  1885. EXAMPLES:
  1886.  
  1887.     options results; channels; say result
  1888.  
  1889. GETCHANNEL
  1890. ----------
  1891.  
  1892. GETSELECTEDUSER
  1893. ---------------
  1894.  
  1895. GETUSER
  1896. -------
  1897.  
  1898. GETUSERS
  1899. --------
  1900.  
  1901. GETUSERSTATE
  1902. ------------
  1903.  
  1904. GETLINE
  1905. -------
  1906.  
  1907. GETLINECOUNT
  1908. ------------
  1909.  
  1910. GETLASTLINE
  1911. -----------
  1912.  
  1913. GETAWAYSTATE
  1914. ------------
  1915.  
  1916. GETVERSION
  1917. ----------
  1918.  
  1919. PARSELINE
  1920. ---------
  1921.  
  1922. Magic User Interface
  1923. ********************
  1924.  
  1925. About MUI
  1926. =========
  1927.  
  1928.  
  1929.                                This application uses
  1930.      
  1931.      
  1932.                              MUI - MagicUserInterface
  1933.      
  1934.                      (c) Copyright 1993/94 by Stefan Stuntz
  1935.      
  1936.      
  1937.                         Without MUI, AmIRC wouldn't exist.
  1938.      
  1939.      
  1940.                If you want to register directly, feel free to send
  1941.      
  1942.      
  1943.                               DM 30.-  or  US$ 20.-
  1944.      
  1945.                                        to
  1946.      
  1947.                                   Stefan Stuntz
  1948.                              Eduard-Spranger-Straße 7
  1949.                                   80935 München
  1950.                                      GERMANY
  1951.  
  1952. Why MUI?
  1953. ========
  1954.  
  1955. Why MUI? you ask...
  1956. MUI is the most powerful application framework toolkit available for any
  1957. platform.  MUI allows applications to provide their users with a highly
  1958. usable, fast and configurable user interface which works well on any
  1959. screen setting, from a 640x200 NTSC display to a 1280x1024 true color
  1960. graphics board.  MUI applications use less memory than comparable
  1961. applications since they can rely on a huge set of shared class code,
  1962. which is especially true if several MUI apps are run on the same
  1963. machine.
  1964.  
  1965. Plus, MUI's powerful OO class methods allows the application programmer
  1966. to work on the program's functionality instead of doing repetitive low
  1967. level tasks, resulting in much more powerful applications given the same
  1968. development times.  MUI's GUI classes overcome the severe design bugs in
  1969. the ROM internal BOOPSI gadget classes, allowing for complex GUI objects
  1970. without high priority CPU hogging or potential system deadlocks.
  1971.  
  1972. MUI compacts over 4 years of development and optimization in a powerful
  1973. toolkit, an effort no application programmer can afford to invest in his
  1974. own development.
  1975.  
  1976. Developments in AmIRC
  1977. *********************
  1978.  
  1979. Revision History
  1980. ================
  1981.  
  1982. 0.87beta
  1983. -------
  1984. - list class now avoids "plane optimization" if AmIRC runs on a cybergfx
  1985.  chunky mode screen.  - made the userlist scroller less jumpy.  -
  1986. fixed a few boolean config settings which weren't properly saved.  -
  1987. fixed screen refresh problems with mark selecting and scrolling.  -
  1988. during config save, "," inside the autojoin channel settings weren't
  1989. properly escaped, causing the server list to be messed up.  - AWAY
  1990. state will now be visualized by rendering the nick underlined   with
  1991. FILLPEN.  - it's now possible to measure the user-server round trip
  1992. time by   issuing the /PING command without parameters.  - double
  1993. clicking on an entry in the URL grabber window will now cause   the
  1994. entry to be copied to the clipboard.
  1995.  
  1996. 0.86beta
  1997. -------
  1998. - fixed several problems with listview refresh.  - cut&paste marking is
  1999. a bit less flashier now again.  - function keys now allow for the same
  2000. placeholders as user op buttons.  - function key assignments ending
  2001. with a "\n" now cause the input   to be directly processed as if the
  2002. user pressed ENTER manually.  - alias definitions now work even if they
  2003. start with a "/".
  2004.  
  2005. 0.85beta
  2006. -------
  2007. - sounds and userlist settings weren't updated upon loading the config
  2008. file.  - fixed TAB messaging to properly cycle in both directions.  -
  2009. fixed several bugs regarding cut&paste marking.  - reduced screen
  2010. refresh during cut&paste.
  2011.  
  2012. 0.84beta
  2013. -------
  2014. - now requires at least MUI 3.1 to work.  - replaced the main text list
  2015. with a custom list object optimized for   this particular purpose. This
  2016. results in about 3 times faster   scrolling and generally less CPU
  2017. usage during text output. Also,   the new list class is much more
  2018. memory efficient and works better   during relayout. Note that the
  2019. speed isn't fully optimized yet.  - the main text listview now supports
  2020. mark/cut to clipboard.  - fixed the desynch problems with the ARexx
  2021. GETLINE command   which could cause lines to be missed. Now, GETLINE
  2022. will buffer   the last 50 server lines internally and will use a special
  2023.  counter variable bound to your ARexx script to make sure you
  2024. receive lines in order.  - rewrote the internal prefs handling
  2025. completely. Decreased AmIRC's   memory usage by a few 100k's since now
  2026. all prefs BOOPSI objects   are created dynamically.  - AmIRC now saves
  2027. a textual configuration file for easy editing.  - the auto prefs saving
  2028. during exit can now be turned off with   a menu option.  - the prefs
  2029. requesters now have "Use" and "Cancel" buttons.  - event sounds are no
  2030. more loaded twice or more if the same sounds   are specified for
  2031. different events.  - fixed NOTIFY to no longer turn recognized nicks
  2032. into upper case   in the list.  - TAB now works more like the ircII tab
  2033. script; cycling through the   list of nicks who last send messages to
  2034. you. SHIFT-TAB cycles forward.  - the "," nick destination will now
  2035. also by set by incoming DCC   CHAT messages.  - "Connect Thread" didn't
  2036. work when the executable path contained   spaces (i.e. "Ram Disk:" ;) -
  2037. real long channel names are now cutted before displayed in the
  2038. channel window and window menu.  - the DCC messages generated by DCC
  2039. sub threads didn't use the   color setup for DCC messages.
  2040.  
  2041. 0.83beta
  2042. -------
  2043. [internal only]
  2044.  
  2045. 0.82beta
  2046. -------
  2047. - changed kickban window layout to fit on medres screens - fixed a
  2048. nasty internal bug which caused innocent memory to be overwritten
  2049. during preference save. Could cause nifty side effects under certain
  2050. circumstances.  - changed yet another bug in the prefs window setup
  2051. which caused a   bad crash when /IGNORE, /HILITE or /ALIAS were used
  2052. after the list   window was opened once.  - reduced overall stack usage
  2053. and default stack size to 24k.  - changed several string buffers to fit
  2054. into boopsi's stringclass   shared buffer.  - several attempts to
  2055. reduce overall memory usage, esspecially   using new MUI 3.2 features.
  2056.  
  2057. 0.81beta
  2058. -------
  2059. - startup failure caused a FreeSignal(0) to happen.  - added new
  2060. OP/VOICE icons which should look better on a 4 color screen.  - several
  2061. GUI fixes.  - reduced signal bit usage to avoid trouble with certain
  2062. inet225 versions.  - added NORESETHANDLER Tooltype/Shell switch.  -
  2063. finally changed DCC host ip lookup to use getsockname() on the server
  2064. socket; this should fix ALL kind of ENV:HOSTNAMEish trouble. TIA
  2065. users still must set TIADCC or change to a real IP provider :) - fixed
  2066. a severe bug in the DCC CHAT IPC system which caused a   non-protected
  2067. access to a pool from several processes, possibly   resulting in a
  2068. nifty crash.  - fixed a few potential crashes when moving objects while
  2069. dynamically   creating prefs windows.  - event rexx script parameter
  2070. extension caused a nice crash with   very long messages.  - changed
  2071. behavior of the "DCC Receive Dir" field. From now on,   changes in this
  2072. path will also affect already queued DCC receive   requests which
  2073. haven't be renamed to a different filename and   path before. This is
  2074. the "intuitive" behavior.  - added "borderright" tooltype/shell option
  2075. to have the window   size border moved to the right. This should really
  2076. be an MUI   prefs option.
  2077.  
  2078. 0.80beta
  2079. -------
  2080. - Wallops-Display will now display the source of the Wallops message -
  2081. fixed a crash when selecting "Sound?" in events menu.  - added fixed
  2082. catalog translations.  - the default initialisation of the server list
  2083. was messed up and caused   both enforcer hits and junk in the password
  2084. entries.  - sound volume settings get messed up, causing sounds to be
  2085. played with   volume 0 until the sound options window was opened once.
  2086.  
  2087. 0.79beta
  2088. -------
  2089. - severe bug in the as225 part of the tcp code caused a AmiTCP LVO to be
  2090.  called on SockBase, resulting in messed up results up to mere crashes.
  2091. - prefs setup modification caused the sound dt support to not work
  2092. properly.  - prefs setup modification caused /LOG to crash immediately.
  2093. - did various GUI fixes.
  2094.  
  2095. 0.78beta
  2096. -------
  2097. - added GETUSERS command which returns a string of all users on a
  2098. channel   of the form "nick1 nick2 nick3"...  - %p replacement within
  2099. EVENT ARexx calls didn't work at all.  - some internal & GUI cleanup.
  2100. - changed DCC port allocation scheme to avoid "reusing" active   but
  2101. delayed DCC requests with different users and to avoid   "No socket"
  2102. errors with MLink.  - workaround a few MLink close() bugs in DCC send.
  2103. - now accepts 422 response as End-Of-MOTD. Fixes problems with IRC
  2104. servers which started up with "Error MOTD file is missing",   causing
  2105. login, autojoin etc.pp. handling to not work.  - topics weren't
  2106. properly cleared when hopping servers or channels.  - rename of
  2107. DCC-CHAT connections upon NICK didn't work properly.  - "Connect
  2108. Thread" didn't work when no autojoin was specified   for the selected
  2109. server (new instance failed immediately with   argument parse error) -
  2110. private messages output caused %-format-codes to be interpreted
  2111. instead of being ignored.  - "/MSG ," addressed the last PRIVMSG source
  2112. even if it was a   PRIVMSG of an ignored user.  - now all ALT-SPACE
  2113. inside input strings are replaced by simple   spaces, to avoid trouble
  2114. with IRC server parsing.  - reduced overall memory usage by making
  2115. several of the prefs   windows dynamic.  - added Language
  2116. Tooltype/Shell-Option to manually select   a language catalog,
  2117. overriding locale prefs.  - fixed several GUI quirks.
  2118.  
  2119. 0.77beta
  2120. -------
  2121. - fixed a potential WaitForEver() problem in DCC Receive threads.  -
  2122. changed user mode parsing to better suit localisation.  - event rexx
  2123. scripts can now take an optional parameter %p which   will be replaced
  2124. with the unparsed server line which caused the   event to happen.  -
  2125. added "PARSELINE" ARexx command which will split it's argument line into
  2126.  LINE.PREFIX, LINE.DEST, LINE.REST and LINE.COMMAND just like GETLINE
  2127. does.  - ARexx-Cmd "ISCONNECTED" didn't work at all, but returned 0
  2128. always.  - added GETAWAYSTATE Arexx command.  - fixed HILITE not
  2129. working properly if the matching word was at the   end of a line.  -
  2130. abuse of MUI's label objects caused several dynamic texts to react
  2131. oddly to "_" within them (most notable the kickban win title).
  2132.  
  2133. 0.76beta
  2134. -------
  2135. - some tangling Printf() debug statement in the DCC Receive handler
  2136. caused   enforcer hits and severe crashes when several DCC Receive
  2137. threads were   active.  - added GETCHANNEL, GETSELECTEDUSER, GETUSER
  2138. and GETUSERSTATE ARexx commands.    All take an optional WINNUM
  2139. argument, GETUSER and GETUSERSTATE require an   user index. GETUSER
  2140. returns the name of the indexed user of the current window,
  2141. GETUSERSTATE returns RC=1 if the user is OP, RC=2 if he has voice.  -
  2142. added GETVERSION ARexx command to check AmIRC's version.  - added
  2143. GETLASTLINE, GETLINECOUNT and GETLINE arexx commands. GETLINE   will
  2144. wait(!) for a new line from the server to arrive and return this   line
  2145. into the "LINE" variable. It will also return the parsed line
  2146. components into LINE.PREFIX (userhost), LINE.COMMAND (either numerical
  2147. or alpha command), LINE.DEST and LINE.REST. The meaning of the
  2148. components   depends on the specific message.  - added new /RXRETURN
  2149. user command. This is merely to support scripts   and ought to be used
  2150. with /ALIAS. It will return it's first and following   parameters with
  2151. the current GETLINE command in LINE.COMMAND and LINE.REST   respectivly.
  2152. - fixed several mode changes command templates which were messed up.  -
  2153. removed auto turn off of input filtering in string gadgets again. Will
  2154. now internally accept CTRL-V, CTRL-U (!), CTRL-B, CTRL-G and CTRL-W
  2155. for entering formatting codes into strings, regardless of the
  2156. IControl input filtering settings.  - lines which contained only
  2157. control codes messed up the word wrap   engine.  - fixed a stupid bug
  2158. in notify which caused ISON request to be not   send properly under
  2159. certain circumstances.
  2160.  
  2161. 0.75beta
  2162. -------
  2163. - /LIST with a single channel as an argument will no longer cause a
  2164. complete   list to be requested.  - fixed "repeat-on-cr-pressed" bug in
  2165. the string gadgets.  - added parsing of 271/272 response codes
  2166. (Undernet SILENCE list).  - windows are properly closed upon close
  2167. request; no longer waits for the   PART message from the IRC server.  -
  2168. vbar rendering in the main listview will now completely be done by MUI
  2169. for efficency and exact positioning.  - added netsplit detection.  -
  2170. string gadget has now turned off input filtering by default.  - string
  2171. gadget accepts up to 1024 chars and splits accordingly
  2172.  
  2173. 0.74alpha
  2174. --------
  2175. - some MUI3 dependancy slipped in the window creation function.
  2176.  
  2177. 0.73alpha
  2178. --------
  2179. - pressing TAB returned garbage if no user was referenced in the user
  2180. listview.  - the first window didn't properly show the nickname.  -
  2181. load and save config with file requester failed badly due to
  2182. misinitalized   screen variable.  - added RAW, ECHO and CHANNELS arexx
  2183. commands.  - fixed several bugs with cycle chains and keyboard control
  2184. of gadgets.  - raised stack size for DCC CHAT threads. Should fix all
  2185. kinds of crashes,   esspecially with as225/inet.  - sound loading was
  2186. severly messed up and caused about EVENTS^2 datatypes   load to happen.
  2187. - fixed WHO layout a bit.  - extended the /LIST command to properly
  2188. work in "shell mode"   with pattern and -MIN arguments.
  2189.  
  2190. 0.72alpha
  2191. --------
  2192. - switched back to using "GetHostId()" if ENV:HOSTNAME doesn't exist
  2193. or is invalid. Should fix all kind of DCC trouble with MLink. Make sure
  2194.  that ENV:HOSTNAME is either correct or not existant if you use MLink.
  2195. - fixed a few typos and IRC response parsing problems.  - Topics longer
  2196. than 127 characters caused a real bad crash.  - reduced memory usage a
  2197. bit.  - %p in alias expansion with missing arguments caused garbage
  2198. to be inserted.  - fixed some bugs in the listview setup.  - added
  2199. basic log capability (no filtering yet, only RAW output).  - URL
  2200. grabber messed up news: URLs - seperate user list windows can now be
  2201. configured to start up opened   or closed.  - will now properly rename
  2202. query windows and dcc chat sessions   upon receiving of a NICK change
  2203. message.  - misc. fixes.
  2204.  
  2205. 0.71alpha
  2206. --------
  2207. - something in the optimizer seems to have broken as225r2 compatibility.
  2208.  Now compiled without optimizer again. Subject for further
  2209. investigation.  - didn't work with MUI 2.x due to use of popscreen.mui.
  2210. Will now   display a simple string gadget then.
  2211.  
  2212. 0.70alpha
  2213. --------
  2214. - changed internal string table layout; internal string access is now
  2215. much   faster, even when strings are taken from a catalog file.  - /DCC
  2216. LIST now works.  - /WALLOPS was broken.  - Query windows can now be
  2217. opened on a different public screen.  - DCC requests are now also
  2218. accepted when sent with a "NOTICE" to accomodate   for certain buggy
  2219. DCC implementations.  - In non-alphasort mode userlist entries were
  2220. added to the top, not to   the bottom of the list.
  2221.  
  2222. 0.69alpha (quickfix)
  2223. -------------------
  2224. - subitems for the window sub menu weren't no longer added,   making
  2225. closing windows crash badly.
  2226.  
  2227. 0.68alpha
  2228. --------
  2229. - CTCP PING didn't work.  - holding down ENTER caused the same text to
  2230. be continously send.  - SHIFT-TAB will now insert "Nick: " into the
  2231. input line.  - CTRL-UP/DOWN and ALT-UP/DOWN inside a query window
  2232. caused instant crash.  - String class was, in cooperation with some MUI
  2233. bug, loosing signal bits.    This caused frame gadgets to not work any
  2234. longer.  - The bubble help of the userlist action buttons will now
  2235. display the   real command assigned to the button.  - Userlist action
  2236. buttons now work if no user is selected and no %u   was specified.  -
  2237. /ME within dialog windows will now work just like /DESCRIBE.
  2238.  
  2239. 0.67alpha
  2240. --------
  2241. - DCC windows now use tiny fonts for the lists.  - optimized TextFit()
  2242. wasn't working correctly, cutting of   characters depending on the font.
  2243. - enforcer hits with commands which had a single channel name   as a
  2244. parameter ("/NAMES #Amigager" for example).  - /RX will now find
  2245. commands in PROGDIR:Rexx - Rexx-on-Event didn't work at all - added a
  2246. few more sound samples by Robert Wilkens - the event manager now has
  2247. "Test sound" buttons - Connect and Autodownload windows shouldn't cause
  2248. trouble any more   (recycled MUIMasterBase between tasks :) - the "is
  2249. this mail or news" guess in the URL grabber   always assumed mail
  2250.  
  2251. 0.66alpha
  2252. --------
  2253. - userlist action button rows which contain no labels will now be
  2254. hidden - the first 10 window selector menu items now have shortcuts
  2255. from "0" to "9".    Allows to easily switch channel windows with
  2256. Amiga-0..9.  - serious bug in DCC-SEND; neither RESUME-ACCEPT nor
  2257. MOVE-RESUME did work   since AmIRC didn't actually seeked to the
  2258. requested file position.  - added support for TIADCC (SetEnv TIADCC
  2259. "tiahost port"). The   variable format is compatible with Tau's DCC
  2260. implementation.  - fixed a few quirks in the string input class.  -
  2261. list class is now more compatible with fonts which have a "obscure"
  2262. tf_XSize value.  - sub processes weren't properly terminated during IPC
  2263. if the main application   was forcefully quit.  - fixed drag & drop
  2264. list sort for server and alias list (MUI3 only).  - the button/info row
  2265. in query windows can now be turned off to save   visual space.  - fixed
  2266. activation state of the user list. If the current user   PARTs or gets
  2267. KICKed, selection will turn off completely. If   the current user
  2268. renames himself, the selection will follow   accordingly.
  2269.  
  2270. 0.65alpha quick fix :)
  2271. ---------------------
  2272. - String input gadget was dead with MUI 2.3.  - added a kludge to avoid
  2273. MUI 3.0's MUIA_String_MaxLen-1-Bug within the   nickname gadgets
  2274.  
  2275. 0.64alpha
  2276. --------
  2277. - fixed splitting and rejoining of lines in listview (spaces got
  2278. inserted   when a line couldn't be split on a word boundary) - main
  2279. listview now properly preserves text style attributes upon line
  2280. splits and relayouts - the ban popup list is now a "real" window which
  2281. can be dragged and sized - line read buffer pointer wasn't reset when a
  2282. server link was forcefully   terminated. Caused nonsense to appear on
  2283. next connect.  - added support for "DCC RESUME", a method of resuming
  2284. DCC SENDs   originally implemented by the mIRC for Windoze IRC client.
  2285. It's not   recommended to use DCC RESUME between AmIRCs, use MOVE
  2286. instead.  - OP/VOICE now accept up to four nicks - BAN did work with a
  2287. single nick only.  - the command parser assumed that all strings
  2288. beginning with "*"   are channel names, effectivly rendering /BAN
  2289. useless.  - KICKBAN window now has four buttons to setup "standard"
  2290. types   of ban mask (full, userhost, dynamic hostname, dynamic ip) -
  2291. CTRL-Cursor-Up/Down now allows to select the current user in   the user
  2292. list.  - TAB will now enter "/MSG nick " if the input line is empty
  2293. or just "nick" if there is already something entered in the line.  -
  2294. ALT-Cursor-Up/Down allows to scroll within the main output list.
  2295. ALT-SHIFT allows to page accordingly.  - fixed a few bugs in state
  2296. managment of the main list class.    Could cause enforcer hits when
  2297. LCM_INSERT was used before   MUIM_Show was called; this mainly occured
  2298. with the new   private message log which normally stays closed.  -
  2299. "Auto open Dialog Windows" was not functional at all.  - Function key
  2300. did only work when changed during the session, not   after loading.  -
  2301. Rexx script gathering caused entries with "PROGDIR:" to be   entered in
  2302. the list, which didn't work, cause it would   have referenced the Rexx
  2303. master process' PROGDIR: if   it would exist :) - several parts of
  2304. parsing code failed with characters > 127,   esspecially the notify
  2305. option with "strange" nicks.  - messages added to the private message
  2306. log now have a time   stamp.  - finally got around adding Troy Davis to
  2307. the thanks list   in the about requester.
  2308.  
  2309. 0.63alpha
  2310. --------
  2311. - the vertical bar in the main listview was messed up.  - added VBars
  2312. on several of the other listviews (MUI3 only) - User list action
  2313. buttons didn't used MUIA_Font_Tiny as intended.  - "Save as" with no
  2314. config name given could cause erraneous behavior   and even crashes
  2315. with some requester patches.  - manually resetting AWAY via menu state
  2316. didn't restart the auto away   timeout.  - failure to open
  2317. "rexxsyslib.library" wasn't catched and could cause   serious trouble
  2318. later on.  - fixed a severe bug in the ioctl() call in AS225 which was
  2319. called   with the AmiTCP code for FIONREAD. Caused DCC's to loop dead.
  2320. - auto reconnect to server now limited to 10 retries.  - now checks for
  2321. duplicates before adding entries to the URL grab window.  - nickname
  2322. gadgets now accept all RFC-1459 allowed nickname characters   and even
  2323. "_" :) - added help bubbles for the channel mode buttons (MUI3 only)
  2324.  
  2325. 0.62alpha
  2326. --------
  2327. - Click-On-Notify still didn't work <blush> - fixed selectwait() call
  2328. in the as225 tcp interface. DCCs are now   properly cancelable :) - /RX
  2329. did pass parameters, but only the first <blush again> - /NOTIFY did
  2330. react on parts of nicknames (e.g. "/NOTIFY OLI" reacted   on an
  2331. "OLIVER" being on) - added URL grabber; incoming text is scanned for
  2332. URLs and MessageIds,   which are presented in a list window. Double
  2333. clicking on a URL will   send them to AMOSAIC.1 via Rexx - Rexx: Using
  2334. "Say" with no open window caused terrible crash - added privmsg log
  2335. window which stores all private msgs send to you - added a few Undernet
  2336. servers to the default server list - added a few useful menu shortcuts
  2337.  
  2338. 0.61alpha
  2339. --------
  2340. - incoming/outging DCC chat requests will now no longer open the dcc
  2341. chat   list window.  - startup errors (in particular wrong arguments
  2342. passed on a shell startup)   caused destructors to be inproperly
  2343. called, resulting in dead locks.  - WHOIS-ON-NOTIFY didn't work when
  2344. the watched user was logged in   (did send "WHOIS +USER"...) - made an
  2345. attempt to fix the as225 code which seems to be crashing   on DCC
  2346. (sorry, can't check this for myself) - /RX didn't pass arguments.  -
  2347. will now no longer create an empty Rexx menu if no rexx scripts are
  2348. found (AmIRC looks into PROGDIR:Rexx/ and Rexx: for files ending with
  2349. *.AMIRX).    It's nicer and avoids nasty crashes with certain buggy
  2350. Menu hacks :)
  2351.  
  2352. 0.60alpha
  2353. --------
  2354. - channel list didn't worked at all.  - double click on an entry in the
  2355. notify list will now issue an /WHOIS nick   command.
  2356.  
  2357. 0.59alpha
  2358. --------
  2359. - AWAY flag is cleared after connection to a server.  - Autojoin
  2360. channels are now bound to the server configs. This allows you to
  2361. specify different channels for different servers.  - state of the
  2362. "Create Icons" menuitem is now saved correctly.  - "Help" menuitem
  2363. works.  - Bug in the string class caused enforcer hits and made MUIKEYS
  2364. not   working correctly.  - when the connection was lost during receive
  2365. of the channel list,   the channel listview stayed deactived.  - empty
  2366. CTCP ACTION requests are no longer displayed.
  2367.  
  2368. 0.58alpha
  2369. --------
  2370. - the light bulb's transparent color wasn't set correctly so the
  2371. background   got overwritten.  - fixed a few MUI object background
  2372. settings.  - program and basename now thoroughly changed from MICROIRC
  2373. to AMIRC.  - light bulb is now a page group to avoid MUIA_Bitmap_Bitmap
  2374. not being   correctly settable. Should also fix a potential crash.  -
  2375. added FKey support.  - String gadget is now constantly activated.  -
  2376. added "Invite" event.  - default prefs storage location is now
  2377. "PROGDIR:Default.MIRC" to   avoid problems if AmIRC is started from
  2378. another dir.  - now deiconifies upon receiving SIGBREAKF_CTRL_F
  2379.  
  2380. 0.57alpha
  2381. --------
  2382. (skipped)
  2383.  
  2384. 0.56alpha
  2385. --------
  2386. - light bulb/mic icon refresh now fixed.  - fixed QUERY windows to
  2387. correctly parse IRC formating codes on output.
  2388.  
  2389. 0.55alpha (saturday evening release, please don't wonder :-)
  2390. -----------------------------------------------------------
  2391. - fixed missing CTCP ACTION parsing for private PRIVMSGs - added
  2392. missing /DESCRIBE command.  - OP/VOICE status is now displayed with a
  2393. nice icon (thanks Morden).    The implementation of the display sucks,
  2394. it's gonna fixed in the next   release.
  2395.  
  2396. 0.54alpha
  2397. --------
  2398. - fixed a bug in WALLOPS and ERROR parsing, not outputting anything but
  2399.  causing an enforcer hit instead.  - userhost database sometimes
  2400. caused calls to FreePool() with a mismatched   size (len-1). Could
  2401. screw up pool management severly.  - now entering a server name no
  2402. longer causes the list to be sorted,   leaving input focus on an
  2403. undesired entry.  - added missing /BAN, /BANDEL and /BANLIST commands.
  2404.  
  2405. 0.53alpha
  2406. --------
  2407. - just bumped revision to avoid confusion with a "0.52alpha" floating
  2408. around.
  2409.  
  2410. 0.52alpha (not published)
  2411. ------------------------
  2412. - seperated user list now finally works without crashing badly.  - the
  2413. seperated user list windows now have a close gadget, and the channel
  2414. windows have a pop button to reopen it.  - fixed sorting of user list.
  2415. - changes of GUI settings now happen instantly. Note that MUI 2.x
  2416. requires closing and reopening of windows for some operations.  -
  2417. kludged around the userlist refresh bug by manually forcing redraw   on
  2418. every JOIN/PART.  - Auto-Rejoin-After-Kick now defaults to off due to
  2419. popular demand.
  2420.  
  2421. 0.51alpha (not published)
  2422. ------------------------
  2423. - fixed incorrect parsing of 317 extend message (signon time) - fixed a
  2424. few quirks in DCC SEND aborted output.
  2425.  
  2426. 0.50alpha
  2427. --------
  2428. - fixed a crash with certain MUI versions on SAVE.  - DCC originating
  2429. sometimes didn't work since GetHostId() reported   "127.0.0.1"
  2430. (localhost). Now falls back to reading ENV:HOSTNAME   and doing
  2431. gethostbyname() on this.  - the user list may now be hidden totally or
  2432. put to a seperate window.    Note: This isn't implemented correctly
  2433. now; i'll change it ASAP.  - the user list sorting can now be turned
  2434. off.
  2435.  
  2436. 0.49alpha
  2437. --------
  2438. - remote logging of AMIRC usage has been removed completely.
  2439.  
  2440. 0.48alpha
  2441. --------
  2442. - added event handling. Allows you to deiconify, beep or play a
  2443. (datatypes) sound on certain events.  - some internal stuff.  - added
  2444. processing of the "250" extension message.
  2445.  
  2446. 0.47alpha
  2447. --------
  2448. - fixed "DCC SEND/MOVE ABORTED" which was screwed in several places.
  2449.  
  2450. 0.46alpha
  2451. --------
  2452. - added RAW IRC output window.  - Auto-Update-Get will now
  2453. automatically extract AMIRC.ReadMe to T:,   display it and offer to
  2454. automatically unpack the gotten archive   to RAM:
  2455.  
  2456. Those Deserving Favour
  2457. **********************
  2458.  
  2459. Thanks to::
  2460. ===========
  2461.  
  2462. The author wishes to thank the following people for their help during
  2463. AmIRC development:
  2464.  
  2465. Karl 'Phalanx' Bellve
  2466.      Who provides space, connectivity and cpu time for running the
  2467.      AmIRC support area.  He also helped during development, and did
  2468.      alot of encouragement. :-)
  2469.  
  2470. Laurence 'DuRaN' Walton
  2471.      Who did write the documentation, first installer and also helped
  2472.      alot during development in other respects.
  2473.  
  2474. Christopher 'ChrisDi' Dietz
  2475.      Who did the German catalog translation.
  2476.  
  2477. Philippe 'PhB' Brand
  2478.      Who did the french catalog translation.
  2479.  
  2480. Fredrik Rambris
  2481.      Who did the swedish catalog translation.
  2482.  
  2483. Pascal 'arcade' Eeftinck
  2484.      Who did the dutch catalog translation.
  2485.  
  2486. Juan 'Goliath' Ramirez
  2487.      Who did the Spanish translation
  2488.  
  2489. Manuel 'CCCP' Giorgini
  2490.      Who did the Italian translation
  2491.  
  2492. Troy 'Doogie' Davis
  2493.      Who helped much with testing and developing the ARexx port, besides
  2494.      reporting bugs and making useful suggestions of other kinds.
  2495.  
  2496. Robert 'RobR' Reiswig
  2497.      Who did write the installer script.
  2498.  
  2499. Olaf 'Olsen' Barthel
  2500. Michael 'mlelstv' van Elst
  2501. Kenneth 'Kenneth' Jennings
  2502. David 'Deathland' Zvekic
  2503.      for their help with debugging the as225r2 code.
  2504.  
  2505. Klaus 'kmel' Melchior
  2506.      for his help with tracking down several MLink problems.
  2507.  
  2508. Andreas M. 'bonzo' Kirchwitz
  2509.      for useful advice and showing a good load of humor during the
  2510.      //KICKBAN test.
  2511.  
  2512. Ralph 'rbabel' Babel
  2513.      who helped to track down a nasty bug in slink's constructor
  2514.      priority ordering.
  2515.  
  2516. The SAS/C Amiga Development team
  2517. (Especially Steve Krueger)
  2518.      For their continued support of teh SAS/C Compiler
  2519.  
  2520. Holger 'hkr' Kruse
  2521.      who pointed out the easy solution to the WTF is my own IP
  2522.      number? problem
  2523.  
  2524. Jason 'morden' Murray
  2525. Robert 'Devo' Bradman
  2526.      who drew the OP and VOICE icons
  2527.  
  2528. Angela 'Nessy' Schmidt
  2529. Christoph 'Pepo' Feck
  2530. Sascha 'Master' Lentz
  2531.      who helped test several AmIRC features in a real-life environment
  2532.      (say #AmigaGER ;-)
  2533.  
  2534. The IRC admin at irc.uni-paderborn.de
  2535. (Thomas 'Heager' Thissen)
  2536.      which served as the primary test site
  2537.  
  2538. Brian 'SmknDHerb' Maurino
  2539. Sandro 'Sandro' Catallo
  2540. Robert 'Gostrider' Wilkins
  2541.      Who created and compiled the demo sounds
  2542.  
  2543. Fionn 'Fionn' Behrens
  2544. Frank 'Daddie' Peters
  2545. Holger 'Heureka' Jakob
  2546. Jens 'Jens' Hünerberg
  2547. Mathias 'Merlin' Mischler
  2548. Michael 'mickh' Hohmann
  2549. Nicole 'Talyn' Brandt
  2550. Peter 'Stoebi' Schulz
  2551. Roy 'AK' Millican
  2552. Thomas 'logo' Butter
  2553.      for early testing and design suggestions
  2554.  
  2555. Christoph 'CeeGee' Gülicher
  2556. Danny 'Danny' Amor
  2557. Markus 'Ill' Illenseer
  2558. Markus 'Lammy' Lamers
  2559. Matthias 'DrMabuse' Lühr
  2560.      who simply bugged me to get on the list :)
  2561.  
  2562. Osma 'Tau' Ahvenlampi
  2563.      The major inspiration for the IGNORE support in AmIRC
  2564.  
  2565. This Document Prepared by Laurence Walton
  2566.  
  2567. ©1995 Oliver Wagner
  2568. All Rights Reserved
  2569.  
  2570. How to Report Bugs
  2571. ******************
  2572.  
  2573. Bug Reports
  2574. ===========
  2575.  
  2576.  
  2577.      Please send bug reports to AmIRC@lsd.wupper.de, not to my
  2578.      standard mailbox.  Include in the report the OS version of your
  2579.      amiga, The version of MUI that you have installed, and the version
  2580.      of AmIRC that you are using.
  2581.      
  2582.      Problems or additions of the AmIRC documentation should be directed to:
  2583.      
  2584.      lww@pgh.net
  2585.  
  2586. Problems, Causes, & Cures
  2587. *************************
  2588.  
  2589. Known Bugs
  2590. ==========
  2591.  
  2592.    * A patch designed to eliminate requestors, easypatch,  will cause
  2593.      AmIRC .88 to crash.
  2594.  
  2595.    * The main window sometimes doesn't refresh properly when
  2596.      SIMPLE_REFRESH is used.  Known bug in MUI 2.3's listview refresh
  2597.      sometimes throwing away damage regions.  Fixed in MUI 3.
  2598.  
  2599.    * Lockup when using Magic Menu. Install NewObtainGIRPort to cure
  2600.      this.  NewObtainGIRPort is available from aminet or from the AmIRC
  2601.      home page.  In older readme's, I suggested using SafeGIRPort, but
  2602.      there were reports that this won't really help the problem. Sorry,
  2603.      I don't use Cycle2Menu or MagicMenu and never had any problems
  2604.      with this myself.
  2605.  
  2606.    * The user list get's messed up. Known bug in MUI 2.3's listview's
  2607.      REMOVE method. Fixed in MUI 3.
  2608.  
  2609.    * There are various problems when using AmIRC as a CLChat (ArcNet)
  2610.      client.  These are all caused by bugs within CLChatIRCD and can't
  2611.      be fixed on AmIRC's side.
  2612.  
  2613.    * ALT-CURSOR-UP/DOWN doesn't work with MultiCX. MultiCX's "advanced
  2614.      Edithook" will eat Cursor-UP/Down-Inputevent on it's own so they
  2615.      can't be processed by AmIRC. Use a different edit hook.
  2616.  
  2617.    * ZFREQ causes AmIRC to fail upon start. ZFREQ seems to be unable to
  2618.      bear an application allocating a real huge number of
  2619.      ASL_Filerequest structures. Use a different file requester patch.
  2620.  
  2621.    * Neither HILITE nor URL-Grabber work on text written by yourself.
  2622.      This is due to internal reasons, I'm not sure if it is worth
  2623.      changing.
  2624.  
  2625. How to Get Help & Updates
  2626. *************************
  2627.  
  2628. One Click Updates
  2629. =================
  2630.  
  2631. You can easily download the latest version of AmIRC from the official
  2632. AmIRC support site by choosing the 'About...' Menu item from the
  2633. 'AmIRC' menu. Here you will Find a gadget Labeled 'Download Latest
  2634. version of AmIRC'.  By clicking this gadget, AmIRC will check the
  2635. support site for the version of AmIRC there. If it is newer than the
  2636. version you are using, it will proceed to download it for you. If it is
  2637. the same version, you will be notified of this, and the download will
  2638. be aborted.  Once the new archive has been downloaded, You will be
  2639. shown the latest 'AmIRC.readme', and you will be given the option of
  2640. unarchiving the release to ram. NOTE: You must have LHA in your c:
  2641. directory for this functon to operate.  Once you have done this, just
  2642. overwrite the old AmIRC files with the new ones. Your configuraton
  2643. files will remain unchanged.
  2644.  
  2645.     NOTE: The auto update will only download a stripped version of the
  2646. archives, because this assumes you have already installed the full
  2647. version of AmIRC.  with auto update, you will receive the executables
  2648. and any updated documents.
  2649.  
  2650. Support
  2651. =======
  2652.  
  2653.     AmIRC Support Mailing List
  2654.  
  2655.      To keep up to date on AmIRC improvements or to get answers to AmIRC
  2656.      problems, Join the AmIRC support mailing list by sending email to:
  2657.      
  2658.      AmIRC-Request@lsd.wupper.de
  2659.      with the text "Add" in the body.
  2660.      
  2661.      
  2662.      AmIRC FTP Support Site
  2663.      
  2664.      For AmIRC Updates & Patches, ftp to:
  2665.      
  2666.      ftp.vapor.com/support/amirc/
  2667.      
  2668.      AmIRC Support on the World Wide Web
  2669.      
  2670.      Or, Alternatively, Visit the AmIRC WWW Support Site at:
  2671.      
  2672.      http://www.vapor.com/support/amirc/
  2673.  
  2674. Index
  2675. *****
  2676.  
  2677.  
  2678.  
  2679.  #amiga                                 IRC
  2680.  Actions Options                        Actions
  2681.  Aliases, setting up                    Lists
  2682.  AmIRC Menu                             AmIRC
  2683.  AmIRC Support                          AmIRC Support
  2684.  ARexx Menu                             Rexx
  2685.  ARexx Reference                        ARexx
  2686.  Away, Setting                          AWAY
  2687.  Bugs, Known                            Known Bugs
  2688.  Bugs, Reporting                        Bug Reports
  2689.  Channel Modes, changing                MODE
  2690.  Commands                               Commands
  2691.  Configuration Options                  AmIRC Setup
  2692.  Configuration with MUI                 MUI Preferences
  2693.  Configuring AmIRC                      Configuration
  2694.  Connecting to an IRC server            Connecting
  2695.  Contents, Table of                     Top
  2696.  Copyright Information                  Copyright
  2697.  Credits                                Credits
  2698.  CTCP                                   CTCP
  2699.  DCC                                    DCC
  2700.  Events Options                         Events
  2701.  Features Of AmIRC                      Features
  2702.  Function Keys, Setting up              Function Keys
  2703.  GUI Options                            GUI
  2704.  Hilighting certain text                Lists
  2705.  Igoring Users                          Lists
  2706.  Installing AmIRC                       Installation
  2707.  Inviting a user to a channel           INVITE
  2708.  IRC                                    IRC
  2709.  IRC Terminology                        IRC Terms
  2710.  Joining a channel                      JOIN
  2711.  Kicking a user from a channel          KICK
  2712.  Known Bugs                             Known Bugs
  2713.  Leaving a channel                      LEAVE
  2714.  LIsting Channels                       LIST
  2715.  Listing names on IRC                   NAMES
  2716.  Listing Users on a server              USERS
  2717.  Lists Menu                             Lists
  2718.  Logging Channel Text                   LOG
  2719.  Menus                                  Menus
  2720.  Messages options                       Messages
  2721.  MUI Configuration                      MUI Preferences
  2722.  MUI, About                             About MUI
  2723.  Net Etiquette                          IRC
  2724.  Nickname, Changing                     NICK
  2725.  Nickname, Setting                      NICK
  2726.  Notice, Sending                        NOTICE
  2727.  Operating AmIRC                        Operation
  2728.  Pattern matching of users              WHO
  2729.  Private message, sending               MSG
  2730.  Quitting IRC                           QUIT
  2731.  Raw text, sending                      RAW
  2732.  Registering AmIRC                      Registration
  2733.  Reporting Bugs                         Bug Reports
  2734.  Requirements for running AmIRC         Requirements
  2735.  Revision History                       Revision History
  2736.  Settings Menu                          Settings
  2737.  Settings menu: Actions                 Actions
  2738.  Settings Menu: Events                  Events
  2739.  Settings Menu: GUI                     GUI
  2740.  Settings Menu: Messages                Messages
  2741.  Support for AmIRC users                AmIRC Support
  2742.  Thanks to...                           Credits
  2743.  Time, getting server's                 TIME
  2744.  Topic, Changing the                    TOPIC
  2745.  User Modes Menu                        User Modes
  2746.  User's, finding more info on           WHOIS
  2747.  User, checking if on                   ISON
  2748.  Userhost, finding a user's             USERHOST
  2749.  Version, server's software             VERSION
  2750.  What is IRC                            IRC
  2751.  Who Was User                           WHOWAS
  2752.  Windows Menu                           Windows
  2753.  
  2754.