home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / unixtalk / ReadMe
Text File  |  1998-01-29  |  7KB  |  185 lines
  1.  
  2.  
  3.                                 UnixTalk
  4.  
  5.                            Version 0.07 beta
  6.  
  7.                               - Freeware -
  8.  
  9.                 (C) Marco Baye & Istvan Horvath 1997, 1998
  10.  
  11.  0. Copyright
  12.  
  13.   The UnixTalk and TalkIO applications are (C) Marco Baye & Istvan Horvath.
  14.   Both applications are released as freeware, which means that you may copy and
  15. distribute them.
  16.  
  17.   If you distribute them, you must distribute the archive in its original form,
  18. without modifying any of its files. You are not allowed to make money with
  19. these programs, you may only charge to cover the cost of distributing them.
  20.  
  21.   UnixTalk uses the ntalk protocol, but no part of it is based on the original
  22. BSD "talk" / "ntalk" / "talkd" / "ntalkd" sources.
  23.   TalkIO uses ZapRedraw, (C) Dominic Symes 1994. Thanks to Dominic for
  24. permitting us to use it.
  25.  
  26.   These programs are supplied "as is". The authors don't accept any
  27. responsibility for loss of data or other damage resulting from the use of
  28. UnixTalk and/or TalkIO.
  29.  
  30.   If you are unsure about these terms, please contact the authors (see below).
  31.  
  32.  
  33.  1. Contents
  34.  
  35.   0.    Copyright
  36.   1.    Contents
  37.   2.    Introduction
  38.    2.1    Basic
  39.    2.2    Features
  40.    2.3    Version
  41.   3.    Installation
  42.   4.    Basic use
  43.    4.1    Sending talk requests
  44.    4.2    Receiving talk requests
  45.    4.3    Logout
  46.    4.4    The Hotlist
  47.   5.    Misc
  48.   6.    Changes
  49.   7.    Contacting the authors
  50.  
  51.  
  52.  2. Introduction
  53.  
  54.   2.1 Basic:
  55.  
  56.     UnixTalk implements the "ntalk" protocol used under Unix to allow a
  57. conversation between users. Under BSD Unix, a user can request a connection to
  58. another user by typing "talk <username>@<hostname>". The recipient will be
  59. informed and if he/she accepts the connection by issueing a matching command,
  60. both users can see what the other one is typing. For this to work, ntalk
  61. daemons (servers) and clients have to be installed on both systems.
  62.     Because RISC OS is a single-user system, the client and the server don't
  63. have to be separate programs.
  64.     Therefore, UnixTalk acts as both a client and a server. The actual chat
  65. sessions are then handled by the separate application TalkIO, which is started
  66. as a subtask when needed. Several TalkIO's can (and will) run concurrently if
  67. needed, sharing their resources and therefore cutting down on memory usage.
  68.     UnixTalk should run on any TCP/IP stack that supports the Acorn sockets
  69. interface.
  70.  
  71.   2.2 Features:
  72.  
  73.     Sending of outgoing talk requests.
  74.     Announce windows for incoming talk requests.
  75.     A hotlist for connections that are used often.
  76.     The ability to reject all incoming talk requests while showing them on-
  77. screen with a datestamp (useful if you leave the computer for a while).
  78.     If your chat partner uses these programs as well, an extended chat protocol
  79. is used, which lets you use the cursor keys, for example.
  80.  
  81.   2.3 Version:
  82.  
  83.     UnixTalk is at version 0.07 beta. It is written in Basic, but the assembler
  84. version will hopefully be finished in a few days time.
  85.     TalkIO is at version 0.97 beta. It is written in Assembler.
  86.  
  87.  
  88.  3. Installation
  89.  
  90.   If you want to start using UnixTalk right away, the first thing you should do
  91. is this:
  92.   Shift-doubleclick the UnixTalk icon to open its directory, then double-click
  93. the "Hotlist" file. Edit the line starting with "root" to contain your desired
  94. login name instead - your real name or IRC nickname, for example. Save the
  95. hotlist file before starting UnixTalk. This should be done because sending talk
  96. requests as "root" will surely irritate the recipient of the talk request.
  97.  
  98.  
  99.  4. Basic use
  100.  
  101.   4.1 Sending talk requests
  102.  
  103.     To send a talk request, click SELECT on the UnixTalk icon bar icon (on the
  104. left hand side of the icon bar). You can also do this by choosing "Send
  105. request…" from UnixTalk's icon bar menu.
  106.     A window will open, named "Send Talk request".
  107.     The "As:" field in the upper left corner contains your own login name. This
  108. will be displayed to your party when your request is announced.
  109.     The "To:" field is for typing in the login name of the user you want to
  110. chat with.
  111.     The "@" field is for typing in the hostname of your party's machine.
  112.     Press the "Cancel" button to make the window disappear, or press the "Send"
  113. button to send your talk request.
  114.     If you click on the "Add to Hotlist" button, the login and hostname fields
  115. will be saved to your hotlist.
  116.  
  117.   4.2 Receiving talk requests
  118.  
  119.     When somebody else is sending you a talk request, a window named "Incoming
  120. Talk request" will pop up in the middle of your screen, containing the address
  121. of the sender (Click "Add to Hotlist" to save this address to your hotlist). If
  122. you click on "Accept", UnixTalk will open a "Send Talk request" window to check
  123. for the connection. When the connection is established, the dialogue windows
  124. will disappear and a chat window will open.
  125.  
  126.   4.3 Logout
  127.  
  128.     If you leave the computer for a while, it would be nice if UnixTalk would
  129. reject all incoming talk requests and make a note of it to show to you later
  130. on. Well, it can do that. :)
  131.     Just click ADJUST on the icon bar icon, or choose "Logged in" from the icon
  132. bar menu. The menu item and the icon bar icon will reflect the change. When you
  133. are marked as being "not logged in", all incoming talk requests are rejected
  134. (the sender will see "Your party is not logged on"). No "Incoming Talk request"
  135. windows will pop up. Instead, a similar window will appear, which shows the
  136. time when it was created. When you return to the computer, you can try to talk
  137. back to the person who sent the talk request by clicking on "Try to talk back".
  138.  
  139.   4.4 The Hotlist
  140.  
  141.     UnixTalk has basic hotlist functions. To send a talk request to an address
  142. from your hotlist, open the icon bar menu and choose the address from the
  143. submenu "Hotlist". Only the login name is shown, though this can be changed. If
  144. you start the !Help application, it will show the full address.
  145.     In the send, announce and note windows there is a button called "Add to
  146. hotlist", which will save the displayed address to your hotlist. It will be
  147. appended to the file and to the menu immediately.
  148.  
  149.     After you have manually edited the hotlist file (recommended because the
  150. user's login name isn't always the best thing to display), the only way to make
  151. UnixTalk re-load the file is to quit and restart UnixTalk. I will try to change
  152. this in the future, so that UnixTalk uses the ExternalEdit or OLE protocol.
  153.  
  154.  
  155.  5. Misc
  156.  
  157.   Though the current version of UnixTalk is written in Basic, it places a very
  158. low load on the computer, because it polls the wimp only once per second.
  159.  
  160.   Please don't complain about the use of the toolbox modules; I really don't
  161. want to build menus on my own ever again.
  162.  
  163.   Both applications are StrongARM-compatible.
  164.  
  165.  
  166.  6. Changes
  167.  
  168.   Changes from version 0.06ß to 0.07ß:
  169.  
  170.     • UnixTalk now has proper Sprites. Many thanks to Andrew Boura for creating them.
  171.     • A really braindead bug is fixed: It caused UnixTalk to crash whenever a talk request was received from someone using a 12-character login name.
  172.  
  173.  7. Contacting the authors
  174.  
  175.   The newest versions of UnixTalk and TalkIO can be found at the UnixTalk homepage:
  176.   http://home.pages.de/~mac_bacon/ntalk/
  177.  
  178.   If you want to report a bug or make a suggestion, then simply drop us an
  179. email.
  180.   (Or send a talk request :)
  181.  
  182.   mailto:Istvan.Horvath@tu-clausthal.de (TalkIO)
  183.   mailto:Marco.Baye@tu-clausthal.de (UnixTalk)
  184.   talkto:Marco@dionin.esw-heim.tu-clausthal.de
  185.