Home » Personal collection » Acorn hard disk » zipped_disks » 2000_apps_1 » apps1/Network/!FreeTerm/!Help

apps1/Network/!FreeTerm/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Personal collection » Acorn hard disk » zipped_disks » 2000_apps_1
Filename: apps1/Network/!FreeTerm/!Help
Read OK:
File size: 3792 bytes
Load address: 0000
Exec address: 0000
Duplicates

There are 5 duplicate copies of this file in the archive:

File contents
                    The FreeTerm Terminal Emulator

                               Freeware
                 (C) Tony Howat & Merlin Hughes 1995/6


0. Copyright

  The FreeTerm application is (C) Tony Howat 1995/6, with the SICKTerm
  terminal library (C) Merlin Hughes, but is released as freeware.
  This means that you may copy and distribute it, subject to certain
  conditions.

  Specifically, as an individual, you may only charge to cover the cost
  of distributing it, and you may not use it to make money directly or
  indirectly (by using it as an incentive to buy something else for
  example).

  Any company which wishes to include the program on a magazine disc or
  disc which will be sold *must* contact us to discuss arrangements.

  It is also imperative that anyone considering including FreeTerm in a
  internet suite of any sort (free or otherwise) contacts me (Tony Howat).

  Contact Tony Howat if you are unsure of how these terms affect you.

  FreeTerm should only be distributed with the whole contents of the
  original archive, with all files unmodified.

  SICKTerm makes use of ZapRedraw, (C) Dominic Symes 1994.
  The project was started by Tom Hughes, author of FreeNet.

  None of the authors accept any responsibility for any
  loss/damage/whatever resulting from the use of FreeTerm. It is
  supplied "as is".

1. Introduction

  The FreeTerm application is a terminal emulator for use with any
  TCP/IP stack that supports the Acorn sockets interface. Currently
  that means either the Acorn TCP/IP stack, FreeNet or any of the
  commercial suites except Termite.

  Currently the application provides support for straightforward
  telnet and finger, and display sessions in a window which emulates
  a VT102 or VT52 series terminal. However, according to the beta
  testers it performs these basic functions rather well, and reliably,
  which is what matters.

2. Using FreeTerm

  Starting FreeTerm places an icon on the iconbar, and clicking on
  this provides a dialogue box with two writeable icons. The first
  of these takes the host name (or IP address), and the second
  the port number (or service name). Leaving the port
  number blank will cause it to default to the standard telnet
  port. Both the host and port writable icons are accompanied by
  pop up menus, and there is also a hot list on the icon bar
  menu. See the section 4 of this manual for details on how to set
  up these menus.

  Selecting certain ports (in this current version this will only
  occur with "finger") will cause the dialogue box to expand and
  display and extra arguments field for extra parameters needed
  to establish a certain kind of connection.

  Clicking on the connect button causes FreeTerm to establish a
  connection to the specified address, and then open a terminal
  window for the connection. For connections to the default telnet
  port, this window will default to character mode (where each
  character you type is transmitted straight away) if that is
  acceptable to the remote host, otherwise line mode is used.

2.1 Downloading and Uploading text.

  To send a file down the telnet connection drag it to the window. To
  save text from a telnet window highlight it, and drag it to a filer
  window.

  To download long chunks of text it is best to use the spooler, use
  the "Spool>Open" save as dialogue to locate your spoolfile and
  start recording. The spool may be paused, and selecting the
  "Spool>Strip" option will filter control codes from the output.
  When you have finished spooling click "Spool>Close"

  NB : FreeTerm only handles text downloads and uploads, ZModem
       transfers may be implemented in the future.

2.2 Disconnection

  Closing a terminal window will result in the connection to the
  remote host being dropped, whilst the remote host dropping an open
  connection will result in a message in the terminal window.

3. Using finger

  Finger is an internet service for finding out who is using a system,
  or finding out about users on a system. FreeTerm includes a finger
  client. To use it enter a hostname in the normal way and select
  "Finger" as the port, the connect window will grow an extra
  writeable icon, this is where you enter the finger string.

  The finger string specifies what information you want from the
  remote system. The most common types of finger strings are
  listed below.

  <Blank>  - An empty finger string lists all the users on a system.
  user     - Entering a valid username returns information on a
             specific user.

  ...you can use the @ character to finger via the system you are
  connecting to. So :

  @wibble.com     - lists the users on wibble.com via the system you
                    actually connected to.
  jack@wibble.com - gets information on the user 'jack' on wibble.com
                    via the system you actually connected to.

  You can use as many @'s as you need, but at most you should only
  need one if you ever need to finger through a firewall. 

  For more information on finger see RFC1288.

4. The host and port menus

  The connection dialogue features two writeable icons for entering
  the port name/number and the host you wish to connect to. Hostnames
  are usually fairly long, and on a local network with only a few
  hosts typing the same thing each time you wish to connect to a host
  soon becomes tiresome. FreeTerm v0.12 and later solve this by way
  of pop up menus, which are triggered by a button alongside each
  writeable icon. The host menu lists entries in the format :

  foo.bar.co.uk (Telnet)
  moo.cow.com (Finger)
  wibble.zonk.org
  ...

  The port name in brackets is the default port, not all entries may
  have a default port. Clicking on an entry in the menu fills in the
  writable fields in the connection box with the hostname and portname
  (if present), leaving you to press the "Connect" button.

  The icon bar hot list is exactly the same as the host menu, except
  that if you click on an entry with both a default port and host name
  the connection starts immediately. If the entry has no default port
  the connect dialogue box is displayed for you to enter a portname.

  The port menu simply lists frequently used portnames, clicking on an
  entry in the menu copies the portname to the writeable icon.

  The contents of the host menu/hotlist and port menu are read from
  configuration files in !FreeUser.Files.FreeTerm, namely HostList
  and PortList. The format of these files is explained in their
  comments.

  In older versions of FreeTerm you hand edit these files, you still
  can, but there is now a user interface in the configuration window
  (accessable from the iconbar 'Configure' option).

5. Other stuff

   The window finder (off the icon bar menu) gives you a list of terminal
   windows open - click on one to bring it to the top.

   The VT100 keypad is useful on VMS systems etc. If you don't know what
   it is or how to use it you probably don't need it.

6. CLI options

  -debug       Traces flow negociation to terminals as per pre-release
  -port <port>
  -host <host> These two options can be used to auto start a session
               as soon as !FreeTerm is loaded.
  -args <...>  Used to specify arguments if you have specified a port
               which makes use of them (ie finger)
  -nopop       No pop-up resolving messages, all problems reported via
               full errors.

7. Miscellaneous notes

  If your FreeTerm session to a unix shell gets munged try 'reset'. The
  session should clear, and after a few <CR>'s you should get a normal
  prompt.

  The auto close check box in the configuration window will make _telnet_
  session windows close automatically if the remote end drops the
  connection.

8. Programmers' guff

  To trigger a session via a WIMP message send Message_FreeTermOp (&440A6).
  The data section should look as follows :

  length      type                      description
  4 bytes     int                       action code == 2
  8 bytes     empty
  64 bytes    null terminated string    port name/number
  80 bytes    null terminated string    destination address
  80 bytes    null terminated string    the arguments
  --------
  236 = total length

  This message is acked if recieved by FreeTerm. OSLib example in C
  follows :

  #include "oslib:user.wimp.h"
  #include "kernel.h"
  #include <string.h>
  
  #define Message_FreeTermOp 0x440a6
    
  typedef struct {
    int action;              /* action code */
    int spare1;
    int spare2;
    char port[64];
    char dest[80];
    char args[80];
  } freeterm_openmsg;
  
  int main(void)
  {
    int    wimpver;
    wimp_t mytaskhandle;
    static wimp_block block;
    wimp_message ms;
    freeterm_openmsg *fom=(freeterm_openmsg *)&(ms.data);
  
    mytaskhandle = wimp_initialise(310,"FreeTerm Test",(void *)-1,&wimpver);
  
    ms.action=Message_FreeTermOp;
    ms.my_ref=0;
    ms.your_ref=1;
    ms.sender=mytaskhandle;
    strcpy(fom->port,"finger");
    strcpy(fom->dest,"g7lzb.ampr.org");
    strcpy(fom->args,"g7lzb");
    fom->action=2;
    ms.size=sizeof(freeterm_openmsg);
    
    wimp_send_message(wimp_USER_MESSAGE,&ms,0);
  
    xwimp_close_down(mytaskhandle);
    return 0;
  }

  The Config.Fonts file is in the format:
    Name                               (string - to appear in menus)
  then
    zap b.m.                           (literal string)
    <TermFonts$Dir>.BitMaps.X.10x20    (string)
  or (for those who are prepared to tweak parameters for a while)
    zap a.a.                           (literal string)
    corpus.medium                      (RISC-OS font name)
    10                                 Point size
    16                                 Width of font
    12                                 Height of font
    0                                  X offset (usually 0)
    8                                  Y offset (usually >0)
  or
    zap b.m. dir
    <TermFonts$Dir>.BitMaps.CX         (Directory to find set of zap fonts)

9. Credits

  Programming :
     Tom Hughes (tom@compton.demon.co.uk) started the project.
     Tony Howat (thowat@xargle.demon.co.uk) continued it.
     Merlin Hughes (hughesm@cs.unc.edu) wrote the terminal emulator.

  Thanks to :
     Dominic Symes for ZapRedraw.
     Stewart Brodie (s.n.brodie@ecs.soton.ac.uk) for help with ArcWeb.
     Ben Summers for help with the ColourPicker, and those on
     comp.sys.acorn.programmer for sorting me out on the occasions when
     I saw fit to ask particularly dumb questions.
     Graham Allan for his help in sadistic terminal emulator abuse. 

  ..and thanks to the beta testers for their helpful comments and
    suggestions.

10. Internationalisation

  I would be extactic if people could provide me with resources for
  different languages to be made available alongside the standard
  FreeTerm distribution. e-mail them UUCoded to thowat@xargle.demon.co.uk

11. TtylinkD

  Ttylinkd is an extension for FreeTerm which allows users to connect to
  your system and open chat sessions. It picks up ttylink (port 87)
  connections to your machine and routes them through to FreeTerm
  allowing you to converse directly with the remote user.
  
  Features :
     * Can run independently of FreeTerm acting as an answering service,
       optionally auto-starting FreeTerm when a connection is answered.
     * Optionally alerts user of incoming connections both visually and
       by playing a sound sample.
     * Variable non-answer timeout.
     * Fully editable connect/answer/etc messages.
     * Integrates fully with FreeTerm.
  
  Ttylinkd will work with any Acorn BSD style TCP/IP stack, and so is
  compatible with FreeNet, AcornNet, InterTalk, Voyager, ANT Internet etc.
  (but *not* Termite Internet). However due to the program being a server it
  is only really appropriate for use with providers which allocate static
  IP addresses - so users of providers like Pipex and Argonet won't be able
  to use it effectively. If you are confused about whether Ttylinkd is
  suitable for your set up feel free to contact me. Ttylinkd will only run
  under RISC OS 3.1 and later.

  *** ttylinkd will hopefully be released before September 1996 by 20-20
  *** Software and its release will be announced on comp.sys.acorn.announce.
  *** It will be a *commercial* program costing �10 (single user) or �15
  *** for a site licence. Further ordering details will be announced when
  *** the program is released.

