home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsf / freeterm / TermDoc < prev   
Encoding:
Text File  |  1995-05-24  |  5.5 KB  |  138 lines
  1.  
  2.                     The FreeTerm Terminal Emulator
  3.  
  4.                (C) Tom Hughes 1995, (C) Tony Howat 1995
  5.  
  6.  
  7. 0. Copyright
  8.  
  9.   The FreeTerm application is (C) Tom Hughes 1995, with modifications
  10.   and extensions (C) Tony Howat 1995, but is released as freeware.
  11.   This means that you may copy and distribute it, subject to certain
  12.   conditions.
  13.  
  14.   Specifically, you may only charge to cover the cost of distributing
  15.   it, and you may not use it to make money directly or indirectly (by
  16.   using it as an incentive to buy something else for example).
  17.  
  18.   Any magazine intending to distribute it should contact me first, so
  19.   that I can provide them with the most recent version. It is useful
  20.   if PD libraries also do this, for the same reasons.
  21.  
  22.   FreeTerm should only be distributed with the whole contents
  23.   of the original archive, with all files unmodified.
  24.  
  25.   This software is based in part upon VTLib Terminal Windows Library,
  26.   (C) Adam Goodfellow 1994, 1995.
  27.  
  28.   None of the authors accept any responsibility for any loss/damage/whatever
  29.   resulting from the use of FreeTerm. It is supplied "as is".
  30.  
  31. 1. Introduction
  32.  
  33.   The FreeTerm application is a terminal emulator for use with any
  34.   TCP/IP stack that supports the Acorn sockets interface. Currently
  35.   that means either the Acorn TCP/IP stack or my FreeNet TCP/IP stack.
  36.  
  37.   Currently the application provides support for straightforward
  38.   telnet, and displays the telnet session in a window which emulates
  39.   a VT1xx series terminal (it should support VT102, VT100 and VT52).
  40.  
  41. 2. Using FreeTerm
  42.   
  43.   Starting FreeTerm places an icon on the iconbar, and clicking on this
  44.   provides a dialogue box with two writeable icons. The first of these
  45.   takes the host name (or IP address), and the second the port number
  46.   (or service name). Leaving the port number blank will cause it to
  47.   default to the standard telnet port. Both the host and port writable
  48.   icons are accompanied by pop up menus, and there is also a hot list
  49.   on the icon bar menu. See the next section of this manual for details
  50.   on how to set up these menus.
  51.  
  52.   Clicking on the connect button causes FreeTerm to establish a
  53.   connection to the specified address, and then open a terminal window
  54.   for the connection. For connections to the default telnet port, this
  55.   window will default to character mode (where each character you type
  56.   is transmitted straight away) if that is acceptable to the remote
  57.   host, otherwise line mode is used.
  58.  
  59.   Clicking menu over a terminal window gives you a menu that allows
  60.   the control of various aspects of terminal behaviour, including
  61.   changing the size and spooling to disc. Some of the options (such as
  62.   echo mode) will cause FreeTerm to try an renegotiate with the remote
  63.   host, and if this fails you will find that the option returns to it's
  64.   original state again.
  65.  
  66.   Closing a terminal window will result in the connection to the remote
  67.   host being dropped, whilst the remote host dropping an open connection
  68.   will result in an error being reported and the terminal window closed.
  69.  
  70. 3. The host and port menus
  71.  
  72.   The connection dialogue features two writeable icons for entering the
  73.   port name/number and the host you wish to connect to. Hostnames are
  74.   usually fairly long, and on a local network with only a few hosts typing
  75.   the same thing each time you wish to connect to a host soon becomes
  76.   tiresome. FreeTerm v0.12 and later solve this by way of pop up menus,
  77.   which are triggered by a button alongside each writeable icon. The host
  78.   menu lists entries in the format :
  79.  
  80.   foo.bar.co.uk (Telnet)
  81.   moo.cow.com (Finger)
  82.   wibble.zonk.org
  83.   ...
  84.  
  85.   The port name in brackets is the default port, not all entries may
  86.   have a default port. Clicking on an entry in the menu fills in the
  87.   writable fields in the connection box with the hostname and portname
  88.   (if present), leaving you to press the "Connect" button.
  89.  
  90.   The icon bar hot list is exactly the same as the host menu, except
  91.   that if you click on an entry with both a default port and host name
  92.   the connection starts immediately. If the entry has no default port
  93.   the connect dialogue box is displayed for you to enter a portname.
  94.  
  95.   The port menu simply lists frequently used portnames, clicking on an
  96.   entry in the menu copies the portname to the writeable icon.
  97.  
  98.   The contents of the host menu/hotlist and port menu are read from
  99.   configuration files in !FreeUser.Files.FreeTerm, namely HostList
  100.   and PortList. The format of these files is explained in their comments.
  101.  
  102. 4. CLI options
  103.  
  104.   -debug       Traces flow negociation to terminals as per pre-release
  105.   -port <port>
  106.   -host <host> These two options can be used to auto start a session as
  107.                soon as !FreeTerm is loaded.
  108.   -nopop       No pop-up resolving messages, all problems reported via
  109.                full errors.
  110.  
  111.   Note these options are likely to be removed in future versions of
  112.   FreeTerm, programmers should _definately_ not use them for triggering
  113.   sessions!
  114.  
  115. 6. Contacting the author(s)
  116.  
  117.   Any on the subject of FreeNet in general should be sent to the original
  118.   author of FreeTerm, Tom Hughes, who can be contacted by email at
  119.   freenet@compton.demon.co.uk, or by snail mail at:
  120.  
  121.       Tom Hughes
  122.       5 Lampits
  123.       Hoddesdon
  124.       Hertfordshire
  125.       EN11 8EH
  126.  
  127.   Development of FreeTerm is being undertaken by Tony Howat, so
  128.   suggestions for enhancements and bug reports should be sent to him by
  129.   email at thowat@xargle.demon.co.uk, or by snail mail at:
  130.  
  131.       Tony Howat
  132.       12 Dover Road
  133.       Birkdale
  134.       Southport
  135.       Merseyside
  136.       PR8 4SY
  137.  
  138.