home *** CD-ROM | disk | FTP | other *** search
/ A Beginner's Guide to the Internet / INTERNET.ISO / text / irc / info / irc.tut < prev    next >
Encoding:
Text File  |  1996-05-06  |  30.2 KB  |  1,023 lines

  1. [Note: all 3 parts have been concatenated into one file]
  2.  
  3. Subject: IRC Tutorial Part 1
  4.  
  5. July 26th, 1991 - written by Ronald van Loon (rvl).
  6.  
  7. [ PART ONE : BASIC COMMANDS, PRIVATE CONVERSATIONS ]
  8.  
  9. IRC for beginners - an introduction
  10. ===================================
  11.  
  12. [NOTE: IRC II, the client we are using in our group, has most
  13. of this information on-line. If you are stuck, type /HELP and
  14. hit return - if that doesn't work, just try again till it does.
  15. To escape from /HELP mode, keep pressing return until your edit
  16. line (the line at the bottom of the screen) is empty.]
  17.  
  18. Most of the information in this file can be found in the following
  19. files :
  20.  
  21. /HELP INTRO
  22. /HELP NEWUSER
  23.  
  24. IRC - what is it
  25. ================
  26.  
  27. Irc is a multi-user, multi-channel chatting network.  It allows
  28. people all over the internet to talk to one another in real-time.
  29. Each irc user has a nickname they use.  All communication with
  30. another user is either by nickname or by the channel that they or
  31. you are on. 
  32.  
  33. More about channels later on.
  34.  
  35. IRC - some basics
  36. =================
  37.  
  38. IRC is based on a client-server model. Clients are programs that 
  39. connect to a server, a server is a program that transports data
  40. (messages) from one user (client) to another. The client we use
  41. at 3DCV is called IRC II (version 2.1.x), originally written by
  42. Michael Sandrov.
  43.  
  44. IRC II
  45. ======
  46.  
  47. All IRCII commands begin with a "/" character. 
  48. Anthing that does not begin with a / is assumed to be a message
  49. to someone and send to your current channel, or to a person you
  50. are QUERYing. In the following I will describe the more common
  51. commands used in every-day IRC-life.
  52.  
  53. If you are not sure about the spelling of an IRC II command,
  54. type the prefix of that command - and press the ESCape key twice.
  55. IRC II (from now on IRC) will give you a listing of COMMANDS and
  56. ALIASes that start with that prefix. Don't forget the "/" in front
  57. of the command, though.
  58.  
  59. Example :
  60.  
  61. /W <ESC><ESC>
  62.  
  63. IRC: *** Commands:
  64. IRC: ***     WAIT           WALLOPS        WHILE          WHO
  65. IRC: ***     WHOIS          WHOWAS
  66. IRC: *** Aliases:
  67. IRC: ***     W              WA             WH             WI
  68. IRC: ***     WLOFF          WLOG           WLON           WS
  69.  
  70. [Note : This is an example. Your screen may show more Aliases,
  71. and less Commands than shown here, or less Aliases and more
  72. Commands - in other words "your mileage may vary" ;-)]
  73.  
  74. BASIC IRC COMMANDS
  75. ==================
  76.  
  77. In the following, everything you have to type is preceded with a
  78. colon (:), everything that the client program does is preceded
  79. with IRC: 
  80.  
  81.     -----
  82.  
  83.     /LIST        Lists all current irc channels, number of
  84.             users, and topic.
  85.     ----- Example :
  86.  
  87.     : /LIST
  88.  
  89. IRC: *** Channel    Users  Topic
  90. IRC: *** +test      1      this is a test channel
  91. IRC: *** #KOFFIE    1
  92.  
  93.     -----
  94.  
  95.     /NAMES        Shows the nicknames of all users on each
  96.             channel
  97.     ----- Example :
  98.  
  99.     : /NAMES
  100.  
  101. IRC: Pub: +test      @rvloon
  102. IRC: Prv: *          ronaldvl fred
  103.  
  104.     -----
  105.  
  106.     /NICK <new_nick> Change your nickname (everyone who wants to talk to
  107.              you sees this name - also, at the moment, nicknames
  108.              are limited to 9 characters max. Your nickname will
  109.              be the same as your login by default. You can also
  110.              set an environment variable, IRCNICK, which value 
  111.              will be used instead.)
  112.  
  113.     ----- Example:
  114.  
  115.     : /NICK harry
  116.  
  117. IRC: *** rvloon is now known as harry
  118.  
  119.     -----
  120.  
  121.     /QUIT        Exits irc. You can also use /BYE, /SIGNOFF and /EXIT.
  122.  
  123.     -----
  124.  
  125.     /HELP <topic>    Gets help on all IRCII commands.
  126.  
  127.     ----- Example :
  128.  
  129.     : /HELP HELP
  130.  
  131. IRC: *** Help on HELP
  132. IRC: Usage: HELP [command]
  133. IRC:   Shows help on the given command.
  134.  
  135.      [ To save space, rest of explanation deleted ]
  136.     
  137.     -----
  138.  
  139.     /WHOIS <nick>    Shows the "true" indentity of someone
  140.  
  141.     ----- Example : 
  142.     
  143.     : /WHOIS fred
  144.  
  145. IRC:*** fred is fred@131.211.145.24 (Fred Appelman) on channel *private*
  146. IRC:*** on irc via server prisma.cv.ruu.nl (The CV stand-alone IRC-server)
  147. IRC:*** Command last received: 6322 :is the idle time f
  148.  
  149.     -----
  150.  
  151.     /AWAY <away-message> Leave a message explaining that you are not currently
  152.              paying attention to IRC.
  153.  
  154.     ----- Example :
  155.  
  156.     : /AWAY I am answering Mother Nature's call. Back in 5 minutes.
  157.  
  158. IRC: You have been marked as being away
  159.  
  160.     -----
  161.  
  162.     /AWAY without any additional argument will remove the away-message.
  163.  
  164.     ----- Example :
  165.  
  166.     : /AWAY
  167.  
  168. IRC: You are no longer marked as being away
  169.  
  170.     -----
  171.  
  172. COMMUNICATION - PRIVATE CONVERSATIONS
  173. =====================================
  174.  
  175.     Use the /MSG command (usually /M is an alias for /MSG) to send someone
  176.     a message that only that person can read.
  177.  
  178.     Usage :
  179.  
  180.     -----
  181.  
  182.     /MSG <nick> <msg> 
  183.  
  184.     ----- Example :
  185.  
  186.     : /MSG rvloon Where did you put the Motif C++ headerfiles ?
  187.  
  188.     This will appear on your screen as :
  189.  
  190. IRC: -> *rvloon* Where did you put the Motif C++ headerfiles ?
  191.  
  192.     And on rvloon's screen as :
  193.  
  194. IRC: *YourName* Where did you put the Motif C++ headerfiles ?
  195.  
  196.     (provided your nickname is "YourName" of course).
  197.  
  198.     -----
  199.  
  200.     To answer to such a message, you have two options :
  201.  
  202.     1) You type /MSG <nick_of_person_who_sent_you_the_message> <reply>
  203.     2) You type /MSG , <reply>
  204.  
  205.     The comma (,) is an abbreviation for "last person who sent me a
  206.     message". In a similar fashion, the dot (.) in a /MSG command is
  207.     an abbreviation for "last person who I sent a message".
  208.  
  209. QUERY
  210. -----
  211.  
  212.     You can have a private conversation by only using /MSG. However, typing
  213.     "/MSG ," or "/MSG <nick>" gets cumbersome. That's where the QUERY command
  214.     comes in handy.
  215.  
  216.     Usage :
  217.  
  218.     /QUERY <nick>
  219.  
  220.     All subsequent text will be send as private messages to <nick> ; all
  221.     subsequent text, that is everything you type in the bottom line which
  222.     doesn't start with a '/'. Also, messages are not sent until you press
  223.     <RETURN> or <ENTER>.
  224.  
  225.     Use /QUERY with no arguments to end a private conversation.
  226.  
  227.     I will now show you an example of a private conversation, and the output
  228.     on both screens :
  229.  
  230. 1)  : /NAMES
  231. 2)  : /QUERY rvloon
  232. 3)  : Goodmorning
  233. 4)  : Pretty good, even the weather's fine
  234. 5)  : /WHOIS rvloon
  235. 6)  : I have to get back to work, I'll drop by later
  236. 7)  : /QUERY
  237.  
  238.     Output on my screen :
  239.  
  240. 1)  Prv: *                              ronaldvl rvloon
  241. 2)  *** Starting conversation with rvloon
  242. 3)  -> *rvloon* Goodmorning
  243.     *rvloon* morning, how is life ? 
  244. 4)  -> *rvloon*  Pretty good, even the weather's fine
  245. 5)  *** rvloon is rvloon@131.211.145.35 (Ronald van Loon) on channel *private*
  246. 5)  *** on irc via server prisma.cv.ruu.nl (The CV stand-alone IRC-server)
  247. 5)  *** Command last received: 46 :is the idle time for
  248.     *rvloon* do you have time for some coffee ? 
  249. 6)  -> *rvloon* I have to get back to work, I'll drop by later
  250. 7)  *** Ending conversation with rvloon
  251.  
  252.     Output on rvloon's screen :
  253.  
  254. 3)  *YourName* Goodmorning
  255.     -> *YourName* morning, how is life ?
  256. 4)  *YourName*  Pretty good, even the weather's fine
  257.     -> *YourName* do you have time for some coffee ?
  258. 6)  *YourName* I have to get back to work, I'll drop by later
  259.  
  260. [ END OF PART ONE. PART TWO WILL DEAL WITH PUBLIC CONVERSATION ]
  261.  
  262. Ronald van Loon (rvloon@cv.ruu.nl, rloon@cs.ruu.nl) 
  263.  
  264. 3D Computer Vision Research Group, Utrecht University,
  265. Utrecht, The Netherlands.
  266.  
  267.  
  268.  
  269. Subject: IRC Tutorial Part 2
  270.  
  271. Written by Ronald van Loon, July 31, 1991 (IRCNICK : rvl)
  272.  
  273. [ PART TWO : PUBLIC CONVERSATIONS, CHANNELS AND CHANNEL MODES ]
  274.  
  275. Most of the information in this file can also be obtained by issuing:
  276.  
  277. /HELP CHANNEL
  278. /HELP MODE
  279.  
  280. and in the /HELP-files to the various commands.
  281.  
  282. Recap
  283. =====
  284.  
  285. In part one, I talked about the basic commands used in IRC and how
  286. you could have a private conversation with someone. In the following I
  287. will assume you have read and understood Part One. If you don't, contact
  288. your local IRC-operator or server-administrator. Information on how you
  289. can find out who he/she is, can be found below.
  290.  
  291. Definitions
  292. ===========
  293.  
  294.    IRC-ADMIN - Person who has access to all files concerning ircd (the server
  295.            program).
  296.    IRC-OPER  - Person who has privileges given to him by an IRC-ADMIN - 
  297.            someone who tries to maintain a fast reliable IRC network.
  298.  
  299.    USER      - Person who is using IRC.
  300.  
  301. More basic commands
  302. ===================
  303.  
  304. The following list of commands deal with servers and clients in general.
  305.  
  306. Unless otherwise stated, all commands take an optional argument ; this
  307. argument specifies the server on which you want the command applied.
  308.  
  309.      -----
  310.  
  311.      /LINKS     Shows all of the servers currently connected to the irc
  312.                 network.  If servername is specifed, LINKS shows any servers
  313.             that match the given servername.  The servername may contain
  314.             wildcards.
  315.  
  316.      -----  Example :
  317.  
  318.      : /LINKS *.com
  319.  
  320. IRC: *** *.Spies.COM : [wiretap.spies.com] :<--- on the OTHER side
  321. IRC: *** Spies.COM : <--- on YOUR side
  322. IRC: *** world.std.com : The World @ Software Tool & Die
  323. IRC: *** Firewall.Nielsen.Com : [138.108.101.10] :AC Nielsen, Bannockburn IL
  324. IRC: *** mips.mitek.com : OpenConnect Systems Server, Dallas, (2.6pre19.p1)
  325.  
  326.      -----
  327.  
  328.      /ADMIN     Displays the administrative details about a server.
  329.         Usually this will give you an e-mail address you can use to
  330.         ask questions. 
  331.  
  332.      ----- Examples :
  333.  
  334.      : /ADMIN
  335.  
  336. IRC: ### Administrative info about fysak.fys.ruu.nl
  337. IRC: ### Dept. of Physics and Astronomy
  338. IRC: ### Rijks Univeristeit Utrecht, the Netherlands
  339. IRC: ### Peter Mutsaers <muts@fys.ruu.nl>
  340.  
  341.      : /ADMIN world.std.com
  342.  
  343. IRC: -world.std.com- ### Administrative info about world.std.com
  344. IRC: -world.std.com- ### The World @ Software Tool & Die
  345. IRC: -world.std.com- ### Brookline, MA, USA
  346. IRC: -world.std.com- ### Spike <spike@world.std.com>
  347.  
  348.      ------
  349.  
  350.      /MOTD      Gives the message-of-the-day for a server.
  351.  
  352.      ------ Example :
  353.  
  354.      : /MOTD world.std.com
  355.  
  356. IRC: -world.std.com- MOTD - world.std.com Message of the Day -
  357. IRC: -world.std.com- MOTD - Be careful out there...
  358. IRC: -world.std.com- MOTD -
  359. IRC: -world.std.com- MOTD - ->Spike
  360. IRC: -world.std.com- * End of /MOTD command.
  361.     
  362.     -------
  363.  
  364.      /USERS     Displays the list of users currently logged in on the server's
  365.         home-machine.
  366.  
  367.      ------ Examples :
  368.  
  369.      : /USERS
  370.  
  371. IRC: UserID   Terminal  Host
  372. IRC: marjo    ttyi0     prisma.cv.ruu.n
  373. IRC: rootb    pty/ttys0 gandalf
  374. IRC: gash     pty/ttys1 kameleon
  375. IRC: fred     pty/ttys2 gandalf
  376. IRC: gash     pty/ttys4 kameleon
  377. IRC: koen     pty/ttys5 drogo
  378. IRC: marjo    pty/ttys6 brutus
  379. IRC: fred     ttyp1     gandalf:0.0
  380. IRC: marjo    ttyp2     brutus:0.0
  381.  
  382.      ------ 
  383.  
  384.      /TIME      Displays the current (local) time on the servermachine.
  385.      /DATE      /DATE and /TIME are identical.
  386.  
  387.      ------ Examples :
  388.  
  389.      : /TIME
  390.  
  391. IRC: *** prisma.cv.ruu.nl : Wednesday July 31 1991 -- 16:11 MET
  392.  
  393.      : /TIME *.au
  394.  
  395. IRC: *** munagin.ee.mu.OZ.AU : Thursday August 1 1991 -- 00:12 EST (from *.AU)
  396.  
  397.      : /TIME *.jp
  398.  
  399. IRC: *** utsun.s.u-tokyo.ac.jp : Wednesday July 31 1991 -- 23:12 JST (from
  400. IRC:     utsun.s.u-tokyo.ac.jp)
  401.  
  402.      : /TIME *.edu
  403.  
  404. IRC: *** polaris.ctr.columbia.edu : Wednesday July 31 1991 -- 10:13 EDT (from
  405. IRC:     polaris.ctr.columbia.edu)
  406.  
  407.      ------
  408.  
  409.      /LUSERS  Gives a brief listing of the number of users, the number
  410.               of servers and the number of operators.
  411.      
  412.      ------ Example :
  413.  
  414.      : /LUSERS
  415.  
  416. IRC: *** There are 210 users on 123 servers
  417. IRC: *** 33 users have connection to the twilight zone
  418.  
  419.      -------
  420.  
  421. Public Conversations
  422. ====================
  423.  
  424. In IRC, there are a lot of places where you can 'hang out' - those places are
  425. called channels. You can compare conversations on a channel to a conversation
  426. among a group of people : you see/hear everything that is said, and you can 
  427. reply to anything that's said. What you type is received by everyone who's 
  428. willing to listen - and everyone who is late will not hear what is said before
  429. unless repeated by one of the ones who were there (who said 'real life'). But
  430. I digress. 
  431.  
  432. All channels on IRC have names. There are two type of channel names, numeric
  433. channel names (all digits) like 42, -40 and 666, and string-channel names,
  434. beginning with either a '+' or a '#' sign (explained below) followed by some
  435. kind of text-string, like '+C++' or '#COFFEE' or '+Motif_1.1.1'. Usually,
  436. the name of the channel will indicate the type of conversation that's going on
  437. in there. Don't count on it, though.
  438.  
  439. Every channel has certain characteristics, called channel modes. These will
  440. also be explained below.
  441.  
  442. First of all, recall the /NAMES and /LIST commands from Part One of this
  443. tutorial ; they will show you the names of existing channel.
  444.  
  445. To join in the conversation on a certain channel you use the /JOIN command.
  446.  
  447.       ------
  448.  
  449.       /JOIN <channel> Changes your current channel to the channel specified.
  450.               /CHANNEL and /JOIN are identical.
  451.  
  452.               If the channel did not exist already, it will be created
  453.               and you will be in charge of the new channel
  454.               (Channeloperator).
  455.  
  456.       ------
  457.  
  458.       I will know show you the example from tutorial Part One, as a public
  459.       conversation on a channel.
  460.  
  461.  
  462. 1)  : /NAMES
  463. 2)  : /JOIN +demo
  464. 3)  : Goodmorning
  465. 4)  : Pretty good, even the weather's fine
  466. 5)  : /WHOIS rvloon
  467. 6)  : I have to get back to work, I'll drop by later
  468. 7)  : /JOIN 0
  469.  
  470.     The output on my screen :
  471.  
  472. 1)  Prv: *                              YourName rvloon
  473. 2)  *** YourName has joined channel +demo
  474. 2)  *** Users on +demo: @Yourname
  475.     *** rvloon has joined channel +demo
  476. 3)  > Goodmorning
  477.     <rvloon> Morning, how is life ?
  478. 4)  > Pretty good, even the weather's fine
  479. 5)  *** rvloon is rvloon@131.211.145.35 (Ronald van Loon) on channel +demo
  480. 5)  *** on irc via server prisma.cv.ruu.nl (The CV stand-alone IRC-server)
  481. 5)  *** Command last received: 32 :is the idle time for this user
  482.     <rvloon> do you have time for some coffee ?
  483. 6)  > I have to get back to work, I'll drop by later
  484. 7)  *** YourName has left channel +demo
  485.  
  486.     The output on rvloon's screen :
  487.  
  488.     *** rvloon has joined channel +demo
  489. 3)  <YourName> Goodmorning
  490.     > Morning, how is life ?
  491. 4)  <YourName> Pretty good, even the weather's fine
  492.     > do you have time for some coffee ?
  493. 6)  <YourName> I have to get back to work, I'll drop by later
  494. 7)  *** YourName has left channel +demo
  495.  
  496.     ------
  497.  
  498.     It is also possible, when you are already on a channel, to ask someone to
  499.     join your channel. The command is called /INVITE. 
  500.  
  501.     ------
  502.  
  503.     /INVITE <nickname> [channel] Invites another user to a channel. If no
  504.                  channel is specified, your current channel
  505.                  is used. In that case, you have to be on a
  506.                  channel for this to work.
  507.  
  508.     ------ Examples :
  509.  
  510.     : /INVITE rvloon +test
  511.  
  512. IRC: *** Inviting rvloon to channel +test
  513.  
  514.     On rvloon's screen the following text will appear :
  515.  
  516.     *** rvloon invites you to channel +test
  517.  
  518.     : /INVITE rvloon
  519.  
  520.     If you are on channel +demo :
  521.  
  522. IRC: *** Inviting rvloon to channel +demo
  523.  
  524.     If you are not on any channels :
  525.  
  526. IRC: *** You have not joined any channel
  527.  
  528.     ------
  529.  
  530.     If you receive an /INVITE message, you have the following options if you
  531.     want to join the channel you were invited to :
  532.  
  533.     ------
  534.  
  535.     /JOIN -INVITE      Join the channel to which you were last invited.
  536.  
  537.     ------
  538.    
  539.     Or type /JOIN <channelname>.
  540.  
  541.     Finally, there is a third flavor of the /JOIN command :
  542.  
  543.     ------
  544.  
  545.     /JOIN -NICK <nick> Join the channel that the specified nickname is on.
  546.  
  547.     ------
  548.     
  549.     If you issue a /JOIN command without any parameters, your current channel
  550.     is displayed.
  551.  
  552.     You can leave a channel by :
  553.  
  554.     - issuing a /JOIN 0 (see explanation below)
  555.     - issuing a /LEAVE <channelname>
  556.  
  557. Topics
  558. ======
  559.  
  560. Channels have topics, that indicate the current topic of conversation. You
  561. can change the topic on a channel with the /TOPIC command.
  562.  
  563.     ------
  564.  
  565.     /TOPIC <topic for channel> Changes the topic for your current channel.
  566.  
  567.     ------ Example : 
  568.  
  569.     : /TOPIC testing
  570.  
  571. IRC: *** rvloon has changed the topic to "testing"
  572.  
  573. Types of Channels
  574. =================
  575.  
  576. There are different types of channels. I will discuss them all and list their
  577. various virtues.
  578.  
  579. Limbo/NULL
  580. ----------
  581. Channel 0 is the NULL channel, or "limbo" channel. This is the channel you are
  582. on by default. You can compare this channel to /dev/null on UNIX systems -
  583. everything said on this channel is lost. You enter this channel if you don't
  584. want to leave IRC, but also don't want to join in any conversation. 
  585.  
  586. Public
  587. ------
  588.  
  589. Channels between 1 and 999 (numeric) and "+"-channels are public by default -
  590. public means that everyone can see the channel in the /NAMES and /LIST lists.
  591. Public also means that everyone can join that particular channel.
  592.  
  593. Private
  594. -------
  595.  
  596. Channels 1000 and up are private by default - private means that the channel
  597. is shown as "Prv" in the /NAMES and /LIST lists. People who don't know the
  598. name of the channel are not able to /JOIN. "+" channels can be made Private
  599. with the /MODE command - described below.
  600.  
  601. Secret
  602. ------
  603.  
  604. Channels below 0 are secret channels - secret means that the channel will not
  605. show up in the /NAMES and /LIST lists at all. "+" channels can be made Secret
  606. with /MODE command - described below. People on secret channels are also not
  607. counted in /LUSERS, and not shown in /NAMES either.
  608.  
  609. Additional channel flavors
  610. ==========================
  611.  
  612. Channels can have additional constraints, which can be set by the /MODE
  613. command. To understand this, recall that the first person to /JOIN a channel
  614. effectively creates it and is initially "in charge" of the channel. (Channel
  615. operator). He can subsequently add those constraints, make other people
  616. channeloperator at leisure.
  617.  
  618. Moderated
  619. ---------
  620.  
  621. The only people who talk on a moderated channel, are channel operators. Useful
  622. for conferencing (the chairman is the one who will grant chanop-status for the
  623. current speaker). Other people can only listen.
  624.  
  625. Limited
  626. -------
  627.  
  628. The number of people allowed to /JOIN the channel is limited to a certain
  629. number of people.
  630.  
  631. Topic Limited
  632. -------------
  633.  
  634. The only people allowd to change the topic on a channel are chanops.
  635.  
  636. Invite only
  637. -----------
  638.  
  639. People can only join your channel if they're /INVITEd by someone on your
  640. channel.
  641.  
  642. Message Disabled
  643. ----------------
  644.  
  645. People cannot send messages to your channel with the /MSG command.
  646.  
  647. Most of the above modes can be combined.
  648.  
  649. Changing channel modes
  650. ======================
  651.  
  652. If you are a channeloperator, you can change the status of the channel with
  653. the /MODE command. The syntax of /MODE is :
  654.  
  655.       /MODE <channelname> +<modechars> <parameters>
  656.  
  657.       Add constraints to channel <channelname>
  658.  
  659.       /MODE <channelname> -<modechars> <parameters>
  660.  
  661.       Remove constraints from channel <channelname>
  662.  
  663.       You have to be channeloperator on <channelname> for this to work.
  664.  
  665.       <Modechars> can be one of the following :
  666.  
  667.       m           - make channel moderated
  668.       s           - make channel secret
  669.           p           - make channel private
  670.       l <number>  - make channel limited, where <number> is the
  671.             maximum number of users allowed
  672.           t           - make channel topic limited
  673.       o <nick>    - Makes <nick> a channel operator
  674.       i           - channel is invite only
  675.       n           - No MSGs to the channel are allowed (Message disabled)
  676.  
  677.      ------ Example :
  678.  
  679.      : /MODE +demo +p
  680.  
  681. IRC: *** Mode change "+p " on channel +demo by rvloon
  682.  
  683.      This will make channel +demo private.
  684.  
  685.      : /MODE +demo +l 10
  686.  
  687.      This will limit the +demo channel to maximum 10 people at the same time.
  688.  
  689. [ END OF PART TWO ; PART THREE WILL DEAL WITH VARIABLE SETTINGS IN IRCII ]
  690.  
  691.  
  692. Subject: IRC Tutorial Part 3
  693.  
  694. Written by Ronald van Loon, August 27, 1991 (IRCNICK : rvl)
  695.  
  696. [ PART THREE : CUSTOMIZING YOUR OWN ENVIRONMENT - VARIABLES AND DEFAULTFILES ]
  697.  
  698. Most of the information in this file can be obtained by issuing :
  699.  
  700. man irc 
  701. (NOTE : does not work when using the irc-program !)
  702.  
  703. /HELP SET
  704. /HELP SET <variable-name>
  705.  
  706. Prerequisites
  707. =============
  708.  
  709. In this part, I will assume the following :
  710.  
  711. - You have read Part One and Part Two of this introduction, and you understand
  712.   most of it ; you know how to deal with messages send to you, and how to have 
  713.   conversations with people on channels.
  714.  
  715. - You know what environment variables are and how to set them ; if you don't,
  716.   a brief recap of the procedure follows below - you should however, go out
  717.   and read a book on UNIX.
  718.  
  719.   Issue the following command :
  720.  
  721.   echo $SHELL
  722.  
  723.   if the computer's response is :
  724.  
  725.   .../sh or : .../bash or : .../ksh
  726.  
  727.   (where ... is a directory name (usually /bin))
  728.  
  729.   then use the following :
  730.  
  731.   <VARIABLE_NAME>="<value>" ; export <VARIABLENAME>
  732.  
  733.   ---- Example :
  734.  
  735.   IRCNAME="Ronald van Loon" ; export IRCNAME 
  736.  
  737.   (This sets the variable 'IRCNAME' to the value 'Ronald van Loon' and makes
  738.    its value available to all programs)
  739.  
  740.   In all (?) other cases, (.../csh .../tcsh etc.)
  741.  
  742.   setenv <VARIABLE_NAME> "<value>"
  743.  
  744.   ---- Example :
  745.  
  746.   setenv IRCNAME "Ronald van Loon"
  747.  
  748.   To make sure what you did was correct, issue the :
  749.  
  750.   echo $<VARIABLE_NAME>
  751.  
  752.   command, the computer's response should be the value you just gave it.
  753.  
  754.   This should be enough to help you understand, or in any case use the 
  755.   information in the next section.
  756.  
  757. IRC II and Environment Variables
  758. ================================
  759.  
  760. IRC II will use the values of the following environmentvariables, if set :
  761.  
  762. IRCNICK : Specifies the nickname you will have when you initially start irc.
  763.           You can change it afterwards, obviously, with /NICK. See also part
  764.       one of this tutorial.
  765.  
  766. IRCNAME : Specifies the name people will see when they issue a /WHO or /WHOIS
  767.       command. Useful for people who use other people's accounts, or in 
  768.       general to reflect the state of mind you are in today.
  769.  
  770.       ---- Example :
  771.  
  772.       $ IRCNAME='Crazy Harry' ; export IRCNAME
  773.       $ IRCNICK='rvl'         ; export IRCNICK  
  774.       $ irc
  775.  
  776.     IRC : *** Welcome to the Internet Relay Network, rvl
  777.  
  778.       : /WHOIS rvl
  779.  
  780.     IRC : *** rvl is rvloon@131.211.145.35 (Crazy Harry) on channel *private*
  781.  
  782.       ----
  783.  
  784. TERM    : Specifies your terminal type ; if this variable is set to the wrong
  785.       value, IRC may behave rather strange. Also beware that at some
  786.       systems IRC II tends to disturb certain settings on your terminal,
  787.       so your terminal may act strange after using IRC II.
  788.  
  789. HOME    : This tells IRC II where your Home directory is. (The directory where
  790.       your files are).
  791.  
  792. Note :
  793.  
  794. TERM and HOME are usually set when you login, so in most cases there's no need
  795. to set them manually.
  796.  
  797. There are three other environment variables IRC uses, but those will be
  798. mentioned at the appropriate places throughout this tutorial.
  799.  
  800. IRC II and Initialisation Files
  801. ===============================
  802.  
  803. When you use IRC II on a (semi)regular basis, you will discover that every
  804. time you start the program you will issue the same initialisation sequence. 
  805. If that is the case, I have good news for you : you don't have to do that
  806. anymore ! IRC II will, at start up, load a file called ".ircrc" (full path:
  807. $HOME/.ircrc). It will treat each line in that file as if you typed it
  808. manually. For example, if the contents or your .ircrc file is :
  809.  
  810. .ircrc : /COMMENT This is definitely *NOT* a typical .ircrc file
  811. .ircrc : /NICK rvl
  812. .ircrc : /JOIN +my_channel
  813.  
  814. Obviously, the ".ircrc :"-bit should not be present in the file. What will
  815. happen is the following :
  816.  
  817. IRC II loads the .ircrc file, executing your commands one by one :
  818.  
  819. The /COMMENT will be ignored, /COMMENT is typically used in .ircrc-files to add
  820. comments to following lines. Second, the /NICK rvl line is read and executed,
  821. thus setting your nick to 'rvl'. Last, you will join a channel called
  822. '+my_channel', when the /JOIN-line is read and executed. NOTE : it is in
  823. general not a good idea to set your nick in .ircrc files, as it makes using
  824. IRC II less flexible. Use the environment variable IRCNICK instead, or use the
  825. command-line option, described elsewhere.
  826.  
  827. The .ircrc file is a so-called defaultfile; you use it to tailor IRC II to
  828. your needs ; you can, however, also create other files with IRC II commands in
  829. them - 'batch files' - and use the /LOAD command.
  830.  
  831.      /LOAD <filename>      Loads the given file into irc, treating each line
  832.                            as an irc command, just as if it were typed into 
  833.                the command line. (Actually, there's more than
  834.                meets the eye here, but I will postpone further
  835.                explanation until I go into ALIASes and such.).
  836.                IRC II provides a number of batchfiles, ready to
  837.                /LOAD. See also /HELP LOAD.
  838.  
  839. You can change where IRC II looks for files by setting the IRCPATH variable.
  840. The value of this variable should be a colon-separated (:) list of directories,
  841. in which your files are stored. 
  842.  
  843. Changing IRC II's behaviour
  844. ===========================
  845.  
  846. To make your life easier (or hopelessly complicated ;-) IRC II has about 543
  847. different variables, all of which control different parts of IRC II.
  848. Typically, you will store your favorite set of variable settings in your
  849. .ircrc. You set, reset and unset variables with the /SET command :
  850.  
  851.      /SET                  Shows settings of all variables
  852.  
  853.      /SET <variablename>   Shows setting of <variablename>. It is also useful
  854.                to show settings of variables starting with a 
  855.                certain prefix.
  856.  
  857.      /SET -<variablename>  If <variablename> is a text (string) variable, it
  858.                will be set to the NULL string ("").
  859.  
  860.      /SET <variablename> <value>
  861.                Sets the value of <variablename> to <value>,
  862.                provided <value> is a valid value for this
  863.                particular variable.
  864.  
  865. Flavours of Variables
  866. =====================
  867.  
  868. There are five kinds of variables:
  869.  
  870. Type      Ref.   Valid Values
  871. =======   ====   =============================================
  872.  
  873. Boolean : BOOL : ON, OFF, TOGGLE
  874. Level   : LVL  : PUBLIC, MSG, NOTICE, WALL, WALLOP, NOTE, CRAP
  875. Integer : INT  : 0,1,2 ...
  876. String  : STR  : <Any text string>
  877. Hybrid  : HYBR : A combination of the four above.
  878.  
  879. Boolean
  880. -------
  881.  
  882. This kind of variable is either ON or OFF. If you specify TOGGLE when
  883. /SETting, it will go from ON to OFF or vice versa.
  884.  
  885. Level
  886. -----
  887.  
  888. This kind of variable is used in situations where IRC II needs to classify
  889. kinds of messages :
  890.  
  891. PUBLIC : Messages on a channel
  892. MSG    : Private messages (MSGs)
  893. NOTICE : Notices 
  894. WALL   : WALL message (a message sent to everyone on IRC)
  895. WALLOP : a WALLOP message (you only get those when you are an IRC Operator)
  896. NOTE   : A (server) NOTE message 
  897. CRAP   : Everything not covered by the six message levels above.
  898. NONE   : None of the above.
  899.  
  900. You can also specify multiple levels, separated by spaces, or specify ALL, and
  901. going down from there by preceding the levels you don't want included with a
  902. minus-sign '-'. 
  903.  
  904. So,
  905.  
  906. ALL is equivalent to : PUBLIC MSG NOTICE WALL WALLOP NOTE CRAP
  907.  
  908. Example:
  909.  
  910. PUBLIC MSG NOTIC is equivalent to ALL -WALL -WALLOP -CRAP -NOTE
  911.  
  912. Integer
  913. -------
  914.  
  915. Your average cardinal type.
  916.  
  917. String
  918. ------
  919.  
  920. A sequence of characters. For certain variables, certain restrictions apply.
  921.  
  922. Hybrid
  923. ------
  924.  
  925. A combination of all or any of the above.
  926.  
  927. General Purpose Variables
  928. =========================
  929.  
  930. I will now describe the variables that are "General Purpose", which means that
  931. they are not connected with other IRC commands, like /ON or /ALIAS. In the
  932. following, I will not give many examples, as obviously a variable controls
  933. certain conditions rather than reflecting an immediate change of environment.
  934. Also note that the order in which variables are listed, is arbitrary.
  935.  
  936. AUTO_UNMARK_AWAY : BOOL 
  937.  
  938. ON : whenever this variable is ON, you will be automatically unmarked as being
  939.      AWAY whenever you send a message to a channel or send a private message.
  940.      (Equivalent to issueing the /AWAY command with no arguments)
  941.  
  942. OFF: Your AWAY-status remains the same, unless you issue the /AWAY command.
  943.  
  944. See also : /AWAY in tutorial one.
  945.  
  946. ----
  947.  
  948. AUTO_WHOWAS : BOOL
  949.  
  950. ON : in cases where /WHOIS <nickname> would result in 
  951.  
  952.      <nickname>: No such nickname
  953.  
  954.      a /WHOWAS <nickname> will automatically be generated.
  955.  
  956. OFF: You will not be bothered by /WHOWAS's
  957.  
  958. ----
  959.  
  960. BEEP - how to avoid or limit the amount of BEEPs (^G's) received
  961. ================================================================
  962.  
  963. BEEP : BOOL
  964.  
  965. ON : All BEEPs will be heard at the terminal
  966. OFF: All ^G (Control-G) characters will be shown as reversed 'G's.
  967.  
  968. The setting of this variable does not affect the BEEPs generated by the
  969. BEEP_ON_MSG variable and the BEEP_WHEN_AWAY variable.
  970.  
  971. ----
  972.  
  973. BEEP_MAX : INT
  974.  
  975. This variable indicates the maxinum number of beeps you will hear for any
  976. given message ; e.g. if this variable is set to '1', and a message sent to you
  977. contains 10 beeps, only '1' will be heard.
  978.  
  979. 0 : All BEEPs in the message will be heard
  980. >0: See explanation.
  981.  
  982. ----
  983.  
  984. BEEP_ON_MSG : LVL
  985.  
  986. The message in the class(es) indicated by this variable will generate an
  987. audible beep on your terminal. For example, if you set this variable to MSG,
  988. then every private MSG you receive will generate an audible BEEP.
  989.  
  990. ----
  991.  
  992. BEEP_WHEN_AWAY : INT
  993.  
  994. When you've /AWAYed, a number of BEEPs will be generated upon receipt of a 
  995. MSG.
  996.  
  997. 0 : do not generate beeps
  998. >0: specifies the number of BEEPs generated. 
  999.  
  1000. ----
  1001.  
  1002. MAIL : INT
  1003.  
  1004. By setting this variable, IRC, will tell you when new mail arrives - the
  1005. client must be installed properly for this to function. See also : part four,
  1006. in which the wonders of the Status Line are revealed.
  1007.  
  1008. 0 : do not check for Mail
  1009. 1 : when mail arrives, display the message : You have new mail. Also, an
  1010.     optional indicator in your status line will tell you how many messages
  1011.     you have in your mailbox.
  1012. 2 : all the functionality of 1, but IRC will also show the three first lines
  1013.     of the message.
  1014.  
  1015. ----
  1016.  
  1017. [ END OF PART THREE : PART FOUR WILL DEAL WITH THE REMAINING VARIABLES AND
  1018.               THE STATUSLINE ]
  1019.  
  1020.  
  1021.  
  1022. .
  1023.