12. Contacting the author(s)

  Any queries on the subject of FreeNet in general should be sent
  to the original author of FreeTerm, Tom Hughes, who can be contacted by
  email at freenet@compton.demon.co.uk, or by snail mail at:

      Tom Hughes
      5 Lampits
      Hoddesdon
      Hertfordshire
      EN11 8EH

  Those with basic configuration problems would be best served by the
  comp.sys.acorn.networking newsgroup.

  Development of FreeTerm is being undertaken by Tony Howat, so
  suggestions for enhancements and bug reports should be sent to him
  by email to thowat@xargle.demon.co.uk, or by snail mail at:

      Tony Howat
      12 Dover Road
      Birkdale
      Southport
      Merseyside
      PR8 4SY

  Only FreeTerm _specific_ queries should be sent to this address, I
  can't help on a more general level. My setup is uniquely strange and
  flakey :)

  If you are so enamoured with FreeTerm that you feel that you may like
  to buy the authors a pint or three money is welcome at the above
  address, it will be split fairly. (We're both impoverished students,
  and so couldn't miss the chance of a beer or two for our trouble!)

  FreeTerm has a web page which should now available from the
  20-20 Software home page. Point your browser at :
                                           http://www.angel.ac.uk/ac/2020/

  Thanks to Michael White for loaning me the web space.

  ------------------------------------------------------------------------
   Note that my e-mail address will be changing. If mail bounces refer to
   the 20-20 Software web pages (http://www.angel.ac.uk/ac/2020/) for a
   current address. 
  ------------------------------------------------------------------------
  

00000000  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000010  20 20 20 20 20 54 68 65  20 46 72 65 65 54 65 72  |     The FreeTer|
00000020  6d 20 54 65 72 6d 69 6e  61 6c 20 45 6d 75 6c 61  |m Terminal Emula|
00000030  74 6f 72 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |tor..           |
00000040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000050  20 20 20 20 46 72 65 65  77 61 72 65 0a 20 20 20  |    Freeware.   |
00000060  20 20 20 20 20 20 20 20  20 20 20 20 20 20 28 43  |              (C|
00000070  29 20 54 6f 6e 79 20 48  6f 77 61 74 20 26 20 4d  |) Tony Howat & M|
00000080  65 72 6c 69 6e 20 48 75  67 68 65 73 20 31 39 39  |erlin Hughes 199|
00000090  35 2f 36 0a 0a 0a 30 2e  20 43 6f 70 79 72 69 67  |5/6...0. Copyrig|
000000a0  68 74 0a 0a 20 20 54 68  65 20 46 72 65 65 54 65  |ht..  The FreeTe|
000000b0  72 6d 20 61 70 70 6c 69  63 61 74 69 6f 6e 20 69  |rm application i|
000000c0  73 20 28 43 29 20 54 6f  6e 79 20 48 6f 77 61 74  |s (C) Tony Howat|
000000d0  20 31 39 39 35 2f 36 2c  20 77 69 74 68 20 74 68  | 1995/6, with th|
000000e0  65 20 53 49 43 4b 54 65  72 6d 0a 20 20 74 65 72  |e SICKTerm.  ter|
000000f0  6d 69 6e 61 6c 20 6c 69  62 72 61 72 79 20 28 43  |minal library (C|
00000100  29 20 4d 65 72 6c 69 6e  20 48 75 67 68 65 73 2c  |) Merlin Hughes,|
00000110  20 62 75 74 20 69 73 20  72 65 6c 65 61 73 65 64  | but is released|
00000120  20 61 73 20 66 72 65 65  77 61 72 65 2e 0a 20 20  | as freeware..  |
00000130  54 68 69 73 20 6d 65 61  6e 73 20 74 68 61 74 20  |This means that |
00000140  79 6f 75 20 6d 61 79 20  63 6f 70 79 20 61 6e 64  |you may copy and|
00000150  20 64 69 73 74 72 69 62  75 74 65 20 69 74 2c 20  | distribute it, |
00000160  73 75 62 6a 65 63 74 20  74 6f 20 63 65 72 74 61  |subject to certa|
00000170  69 6e 0a 20 20 63 6f 6e  64 69 74 69 6f 6e 73 2e  |in.  conditions.|
00000180  0a 0a 20 20 53 70 65 63  69 66 69 63 61 6c 6c 79  |..  Specifically|
00000190  2c 20 61 73 20 61 6e 20  69 6e 64 69 76 69 64 75  |, as an individu|
000001a0  61 6c 2c 20 79 6f 75 20  6d 61 79 20 6f 6e 6c 79  |al, you may only|
000001b0  20 63 68 61 72 67 65 20  74 6f 20 63 6f 76 65 72  | charge to cover|
000001c0  20 74 68 65 20 63 6f 73  74 0a 20 20 6f 66 20 64  | the cost.  of d|
000001d0  69 73 74 72 69 62 75 74  69 6e 67 20 69 74 2c 20  |istributing it, |
000001e0  61 6e 64 20 79 6f 75 20  6d 61 79 20 6e 6f 74 20  |and you may not |
000001f0  75 73 65 20 69 74 20 74  6f 20 6d 61 6b 65 20 6d  |use it to make m|
00000200  6f 6e 65 79 20 64 69 72  65 63 74 6c 79 20 6f 72  |oney directly or|
00000210  0a 20 20 69 6e 64 69 72  65 63 74 6c 79 20 28 62  |.  indirectly (b|
00000220  79 20 75 73 69 6e 67 20  69 74 20 61 73 20 61 6e  |y using it as an|
00000230  20 69 6e 63 65 6e 74 69  76 65 20 74 6f 20 62 75  | incentive to bu|
00000240  79 20 73 6f 6d 65 74 68  69 6e 67 20 65 6c 73 65  |y something else|
00000250  20 66 6f 72 0a 20 20 65  78 61 6d 70 6c 65 29 2e  | for.  example).|
00000260  0a 0a 20 20 41 6e 79 20  63 6f 6d 70 61 6e 79 20  |..  Any company |
00000270  77 68 69 63 68 20 77 69  73 68 65 73 20 74 6f 20  |which wishes to |
00000280  69 6e 63 6c 75 64 65 20  74 68 65 20 70 72 6f 67  |include the prog|
00000290  72 61 6d 20 6f 6e 20 61  20 6d 61 67 61 7a 69 6e  |ram on a magazin|
000002a0  65 20 64 69 73 63 20 6f  72 0a 20 20 64 69 73 63  |e disc or.  disc|
000002b0  20 77 68 69 63 68 20 77  69 6c 6c 20 62 65 20 73  | which will be s|
000002c0  6f 6c 64 20 2a 6d 75 73  74 2a 20 63 6f 6e 74 61  |old *must* conta|
000002d0  63 74 20 75 73 20 74 6f  20 64 69 73 63 75 73 73  |ct us to discuss|
000002e0  20 61 72 72 61 6e 67 65  6d 65 6e 74 73 2e 0a 0a  | arrangements...|
000002f0  20 20 49 74 20 69 73 20  61 6c 73 6f 20 69 6d 70  |  It is also imp|
00000300  65 72 61 74 69 76 65 20  74 68 61 74 20 61 6e 79  |erative that any|
00000310  6f 6e 65 20 63 6f 6e 73  69 64 65 72 69 6e 67 20  |one considering |
00000320  69 6e 63 6c 75 64 69 6e  67 20 46 72 65 65 54 65  |including FreeTe|
00000330  72 6d 20 69 6e 20 61 0a  20 20 69 6e 74 65 72 6e  |rm in a.  intern|
00000340  65 74 20 73 75 69 74 65  20 6f 66 20 61 6e 79 20  |et suite of any |
00000350  73 6f 72 74 20 28 66 72  65 65 20 6f 72 20 6f 74  |sort (free or ot|
00000360  68 65 72 77 69 73 65 29  20 63 6f 6e 74 61 63 74  |herwise) contact|
00000370  73 20 6d 65 20 28 54 6f  6e 79 20 48 6f 77 61 74  |s me (Tony Howat|
00000380  29 2e 0a 0a 20 20 43 6f  6e 74 61 63 74 20 54 6f  |)...  Contact To|
00000390  6e 79 20 48 6f 77 61 74  20 69 66 20 79 6f 75 20  |ny Howat if you |
000003a0  61 72 65 20 75 6e 73 75  72 65 20 6f 66 20 68 6f  |are unsure of ho|
000003b0  77 20 74 68 65 73 65 20  74 65 72 6d 73 20 61 66  |w these terms af|
000003c0  66 65 63 74 20 79 6f 75  2e 0a 0a 20 20 46 72 65  |fect you...  Fre|
000003d0  65 54 65 72 6d 20 73 68  6f 75 6c 64 20 6f 6e 6c  |eTerm should onl|
000003e0  79 20 62 65 20 64 69 73  74 72 69 62 75 74 65 64  |y be distributed|
000003f0  20 77 69 74 68 20 74 68  65 20 77 68 6f 6c 65 20  | with the whole |
00000400  63 6f 6e 74 65 6e 74 73  20 6f 66 20 74 68 65 0a  |contents of the.|
00000410  20 20 6f 72 69 67 69 6e  61 6c 20 61 72 63 68 69  |  original archi|
00000420  76 65 2c 20 77 69 74 68  20 61 6c 6c 20 66 69 6c  |ve, with all fil|
00000430  65 73 20 75 6e 6d 6f 64  69 66 69 65 64 2e 0a 0a  |es unmodified...|
00000440  20 20 53 49 43 4b 54 65  72 6d 20 6d 61 6b 65 73  |  SICKTerm makes|
00000450  20 75 73 65 20 6f 66 20  5a 61 70 52 65 64 72 61  | use of ZapRedra|
00000460  77 2c 20 28 43 29 20 44  6f 6d 69 6e 69 63 20 53  |w, (C) Dominic S|
00000470  79 6d 65 73 20 31 39 39  34 2e 0a 20 20 54 68 65  |ymes 1994..  The|
00000480  20 70 72 6f 6a 65 63 74  20 77 61 73 20 73 74 61  | project was sta|
00000490  72 74 65 64 20 62 79 20  54 6f 6d 20 48 75 67 68  |rted by Tom Hugh|
000004a0  65 73 2c 20 61 75 74 68  6f 72 20 6f 66 20 46 72  |es, author of Fr|
000004b0  65 65 4e 65 74 2e 0a 0a  20 20 4e 6f 6e 65 20 6f  |eeNet...  None o|
000004c0  66 20 74 68 65 20 61 75  74 68 6f 72 73 20 61 63  |f the authors ac|
000004d0  63 65 70 74 20 61 6e 79  20 72 65 73 70 6f 6e 73  |cept any respons|
000004e0  69 62 69 6c 69 74 79 20  66 6f 72 20 61 6e 79 0a  |ibility for any.|
000004f0  20 20 6c 6f 73 73 2f 64  61 6d 61 67 65 2f 77 68  |  loss/damage/wh|
00000500  61 74 65 76 65 72 20 72  65 73 75 6c 74 69 6e 67  |atever resulting|
00000510  20 66 72 6f 6d 20 74 68  65 20 75 73 65 20 6f 66  | from the use of|
00000520  20 46 72 65 65 54 65 72  6d 2e 20 49 74 20 69 73  | FreeTerm. It is|
00000530  0a 20 20 73 75 70 70 6c  69 65 64 20 22 61 73 20  |.  supplied "as |
00000540  69 73 22 2e 0a 0a 31 2e  20 49 6e 74 72 6f 64 75  |is"...1. Introdu|
00000550  63 74 69 6f 6e 0a 0a 20  20 54 68 65 20 46 72 65  |ction..  The Fre|
00000560  65 54 65 72 6d 20 61 70  70 6c 69 63 61 74 69 6f  |eTerm applicatio|
00000570  6e 20 69 73 20 61 20 74  65 72 6d 69 6e 61 6c 20  |n is a terminal |
00000580  65 6d 75 6c 61 74 6f 72  20 66 6f 72 20 75 73 65  |emulator for use|
00000590  20 77 69 74 68 20 61 6e  79 0a 20 20 54 43 50 2f  | with any.  TCP/|
000005a0  49 50 20 73 74 61 63 6b  20 74 68 61 74 20 73 75  |IP stack that su|
000005b0  70 70 6f 72 74 73 20 74  68 65 20 41 63 6f 72 6e  |pports the Acorn|
000005c0  20 73 6f 63 6b 65 74 73  20 69 6e 74 65 72 66 61  | sockets interfa|
000005d0  63 65 2e 20 43 75 72 72  65 6e 74 6c 79 0a 20 20  |ce. Currently.  |
000005e0  74 68 61 74 20 6d 65 61  6e 73 20 65 69 74 68 65  |that means eithe|
000005f0  72 20 74 68 65 20 41 63  6f 72 6e 20 54 43 50 2f  |r the Acorn TCP/|
00000600  49 50 20 73 74 61 63 6b  2c 20 46 72 65 65 4e 65  |IP stack, FreeNe|
00000610  74 20 6f 72 20 61 6e 79  20 6f 66 20 74 68 65 0a  |t or any of the.|
00000620  20 20 63 6f 6d 6d 65 72  63 69 61 6c 20 73 75 69  |  commercial sui|
00000630  74 65 73 20 65 78 63 65  70 74 20 54 65 72 6d 69  |tes except Termi|
00000640  74 65 2e 0a 0a 20 20 43  75 72 72 65 6e 74 6c 79  |te...  Currently|
00000650  20 74 68 65 20 61 70 70  6c 69 63 61 74 69 6f 6e  | the application|
00000660  20 70 72 6f 76 69 64 65  73 20 73 75 70 70 6f 72  | provides suppor|
00000670  74 20 66 6f 72 20 73 74  72 61 69 67 68 74 66 6f  |t for straightfo|
00000680  72 77 61 72 64 0a 20 20  74 65 6c 6e 65 74 20 61  |rward.  telnet a|
00000690  6e 64 20 66 69 6e 67 65  72 2c 20 61 6e 64 20 64  |nd finger, and d|
000006a0  69 73 70 6c 61 79 20 73  65 73 73 69 6f 6e 73 20  |isplay sessions |
000006b0  69 6e 20 61 20 77 69 6e  64 6f 77 20 77 68 69 63  |in a window whic|
000006c0  68 20 65 6d 75 6c 61 74  65 73 0a 20 20 61 20 56  |h emulates.  a V|
000006d0  54 31 30 32 20 6f 72 20  56 54 35 32 20 73 65 72  |T102 or VT52 ser|
000006e0  69 65 73 20 74 65 72 6d  69 6e 61 6c 2e 20 48 6f  |ies terminal. Ho|
000006f0  77 65 76 65 72 2c 20 61  63 63 6f 72 64 69 6e 67  |wever, according|
00000700  20 74 6f 20 74 68 65 20  62 65 74 61 0a 20 20 74  | to the beta.  t|
00000710  65 73 74 65 72 73 20 69  74 20 70 65 72 66 6f 72  |esters it perfor|
00000720  6d 73 20 74 68 65 73 65  20 62 61 73 69 63 20 66  |ms these basic f|
00000730  75 6e 63 74 69 6f 6e 73  20 72 61 74 68 65 72 20  |unctions rather |
00000740  77 65 6c 6c 2c 20 61 6e  64 20 72 65 6c 69 61 62  |well, and reliab|
00000750  6c 79 2c 0a 20 20 77 68  69 63 68 20 69 73 20 77  |ly,.  which is w|
00000760  68 61 74 20 6d 61 74 74  65 72 73 2e 0a 0a 32 2e  |hat matters...2.|
00000770  20 55 73 69 6e 67 20 46  72 65 65 54 65 72 6d 0a  | Using FreeTerm.|
00000780  0a 20 20 53 74 61 72 74  69 6e 67 20 46 72 65 65  |.  Starting Free|
00000790  54 65 72 6d 20 70 6c 61  63 65 73 20 61 6e 20 69  |Term places an i|
000007a0  63 6f 6e 20 6f 6e 20 74  68 65 20 69 63 6f 6e 62  |con on the iconb|
000007b0  61 72 2c 20 61 6e 64 20  63 6c 69 63 6b 69 6e 67  |ar, and clicking|
000007c0  20 6f 6e 0a 20 20 74 68  69 73 20 70 72 6f 76 69  | on.  this provi|
000007d0  64 65 73 20 61 20 64 69  61 6c 6f 67 75 65 20 62  |des a dialogue b|
000007e0  6f 78 20 77 69 74 68 20  74 77 6f 20 77 72 69 74  |ox with two writ|
000007f0  65 61 62 6c 65 20 69 63  6f 6e 73 2e 20 54 68 65  |eable icons. The|
00000800  20 66 69 72 73 74 0a 20  20 6f 66 20 74 68 65 73  | first.  of thes|
00000810  65 20 74 61 6b 65 73 20  74 68 65 20 68 6f 73 74  |e takes the host|
00000820  20 6e 61 6d 65 20 28 6f  72 20 49 50 20 61 64 64  | name (or IP add|
00000830  72 65 73 73 29 2c 20 61  6e 64 20 74 68 65 20 73  |ress), and the s|
00000840  65 63 6f 6e 64 0a 20 20  74 68 65 20 70 6f 72 74  |econd.  the port|
00000850  20 6e 75 6d 62 65 72 20  28 6f 72 20 73 65 72 76  | number (or serv|
00000860  69 63 65 20 6e 61 6d 65  29 2e 20 4c 65 61 76 69  |ice name). Leavi|
00000870  6e 67 20 74 68 65 20 70  6f 72 74 0a 20 20 6e 75  |ng the port.  nu|
00000880  6d 62 65 72 20 62 6c 61  6e 6b 20 77 69 6c 6c 20  |mber blank will |
00000890  63 61 75 73 65 20 69 74  20 74 6f 20 64 65 66 61  |cause it to defa|
000008a0  75 6c 74 20 74 6f 20 74  68 65 20 73 74 61 6e 64  |ult to the stand|
000008b0  61 72 64 20 74 65 6c 6e  65 74 0a 20 20 70 6f 72  |ard telnet.  por|
000008c0  74 2e 20 42 6f 74 68 20  74 68 65 20 68 6f 73 74  |t. Both the host|
000008d0  20 61 6e 64 20 70 6f 72  74 20 77 72 69 74 61 62  | and port writab|
000008e0  6c 65 20 69 63 6f 6e 73  20 61 72 65 20 61 63 63  |le icons are acc|
000008f0  6f 6d 70 61 6e 69 65 64  20 62 79 0a 20 20 70 6f  |ompanied by.  po|
00000900  70 20 75 70 20 6d 65 6e  75 73 2c 20 61 6e 64 20  |p up menus, and |
00000910  74 68 65 72 65 20 69 73  20 61 6c 73 6f 20 61 20  |there is also a |
00000920  68 6f 74 20 6c 69 73 74  20 6f 6e 20 74 68 65 20  |hot list on the |
00000930  69 63 6f 6e 20 62 61 72  0a 20 20 6d 65 6e 75 2e  |icon bar.  menu.|
00000940  20 53 65 65 20 74 68 65  20 73 65 63 74 69 6f 6e  | See the section|
00000950  20 34 20 6f 66 20 74 68  69 73 20 6d 61 6e 75 61  | 4 of this manua|
00000960  6c 20 66 6f 72 20 64 65  74 61 69 6c 73 20 6f 6e  |l for details on|
00000970  20 68 6f 77 20 74 6f 20  73 65 74 0a 20 20 75 70  | how to set.  up|
00000980  20 74 68 65 73 65 20 6d  65 6e 75 73 2e 0a 0a 20  | these menus... |
00000990  20 53 65 6c 65 63 74 69  6e 67 20 63 65 72 74 61  | Selecting certa|
000009a0  69 6e 20 70 6f 72 74 73  20 28 69 6e 20 74 68 69  |in ports (in thi|
000009b0  73 20 63 75 72 72 65 6e  74 20 76 65 72 73 69 6f  |s current versio|
000009c0  6e 20 74 68 69 73 20 77  69 6c 6c 20 6f 6e 6c 79  |n this will only|
000009d0  0a 20 20 6f 63 63 75 72  20 77 69 74 68 20 22 66  |.  occur with "f|
000009e0  69 6e 67 65 72 22 29 20  77 69 6c 6c 20 63 61 75  |inger") will cau|
000009f0  73 65 20 74 68 65 20 64  69 61 6c 6f 67 75 65 20  |se the dialogue |
00000a00  62 6f 78 20 74 6f 20 65  78 70 61 6e 64 20 61 6e  |box to expand an|
00000a10  64 0a 20 20 64 69 73 70  6c 61 79 20 61 6e 64 20  |d.  display and |
00000a20  65 78 74 72 61 20 61 72  67 75 6d 65 6e 74 73 20  |extra arguments |
00000a30  66 69 65 6c 64 20 66 6f  72 20 65 78 74 72 61 20  |field for extra |
00000a40  70 61 72 61 6d 65 74 65  72 73 20 6e 65 65 64 65  |parameters neede|
00000a50  64 0a 20 20 74 6f 20 65  73 74 61 62 6c 69 73 68  |d.  to establish|
00000a60  20 61 20 63 65 72 74 61  69 6e 20 6b 69 6e 64 20  | a certain kind |
00000a70  6f 66 20 63 6f 6e 6e 65  63 74 69 6f 6e 2e 0a 0a  |of connection...|
00000a80  20 20 43 6c 69 63 6b 69  6e 67 20 6f 6e 20 74 68  |  Clicking on th|
00000a90  65 20 63 6f 6e 6e 65 63  74 20 62 75 74 74 6f 6e  |e connect button|
00000aa0  20 63 61 75 73 65 73 20  46 72 65 65 54 65 72 6d  | causes FreeTerm|
00000ab0  20 74 6f 20 65 73 74 61  62 6c 69 73 68 20 61 0a  | to establish a.|
00000ac0  20 20 63 6f 6e 6e 65 63  74 69 6f 6e 20 74 6f 20  |  connection to |
00000ad0  74 68 65 20 73 70 65 63  69 66 69 65 64 20 61 64  |the specified ad|
00000ae0  64 72 65 73 73 2c 20 61  6e 64 20 74 68 65 6e 20  |dress, and then |
00000af0  6f 70 65 6e 20 61 20 74  65 72 6d 69 6e 61 6c 0a  |open a terminal.|
00000b00  20 20 77 69 6e 64 6f 77  20 66 6f 72 20 74 68 65  |  window for the|
00000b10  20 63 6f 6e 6e 65 63 74  69 6f 6e 2e 20 46 6f 72  | connection. For|
00000b20  20 63 6f 6e 6e 65 63 74  69 6f 6e 73 20 74 6f 20  | connections to |
00000b30  74 68 65 20 64 65 66 61  75 6c 74 20 74 65 6c 6e  |the default teln|
00000b40  65 74 0a 20 20 70 6f 72  74 2c 20 74 68 69 73 20  |et.  port, this |
00000b50  77 69 6e 64 6f 77 20 77  69 6c 6c 20 64 65 66 61  |window will defa|
00000b60  75 6c 74 20 74 6f 20 63  68 61 72 61 63 74 65 72  |ult to character|
00000b70  20 6d 6f 64 65 20 28 77  68 65 72 65 20 65 61 63  | mode (where eac|
00000b80  68 0a 20 20 63 68 61 72  61 63 74 65 72 20 79 6f  |h.  character yo|
00000b90  75 20 74 79 70 65 20 69  73 20 74 72 61 6e 73 6d  |u type is transm|
00000ba0  69 74 74 65 64 20 73 74  72 61 69 67 68 74 20 61  |itted straight a|
00000bb0  77 61 79 29 20 69 66 20  74 68 61 74 20 69 73 0a  |way) if that is.|
00000bc0  20 20 61 63 63 65 70 74  61 62 6c 65 20 74 6f 20  |  acceptable to |
00000bd0  74 68 65 20 72 65 6d 6f  74 65 20 68 6f 73 74 2c  |the remote host,|
00000be0  20 6f 74 68 65 72 77 69  73 65 20 6c 69 6e 65 20  | otherwise line |
00000bf0  6d 6f 64 65 20 69 73 20  75 73 65 64 2e 0a 0a 32  |mode is used...2|
00000c00  2e 31 20 44 6f 77 6e 6c  6f 61 64 69 6e 67 20 61  |.1 Downloading a|
00000c10  6e 64 20 55 70 6c 6f 61  64 69 6e 67 20 74 65 78  |nd Uploading tex|
00000c20  74 2e 0a 0a 20 20 54 6f  20 73 65 6e 64 20 61 20  |t...  To send a |
00000c30  66 69 6c 65 20 64 6f 77  6e 20 74 68 65 20 74 65  |file down the te|
00000c40  6c 6e 65 74 20 63 6f 6e  6e 65 63 74 69 6f 6e 20  |lnet connection |
00000c50  64 72 61 67 20 69 74 20  74 6f 20 74 68 65 20 77  |drag it to the w|
00000c60  69 6e 64 6f 77 2e 20 54  6f 0a 20 20 73 61 76 65  |indow. To.  save|
00000c70  20 74 65 78 74 20 66 72  6f 6d 20 61 20 74 65 6c  | text from a tel|
00000c80  6e 65 74 20 77 69 6e 64  6f 77 20 68 69 67 68 6c  |net window highl|
00000c90  69 67 68 74 20 69 74 2c  20 61 6e 64 20 64 72 61  |ight it, and dra|
00000ca0  67 20 69 74 20 74 6f 20  61 20 66 69 6c 65 72 0a  |g it to a filer.|
00000cb0  20 20 77 69 6e 64 6f 77  2e 0a 0a 20 20 54 6f 20  |  window...  To |
00000cc0  64 6f 77 6e 6c 6f 61 64  20 6c 6f 6e 67 20 63 68  |download long ch|
00000cd0  75 6e 6b 73 20 6f 66 20  74 65 78 74 20 69 74 20  |unks of text it |
00000ce0  69 73 20 62 65 73 74 20  74 6f 20 75 73 65 20 74  |is best to use t|
00000cf0  68 65 20 73 70 6f 6f 6c  65 72 2c 20 75 73 65 0a  |he spooler, use.|
00000d00  20 20 74 68 65 20 22 53  70 6f 6f 6c 3e 4f 70 65  |  the "Spool>Ope|
00000d10  6e 22 20 73 61 76 65 20  61 73 20 64 69 61 6c 6f  |n" save as dialo|
00000d20  67 75 65 20 74 6f 20 6c  6f 63 61 74 65 20 79 6f  |gue to locate yo|
00000d30  75 72 20 73 70 6f 6f 6c  66 69 6c 65 20 61 6e 64  |ur spoolfile and|
00000d40  0a 20 20 73 74 61 72 74  20 72 65 63 6f 72 64 69  |.  start recordi|
00000d50  6e 67 2e 20 54 68 65 20  73 70 6f 6f 6c 20 6d 61  |ng. The spool ma|
00000d60  79 20 62 65 20 70 61 75  73 65 64 2c 20 61 6e 64  |y be paused, and|
00000d70  20 73 65 6c 65 63 74 69  6e 67 20 74 68 65 0a 20  | selecting the. |
00000d80  20 22 53 70 6f 6f 6c 3e  53 74 72 69 70 22 20 6f  | "Spool>Strip" o|
00000d90  70 74 69 6f 6e 20 77 69  6c 6c 20 66 69 6c 74 65  |ption will filte|
00000da0  72 20 63 6f 6e 74 72 6f  6c 20 63 6f 64 65 73 20  |r control codes |
00000db0  66 72 6f 6d 20 74 68 65  20 6f 75 74 70 75 74 2e  |from the output.|
00000dc0  0a 20 20 57 68 65 6e 20  79 6f 75 20 68 61 76 65  |.  When you have|
00000dd0  20 66 69 6e 69 73 68 65  64 20 73 70 6f 6f 6c 69  | finished spooli|
00000de0  6e 67 20 63 6c 69 63 6b  20 22 53 70 6f 6f 6c 3e  |ng click "Spool>|
00000df0  43 6c 6f 73 65 22 0a 0a  20 20 4e 42 20 3a 20 46  |Close"..  NB : F|
00000e00  72 65 65 54 65 72 6d 20  6f 6e 6c 79 20 68 61 6e  |reeTerm only han|
00000e10  64 6c 65 73 20 74 65 78  74 20 64 6f 77 6e 6c 6f  |dles text downlo|
00000e20  61 64 73 20 61 6e 64 20  75 70 6c 6f 61 64 73 2c  |ads and uploads,|
00000e30  20 5a 4d 6f 64 65 6d 0a  20 20 20 20 20 20 20 74  | ZModem.       t|
00000e40  72 61 6e 73 66 65 72 73  20 6d 61 79 20 62 65 20  |ransfers may be |
00000e50  69 6d 70 6c 65 6d 65 6e  74 65 64 20 69 6e 20 74  |implemented in t|
00000e60  68 65 20 66 75 74 75 72  65 2e 0a 0a 32 2e 32 20  |he future...2.2 |
00000e70  44 69 73 63 6f 6e 6e 65  63 74 69 6f 6e 0a 0a 20  |Disconnection.. |
00000e80  20 43 6c 6f 73 69 6e 67  20 61 20 74 65 72 6d 69  | Closing a termi|
00000e90  6e 61 6c 20 77 69 6e 64  6f 77 20 77 69 6c 6c 20  |nal window will |
00000ea0  72 65 73 75 6c 74 20 69  6e 20 74 68 65 20 63 6f  |result in the co|
00000eb0  6e 6e 65 63 74 69 6f 6e  20 74 6f 20 74 68 65 0a  |nnection to the.|
00000ec0  20 20 72 65 6d 6f 74 65  20 68 6f 73 74 20 62 65  |  remote host be|
00000ed0  69 6e 67 20 64 72 6f 70  70 65 64 2c 20 77 68 69  |ing dropped, whi|
00000ee0  6c 73 74 20 74 68 65 20  72 65 6d 6f 74 65 20 68  |lst the remote h|
00000ef0  6f 73 74 20 64 72 6f 70  70 69 6e 67 20 61 6e 20  |ost dropping an |
00000f00  6f 70 65 6e 0a 20 20 63  6f 6e 6e 65 63 74 69 6f  |open.  connectio|
00000f10  6e 20 77 69 6c 6c 20 72  65 73 75 6c 74 20 69 6e  |n will result in|
00000f20  20 61 20 6d 65 73 73 61  67 65 20 69 6e 20 74 68  | a message in th|
00000f30  65 20 74 65 72 6d 69 6e  61 6c 20 77 69 6e 64 6f  |e terminal windo|
00000f40  77 2e 0a 0a 33 2e 20 55  73 69 6e 67 20 66 69 6e  |w...3. Using fin|
00000f50  67 65 72 0a 0a 20 20 46  69 6e 67 65 72 20 69 73  |ger..  Finger is|
00000f60  20 61 6e 20 69 6e 74 65  72 6e 65 74 20 73 65 72  | an internet ser|
00000f70  76 69 63 65 20 66 6f 72  20 66 69 6e 64 69 6e 67  |vice for finding|
00000f80  20 6f 75 74 20 77 68 6f  20 69 73 20 75 73 69 6e  | out who is usin|
00000f90  67 20 61 20 73 79 73 74  65 6d 2c 0a 20 20 6f 72  |g a system,.  or|
00000fa0  20 66 69 6e 64 69 6e 67  20 6f 75 74 20 61 62 6f  | finding out abo|
00000fb0  75 74 20 75 73 65 72 73  20 6f 6e 20 61 20 73 79  |ut users on a sy|
00000fc0  73 74 65 6d 2e 20 46 72  65 65 54 65 72 6d 20 69  |stem. FreeTerm i|
00000fd0  6e 63 6c 75 64 65 73 20  61 20 66 69 6e 67 65 72  |ncludes a finger|
00000fe0  0a 20 20 63 6c 69 65 6e  74 2e 20 54 6f 20 75 73  |.  client. To us|
00000ff0  65 20 69 74 20 65 6e 74  65 72 20 61 20 68 6f 73  |e it enter a hos|
00001000  74 6e 61 6d 65 20 69 6e  20 74 68 65 20 6e 6f 72  |tname in the nor|
00001010  6d 61 6c 20 77 61 79 20  61 6e 64 20 73 65 6c 65  |mal way and sele|
00001020  63 74 0a 20 20 22 46 69  6e 67 65 72 22 20 61 73  |ct.  "Finger" as|
00001030  20 74 68 65 20 70 6f 72  74 2c 20 74 68 65 20 63  | the port, the c|
00001040  6f 6e 6e 65 63 74 20 77  69 6e 64 6f 77 20 77 69  |onnect window wi|
00001050  6c 6c 20 67 72 6f 77 20  61 6e 20 65 78 74 72 61  |ll grow an extra|
00001060  0a 20 20 77 72 69 74 65  61 62 6c 65 20 69 63 6f  |.  writeable ico|
00001070  6e 2c 20 74 68 69 73 20  69 73 20 77 68 65 72 65  |n, this is where|
00001080  20 79 6f 75 20 65 6e 74  65 72 20 74 68 65 20 66  | you enter the f|
00001090  69 6e 67 65 72 20 73 74  72 69 6e 67 2e 0a 0a 20  |inger string... |
000010a0  20 54 68 65 20 66 69 6e  67 65 72 20 73 74 72 69  | The finger stri|
000010b0  6e 67 20 73 70 65 63 69  66 69 65 73 20 77 68 61  |ng specifies wha|
000010c0  74 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 79 6f  |t information yo|
000010d0  75 20 77 61 6e 74 20 66  72 6f 6d 20 74 68 65 0a  |u want from the.|
000010e0  20 20 72 65 6d 6f 74 65  20 73 79 73 74 65 6d 2e  |  remote system.|
000010f0  20 54 68 65 20 6d 6f 73  74 20 63 6f 6d 6d 6f 6e  | The most common|
00001100  20 74 79 70 65 73 20 6f  66 20 66 69 6e 67 65 72  | types of finger|
00001110  20 73 74 72 69 6e 67 73  20 61 72 65 0a 20 20 6c  | strings are.  l|
00001120  69 73 74 65 64 20 62 65  6c 6f 77 2e 0a 0a 20 20  |isted below...  |
00001130  3c 42 6c 61 6e 6b 3e 20  20 2d 20 41 6e 20 65 6d  |<Blank>  - An em|
00001140  70 74 79 20 66 69 6e 67  65 72 20 73 74 72 69 6e  |pty finger strin|
00001150  67 20 6c 69 73 74 73 20  61 6c 6c 20 74 68 65 20  |g lists all the |
00001160  75 73 65 72 73 20 6f 6e  20 61 20 73 79 73 74 65  |users on a syste|
00001170  6d 2e 0a 20 20 75 73 65  72 20 20 20 20 20 2d 20  |m..  user     - |
00001180  45 6e 74 65 72 69 6e 67  20 61 20 76 61 6c 69 64  |Entering a valid|
00001190  20 75 73 65 72 6e 61 6d  65 20 72 65 74 75 72 6e  | username return|
000011a0  73 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 6f 6e  |s information on|
000011b0  20 61 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  | a.             |
000011c0  73 70 65 63 69 66 69 63  20 75 73 65 72 2e 0a 0a  |specific user...|
000011d0  20 20 2e 2e 2e 79 6f 75  20 63 61 6e 20 75 73 65  |  ...you can use|
000011e0  20 74 68 65 20 40 20 63  68 61 72 61 63 74 65 72  | the @ character|
000011f0  20 74 6f 20 66 69 6e 67  65 72 20 76 69 61 20 74  | to finger via t|
00001200  68 65 20 73 79 73 74 65  6d 20 79 6f 75 20 61 72  |he system you ar|
00001210  65 0a 20 20 63 6f 6e 6e  65 63 74 69 6e 67 20 74  |e.  connecting t|
00001220  6f 2e 20 53 6f 20 3a 0a  0a 20 20 40 77 69 62 62  |o. So :..  @wibb|
00001230  6c 65 2e 63 6f 6d 20 20  20 20 20 2d 20 6c 69 73  |le.com     - lis|
00001240  74 73 20 74 68 65 20 75  73 65 72 73 20 6f 6e 20  |ts the users on |
00001250  77 69 62 62 6c 65 2e 63  6f 6d 20 76 69 61 20 74  |wibble.com via t|
00001260  68 65 20 73 79 73 74 65  6d 20 79 6f 75 0a 20 20  |he system you.  |
00001270  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001280  20 20 61 63 74 75 61 6c  6c 79 20 63 6f 6e 6e 65  |  actually conne|
00001290  63 74 65 64 20 74 6f 2e  0a 20 20 6a 61 63 6b 40  |cted to..  jack@|
000012a0  77 69 62 62 6c 65 2e 63  6f 6d 20 2d 20 67 65 74  |wibble.com - get|
000012b0  73 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 6f 6e  |s information on|
000012c0  20 74 68 65 20 75 73 65  72 20 27 6a 61 63 6b 27  | the user 'jack'|
000012d0  20 6f 6e 20 77 69 62 62  6c 65 2e 63 6f 6d 0a 20  | on wibble.com. |
000012e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000012f0  20 20 20 76 69 61 20 74  68 65 20 73 79 73 74 65  |   via the syste|
00001300  6d 20 79 6f 75 20 61 63  74 75 61 6c 6c 79 20 63  |m you actually c|
00001310  6f 6e 6e 65 63 74 65 64  20 74 6f 2e 0a 0a 20 20  |onnected to...  |
00001320  59 6f 75 20 63 61 6e 20  75 73 65 20 61 73 20 6d  |You can use as m|
00001330  61 6e 79 20 40 27 73 20  61 73 20 79 6f 75 20 6e  |any @'s as you n|
00001340  65 65 64 2c 20 62 75 74  20 61 74 20 6d 6f 73 74  |eed, but at most|
00001350  20 79 6f 75 20 73 68 6f  75 6c 64 20 6f 6e 6c 79  | you should only|
00001360  0a 20 20 6e 65 65 64 20  6f 6e 65 20 69 66 20 79  |.  need one if y|
00001370  6f 75 20 65 76 65 72 20  6e 65 65 64 20 74 6f 20  |ou ever need to |
00001380  66 69 6e 67 65 72 20 74  68 72 6f 75 67 68 20 61  |finger through a|
00001390  20 66 69 72 65 77 61 6c  6c 2e 20 0a 0a 20 20 46  | firewall. ..  F|
000013a0  6f 72 20 6d 6f 72 65 20  69 6e 66 6f 72 6d 61 74  |or more informat|
000013b0  69 6f 6e 20 6f 6e 20 66  69 6e 67 65 72 20 73 65  |ion on finger se|
000013c0  65 20 52 46 43 31 32 38  38 2e 0a 0a 34 2e 20 54  |e RFC1288...4. T|
000013d0  68 65 20 68 6f 73 74 20  61 6e 64 20 70 6f 72 74  |he host and port|
000013e0  20 6d 65 6e 75 73 0a 0a  20 20 54 68 65 20 63 6f  | menus..  The co|
000013f0  6e 6e 65 63 74 69 6f 6e  20 64 69 61 6c 6f 67 75  |nnection dialogu|
00001400  65 20 66 65 61 74 75 72  65 73 20 74 77 6f 20 77  |e features two w|
00001410  72 69 74 65 61 62 6c 65  20 69 63 6f 6e 73 20 66  |riteable icons f|
00001420  6f 72 20 65 6e 74 65 72  69 6e 67 0a 20 20 74 68  |or entering.  th|
00001430  65 20 70 6f 72 74 20 6e  61 6d 65 2f 6e 75 6d 62  |e port name/numb|
00001440  65 72 20 61 6e 64 20 74  68 65 20 68 6f 73 74 20  |er and the host |
00001450  79 6f 75 20 77 69 73 68  20 74 6f 20 63 6f 6e 6e  |you wish to conn|
00001460  65 63 74 20 74 6f 2e 20  48 6f 73 74 6e 61 6d 65  |ect to. Hostname|
00001470  73 0a 20 20 61 72 65 20  75 73 75 61 6c 6c 79 20  |s.  are usually |
00001480  66 61 69 72 6c 79 20 6c  6f 6e 67 2c 20 61 6e 64  |fairly long, and|
00001490  20 6f 6e 20 61 20 6c 6f  63 61 6c 20 6e 65 74 77  | on a local netw|
000014a0  6f 72 6b 20 77 69 74 68  20 6f 6e 6c 79 20 61 20  |ork with only a |
000014b0  66 65 77 0a 20 20 68 6f  73 74 73 20 74 79 70 69  |few.  hosts typi|
000014c0  6e 67 20 74 68 65 20 73  61 6d 65 20 74 68 69 6e  |ng the same thin|
000014d0  67 20 65 61 63 68 20 74  69 6d 65 20 79 6f 75 20  |g each time you |
000014e0  77 69 73 68 20 74 6f 20  63 6f 6e 6e 65 63 74 20  |wish to connect |
000014f0  74 6f 20 61 20 68 6f 73  74 0a 20 20 73 6f 6f 6e  |to a host.  soon|
00001500  20 62 65 63 6f 6d 65 73  20 74 69 72 65 73 6f 6d  | becomes tiresom|
00001510  65 2e 20 46 72 65 65 54  65 72 6d 20 76 30 2e 31  |e. FreeTerm v0.1|
00001520  32 20 61 6e 64 20 6c 61  74 65 72 20 73 6f 6c 76  |2 and later solv|
00001530  65 20 74 68 69 73 20 62  79 20 77 61 79 0a 20 20  |e this by way.  |
00001540  6f 66 20 70 6f 70 20 75  70 20 6d 65 6e 75 73 2c  |of pop up menus,|
00001550  20 77 68 69 63 68 20 61  72 65 20 74 72 69 67 67  | which are trigg|
00001560  65 72 65 64 20 62 79 20  61 20 62 75 74 74 6f 6e  |ered by a button|
00001570  20 61 6c 6f 6e 67 73 69  64 65 20 65 61 63 68 0a  | alongside each.|
00001580  20 20 77 72 69 74 65 61  62 6c 65 20 69 63 6f 6e  |  writeable icon|
00001590  2e 20 54 68 65 20 68 6f  73 74 20 6d 65 6e 75 20  |. The host menu |
000015a0  6c 69 73 74 73 20 65 6e  74 72 69 65 73 20 69 6e  |lists entries in|
000015b0  20 74 68 65 20 66 6f 72  6d 61 74 20 3a 0a 0a 20  | the format :.. |
000015c0  20 66 6f 6f 2e 62 61 72  2e 63 6f 2e 75 6b 20 28  | foo.bar.co.uk (|
000015d0  54 65 6c 6e 65 74 29 0a  20 20 6d 6f 6f 2e 63 6f  |Telnet).  moo.co|
000015e0  77 2e 63 6f 6d 20 28 46  69 6e 67 65 72 29 0a 20  |w.com (Finger). |
000015f0  20 77 69 62 62 6c 65 2e  7a 6f 6e 6b 2e 6f 72 67  | wibble.zonk.org|
00001600  0a 20 20 2e 2e 2e 0a 0a  20 20 54 68 65 20 70 6f  |.  .....  The po|
00001610  72 74 20 6e 61 6d 65 20  69 6e 20 62 72 61 63 6b  |rt name in brack|
00001620  65 74 73 20 69 73 20 74  68 65 20 64 65 66 61 75  |ets is the defau|
00001630  6c 74 20 70 6f 72 74 2c  20 6e 6f 74 20 61 6c 6c  |lt port, not all|
00001640  20 65 6e 74 72 69 65 73  20 6d 61 79 0a 20 20 68  | entries may.  h|
00001650  61 76 65 20 61 20 64 65  66 61 75 6c 74 20 70 6f  |ave a default po|
00001660  72 74 2e 20 43 6c 69 63  6b 69 6e 67 20 6f 6e 20  |rt. Clicking on |
00001670  61 6e 20 65 6e 74 72 79  20 69 6e 20 74 68 65 20  |an entry in the |
00001680  6d 65 6e 75 20 66 69 6c  6c 73 20 69 6e 20 74 68  |menu fills in th|
00001690  65 0a 20 20 77 72 69 74  61 62 6c 65 20 66 69 65  |e.  writable fie|
000016a0  6c 64 73 20 69 6e 20 74  68 65 20 63 6f 6e 6e 65  |lds in the conne|
000016b0  63 74 69 6f 6e 20 62 6f  78 20 77 69 74 68 20 74  |ction box with t|
000016c0  68 65 20 68 6f 73 74 6e  61 6d 65 20 61 6e 64 20  |he hostname and |
000016d0  70 6f 72 74 6e 61 6d 65  0a 20 20 28 69 66 20 70  |portname.  (if p|
000016e0  72 65 73 65 6e 74 29 2c  20 6c 65 61 76 69 6e 67  |resent), leaving|
000016f0  20 79 6f 75 20 74 6f 20  70 72 65 73 73 20 74 68  | you to press th|
00001700  65 20 22 43 6f 6e 6e 65  63 74 22 20 62 75 74 74  |e "Connect" butt|
00001710  6f 6e 2e 0a 0a 20 20 54  68 65 20 69 63 6f 6e 20  |on...  The icon |
00001720  62 61 72 20 68 6f 74 20  6c 69 73 74 20 69 73 20  |bar hot list is |
00001730  65 78 61 63 74 6c 79 20  74 68 65 20 73 61 6d 65  |exactly the same|
00001740  20 61 73 20 74 68 65 20  68 6f 73 74 20 6d 65 6e  | as the host men|
00001750  75 2c 20 65 78 63 65 70  74 0a 20 20 74 68 61 74  |u, except.  that|
00001760  20 69 66 20 79 6f 75 20  63 6c 69 63 6b 20 6f 6e  | if you click on|
00001770  20 61 6e 20 65 6e 74 72  79 20 77 69 74 68 20 62  | an entry with b|
00001780  6f 74 68 20 61 20 64 65  66 61 75 6c 74 20 70 6f  |oth a default po|
00001790  72 74 20 61 6e 64 20 68  6f 73 74 20 6e 61 6d 65  |rt and host name|
000017a0  0a 20 20 74 68 65 20 63  6f 6e 6e 65 63 74 69 6f  |.  the connectio|
000017b0  6e 20 73 74 61 72 74 73  20 69 6d 6d 65 64 69 61  |n starts immedia|
000017c0  74 65 6c 79 2e 20 49 66  20 74 68 65 20 65 6e 74  |tely. If the ent|
000017d0  72 79 20 68 61 73 20 6e  6f 20 64 65 66 61 75 6c  |ry has no defaul|
000017e0  74 20 70 6f 72 74 0a 20  20 74 68 65 20 63 6f 6e  |t port.  the con|
000017f0  6e 65 63 74 20 64 69 61  6c 6f 67 75 65 20 62 6f  |nect dialogue bo|
00001800  78 20 69 73 20 64 69 73  70 6c 61 79 65 64 20 66  |x is displayed f|
00001810  6f 72 20 79 6f 75 20 74  6f 20 65 6e 74 65 72 20  |or you to enter |
00001820  61 20 70 6f 72 74 6e 61  6d 65 2e 0a 0a 20 20 54  |a portname...  T|
00001830  68 65 20 70 6f 72 74 20  6d 65 6e 75 20 73 69 6d  |he port menu sim|
00001840  70 6c 79 20 6c 69 73 74  73 20 66 72 65 71 75 65  |ply lists freque|
00001850  6e 74 6c 79 20 75 73 65  64 20 70 6f 72 74 6e 61  |ntly used portna|
00001860  6d 65 73 2c 20 63 6c 69  63 6b 69 6e 67 20 6f 6e  |mes, clicking on|
00001870  20 61 6e 0a 20 20 65 6e  74 72 79 20 69 6e 20 74  | an.  entry in t|
00001880  68 65 20 6d 65 6e 75 20  63 6f 70 69 65 73 20 74  |he menu copies t|
00001890  68 65 20 70 6f 72 74 6e  61 6d 65 20 74 6f 20 74  |he portname to t|
000018a0  68 65 20 77 72 69 74 65  61 62 6c 65 20 69 63 6f  |he writeable ico|
000018b0  6e 2e 0a 0a 20 20 54 68  65 20 63 6f 6e 74 65 6e  |n...  The conten|
000018c0  74 73 20 6f 66 20 74 68  65 20 68 6f 73 74 20 6d  |ts of the host m|
000018d0  65 6e 75 2f 68 6f 74 6c  69 73 74 20 61 6e 64 20  |enu/hotlist and |
000018e0  70 6f 72 74 20 6d 65 6e  75 20 61 72 65 20 72 65  |port menu are re|
000018f0  61 64 20 66 72 6f 6d 0a  20 20 63 6f 6e 66 69 67  |ad from.  config|
00001900  75 72 61 74 69 6f 6e 20  66 69 6c 65 73 20 69 6e  |uration files in|
00001910  20 21 46 72 65 65 55 73  65 72 2e 46 69 6c 65 73  | !FreeUser.Files|
00001920  2e 46 72 65 65 54 65 72  6d 2c 20 6e 61 6d 65 6c  |.FreeTerm, namel|
00001930  79 20 48 6f 73 74 4c 69  73 74 0a 20 20 61 6e 64  |y HostList.  and|
00001940  20 50 6f 72 74 4c 69 73  74 2e 20 54 68 65 20 66  | PortList. The f|
00001950  6f 72 6d 61 74 20 6f 66  20 74 68 65 73 65 20 66  |ormat of these f|
00001960  69 6c 65 73 20 69 73 20  65 78 70 6c 61 69 6e 65  |iles is explaine|
00001970  64 20 69 6e 20 74 68 65  69 72 0a 20 20 63 6f 6d  |d in their.  com|
00001980  6d 65 6e 74 73 2e 0a 0a  20 20 49 6e 20 6f 6c 64  |ments...  In old|
00001990  65 72 20 76 65 72 73 69  6f 6e 73 20 6f 66 20 46  |er versions of F|
000019a0  72 65 65 54 65 72 6d 20  79 6f 75 20 68 61 6e 64  |reeTerm you hand|
000019b0  20 65 64 69 74 20 74 68  65 73 65 20 66 69 6c 65  | edit these file|
000019c0  73 2c 20 79 6f 75 20 73  74 69 6c 6c 0a 20 20 63  |s, you still.  c|
000019d0  61 6e 2c 20 62 75 74 20  74 68 65 72 65 20 69 73  |an, but there is|
000019e0  20 6e 6f 77 20 61 20 75  73 65 72 20 69 6e 74 65  | now a user inte|
000019f0  72 66 61 63 65 20 69 6e  20 74 68 65 20 63 6f 6e  |rface in the con|
00001a00  66 69 67 75 72 61 74 69  6f 6e 20 77 69 6e 64 6f  |figuration windo|
00001a10  77 0a 20 20 28 61 63 63  65 73 73 61 62 6c 65 20  |w.  (accessable |
00001a20  66 72 6f 6d 20 74 68 65  20 69 63 6f 6e 62 61 72  |from the iconbar|
00001a30  20 27 43 6f 6e 66 69 67  75 72 65 27 20 6f 70 74  | 'Configure' opt|
00001a40  69 6f 6e 29 2e 0a 0a 35  2e 20 4f 74 68 65 72 20  |ion)...5. Other |
00001a50  73 74 75 66 66 0a 0a 20  20 20 54 68 65 20 77 69  |stuff..   The wi|
00001a60  6e 64 6f 77 20 66 69 6e  64 65 72 20 28 6f 66 66  |ndow finder (off|
00001a70  20 74 68 65 20 69 63 6f  6e 20 62 61 72 20 6d 65  | the icon bar me|
00001a80  6e 75 29 20 67 69 76 65  73 20 79 6f 75 20 61 20  |nu) gives you a |
00001a90  6c 69 73 74 20 6f 66 20  74 65 72 6d 69 6e 61 6c  |list of terminal|
00001aa0  0a 20 20 20 77 69 6e 64  6f 77 73 20 6f 70 65 6e  |.   windows open|
00001ab0  20 2d 20 63 6c 69 63 6b  20 6f 6e 20 6f 6e 65 20  | - click on one |
00001ac0  74 6f 20 62 72 69 6e 67  20 69 74 20 74 6f 20 74  |to bring it to t|
00001ad0  68 65 20 74 6f 70 2e 0a  0a 20 20 20 54 68 65 20  |he top...   The |
00001ae0  56 54 31 30 30 20 6b 65  79 70 61 64 20 69 73 20  |VT100 keypad is |
00001af0  75 73 65 66 75 6c 20 6f  6e 20 56 4d 53 20 73 79  |useful on VMS sy|
00001b00  73 74 65 6d 73 20 65 74  63 2e 20 49 66 20 79 6f  |stems etc. If yo|
00001b10  75 20 64 6f 6e 27 74 20  6b 6e 6f 77 20 77 68 61  |u don't know wha|
00001b20  74 0a 20 20 20 69 74 20  69 73 20 6f 72 20 68 6f  |t.   it is or ho|
00001b30  77 20 74 6f 20 75 73 65  20 69 74 20 79 6f 75 20  |w to use it you |
00001b40  70 72 6f 62 61 62 6c 79  20 64 6f 6e 27 74 20 6e  |probably don't n|
00001b50  65 65 64 20 69 74 2e 0a  0a 36 2e 20 43 4c 49 20  |eed it...6. CLI |
00001b60  6f 70 74 69 6f 6e 73 0a  0a 20 20 2d 64 65 62 75  |options..  -debu|
00001b70  67 20 20 20 20 20 20 20  54 72 61 63 65 73 20 66  |g       Traces f|
00001b80  6c 6f 77 20 6e 65 67 6f  63 69 61 74 69 6f 6e 20  |low negociation |
00001b90  74 6f 20 74 65 72 6d 69  6e 61 6c 73 20 61 73 20  |to terminals as |
00001ba0  70 65 72 20 70 72 65 2d  72 65 6c 65 61 73 65 0a  |per pre-release.|
00001bb0  20 20 2d 70 6f 72 74 20  3c 70 6f 72 74 3e 0a 20  |  -port <port>. |
00001bc0  20 2d 68 6f 73 74 20 3c  68 6f 73 74 3e 20 54 68  | -host <host> Th|
00001bd0  65 73 65 20 74 77 6f 20  6f 70 74 69 6f 6e 73 20  |ese two options |
00001be0  63 61 6e 20 62 65 20 75  73 65 64 20 74 6f 20 61  |can be used to a|
00001bf0  75 74 6f 20 73 74 61 72  74 20 61 20 73 65 73 73  |uto start a sess|
00001c00  69 6f 6e 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ion.            |
00001c10  20 20 20 61 73 20 73 6f  6f 6e 20 61 73 20 21 46  |   as soon as !F|
00001c20  72 65 65 54 65 72 6d 20  69 73 20 6c 6f 61 64 65  |reeTerm is loade|
00001c30  64 2e 0a 20 20 2d 61 72  67 73 20 3c 2e 2e 2e 3e  |d..  -args <...>|
00001c40  20 20 55 73 65 64 20 74  6f 20 73 70 65 63 69 66  |  Used to specif|
00001c50  79 20 61 72 67 75 6d 65  6e 74 73 20 69 66 20 79  |y arguments if y|
00001c60  6f 75 20 68 61 76 65 20  73 70 65 63 69 66 69 65  |ou have specifie|
00001c70  64 20 61 20 70 6f 72 74  0a 20 20 20 20 20 20 20  |d a port.       |
00001c80  20 20 20 20 20 20 20 20  77 68 69 63 68 20 6d 61  |        which ma|
00001c90  6b 65 73 20 75 73 65 20  6f 66 20 74 68 65 6d 20  |kes use of them |
00001ca0  28 69 65 20 66 69 6e 67  65 72 29 0a 20 20 2d 6e  |(ie finger).  -n|
00001cb0  6f 70 6f 70 20 20 20 20  20 20 20 4e 6f 20 70 6f  |opop       No po|
00001cc0  70 2d 75 70 20 72 65 73  6f 6c 76 69 6e 67 20 6d  |p-up resolving m|
00001cd0  65 73 73 61 67 65 73 2c  20 61 6c 6c 20 70 72 6f  |essages, all pro|
00001ce0  62 6c 65 6d 73 20 72 65  70 6f 72 74 65 64 20 76  |blems reported v|
00001cf0  69 61 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ia.             |
00001d00  20 20 66 75 6c 6c 20 65  72 72 6f 72 73 2e 0a 0a  |  full errors...|
00001d10  37 2e 20 4d 69 73 63 65  6c 6c 61 6e 65 6f 75 73  |7. Miscellaneous|
00001d20  20 6e 6f 74 65 73 0a 0a  20 20 49 66 20 79 6f 75  | notes..  If you|
00001d30  72 20 46 72 65 65 54 65  72 6d 20 73 65 73 73 69  |r FreeTerm sessi|
00001d40  6f 6e 20 74 6f 20 61 20  75 6e 69 78 20 73 68 65  |on to a unix she|
00001d50  6c 6c 20 67 65 74 73 20  6d 75 6e 67 65 64 20 74  |ll gets munged t|
00001d60  72 79 20 27 72 65 73 65  74 27 2e 20 54 68 65 0a  |ry 'reset'. The.|
00001d70  20 20 73 65 73 73 69 6f  6e 20 73 68 6f 75 6c 64  |  session should|
00001d80  20 63 6c 65 61 72 2c 20  61 6e 64 20 61 66 74 65  | clear, and afte|
00001d90  72 20 61 20 66 65 77 20  3c 43 52 3e 27 73 20 79  |r a few <CR>'s y|
00001da0  6f 75 20 73 68 6f 75 6c  64 20 67 65 74 20 61 20  |ou should get a |
00001db0  6e 6f 72 6d 61 6c 0a 20  20 70 72 6f 6d 70 74 2e  |normal.  prompt.|
00001dc0  0a 0a 20 20 54 68 65 20  61 75 74 6f 20 63 6c 6f  |..  The auto clo|
00001dd0  73 65 20 63 68 65 63 6b  20 62 6f 78 20 69 6e 20  |se check box in |
00001de0  74 68 65 20 63 6f 6e 66  69 67 75 72 61 74 69 6f  |the configuratio|
00001df0  6e 20 77 69 6e 64 6f 77  20 77 69 6c 6c 20 6d 61  |n window will ma|
00001e00  6b 65 20 5f 74 65 6c 6e  65 74 5f 0a 20 20 73 65  |ke _telnet_.  se|
00001e10  73 73 69 6f 6e 20 77 69  6e 64 6f 77 73 20 63 6c  |ssion windows cl|
00001e20  6f 73 65 20 61 75 74 6f  6d 61 74 69 63 61 6c 6c  |ose automaticall|
00001e30  79 20 69 66 20 74 68 65  20 72 65 6d 6f 74 65 20  |y if the remote |
00001e40  65 6e 64 20 64 72 6f 70  73 20 74 68 65 0a 20 20  |end drops the.  |
00001e50  63 6f 6e 6e 65 63 74 69  6f 6e 2e 0a 0a 38 2e 20  |connection...8. |
00001e60  50 72 6f 67 72 61 6d 6d  65 72 73 27 20 67 75 66  |Programmers' guf|
00001e70  66 0a 0a 20 20 54 6f 20  74 72 69 67 67 65 72 20  |f..  To trigger |
00001e80  61 20 73 65 73 73 69 6f  6e 20 76 69 61 20 61 20  |a session via a |
00001e90  57 49 4d 50 20 6d 65 73  73 61 67 65 20 73 65 6e  |WIMP message sen|
00001ea0  64 20 4d 65 73 73 61 67  65 5f 46 72 65 65 54 65  |d Message_FreeTe|
00001eb0  72 6d 4f 70 20 28 26 34  34 30 41 36 29 2e 0a 20  |rmOp (&440A6).. |
00001ec0  20 54 68 65 20 64 61 74  61 20 73 65 63 74 69 6f  | The data sectio|
00001ed0  6e 20 73 68 6f 75 6c 64  20 6c 6f 6f 6b 20 61 73  |n should look as|
00001ee0  20 66 6f 6c 6c 6f 77 73  20 3a 0a 0a 20 20 6c 65  | follows :..  le|
00001ef0  6e 67 74 68 20 20 20 20  20 20 74 79 70 65 20 20  |ngth      type  |
00001f00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001f10  20 20 20 20 64 65 73 63  72 69 70 74 69 6f 6e 0a  |    description.|
00001f20  20 20 34 20 62 79 74 65  73 20 20 20 20 20 69 6e  |  4 bytes     in|
00001f30  74 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |t               |
00001f40  20 20 20 20 20 20 20 20  61 63 74 69 6f 6e 20 63  |        action c|
00001f50  6f 64 65 20 3d 3d 20 32  0a 20 20 38 20 62 79 74  |ode == 2.  8 byt|
00001f60  65 73 20 20 20 20 20 65  6d 70 74 79 0a 20 20 36  |es     empty.  6|
00001f70  34 20 62 79 74 65 73 20  20 20 20 6e 75 6c 6c 20  |4 bytes    null |
00001f80  74 65 72 6d 69 6e 61 74  65 64 20 73 74 72 69 6e  |terminated strin|
00001f90  67 20 20 20 20 70 6f 72  74 20 6e 61 6d 65 2f 6e  |g    port name/n|
00001fa0  75 6d 62 65 72 0a 20 20  38 30 20 62 79 74 65 73  |umber.  80 bytes|
00001fb0  20 20 20 20 6e 75 6c 6c  20 74 65 72 6d 69 6e 61  |    null termina|
00001fc0  74 65 64 20 73 74 72 69  6e 67 20 20 20 20 64 65  |ted string    de|
00001fd0  73 74 69 6e 61 74 69 6f  6e 20 61 64 64 72 65 73  |stination addres|
00001fe0  73 0a 20 20 38 30 20 62  79 74 65 73 20 20 20 20  |s.  80 bytes    |
00001ff0  6e 75 6c 6c 20 74 65 72  6d 69 6e 61 74 65 64 20  |null terminated |
00002000  73 74 72 69 6e 67 20 20  20 20 74 68 65 20 61 72  |string    the ar|
00002010  67 75 6d 65 6e 74 73 0a  20 20 2d 2d 2d 2d 2d 2d  |guments.  ------|
00002020  2d 2d 0a 20 20 32 33 36  20 3d 20 74 6f 74 61 6c  |--.  236 = total|
00002030  20 6c 65 6e 67 74 68 0a  0a 20 20 54 68 69 73 20  | length..  This |
00002040  6d 65 73 73 61 67 65 20  69 73 20 61 63 6b 65 64  |message is acked|
00002050  20 69 66 20 72 65 63 69  65 76 65 64 20 62 79 20  | if recieved by |
00002060  46 72 65 65 54 65 72 6d  2e 20 4f 53 4c 69 62 20  |FreeTerm. OSLib |
00002070  65 78 61 6d 70 6c 65 20  69 6e 20 43 0a 20 20 66  |example in C.  f|
00002080  6f 6c 6c 6f 77 73 20 3a  0a 0a 20 20 23 69 6e 63  |ollows :..  #inc|
00002090  6c 75 64 65 20 22 6f 73  6c 69 62 3a 75 73 65 72  |lude "oslib:user|
000020a0  2e 77 69 6d 70 2e 68 22  0a 20 20 23 69 6e 63 6c  |.wimp.h".  #incl|
000020b0  75 64 65 20 22 6b 65 72  6e 65 6c 2e 68 22 0a 20  |ude "kernel.h". |
000020c0  20 23 69 6e 63 6c 75 64  65 20 3c 73 74 72 69 6e  | #include <strin|
000020d0  67 2e 68 3e 0a 20 20 0a  20 20 23 64 65 66 69 6e  |g.h>.  .  #defin|
000020e0  65 20 4d 65 73 73 61 67  65 5f 46 72 65 65 54 65  |e Message_FreeTe|
000020f0  72 6d 4f 70 20 30 78 34  34 30 61 36 0a 20 20 20  |rmOp 0x440a6.   |
00002100  20 0a 20 20 74 79 70 65  64 65 66 20 73 74 72 75  | .  typedef stru|
00002110  63 74 20 7b 0a 20 20 20  20 69 6e 74 20 61 63 74  |ct {.    int act|
00002120  69 6f 6e 3b 20 20 20 20  20 20 20 20 20 20 20 20  |ion;            |
00002130  20 20 2f 2a 20 61 63 74  69 6f 6e 20 63 6f 64 65  |  /* action code|
00002140  20 2a 2f 0a 20 20 20 20  69 6e 74 20 73 70 61 72  | */.    int spar|
00002150  65 31 3b 0a 20 20 20 20  69 6e 74 20 73 70 61 72  |e1;.    int spar|
00002160  65 32 3b 0a 20 20 20 20  63 68 61 72 20 70 6f 72  |e2;.    char por|
00002170  74 5b 36 34 5d 3b 0a 20  20 20 20 63 68 61 72 20  |t[64];.    char |
00002180  64 65 73 74 5b 38 30 5d  3b 0a 20 20 20 20 63 68  |dest[80];.    ch|
00002190  61 72 20 61 72 67 73 5b  38 30 5d 3b 0a 20 20 7d  |ar args[80];.  }|
000021a0  20 66 72 65 65 74 65 72  6d 5f 6f 70 65 6e 6d 73  | freeterm_openms|
000021b0  67 3b 0a 20 20 0a 20 20  69 6e 74 20 6d 61 69 6e  |g;.  .  int main|
000021c0  28 76 6f 69 64 29 0a 20  20 7b 0a 20 20 20 20 69  |(void).  {.    i|
000021d0  6e 74 20 20 20 20 77 69  6d 70 76 65 72 3b 0a 20  |nt    wimpver;. |
000021e0  20 20 20 77 69 6d 70 5f  74 20 6d 79 74 61 73 6b  |   wimp_t mytask|
000021f0  68 61 6e 64 6c 65 3b 0a  20 20 20 20 73 74 61 74  |handle;.    stat|
00002200  69 63 20 77 69 6d 70 5f  62 6c 6f 63 6b 20 62 6c  |ic wimp_block bl|
00002210  6f 63 6b 3b 0a 20 20 20  20 77 69 6d 70 5f 6d 65  |ock;.    wimp_me|
00002220  73 73 61 67 65 20 6d 73  3b 0a 20 20 20 20 66 72  |ssage ms;.    fr|
00002230  65 65 74 65 72 6d 5f 6f  70 65 6e 6d 73 67 20 2a  |eeterm_openmsg *|
00002240  66 6f 6d 3d 28 66 72 65  65 74 65 72 6d 5f 6f 70  |fom=(freeterm_op|
00002250  65 6e 6d 73 67 20 2a 29  26 28 6d 73 2e 64 61 74  |enmsg *)&(ms.dat|
00002260  61 29 3b 0a 20 20 0a 20  20 20 20 6d 79 74 61 73  |a);.  .    mytas|
00002270  6b 68 61 6e 64 6c 65 20  3d 20 77 69 6d 70 5f 69  |khandle = wimp_i|
00002280  6e 69 74 69 61 6c 69 73  65 28 33 31 30 2c 22 46  |nitialise(310,"F|
00002290  72 65 65 54 65 72 6d 20  54 65 73 74 22 2c 28 76  |reeTerm Test",(v|
000022a0  6f 69 64 20 2a 29 2d 31  2c 26 77 69 6d 70 76 65  |oid *)-1,&wimpve|
000022b0  72 29 3b 0a 20 20 0a 20  20 20 20 6d 73 2e 61 63  |r);.  .    ms.ac|
000022c0  74 69 6f 6e 3d 4d 65 73  73 61 67 65 5f 46 72 65  |tion=Message_Fre|
000022d0  65 54 65 72 6d 4f 70 3b  0a 20 20 20 20 6d 73 2e  |eTermOp;.    ms.|
000022e0  6d 79 5f 72 65 66 3d 30  3b 0a 20 20 20 20 6d 73  |my_ref=0;.    ms|
000022f0  2e 79 6f 75 72 5f 72 65  66 3d 31 3b 0a 20 20 20  |.your_ref=1;.   |
00002300  20 6d 73 2e 73 65 6e 64  65 72 3d 6d 79 74 61 73  | ms.sender=mytas|
00002310  6b 68 61 6e 64 6c 65 3b  0a 20 20 20 20 73 74 72  |khandle;.    str|
00002320  63 70 79 28 66 6f 6d 2d  3e 70 6f 72 74 2c 22 66  |cpy(fom->port,"f|
00002330  69 6e 67 65 72 22 29 3b  0a 20 20 20 20 73 74 72  |inger");.    str|
00002340  63 70 79 28 66 6f 6d 2d  3e 64 65 73 74 2c 22 67  |cpy(fom->dest,"g|
00002350  37 6c 7a 62 2e 61 6d 70  72 2e 6f 72 67 22 29 3b  |7lzb.ampr.org");|
00002360  0a 20 20 20 20 73 74 72  63 70 79 28 66 6f 6d 2d  |.    strcpy(fom-|
00002370  3e 61 72 67 73 2c 22 67  37 6c 7a 62 22 29 3b 0a  |>args,"g7lzb");.|
00002380  20 20 20 20 66 6f 6d 2d  3e 61 63 74 69 6f 6e 3d  |    fom->action=|
00002390  32 3b 0a 20 20 20 20 6d  73 2e 73 69 7a 65 3d 73  |2;.    ms.size=s|
000023a0  69 7a 65 6f 66 28 66 72  65 65 74 65 72 6d 5f 6f  |izeof(freeterm_o|
000023b0  70 65 6e 6d 73 67 29 3b  0a 20 20 20 20 0a 20 20  |penmsg);.    .  |
000023c0  20 20 77 69 6d 70 5f 73  65 6e 64 5f 6d 65 73 73  |  wimp_send_mess|
000023d0  61 67 65 28 77 69 6d 70  5f 55 53 45 52 5f 4d 45  |age(wimp_USER_ME|
000023e0  53 53 41 47 45 2c 26 6d  73 2c 30 29 3b 0a 20 20  |SSAGE,&ms,0);.  |
000023f0  0a 20 20 20 20 78 77 69  6d 70 5f 63 6c 6f 73 65  |.    xwimp_close|
00002400  5f 64 6f 77 6e 28 6d 79  74 61 73 6b 68 61 6e 64  |_down(mytaskhand|
00002410  6c 65 29 3b 0a 20 20 20  20 72 65 74 75 72 6e 20  |le);.    return |
00002420  30 3b 0a 20 20 7d 0a 0a  20 20 54 68 65 20 43 6f  |0;.  }..  The Co|
00002430  6e 66 69 67 2e 46 6f 6e  74 73 20 66 69 6c 65 20  |nfig.Fonts file |
00002440  69 73 20 69 6e 20 74 68  65 20 66 6f 72 6d 61 74  |is in the format|
00002450  3a 0a 20 20 20 20 4e 61  6d 65 20 20 20 20 20 20  |:.    Name      |
00002460  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002470  20 20 20 20 20 20 20 20  20 28 73 74 72 69 6e 67  |         (string|
00002480  20 2d 20 74 6f 20 61 70  70 65 61 72 20 69 6e 20  | - to appear in |
00002490  6d 65 6e 75 73 29 0a 20  20 74 68 65 6e 0a 20 20  |menus).  then.  |
000024a0  20 20 7a 61 70 20 62 2e  6d 2e 20 20 20 20 20 20  |  zap b.m.      |
000024b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000024c0  20 20 20 20 20 28 6c 69  74 65 72 61 6c 20 73 74  |     (literal st|
000024d0  72 69 6e 67 29 0a 20 20  20 20 3c 54 65 72 6d 46  |ring).    <TermF|
000024e0  6f 6e 74 73 24 44 69 72  3e 2e 42 69 74 4d 61 70  |onts$Dir>.BitMap|
000024f0  73 2e 58 2e 31 30 78 32  30 20 20 20 20 28 73 74  |s.X.10x20    (st|
00002500  72 69 6e 67 29 0a 20 20  6f 72 20 28 66 6f 72 20  |ring).  or (for |
00002510  74 68 6f 73 65 20 77 68  6f 20 61 72 65 20 70 72  |those who are pr|
00002520  65 70 61 72 65 64 20 74  6f 20 74 77 65 61 6b 20  |epared to tweak |
00002530  70 61 72 61 6d 65 74 65  72 73 20 66 6f 72 20 61  |parameters for a|
00002540  20 77 68 69 6c 65 29 0a  20 20 20 20 7a 61 70 20  | while).    zap |
00002550  61 2e 61 2e 20 20 20 20  20 20 20 20 20 20 20 20  |a.a.            |
00002560  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 28  |               (|
00002570  6c 69 74 65 72 61 6c 20  73 74 72 69 6e 67 29 0a  |literal string).|
00002580  20 20 20 20 63 6f 72 70  75 73 2e 6d 65 64 69 75  |    corpus.mediu|
00002590  6d 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |m               |
000025a0  20 20 20 20 20 20 20 28  52 49 53 43 2d 4f 53 20  |       (RISC-OS |
000025b0  66 6f 6e 74 20 6e 61 6d  65 29 0a 20 20 20 20 31  |font name).    1|
000025c0  30 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |0               |
000025d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000025e0  20 20 50 6f 69 6e 74 20  73 69 7a 65 0a 20 20 20  |  Point size.   |
000025f0  20 31 36 20 20 20 20 20  20 20 20 20 20 20 20 20  | 16             |
00002600  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002610  20 20 20 20 57 69 64 74  68 20 6f 66 20 66 6f 6e  |    Width of fon|
00002620  74 0a 20 20 20 20 31 32  20 20 20 20 20 20 20 20  |t.    12        |
00002630  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002640  20 20 20 20 20 20 20 20  20 48 65 69 67 68 74 20  |         Height |
00002650  6f 66 20 66 6f 6e 74 0a  20 20 20 20 30 20 20 20  |of font.    0   |
00002660  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002670  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 58  |               X|
00002680  20 6f 66 66 73 65 74 20  28 75 73 75 61 6c 6c 79  | offset (usually|
00002690  20 30 29 0a 20 20 20 20  38 20 20 20 20 20 20 20  | 0).    8       |
000026a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000026b0  20 20 20 20 20 20 20 20  20 20 20 59 20 6f 66 66  |           Y off|
000026c0  73 65 74 20 28 75 73 75  61 6c 6c 79 20 3e 30 29  |set (usually >0)|
000026d0  0a 20 20 6f 72 0a 20 20  20 20 7a 61 70 20 62 2e  |.  or.    zap b.|
000026e0  6d 2e 20 64 69 72 0a 20  20 20 20 3c 54 65 72 6d  |m. dir.    <Term|
000026f0  46 6f 6e 74 73 24 44 69  72 3e 2e 42 69 74 4d 61  |Fonts$Dir>.BitMa|
00002700  70 73 2e 43 58 20 20 20  20 20 20 20 20 20 28 44  |ps.CX         (D|
00002710  69 72 65 63 74 6f 72 79  20 74 6f 20 66 69 6e 64  |irectory to find|
00002720  20 73 65 74 20 6f 66 20  7a 61 70 20 66 6f 6e 74  | set of zap font|
00002730  73 29 0a 0a 39 2e 20 43  72 65 64 69 74 73 0a 0a  |s)..9. Credits..|
00002740  20 20 50 72 6f 67 72 61  6d 6d 69 6e 67 20 3a 0a  |  Programming :.|
00002750  20 20 20 20 20 54 6f 6d  20 48 75 67 68 65 73 20  |     Tom Hughes |
00002760  28 74 6f 6d 40 63 6f 6d  70 74 6f 6e 2e 64 65 6d  |(tom@compton.dem|
00002770  6f 6e 2e 63 6f 2e 75 6b  29 20 73 74 61 72 74 65  |on.co.uk) starte|
00002780  64 20 74 68 65 20 70 72  6f 6a 65 63 74 2e 0a 20  |d the project.. |
00002790  20 20 20 20 54 6f 6e 79  20 48 6f 77 61 74 20 28  |    Tony Howat (|
000027a0  74 68 6f 77 61 74 40 78  61 72 67 6c 65 2e 64 65  |thowat@xargle.de|
000027b0  6d 6f 6e 2e 63 6f 2e 75  6b 29 20 63 6f 6e 74 69  |mon.co.uk) conti|
000027c0  6e 75 65 64 20 69 74 2e  0a 20 20 20 20 20 4d 65  |nued it..     Me|
000027d0  72 6c 69 6e 20 48 75 67  68 65 73 20 28 68 75 67  |rlin Hughes (hug|
000027e0  68 65 73 6d 40 63 73 2e  75 6e 63 2e 65 64 75 29  |hesm@cs.unc.edu)|
000027f0  20 77 72 6f 74 65 20 74  68 65 20 74 65 72 6d 69  | wrote the termi|
00002800  6e 61 6c 20 65 6d 75 6c  61 74 6f 72 2e 0a 0a 20  |nal emulator... |
00002810  20 54 68 61 6e 6b 73 20  74 6f 20 3a 0a 20 20 20  | Thanks to :.   |
00002820  20 20 44 6f 6d 69 6e 69  63 20 53 79 6d 65 73 20  |  Dominic Symes |
00002830  66 6f 72 20 5a 61 70 52  65 64 72 61 77 2e 0a 20  |for ZapRedraw.. |
00002840  20 20 20 20 53 74 65 77  61 72 74 20 42 72 6f 64  |    Stewart Brod|
00002850  69 65 20 28 73 2e 6e 2e  62 72 6f 64 69 65 40 65  |ie (s.n.brodie@e|
00002860  63 73 2e 73 6f 74 6f 6e  2e 61 63 2e 75 6b 29 20  |cs.soton.ac.uk) |
00002870  66 6f 72 20 68 65 6c 70  20 77 69 74 68 20 41 72  |for help with Ar|
00002880  63 57 65 62 2e 0a 20 20  20 20 20 42 65 6e 20 53  |cWeb..     Ben S|
00002890  75 6d 6d 65 72 73 20 66  6f 72 20 68 65 6c 70 20  |ummers for help |
000028a0  77 69 74 68 20 74 68 65  20 43 6f 6c 6f 75 72 50  |with the ColourP|
000028b0  69 63 6b 65 72 2c 20 61  6e 64 20 74 68 6f 73 65  |icker, and those|
000028c0  20 6f 6e 0a 20 20 20 20  20 63 6f 6d 70 2e 73 79  | on.     comp.sy|
000028d0  73 2e 61 63 6f 72 6e 2e  70 72 6f 67 72 61 6d 6d  |s.acorn.programm|
000028e0  65 72 20 66 6f 72 20 73  6f 72 74 69 6e 67 20 6d  |er for sorting m|
000028f0  65 20 6f 75 74 20 6f 6e  20 74 68 65 20 6f 63 63  |e out on the occ|
00002900  61 73 69 6f 6e 73 20 77  68 65 6e 0a 20 20 20 20  |asions when.    |
00002910  20 49 20 73 61 77 20 66  69 74 20 74 6f 20 61 73  | I saw fit to as|
00002920  6b 20 70 61 72 74 69 63  75 6c 61 72 6c 79 20 64  |k particularly d|
00002930  75 6d 62 20 71 75 65 73  74 69 6f 6e 73 2e 0a 20  |umb questions.. |
00002940  20 20 20 20 47 72 61 68  61 6d 20 41 6c 6c 61 6e  |    Graham Allan|
00002950  20 66 6f 72 20 68 69 73  20 68 65 6c 70 20 69 6e  | for his help in|
00002960  20 73 61 64 69 73 74 69  63 20 74 65 72 6d 69 6e  | sadistic termin|
00002970  61 6c 20 65 6d 75 6c 61  74 6f 72 20 61 62 75 73  |al emulator abus|
00002980  65 2e 20 0a 0a 20 20 2e  2e 61 6e 64 20 74 68 61  |e. ..  ..and tha|
00002990  6e 6b 73 20 74 6f 20 74  68 65 20 62 65 74 61 20  |nks to the beta |
000029a0  74 65 73 74 65 72 73 20  66 6f 72 20 74 68 65 69  |testers for thei|
000029b0  72 20 68 65 6c 70 66 75  6c 20 63 6f 6d 6d 65 6e  |r helpful commen|
000029c0  74 73 20 61 6e 64 0a 20  20 20 20 73 75 67 67 65  |ts and.    sugge|
000029d0  73 74 69 6f 6e 73 2e 0a  0a 31 30 2e 20 49 6e 74  |stions...10. Int|
000029e0  65 72 6e 61 74 69 6f 6e  61 6c 69 73 61 74 69 6f  |ernationalisatio|
000029f0  6e 0a 0a 20 20 49 20 77  6f 75 6c 64 20 62 65 20  |n..  I would be |
00002a00  65 78 74 61 63 74 69 63  20 69 66 20 70 65 6f 70  |extactic if peop|
00002a10  6c 65 20 63 6f 75 6c 64  20 70 72 6f 76 69 64 65  |le could provide|
00002a20  20 6d 65 20 77 69 74 68  20 72 65 73 6f 75 72 63  | me with resourc|
00002a30  65 73 20 66 6f 72 0a 20  20 64 69 66 66 65 72 65  |es for.  differe|
00002a40  6e 74 20 6c 61 6e 67 75  61 67 65 73 20 74 6f 20  |nt languages to |
00002a50  62 65 20 6d 61 64 65 20  61 76 61 69 6c 61 62 6c  |be made availabl|
00002a60  65 20 61 6c 6f 6e 67 73  69 64 65 20 74 68 65 20  |e alongside the |
00002a70  73 74 61 6e 64 61 72 64  0a 20 20 46 72 65 65 54  |standard.  FreeT|
00002a80  65 72 6d 20 64 69 73 74  72 69 62 75 74 69 6f 6e  |erm distribution|
00002a90  2e 20 65 2d 6d 61 69 6c  20 74 68 65 6d 20 55 55  |. e-mail them UU|
00002aa0  43 6f 64 65 64 20 74 6f  20 74 68 6f 77 61 74 40  |Coded to thowat@|
00002ab0  78 61 72 67 6c 65 2e 64  65 6d 6f 6e 2e 63 6f 2e  |xargle.demon.co.|
00002ac0  75 6b 0a 0a 31 31 2e 20  54 74 79 6c 69 6e 6b 44  |uk..11. TtylinkD|
00002ad0  0a 0a 20 20 54 74 79 6c  69 6e 6b 64 20 69 73 20  |..  Ttylinkd is |
00002ae0  61 6e 20 65 78 74 65 6e  73 69 6f 6e 20 66 6f 72  |an extension for|
00002af0  20 46 72 65 65 54 65 72  6d 20 77 68 69 63 68 20  | FreeTerm which |
00002b00  61 6c 6c 6f 77 73 20 75  73 65 72 73 20 74 6f 20  |allows users to |
00002b10  63 6f 6e 6e 65 63 74 20  74 6f 0a 20 20 79 6f 75  |connect to.  you|
00002b20  72 20 73 79 73 74 65 6d  20 61 6e 64 20 6f 70 65  |r system and ope|
00002b30  6e 20 63 68 61 74 20 73  65 73 73 69 6f 6e 73 2e  |n chat sessions.|
00002b40  20 49 74 20 70 69 63 6b  73 20 75 70 20 74 74 79  | It picks up tty|
00002b50  6c 69 6e 6b 20 28 70 6f  72 74 20 38 37 29 0a 20  |link (port 87). |
00002b60  20 63 6f 6e 6e 65 63 74  69 6f 6e 73 20 74 6f 20  | connections to |
00002b70  79 6f 75 72 20 6d 61 63  68 69 6e 65 20 61 6e 64  |your machine and|
00002b80  20 72 6f 75 74 65 73 20  74 68 65 6d 20 74 68 72  | routes them thr|
00002b90  6f 75 67 68 20 74 6f 20  46 72 65 65 54 65 72 6d  |ough to FreeTerm|
00002ba0  0a 20 20 61 6c 6c 6f 77  69 6e 67 20 79 6f 75 20  |.  allowing you |
00002bb0  74 6f 20 63 6f 6e 76 65  72 73 65 20 64 69 72 65  |to converse dire|
00002bc0  63 74 6c 79 20 77 69 74  68 20 74 68 65 20 72 65  |ctly with the re|
00002bd0  6d 6f 74 65 20 75 73 65  72 2e 0a 20 20 0a 20 20  |mote user..  .  |
00002be0  46 65 61 74 75 72 65 73  20 3a 0a 20 20 20 20 20  |Features :.     |
00002bf0  2a 20 43 61 6e 20 72 75  6e 20 69 6e 64 65 70 65  |* Can run indepe|
00002c00  6e 64 65 6e 74 6c 79 20  6f 66 20 46 72 65 65 54  |ndently of FreeT|
00002c10  65 72 6d 20 61 63 74 69  6e 67 20 61 73 20 61 6e  |erm acting as an|
00002c20  20 61 6e 73 77 65 72 69  6e 67 20 73 65 72 76 69  | answering servi|
00002c30  63 65 2c 0a 20 20 20 20  20 20 20 6f 70 74 69 6f  |ce,.       optio|
00002c40  6e 61 6c 6c 79 20 61 75  74 6f 2d 73 74 61 72 74  |nally auto-start|
00002c50  69 6e 67 20 46 72 65 65  54 65 72 6d 20 77 68 65  |ing FreeTerm whe|
00002c60  6e 20 61 20 63 6f 6e 6e  65 63 74 69 6f 6e 20 69  |n a connection i|
00002c70  73 20 61 6e 73 77 65 72  65 64 2e 0a 20 20 20 20  |s answered..    |
00002c80  20 2a 20 4f 70 74 69 6f  6e 61 6c 6c 79 20 61 6c  | * Optionally al|
00002c90  65 72 74 73 20 75 73 65  72 20 6f 66 20 69 6e 63  |erts user of inc|
00002ca0  6f 6d 69 6e 67 20 63 6f  6e 6e 65 63 74 69 6f 6e  |oming connection|
00002cb0  73 20 62 6f 74 68 20 76  69 73 75 61 6c 6c 79 20  |s both visually |
00002cc0  61 6e 64 0a 20 20 20 20  20 20 20 62 79 20 70 6c  |and.       by pl|
00002cd0  61 79 69 6e 67 20 61 20  73 6f 75 6e 64 20 73 61  |aying a sound sa|
00002ce0  6d 70 6c 65 2e 0a 20 20  20 20 20 2a 20 56 61 72  |mple..     * Var|
00002cf0  69 61 62 6c 65 20 6e 6f  6e 2d 61 6e 73 77 65 72  |iable non-answer|
00002d00  20 74 69 6d 65 6f 75 74  2e 0a 20 20 20 20 20 2a  | timeout..     *|
00002d10  20 46 75 6c 6c 79 20 65  64 69 74 61 62 6c 65 20  | Fully editable |
00002d20  63 6f 6e 6e 65 63 74 2f  61 6e 73 77 65 72 2f 65  |connect/answer/e|
00002d30  74 63 20 6d 65 73 73 61  67 65 73 2e 0a 20 20 20  |tc messages..   |
00002d40  20 20 2a 20 49 6e 74 65  67 72 61 74 65 73 20 66  |  * Integrates f|
00002d50  75 6c 6c 79 20 77 69 74  68 20 46 72 65 65 54 65  |ully with FreeTe|
00002d60  72 6d 2e 0a 20 20 0a 20  20 54 74 79 6c 69 6e 6b  |rm..  .  Ttylink|
00002d70  64 20 77 69 6c 6c 20 77  6f 72 6b 20 77 69 74 68  |d will work with|
00002d80  20 61 6e 79 20 41 63 6f  72 6e 20 42 53 44 20 73  | any Acorn BSD s|
00002d90  74 79 6c 65 20 54 43 50  2f 49 50 20 73 74 61 63  |tyle TCP/IP stac|
00002da0  6b 2c 20 61 6e 64 20 73  6f 20 69 73 0a 20 20 63  |k, and so is.  c|
00002db0  6f 6d 70 61 74 69 62 6c  65 20 77 69 74 68 20 46  |ompatible with F|
00002dc0  72 65 65 4e 65 74 2c 20  41 63 6f 72 6e 4e 65 74  |reeNet, AcornNet|
00002dd0  2c 20 49 6e 74 65 72 54  61 6c 6b 2c 20 56 6f 79  |, InterTalk, Voy|
00002de0  61 67 65 72 2c 20 41 4e  54 20 49 6e 74 65 72 6e  |ager, ANT Intern|
00002df0  65 74 20 65 74 63 2e 0a  20 20 28 62 75 74 20 2a  |et etc..  (but *|
00002e00  6e 6f 74 2a 20 54 65 72  6d 69 74 65 20 49 6e 74  |not* Termite Int|
00002e10  65 72 6e 65 74 29 2e 20  48 6f 77 65 76 65 72 20  |ernet). However |
00002e20  64 75 65 20 74 6f 20 74  68 65 20 70 72 6f 67 72  |due to the progr|
00002e30  61 6d 20 62 65 69 6e 67  20 61 20 73 65 72 76 65  |am being a serve|
00002e40  72 20 69 74 0a 20 20 69  73 20 6f 6e 6c 79 20 72  |r it.  is only r|
00002e50  65 61 6c 6c 79 20 61 70  70 72 6f 70 72 69 61 74  |eally appropriat|
00002e60  65 20 66 6f 72 20 75 73  65 20 77 69 74 68 20 70  |e for use with p|
00002e70  72 6f 76 69 64 65 72 73  20 77 68 69 63 68 20 61  |roviders which a|
00002e80  6c 6c 6f 63 61 74 65 20  73 74 61 74 69 63 0a 20  |llocate static. |
00002e90  20 49 50 20 61 64 64 72  65 73 73 65 73 20 2d 20  | IP addresses - |
00002ea0  73 6f 20 75 73 65 72 73  20 6f 66 20 70 72 6f 76  |so users of prov|
00002eb0  69 64 65 72 73 20 6c 69  6b 65 20 50 69 70 65 78  |iders like Pipex|
00002ec0  20 61 6e 64 20 41 72 67  6f 6e 65 74 20 77 6f 6e  | and Argonet won|
00002ed0  27 74 20 62 65 20 61 62  6c 65 0a 20 20 74 6f 20  |'t be able.  to |
00002ee0  75 73 65 20 69 74 20 65  66 66 65 63 74 69 76 65  |use it effective|
00002ef0  6c 79 2e 20 49 66 20 79  6f 75 20 61 72 65 20 63  |ly. If you are c|
00002f00  6f 6e 66 75 73 65 64 20  61 62 6f 75 74 20 77 68  |onfused about wh|
00002f10  65 74 68 65 72 20 54 74  79 6c 69 6e 6b 64 20 69  |ether Ttylinkd i|
00002f20  73 0a 20 20 73 75 69 74  61 62 6c 65 20 66 6f 72  |s.  suitable for|
00002f30  20 79 6f 75 72 20 73 65  74 20 75 70 20 66 65 65  | your set up fee|
00002f40  6c 20 66 72 65 65 20 74  6f 20 63 6f 6e 74 61 63  |l free to contac|
00002f50  74 20 6d 65 2e 20 54 74  79 6c 69 6e 6b 64 20 77  |t me. Ttylinkd w|
00002f60  69 6c 6c 20 6f 6e 6c 79  20 72 75 6e 0a 20 20 75  |ill only run.  u|
00002f70  6e 64 65 72 20 52 49 53  43 20 4f 53 20 33 2e 31  |nder RISC OS 3.1|
00002f80  20 61 6e 64 20 6c 61 74  65 72 2e 0a 0a 20 20 2a  | and later...  *|
00002f90  2a 2a 20 74 74 79 6c 69  6e 6b 64 20 77 69 6c 6c  |** ttylinkd will|
00002fa0  20 68 6f 70 65 66 75 6c  6c 79 20 62 65 20 72 65  | hopefully be re|
00002fb0  6c 65 61 73 65 64 20 62  65 66 6f 72 65 20 53 65  |leased before Se|
00002fc0  70 74 65 6d 62 65 72 20  31 39 39 36 20 62 79 20  |ptember 1996 by |
00002fd0  32 30 2d 32 30 0a 20 20  2a 2a 2a 20 53 6f 66 74  |20-20.  *** Soft|
00002fe0  77 61 72 65 20 61 6e 64  20 69 74 73 20 72 65 6c  |ware and its rel|
00002ff0  65 61 73 65 20 77 69 6c  6c 20 62 65 20 61 6e 6e  |ease will be ann|
00003000  6f 75 6e 63 65 64 20 6f  6e 20 63 6f 6d 70 2e 73  |ounced on comp.s|
00003010  79 73 2e 61 63 6f 72 6e  2e 61 6e 6e 6f 75 6e 63  |ys.acorn.announc|
00003020  65 2e 0a 20 20 2a 2a 2a  20 49 74 20 77 69 6c 6c  |e..  *** It will|
00003030  20 62 65 20 61 20 2a 63  6f 6d 6d 65 72 63 69 61  | be a *commercia|
00003040  6c 2a 20 70 72 6f 67 72  61 6d 20 63 6f 73 74 69  |l* program costi|
00003050  6e 67 20 a3 31 30 20 28  73 69 6e 67 6c 65 20 75  |ng .10 (single u|
00003060  73 65 72 29 20 6f 72 20  a3 31 35 0a 20 20 2a 2a  |ser) or .15.  **|
00003070  2a 20 66 6f 72 20 61 20  73 69 74 65 20 6c 69 63  |* for a site lic|
00003080  65 6e 63 65 2e 20 46 75  72 74 68 65 72 20 6f 72  |ence. Further or|
00003090  64 65 72 69 6e 67 20 64  65 74 61 69 6c 73 20 77  |dering details w|
000030a0  69 6c 6c 20 62 65 20 61  6e 6e 6f 75 6e 63 65 64  |ill be announced|
000030b0  20 77 68 65 6e 0a 20 20  2a 2a 2a 20 74 68 65 20  | when.  *** the |
000030c0  70 72 6f 67 72 61 6d 20  69 73 20 72 65 6c 65 61  |program is relea|
000030d0  73 65 64 2e 0a 0a 31 32  2e 20 43 6f 6e 74 61 63  |sed...12. Contac|
000030e0  74 69 6e 67 20 74 68 65  20 61 75 74 68 6f 72 28  |ting the author(|
000030f0  73 29 0a 0a 20 20 41 6e  79 20 71 75 65 72 69 65  |s)..  Any querie|
00003100  73 20 6f 6e 20 74 68 65  20 73 75 62 6a 65 63 74  |s on the subject|
00003110  20 6f 66 20 46 72 65 65  4e 65 74 20 69 6e 20 67  | of FreeNet in g|
00003120  65 6e 65 72 61 6c 20 73  68 6f 75 6c 64 20 62 65  |eneral should be|
00003130  20 73 65 6e 74 0a 20 20  74 6f 20 74 68 65 20 6f  | sent.  to the o|
00003140  72 69 67 69 6e 61 6c 20  61 75 74 68 6f 72 20 6f  |riginal author o|
00003150  66 20 46 72 65 65 54 65  72 6d 2c 20 54 6f 6d 20  |f FreeTerm, Tom |
00003160  48 75 67 68 65 73 2c 20  77 68 6f 20 63 61 6e 20  |Hughes, who can |
00003170  62 65 20 63 6f 6e 74 61  63 74 65 64 20 62 79 0a  |be contacted by.|
00003180  20 20 65 6d 61 69 6c 20  61 74 20 66 72 65 65 6e  |  email at freen|
00003190  65 74 40 63 6f 6d 70 74  6f 6e 2e 64 65 6d 6f 6e  |et@compton.demon|
000031a0  2e 63 6f 2e 75 6b 2c 20  6f 72 20 62 79 20 73 6e  |.co.uk, or by sn|
000031b0  61 69 6c 20 6d 61 69 6c  20 61 74 3a 0a 0a 20 20  |ail mail at:..  |
000031c0  20 20 20 20 54 6f 6d 20  48 75 67 68 65 73 0a 20  |    Tom Hughes. |
000031d0  20 20 20 20 20 35 20 4c  61 6d 70 69 74 73 0a 20  |     5 Lampits. |
000031e0  20 20 20 20 20 48 6f 64  64 65 73 64 6f 6e 0a 20  |     Hoddesdon. |
000031f0  20 20 20 20 20 48 65 72  74 66 6f 72 64 73 68 69  |     Hertfordshi|
00003200  72 65 0a 20 20 20 20 20  20 45 4e 31 31 20 38 45  |re.      EN11 8E|
00003210  48 0a 0a 20 20 54 68 6f  73 65 20 77 69 74 68 20  |H..  Those with |
00003220  62 61 73 69 63 20 63 6f  6e 66 69 67 75 72 61 74  |basic configurat|
00003230  69 6f 6e 20 70 72 6f 62  6c 65 6d 73 20 77 6f 75  |ion problems wou|
00003240  6c 64 20 62 65 20 62 65  73 74 20 73 65 72 76 65  |ld be best serve|
00003250  64 20 62 79 20 74 68 65  0a 20 20 63 6f 6d 70 2e  |d by the.  comp.|
00003260  73 79 73 2e 61 63 6f 72  6e 2e 6e 65 74 77 6f 72  |sys.acorn.networ|
00003270  6b 69 6e 67 20 6e 65 77  73 67 72 6f 75 70 2e 0a  |king newsgroup..|
00003280  0a 20 20 44 65 76 65 6c  6f 70 6d 65 6e 74 20 6f  |.  Development o|
00003290  66 20 46 72 65 65 54 65  72 6d 20 69 73 20 62 65  |f FreeTerm is be|
000032a0  69 6e 67 20 75 6e 64 65  72 74 61 6b 65 6e 20 62  |ing undertaken b|
000032b0  79 20 54 6f 6e 79 20 48  6f 77 61 74 2c 20 73 6f  |y Tony Howat, so|
000032c0  0a 20 20 73 75 67 67 65  73 74 69 6f 6e 73 20 66  |.  suggestions f|
000032d0  6f 72 20 65 6e 68 61 6e  63 65 6d 65 6e 74 73 20  |or enhancements |
000032e0  61 6e 64 20 62 75 67 20  72 65 70 6f 72 74 73 20  |and bug reports |
000032f0  73 68 6f 75 6c 64 20 62  65 20 73 65 6e 74 20 74  |should be sent t|
00003300  6f 20 68 69 6d 0a 20 20  62 79 20 65 6d 61 69 6c  |o him.  by email|
00003310  20 74 6f 20 74 68 6f 77  61 74 40 78 61 72 67 6c  | to thowat@xargl|
00003320  65 2e 64 65 6d 6f 6e 2e  63 6f 2e 75 6b 2c 20 6f  |e.demon.co.uk, o|
00003330  72 20 62 79 20 73 6e 61  69 6c 20 6d 61 69 6c 20  |r by snail mail |
00003340  61 74 3a 0a 0a 20 20 20  20 20 20 54 6f 6e 79 20  |at:..      Tony |
00003350  48 6f 77 61 74 0a 20 20  20 20 20 20 31 32 20 44  |Howat.      12 D|
00003360  6f 76 65 72 20 52 6f 61  64 0a 20 20 20 20 20 20  |over Road.      |
00003370  42 69 72 6b 64 61 6c 65  0a 20 20 20 20 20 20 53  |Birkdale.      S|
00003380  6f 75 74 68 70 6f 72 74  0a 20 20 20 20 20 20 4d  |outhport.      M|
00003390  65 72 73 65 79 73 69 64  65 0a 20 20 20 20 20 20  |erseyside.      |
000033a0  50 52 38 20 34 53 59 0a  0a 20 20 4f 6e 6c 79 20  |PR8 4SY..  Only |
000033b0  46 72 65 65 54 65 72 6d  20 5f 73 70 65 63 69 66  |FreeTerm _specif|
000033c0  69 63 5f 20 71 75 65 72  69 65 73 20 73 68 6f 75  |ic_ queries shou|
000033d0  6c 64 20 62 65 20 73 65  6e 74 20 74 6f 20 74 68  |ld be sent to th|
000033e0  69 73 20 61 64 64 72 65  73 73 2c 20 49 0a 20 20  |is address, I.  |
000033f0  63 61 6e 27 74 20 68 65  6c 70 20 6f 6e 20 61 20  |can't help on a |
00003400  6d 6f 72 65 20 67 65 6e  65 72 61 6c 20 6c 65 76  |more general lev|
00003410  65 6c 2e 20 4d 79 20 73  65 74 75 70 20 69 73 20  |el. My setup is |
00003420  75 6e 69 71 75 65 6c 79  20 73 74 72 61 6e 67 65  |uniquely strange|
00003430  20 61 6e 64 0a 20 20 66  6c 61 6b 65 79 20 3a 29  | and.  flakey :)|
00003440  0a 0a 20 20 49 66 20 79  6f 75 20 61 72 65 20 73  |..  If you are s|
00003450  6f 20 65 6e 61 6d 6f 75  72 65 64 20 77 69 74 68  |o enamoured with|
00003460  20 46 72 65 65 54 65 72  6d 20 74 68 61 74 20 79  | FreeTerm that y|
00003470  6f 75 20 66 65 65 6c 20  74 68 61 74 20 79 6f 75  |ou feel that you|
00003480  20 6d 61 79 20 6c 69 6b  65 0a 20 20 74 6f 20 62  | may like.  to b|
00003490  75 79 20 74 68 65 20 61  75 74 68 6f 72 73 20 61  |uy the authors a|
000034a0  20 70 69 6e 74 20 6f 72  20 74 68 72 65 65 20 6d  | pint or three m|
000034b0  6f 6e 65 79 20 69 73 20  77 65 6c 63 6f 6d 65 20  |oney is welcome |
000034c0  61 74 20 74 68 65 20 61  62 6f 76 65 0a 20 20 61  |at the above.  a|
000034d0  64 64 72 65 73 73 2c 20  69 74 20 77 69 6c 6c 20  |ddress, it will |
000034e0  62 65 20 73 70 6c 69 74  20 66 61 69 72 6c 79 2e  |be split fairly.|
000034f0  20 28 57 65 27 72 65 20  62 6f 74 68 20 69 6d 70  | (We're both imp|
00003500  6f 76 65 72 69 73 68 65  64 20 73 74 75 64 65 6e  |overished studen|
00003510  74 73 2c 0a 20 20 61 6e  64 20 73 6f 20 63 6f 75  |ts,.  and so cou|
00003520  6c 64 6e 27 74 20 6d 69  73 73 20 74 68 65 20 63  |ldn't miss the c|
00003530  68 61 6e 63 65 20 6f 66  20 61 20 62 65 65 72 20  |hance of a beer |
00003540  6f 72 20 74 77 6f 20 66  6f 72 20 6f 75 72 20 74  |or two for our t|
00003550  72 6f 75 62 6c 65 21 29  0a 0a 20 20 46 72 65 65  |rouble!)..  Free|
00003560  54 65 72 6d 20 68 61 73  20 61 20 77 65 62 20 70  |Term has a web p|
00003570  61 67 65 20 77 68 69 63  68 20 73 68 6f 75 6c 64  |age which should|
00003580  20 6e 6f 77 20 61 76 61  69 6c 61 62 6c 65 20 66  | now available f|
00003590  72 6f 6d 20 74 68 65 0a  20 20 32 30 2d 32 30 20  |rom the.  20-20 |
000035a0  53 6f 66 74 77 61 72 65  20 68 6f 6d 65 20 70 61  |Software home pa|
000035b0  67 65 2e 20 50 6f 69 6e  74 20 79 6f 75 72 20 62  |ge. Point your b|
000035c0  72 6f 77 73 65 72 20 61  74 20 3a 0a 20 20 20 20  |rowser at :.    |
000035d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000035f0  20 20 20 20 20 20 20 68  74 74 70 3a 2f 2f 77 77  |       http://ww|
00003600  77 2e 61 6e 67 65 6c 2e  61 63 2e 75 6b 2f 61 63  |w.angel.ac.uk/ac|
00003610  2f 32 30 32 30 2f 0a 0a  20 20 54 68 61 6e 6b 73  |/2020/..  Thanks|
00003620  20 74 6f 20 4d 69 63 68  61 65 6c 20 57 68 69 74  | to Michael Whit|
00003630  65 20 66 6f 72 20 6c 6f  61 6e 69 6e 67 20 6d 65  |e for loaning me|
00003640  20 74 68 65 20 77 65 62  20 73 70 61 63 65 2e 0a  | the web space..|
00003650  0a 20 20 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.  -------------|
00003660  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003690  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 20 20 20 4e  |-----------.   N|
000036a0  6f 74 65 20 74 68 61 74  20 6d 79 20 65 2d 6d 61  |ote that my e-ma|
000036b0  69 6c 20 61 64 64 72 65  73 73 20 77 69 6c 6c 20  |il address will |
000036c0  62 65 20 63 68 61 6e 67  69 6e 67 2e 20 49 66 20  |be changing. If |
000036d0  6d 61 69 6c 20 62 6f 75  6e 63 65 73 20 72 65 66  |mail bounces ref|
000036e0  65 72 20 74 6f 0a 20 20  20 74 68 65 20 32 30 2d  |er to.   the 20-|
000036f0  32 30 20 53 6f 66 74 77  61 72 65 20 77 65 62 20  |20 Software web |
00003700  70 61 67 65 73 20 28 68  74 74 70 3a 2f 2f 77 77  |pages (http://ww|
00003710  77 2e 61 6e 67 65 6c 2e  61 63 2e 75 6b 2f 61 63  |w.angel.ac.uk/ac|
00003720  2f 32 30 32 30 2f 29 20  66 6f 72 20 61 0a 20 20  |/2020/) for a.  |
00003730  20 63 75 72 72 65 6e 74  20 61 64 64 72 65 73 73  | current address|
00003740  2e 20 0a 20 20 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |. .  -----------|
00003750  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003780  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 20 20  |-------------.  |
00003790  0a 0a                                             |..|
00003792