home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / telecom / handshake_449 / handshake.doc < prev    next >
Text File  |  1991-02-02  |  47KB  |  976 lines
  1. -----------------
  2.  
  3.       /\/\
  4.      / /  \
  5.  ---/ / /\ \-----
  6.       \/  \ 
  7.  Hand     / Shake  Version 2.20b
  8.  ---\    / /-----
  9.      \  / /
  10.       \/\/
  11.  
  12. -----------------
  13.  
  14. HandShake V2.20c. Summary of Features.
  15.  
  16. *** Important Note ***
  17.  
  18. The .parms file format file for this release has changed for release v2.20a
  19. please see the "WHAT PROBLEMS ARE THERE WITH HandShake: section in this
  20. document. This describes how to convert from the old format to the new
  21. format.
  22.  
  23. If you want to see how this version of HandShake has changed from the
  24. previous versions please refer to the Version History section at the end
  25. of this document.
  26.  
  27. WHAT IS IT?
  28.  
  29. HandShake is the copyrighted property  ( (c) 1987, 1988, 1989, 1990) of Eric
  30. Haberfellner
  31.  
  32. HandShake is a Full featured VT52/100/102/220 terminal emulator for those
  33. people who really need it. I have taken great pains to support the full
  34. VT102 spec (VT102 is a superset of VT100) and most of the VT220 spec. I have
  35. no real way currently to test the full functionality of the VT220 emulation,
  36. so I am relying on my users to point out any errors. Please detail any
  37. problems that you find, and I will fix them for the next release.
  38.  
  39. See the review included in the ARC file.
  40.  
  41. I take no responsibility for the proper functioning of this program or for
  42. any damage to you or your business that may be caused by this program.
  43. (obligatory disclaimer.)
  44.  
  45. IMPORTANT NOTE ABOUT DISTRIBUTION AND SHAREWARE
  46.  
  47. Feel free to use and distribute this program as you like, as long as it is
  48. not for commercial use. If you like it, use it and want to see it get
  49. better, please send a contribution of $35.00 to the address listed in the
  50. program's "About.." requester. Commercial users are urged to contact the
  51. author. Please do not alter or rename the distribution ARC file in any
  52. way if you pass it along or post it on a bulletin board. The current
  53. HandShake distribution ARC file is called HDSK220a.arc. This way people
  54. can tell what version of HandShake is on a BBS.
  55.  
  56. Future enhancements that I would like to do include multiple number dialing,
  57. etc, however I will have to see an increase in user support if I am going
  58. to do these things. If you like this product and use it send a contribution.
  59. This is not free software. It is SHAREWARE it has a cost that you are expected
  60. to pay if you use it. Let me know what features are important to you. If you
  61. feel that there are features missing that you would like to see, please let
  62. me know that as well. How would you feel if HandShake got even bigger? Is
  63. size a problem? How do you feel about overlays? Would having to do an assign
  64. in your startup-sequence make HandShake unusable or cumbersome to you?
  65.  
  66. COME ON PEOPLE TALK TO ME! I know that you are out there and using
  67. HandShake. If the support does not pick up I will have to start releasing
  68. crippled versions of HandShake, and only send the full featured non-freely
  69. distributable versions to people who contribute. I do not want to have to
  70. do this, it is contrary to my beliefs about SHAREWARE and people supplying
  71. quality software to others for low cost. I know it is a nuisance to have
  72. to walk to your chequebook and fill out a cheque, address an envelope, and
  73. mail it, but prove that you are someone that cares about SHAREWARE and wants
  74. it to continue. Make a statement, not just for me and my program, but for
  75. other SHAREWARE products that you use as well. The people who write these
  76. programs are highly skilled professionals in most cases who want to help
  77. other users. They deserve your support!
  78.  
  79. WHAT IS THIS DOCUMENT?
  80.  
  81. This document is a quick description of the features of HandShake paying
  82. particular attention to the less obvious aspects of HandShake so that an
  83. experienced user will be able to use the program. This document assumes
  84. that the user has experience with terminal programs and the Amiga.
  85. Especially the Intuition user interface ( Menus, requesters, etc. )
  86.  
  87. Please also see the file HandShake_AREXX.doc which describes the
  88. HandShake-AREXX interface.
  89.  
  90. WHAT IS THIS DOCUMENT NOT?
  91.  
  92. This document is not a course on telecomunications and modem usage it
  93. assumes some familiarity with telecommunications and terminal programs.
  94. If you are not familiar with terminal programs or the Amiga user
  95. interface, find a friend who is and ask him/her to help you.
  96.  
  97. WHAT DO YOU NEED TO RUN HandShake?
  98.  
  99. An Amiga with 512K or more. At least version 1.2 of Kickstart and Workbench.
  100. THIS PROGRAM WILL NOT WORK WITH VERSION 1.1 OR EARLIER OF AMIGADOS.
  101. Hardware to connect to the other computer. This may consist of only a cable
  102. if you are locally wired, or a cable and a modem if you are accessing the
  103. other computer over the telephone. This program does work with memory
  104. expanded beyond 512K.
  105.  
  106. To make full use of the features of HandShake, you will probably need more
  107. than 512K of memory.
  108. Also, HandShake can take advantage of the following programs if they are
  109. running in your system. They are not required to run HandShake however:
  110.  
  111.         AREXX - If AREXX is available, you can use it to write macros
  112.                 which give HandShake a very powerful script language.
  113.                 See the file HandShake_AREXX.doc for full details.
  114.         CONMAN- If the CONMAN console editor/manager is available,
  115.                 HandShake can use it to open DOS command windows
  116.                 on the HandShake screen.
  117.         WSHELL- If WSHELL is installed, HandShake will try to open
  118.                 a WSHELL window when asked to open a DOS window on
  119.                 its screen. If you Don't have WSHELL HandShake will
  120.                 open an AmigaShell or CLI window.
  121.                 
  122.         NOTE: All of the above tools were developed by Bill Hawes.
  123.               AREXX and WSHELL are commercial products and should
  124.               be available at your dealer, or can be bought from
  125.               Mr. Hawes directly. CONMAN is a public domain program
  126.               and is probably on your favourite bulletin board. It
  127.               also comes with the above products when you buy them.
  128.               I am in no way affiliated with Mr. Hawes. I just think
  129.               that he makes great tools.
  130.  
  131.         XPR   - HandShake now makes use of the XPR facility (developed
  132.                 by Willy Langeveld) to support external file transfer protocols.
  133.                 For those of you who who have been asking for ZMODEM support,
  134.                 it is now available as an external protocol library available
  135.                 from your favourite bulletin board.
  136.  
  137. WHY SHOULD YOU USE HandShake?
  138.  
  139. If you have a requirement for FULL VT52/100/102/220 compatability and have
  140. not been satisfied by other programs which only do half the job, this is
  141. probably the program you have been looking for!
  142.  
  143. Here is a list of some of the features that HandShake offers:
  144.  
  145.     - Full 24/48 line display with title bar enabled! No more turning the
  146.       title bar on and off to see all 24 lines.
  147.  
  148.     - Full VT52 support. Every VT100 has a VT52 inside of it. So does
  149.       HandShake -- right down to the VT52 graphics character set.
  150.  
  151.     - VT102/220 Edit mode. Local insert and deletes.
  152.  
  153.     - VT220 Emulation. Including downloadable character sets. It works
  154.       great with VMS APL.
  155.       
  156.     - VT220 7 or 8 bit control mode. Selectable erase etc.
  157.     
  158.     - Full featured AREXX support. HandShake is both an AREXX command
  159.       host and an AREXX function host. See the file HandShake_AREXX.doc
  160.       for full details.
  161.  
  162.     - Smooth or Jump scrolling.
  163.  
  164.     - Block or Underline see through reverse video cursor. Blinking or
  165.       non-blinking
  166.  
  167.     - Full VT100 Special Graphics Character Set.
  168.  
  169.     - Full double height and double width characters.
  170.  
  171.     - 132 character per line mode. It may be necessary to run preferences
  172.       and use the screen centering gadget a little to the left in order to
  173.       see the last few columns in 132 column mode.
  174.  
  175.     - Double height and width characters in 80 and 132 column mode.
  176.  
  177.     - All character modes. Normal, Bold, Reverse video, Underline and
  178.       Blinking in any combination.
  179.       
  180.     - Optional color mode. Uses ANSI color selection codes. Handy for
  181.       bulletin boards which support color.
  182.  
  183.     - Full keyboard support. This includes VT52 mode. HandShake handles the
  184.       escape sequences to turn auto repeat on and off and lock the
  185.       keyboard. No more run away cursors while in EDT under VMS etc.
  186.     
  187.     - As of release 1.60a HandShake supports the additional Amiga 500/2000
  188.       numeric keypad keys.
  189.  
  190.     - ASCII file transfer mode with user definable end-of-line translation
  191.       for both sending and receiving. No more carriage returns in your
  192.       received files (unless you want them).
  193.  
  194.     - XMODEM, XMODEM/CRC, YMODEM, YMODEM Batch, KERMIT/TEXT, KERMIT/8 BIT
  195.       BINARY and KERMIT/7 bit BINARY protocols for binaryfile transfers.
  196.  
  197.     - External Protocol support. Handshake supports XPR protocol libraries.
  198.       This allows Handshake to use protocols written by other authors. This
  199.       is how ZMODEM and other protocols which are not internal to Handshake
  200.       are supported.
  201.  
  202.     - Non-display mode lets Handshake run in the background as an AREXX
  203.       communications command server.
  204.  
  205.     - User settable Font. Handshake can use any 8 x 8 font. This font will
  206.       be scaled to provide 132 column and double width, double height fonts.
  207.  
  208.     - Six user definable function keys.
  209.     
  210.     - Dialing Support with a 20 Phone number Directory. Optional auto
  211.       redialing is available. System characteristics ( baud rate, data
  212.       bits, parity, stop bits ) can be specified in the dialing directory
  213.       entry. Auto redial can be specified in the directory entry. This
  214.       dialing mode is geared to Hayes compatible modems, although the user
  215.       can specify the dialing prefix ( ATDP or ATE0DT, etc. ).
  216.  
  217.     - Fast! Using a 95K text file captured from a VAX which was then sent
  218.       to HandShake from a local microcomputer, HandShake maintained a
  219.       throughput of 875 characters per second. This means that HandShake
  220.       can take characters as fast as your host can send them at 7200 baud,
  221.       and still look good at 9600. A real VT100 can't keep up at 9600
  222.       baud either. You can use the shareware BLITZFONTS program to get even
  223.       better performance.
  224.       
  225.     - Complete Workbench integration. HandShake can be started from the
  226.       Workbench. As you save parameter files, icons are optionally created.
  227.       These icons can be used to invoke HandShake later with the same
  228.       paremeters. You can even specify a host to dial immediately when the
  229.       icon is invoked. This feature can be turned off if you prefer the CLI
  230.       and do not want .info files cluttering up your disk.
  231.       
  232.     - The ability to capture screen images to an ASCII file or to a printer.
  233.       Just for you Toronto Real Estate Board Users. See, I do listen to my
  234.       users.
  235.       
  236.     - HandShake will optionally make use of the ARP file requester if
  237.       ARP.library is installed in the LIBS: directory of your workbench disk.
  238.  
  239. WHAT PROBLEMS ARE THERE WITH HandShake?
  240. *
  241. * PLEASE READ THIS SECTION!!
  242. *
  243. Version 2.20a has a new .parms file format. A utility called CvtParms is 
  244. provided to convert from the v2.12a (and before) format to the new format.
  245. the usage is as follows:
  246.     CvtParms oldfile.parms newfile.parms
  247. Simple eh? (We apologize for the inconvenience).
  248.  
  249. The VT220 mode does not support the Host Definable Keys feature. This will
  250. probably be in the next major release.
  251.  
  252. Line noise will sometimes select one of the special character sets (this
  253. happens with real VT100 terminals too). You can reselect the ASCII font
  254. by selecting the Terminal Type from the Terminal menu. For instance, if
  255. you are in VT102 mode, and you wish to reset the ASCII character set, just
  256. select the VT102 submenu.
  257.  
  258. HandShake takes up a lot of memory for its fonts and buffers. HandShake
  259. will run on a 512k system, but you may run into problems if you have
  260. a background utilities running (machii, virusx, etc). The best solution
  261. is to buy more memory. A 512k Amiga is really starving. However I intend
  262. to address this problem in a future release. Maybe a menu option to disable
  263. everything but the 80 column fonts.
  264.  
  265. You may find that you can not see the last two or three columns of 132 column
  266. mode. If this happens to you, run Preferences and move the screen centering
  267. gadget to the left a bit. This should fix the problem.
  268.  
  269. WHO DO YOU CALL WITH PROBLEMS, SUGGESTIONS, MAKE CONTRIBUTIONS TO ETC?
  270.  
  271. Me!
  272.     Eric Haberfellner,
  273.     57 Glenwood Avenue,
  274.     Toronto, Ontario
  275.     CANADA
  276.     M6P 3C7
  277.  
  278.     Voice Phone (416) 604-2025 ( After Six P.M. EST please ).
  279.  
  280.     I am on available on BIX as ehaberfellner, and can be reached through
  281.     USENET at ...utgpu!mnetor!becker!haberfellner!eric or eric@haberfellner.
  282.  
  283. WHAT DO YOU NEED TO KNOW ABOUT HandShake TO USE IT NOW?
  284.  
  285. The follwing things about HandShake are not obvious so you should
  286. familiarize yourself with this section.
  287.  
  288.     * READ THIS NOTE.
  289.     * HandShake uses a 660 pixel wide screen instead of the usual 640 pixels.
  290.     * This means that the HandShake extends 20 pixels further to the right
  291.     * Than most screens. It may not be possible to seew the screen depth
  292.     * arrangement gadgets at the right of the title bar or the last 3 or 4
  293.     * columns of test in 132 column mode unless you run preferences and move
  294.     * the screen centering gadget a little to the left!!
  295.  
  296. Command line.
  297.  
  298.     HandShake can be invoked from the CLI. The general form of the command
  299.     line is illustrated below (parts in square brackets are optional):
  300.  
  301.     HandShake [-n] [-p parameter_file_name] [-m AREXX_macro] [destination_name]
  302.  
  303.     The -n switch will start up HandShake in its NODISPLAY mode. In this mode
  304.     Handshake does not open a window or screen, but starts quietly in the
  305.     background. This is useful for using Handshake as an AREXX communications
  306.     command server.
  307.  
  308.     The parameter file name is the parameter file to be used, if none is
  309.     specified the default file HandShake.parms is used.
  310.  
  311.     The destination name is the name of the remote computer to be dialed.
  312.     This name must be one that appears in dialing directory of the
  313.     parameter file being used and must be spelled exactly the same way it
  314.     is spelled in the dialing directory entry (Case of characters is not
  315.     significant).
  316.  
  317.     If the name in the dialing diretory entry ends in a '*' or the Auto
  318.     Redial menu selection is set in the parameter file, HandShake will keep
  319.     dialing the number until a connection is made. If the name in the
  320.     dialing directory entry ends in a '*', do not include the '*' on the
  321.     command line when specifying the destination name.
  322.  
  323.     If this dialing directory entry appeared in the default file
  324.     HandShake.parms:
  325.  
  326.     555-1234:1200,8,n,1 Fred's BBS*
  327.  
  328.     The following command line coule be used to call this BBS.
  329.  
  330.     HandShake "Fred's BBS"
  331.  
  332.     Note that the '"'s are necessary in this case because the name of the
  333.     BBS has a space in it.
  334.  
  335.     Here are a few more examples:
  336.  
  337.     HandShake -p universities.parms UCLA
  338.  
  339.     This would dial the phone number associated with the descriptor UCLA
  340.     in the parameter file universities.parms
  341.  
  342.     HandShake -p TymNet -m readmail BIX
  343.  
  344.     This would load the parameter file Tymnet.parms, then dial the
  345.     destination BIX and finally invoke the AREXX macro readmail.rexx.
  346.  
  347.     For a complete description of dialing directory entries, see the
  348.     discussion later in this section
  349.  
  350. Workbench.
  351.  
  352.    HandShake can also be invoked from the Workbench. There is an icon which
  353.    looks like a terminal. Invoking this icon will cause HandShake to be
  354.    invoked with the parameters from HandShake.parms, or if this file does
  355.    not exist HandShake will use it's built in parameters.
  356.    
  357.    In the project menu there is an item "Create Icons". if you set this to
  358.    "Yes" HandShake will create a telephone icon every time that you save
  359.    the parameters. While HandShake is saving the parameters it will also
  360.    prompt you for a dialing descriptor which if specified will be used as
  361.    the initial dialing destination when the icon is invoked. If AREXX is
  362.    running on your system, you will also be prompted specify an optional
  363.    AREXX startup macro.
  364.  
  365.    The initial dialing descriptor  can be edited from the workbench by
  366.    examining the icon that you wish to modify and editing or adding a
  367.    Tool Types line of the form:
  368.  
  369.         DIALUP=Fred's BBS*
  370.    
  371.    The initial AREXX Macro can be edited from the workbench by
  372.    examining the icon that you wish to modify and editing or adding a
  373.    Tool Types line of the form:
  374.  
  375.         MACRO=readmail
  376.  
  377.    It is also possible to include a Tool Types line of the form:
  378.  
  379.         NODISPLAY
  380.  
  381.     This will build an icon whoch will start up HandShake in No Display mode.
  382.  
  383.    CLI users will probably want to keep the "Create Icons" option set to
  384.    "No" so that their disks will not be cluttered with un-necessary .info
  385.    files.
  386.  
  387. Keyboard.
  388.  
  389.     VT100 Keys                Amiga Keys
  390.     ----------                ----------
  391.     Arrow keys                Arrow keys
  392.     
  393.     F1 through F4             F1 through F4 on all Amaigas
  394.                    or
  395.     F1                        Keypad ( on Amiga 500/2000
  396.     F2                        Keypad ) on Amiga 500/2000
  397.     F3                        Keypad / on Amiga 500/2000
  398.     F4                        Keypad * on Amiga 500/2000
  399.     
  400.     Keypad 0 through 9        Keypad 0 through 9 on all Amigas
  401.     Keypad .                  Keypad . on all Amigas
  402.     Keypad -                  Keypad - on all Amigas
  403.     Keypad ,                  RIGHT_ALT key on all Amigas **Watch for this**
  404.                    or
  405.     Keypad ,                  Keypad + on Amiga 500/2000
  406.     
  407.     Keypad Enter              Keypad Enter on all Amigas
  408.     
  409.     
  410.     
  411.  
  412.     VT220 Keys                Amiga Keys
  413.     ----------                ----------
  414.     Arrow keys                Arrow keys
  415.     
  416.     F1 through F4             F1 through F4 on all Amaigas
  417.                    or
  418.     PF1                       Keypad ( on Amiga 500/2000
  419.     PF2                       Keypad ) on Amiga 500/2000
  420.     PF3                       Keypad / on Amiga 500/2000
  421.     PF4                       Keypad * on Amiga 500/2000
  422.  
  423.     F1-F4                     Do not transmit any key codes and are not
  424.                               currently mapped.
  425.     F5                        RIGHT-AMIGA B on all Amigas
  426.     F6                        SHIFTED F1 on all Amigas
  427.     F7                        SHIFTED F2 on all Amigas
  428.     F8                        SHIFTED F3 on all Amigas
  429.     F9                        SHIFTED F4 on all Amigas
  430.     F10                       SHIFTED F5 on all Amigas
  431.     F11                       Escape on all Amiags
  432.     F13                       Any SHIFTED Arrow key on all Amigas
  433.     F12                       Backspace on all Amigas
  434.     F14                       SHIFTED F6 on all Amigas
  435.     F17                       SHIFTED F7 on all Amigas
  436.     F18                       SHIFTED F8 on all Amigas
  437.     F19                       SHIFTED F9 on all Amigas 
  438.     F20                       SHIFTED F10 on all Amigas
  439.     
  440.     FIND                      SHIFTED-Keypad 7 on all Amigas
  441.     INSERT HERE               SHIFTED-Keypad 8 on all Amigas
  442.     REMOVE                    SHIFTED-Keypad 9 on all Amigas
  443.     SELECT                    SHIFTED-Keypad 4 on all Amigas
  444.     PREV SCREEN               SHIFTED-Keypad 5 on all Amigas
  445.     NEXT SCREEN               SHIFTED-Keypad 6 on all Amigas
  446.     
  447.     Keypad 0 through 9        Keypad 0 through 9 on all Amigas
  448.     Keypad .                  Keypad . on all Amigas
  449.     Keypad -                  Keypad - on all Amigas
  450.     Keypad ,                  RIGHT-ALT key on all Amigas **Watch for this**
  451.                    or
  452.     Keypad ,                  Keypad + on Amiga 500/2000
  453.     
  454.     Keypad Enter              Keypad Enter on all Amigas
  455.  
  456.     The Back space and Del keys can be reversed with a TERMINAL menu option.
  457.  
  458. User Definable Function Keys.
  459.  
  460.     The function keys F5 through F10 are now user definable keys. There
  461.     is now a new menu item in the Porject menu, the "Function keys" item.
  462.     Selecting this option will cause the Function Key Edit Requester to
  463.     appear. Just type in the strings that you want the fucntion keys to
  464.     transmit. When you are finished, just select the ALL DONE gadget.
  465.     
  466.     There are two other gadgets on the Function Key Edit Requester. These
  467.     allow the user to specify which characters in the transmit strings should
  468.     be used to represent the carriage return and line feed keys. The default
  469.     values are the '~' for carriage return and '`' for line feed. Please
  470.     note that inorder to change these charcters it is necessary to delete the
  471.     character which appears in the gadget before typing in the new one.
  472.     
  473.     The function key definitions are saved along with the phone directory
  474.     and other options the the selected HandShake parameter file.
  475.  
  476. File Transfers.
  477.  
  478.     The "Receive/Transmit CR/LF as ..." menu options are only applicable to
  479.     the ASCII file transfer modes. These can be used to translate end of
  480.     line characters when sending to the other system. For instance, when
  481.     sending to a VAX which is receiving with the CREATE command, you
  482.     will want to send a carriage return to the  VAX at the end of each
  483.     line. Amiga text files have no carriage returns in them so lines are
  484.     terminated with line feed characters. By selecting the Transmit LF as
  485.     CR option HandShake will do the conversion for you.
  486.  
  487.     
  488.     As of version 1.30b you no longer have to terminate ASCII Receive
  489.     (capture) mode in order to do a binary file transfer. HandShake
  490.     will automatically suspend cpature mode while the transfer is taking
  491.     place and will restart it  when the transfer has completed.
  492.     
  493.     If you use the XMODEM, XMODEM/CRC or single file YMODEM binary file
  494.     transfer mode, be aware that the received file will probably have to
  495.     be truncated. This is because all files received by XMODEM are a
  496.     multiple of 128 bytes long. AmigaDos does not like these extra bytes.
  497.     There are several good public domain utilities available to strip
  498.     these bytes off the end of the file (TAILRID, for one). If you send
  499.     your files in ARC format then this is not a problem.
  500.  
  501.     HandShake also supports the YMODEM Batch protocol and KERMIT. Using 
  502.     these protocols lets you transfer multiple files in one trnasfer,
  503.     frees the receiving user from the necessity of having to enter the name
  504.     of the file being received, and results in files that have the same
  505.     length as the original file (No need to chop extra bytes off the end
  506.     of the file). HandShake does however ask the receiving user to specify
  507.     the directory path into which the received files should be placed. 
  508.     This directory path MUST end in a ":" or a "/". Some exapmles of valid
  509.     directory paths are:
  510.     
  511.        df0:
  512.        df1:source/
  513.        source/
  514.        :source/
  515.        vd0:source/headers/
  516.        RAM:download_files/
  517.        my_files:               /* In this case my_files must be a vilume
  518.                                   name or have been assigned with the
  519.                                   assign command.
  520.                                */
  521.     If you do not specify a directory path the files will be placed in the
  522.     current directory.
  523.     
  524.     When sending with YMODEM Batch protocol you can specify a file name as
  525.     usual, or use wildcards as well. Here are some sample YMODEM Batch
  526.     send file specifications:
  527.     
  528.        df0:source/my_file.c
  529.        ram:#?
  530.        df1:source/headers/#?.h
  531.        
  532.     You get the idea. YMODEM Batch or KERMIT will transfer all the specified
  533.     files to the receiver. It will send the file names, and the file lengths
  534.     as well.
  535.     
  536.     
  537.     HandShake now supports the KERMIT file transfer protocol. It is used in
  538.     much the same way as the YMODEM Batch protocol which also supports
  539.     multiple file transfers. There are three KERMIT modes. KERMIT 8 bit
  540.     Binary, KERMIT 7 bit Binary and KERMIT Text. Kermit 8 bit Binary requires
  541.     you to be connected with the other computer with 8 data bits. It will not
  542.     work with a seven bit connection. KERMIT 7 bit binary works with a 7
  543.     bit connection it uses the KERMIT binary escaping feature. This should
  544.     only be used if an 8 bit connection is unavailable, since it can really
  545.     slow down the transfer. KERMIT Binary protocols do image transfers, the
  546.     received or sent file is bit for bit identical with the original.
  547.     Kermit Text is used for text files, and will work with either a 7 bit or
  548.     8 bit connection. It should be used for text files only. The received
  549.     files will have no cariage returns at the end of the lines, only line
  550.     feeds. If you want the carigae returns, use one of the binary protocols
  551.  
  552.     As of version 2.20b, Handshake supports the XPR External protocol
  553.     facility. This will allow you to use any XPR file transfer library
  554.     which you can pick up for your favourite bulletin board. Existing
  555.     XPR libraries include ASCII, ZMODEM, KERMIT, and QUICKB. There are
  556.     probably others by now. Simply select the "External Protocol" option from
  557.     the "Binary Protocol" sub-menu. Handshake will pop up a file requester
  558.     asking you for the name of the external protocol you wish to use. If
  559.     you re using the ARP file requester, a list will be displayed for you.
  560.     Once you have selected the protocol. You can customize its options
  561.     by selecting the "Init. External Protocol" menu item from the file
  562.     transfer menu. Once this is done, file transfers happen as for any
  563.     of HandShake's internal protocols.
  564.     
  565.     For the protocol transfers and for the ASCII Send, HandShake pops up
  566.     two windows, one in its own screen and one in the workbench screen.
  567.     These windows provide information on the progress of the transfer.
  568.     The one in the HandShake screen can be used to abort the transfer
  569.     just by clicking on the close gadget in the upper left hand corner.
  570.     The window in the Workbench screen is provided so that during a long
  571.     file transfer you can use your multi-tasking Amiga to do other things
  572.     and not have to keep flipping back to HandShake to see if the transfer
  573.     has completed.
  574.     
  575.     If you have the Audio Bell option enabled, You will hear a rising
  576.     sequence of notes for a successfull file transfer, and a falling
  577.     sequence of notes for an unsuccessfull file transfer.
  578.  
  579.     File transfers can also be initiated from an AREXX macro. Please
  580.     see the file HandShake_AREXX.doc for full details.
  581.  
  582.  
  583. Dialing the Phone.
  584.  
  585.     In order to dial a number from the dialing directory ( Menu option 
  586.     "Dial Phone" ), click using the mouse on the small square gadget
  587.     immediately to the left of the number that you want to dial. Clicking
  588.     on the text of the number allows you to edit the entry, but not to
  589.     dial it.
  590.  
  591.     The dialing directory is saved to disk whenever you save the parameters
  592.     It is possible to have several diailing directories by using different
  593.     parameter files.
  594.     
  595.     Whenever HandShake goes into auto-dialing mode, it pops up a pair of
  596.     windows much like in file transfer mode to keep you informed of progress.
  597.     See the description in the file transfer section above.
  598.     
  599.     If the Audio bell feature is enabled, you will hear a four note
  600.     sequence to indicate that the connection has been completed.
  601.  
  602.     Dialing can also be initiated from an AEXX macro. See the file
  603.     HandShake_AREXX.doc for full details.
  604.  
  605. Format of dialing directory entries.
  606.  
  607.     A dialing directory entry has the following general format. The parts
  608.     in the square brackets are optional. The * at the end of the line is
  609.     used to indicate auto redialing.
  610.  
  611.     telephone_number[:baudrate[,data_bits[,parity[,stop_bits]]]] [desc][*]
  612.  
  613.     Below are some sample dialing directory entries:
  614.  
  615.     123-4567                                      Simplest case. Dial the
  616.                                                   number using the current
  617.                                                   serial parameters.
  618.  
  619.     123-4567 Joe's BBS                            Same as above with a
  620.                                                   description.
  621.  
  622.     123-4567 *                                    Both of these will dial
  623.     123-4567 Joe's BBS*                           Until the other system
  624.                                                   Answers.
  625.  
  626.     123-4567:1200                                 Call the number changing
  627.                                                   baud rate to 1200 if
  628.                                                   necessary.
  629.  
  630.     123-4567:1200,8,n,1 Joe's BBS*                A biggie. Call Joe's
  631.                                                   until it answers using
  632.                                                   1200 baud, 8 data bits,
  633.                                                   no parity and 1 stop
  634.                                                   bit.
  635.                                                   
  636.     Valid parity characters are n=none, o=odd, e=even, m=mark and s=space.
  637.  
  638. Interlace.
  639.  
  640.     The Half screen interlace mode is intended to give you a full 24 line
  641.     VT100 Emulation in half a screen. This leaves you the other half to do
  642.     whatever you like, and still watch your terminal screen.
  643.  
  644.     The full screen interlace mode is useful in 132 column mode.
  645.     Readability of characters in interlaced mode may depend on your
  646.     selection of colors. (I find that black characters on a gray
  647.     background look just super ).
  648.  
  649.     The full screen 48 line interlace mode is useful to allow twice as
  650.     much information on teh screen. All escape sequences are extended
  651.     to work in the 48 line mode. This is useable with the new generation
  652.     of DEC editors like TPU, and others.
  653.     
  654. Multiple serial ports.
  655.  
  656.     HandShake version 2.20a supports the specification of alternative
  657.     device drivers. The default is DEVS:serial.device. Alternative drivers
  658.     can be specified from a menu item in the terminal menu, the command
  659.     line or ToolTypes Array from an Icon.
  660.     
  661.     The command line now supports the -d switch. To start Handshake with
  662.     the hypothetical driver devs:cereal.driver instead of devs:serial.driver
  663.     you could use the following command.
  664.     
  665.     HandShake -dcereal.device
  666.     
  667.     To select a device driver from an Icon, add a ToolTypes Array like the
  668.     one below.
  669.     
  670.     DRIVER=cereal.driver
  671.     
  672.     HandShake version 2.20a can be used with additional serial
  673.     ports if they are available on your Amiga. There is a new menu item
  674.     in the SETUP menu which allows you to switch serial ports on the
  675.     fly from within HandShake. If you save the parameters, Handshake will
  676.     try to use the same serial port and device driver next time you start
  677.     it with that parameter file unless you override the port selection.
  678.     
  679.     Overriding the serial port selection can be done in 2 ways from the
  680.     command line, and from an Icon.
  681.     
  682.     The command line now supports the -s switch. To start Handshake with
  683.     serial port 4 for instance, use the follwing command.
  684.     
  685.     HandShake -s4
  686.     
  687.     To select a serial port from an Icon, add a ToolTypes Array entry like
  688.     the one below.
  689.     
  690.     PORT=4
  691.  
  692.  
  693. HandShake VERSION HISTORY
  694.  
  695. Version 2.20c
  696.      - Added support for XPR external protocols.
  697.      - User can now specify which 8x8 font to use in Handshake.
  698. Version 2.20a
  699.      - Added support for multiple serial ports. HandShake now supports
  700.        unit numbers from 0 to 9. HandShake also supports alternative device
  701.        drivers.
  702.      - Adopted new HandShake Logo and therefore Changed the HandShake
  703.        icon. A thousand thanks to Art Lupinacci who designed and laid out
  704.        the Logo and disk labels for me.
  705.      - The .parms file format has been changed for this release. A utility
  706.        called CvtParms is provided to convert from the old format to the new
  707.        format. This format change was necessary because I finally ran out of
  708.        space for new stuff in the old format.
  709.      - I would like to thank Brad Fowles who forced me to do this AREXX
  710.        port by publicly telling the Toronto Amiga Developer's Forum that
  711.        I had already done it (even though I had not a single line of
  712.        code written).
  713.      - Fixed bug which caused crash when there was not enough memory to
  714.        switch screen modes to 48 line or colour mode.
  715.      - Added support for the SS2 and SS3 single shift escape sequences.
  716.      - Improved 132 column fonts.
  717.      - Added support for host printer control escape sequences. This allows
  718.        the host system to make use of the Amiga Parallel printer if it
  719.        is attached.
  720.      - HandShake now detaches when run from the command line. This means
  721.        that the CLI is not blocked if you don't type RUN HandShake.
  722.      - Replaced error requesters with moveable AutoRequesters.
  723.      - Added AREXX support. HandShake now functions as both an AREXX
  724.        command host and an AREXX function host. The name of the HandShake
  725.        AREXX port is 'HANDSHAKE'.
  726.      - Added the AREXX menu to the titlebar menus.
  727.      - Added the RUN MACRO item to the AREXX  menu.
  728.      - Added the DOS Window item to the AREXX menu. This allows a user
  729.        to open a DOS window on the HandShake screen if he is running
  730.        ConMan on his system. This is especially useful with AREXX if you
  731.        are running the Wshell from Bill Hawes.
  732.      - Added the -m option to the command line to allow CLI users to
  733.        invoke AREXX macros when starting HandShake
  734.      - Added support for running an AREXX macro when starting HandShake
  735.        from a workbench icon. This was done by adding the MACRO= ToolType.
  736.  
  737. Version 2.12a
  738.      - Cleaned up font support so that HandShake's fonts were not visible
  739.        to other applications in the system (i.e. Notepad).
  740.      - Fixed several downloadable font bugs which were reported by Joe
  741.        Trivers. Many thanks to Joe, who brought over a real VT220 to
  742.        demonstrate these bugs.
  743.      - 24 line half screen mode stopped working in the last version as
  744.        a result of the interlace bug fix. This has been corrected.
  745.      - Last version was not linked with a tiny _main, as a result a window
  746.        opened on the workbench when HandShake was run from the workbench.
  747.        This version is correctly linked.
  748.      - Changed the default foreground colour in the colour mode to 7
  749.        instead of 1.
  750.  
  751. Version 2.11a
  752.      - Fixed the "Interlace WorkBench" bug reported by Joanne Dow. If
  753.        you were running HandShake in 48 line mode with an interlaced
  754.        workbench and flipped back to the workbench with the Amiga-M,N
  755.        keys junk would be displayed.
  756.        
  757. Version 2.10a
  758.      - Set default VT220 character set mapping to gr<-g2<-DEC special
  759.        character set.
  760.      - Fixed and improved the VT220 soft font support.
  761.      - Changed Backspace handling so that it does now not wrap to previous
  762.        when at the start of a line.
  763.      - Added menu item to transmit the answer back message.
  764.      - ASCII screen images (printed or filed) no longer have trailing blanks.
  765.      - Added close file option for the Save Screen submenu.
  766.      - ctrl-Z and ctrl-X now displayed as upside down ?.
  767.      - Fixed File IO Guru in BuildFullName.
  768.      - Cleaned up handling of IDCMP messages all over.
  769.      - Added default fourth colour for File requester. This can be edited
  770.        using the color edit in the project menu.
  771.      - Added menu item in the phone menu which lets the user dial without
  772.        first hanging up. This is required for some phone systems which
  773.        require multiple dials to reach a destination. Also some people did
  774.        not like the wait associated with waiting for the phone to hang up.
  775.      - General cleanup of dialing code.
  776.      - Fixed bug in locked line requester which caused it to hang.
  777.      - Fixed receive buffer overflow problem. Receive buffer now stands at
  778.        1536 bytes.
  779.      - Ymodem receives now correctly display received size when a
  780.        retransmitted block is encountered.
  781.      - Screen formats and colors are now set if a parameter file is loaded
  782.        once HandShake is already running.
  783.      - Added more VT220 control keys (3,4,5,6,7).
  784.      - Added support for mark and space parity.
  785.      - Added support for zero stop bits.
  786.      - File requesters for loading and saving parameters now only
  787.        display files which have a ".parms" extension. If a file name
  788.        without this extension is entered. it will be added.
  789.      - Removed WaitBOVP () calls and replaced them with WaitTOF () calls.
  790.        WaitBOVP () BUSY WAITS!! UGH.
  791.      - Replaced RJ's file requester with the ARP one. If ARP.library is not
  792.        available, fall back to old style plain requesters.
  793.      - Fixed the Special Graphics character set GURU reported by Joe Trivers.
  794.      - Added direct screen print to the "Save Image" submenu.
  795.      - Added Close File menu option for "Save Image" submenu.
  796.      - The "New File" option in the "Save Image" memu item no longer saves
  797.        the first image. You must explicitly save all images now with the
  798.        Write Sreen submenu item.
  799.      - Corrected spelling for "Successful"
  800.      - Sundry other small fixes.
  801.  
  802. Version 2.00a
  803.      - Incredible code changes from last version.
  804.      - Full VT200 support (actually VT220 except for User Definable Keys).
  805.      - Added RJ Mical's color editor so you can set and save colors. See
  806.        PROJECT menu.
  807.      - Added RJ Mical's file requester. All file names are now input using
  808.        this file requester.
  809.      - Made several code changes related to serial input to clean up the
  810.        lockup problem.
  811.      - See the new keyboard layout above. Some keys have moved to accomodate
  812.        VT200 support.
  813.      - Optinal 8 color mode for "ANSI" BBSs.
  814.      - Ability to save ASCII screen images to a file. See the Screen Image
  815.        menu item in the Project Menu.
  816.      - Fixed Backspace and delete handling. No longer affects CTRL-h.
  817.        
  818. Version 1.60a    Jan/88
  819.      - Massive code cleanup. Defined function prototypes for all functions in
  820.        the source. Compiled with Lattice v4.0. Since this version is such
  821.        a major reworking of the source and compiled with a new compiler,
  822.        I would like to hear back from users as quickly as possible if you
  823.        encounter any bugs.
  824.      - Function prototyping turned up a bug in VT102 insert line feature
  825.        which could have caused trashing of very low memory. Fixed.
  826.      - Tried to convert to 16 bit integers. Failed because of bugs in Lattice
  827.        v4.0. However the source is all set to go. Maybe next release if
  828.        Lattice fixes their bugs in getfnl(). This should speed things up
  829.        a bit more.
  830.      - Added support for the extra keys on the Amiga 500/2000 Keypad. These
  831.        can now be used as F1 through F4 and the VT100 keypad comma key. See
  832.        the text above.
  833.      - Added KERMIT 7 bit binary protocol for users who connect to host
  834.        system with 7 bit connections and want to transfer binary files very
  835.        slowly.
  836.      - Reversed PHONE and TRANSFER menus.
  837.      - Cleaned up XMODEM transfer protocol bugs. XMODEM wouldn't switch from
  838.        CRC to checksum properly.
  839.      - Improved dialing. HandShake now recognizes the baud rate that a
  840.        connection is made at from the CONNECT message. i.e. CONNECT 1200 or
  841.        CONNECT 2400 etc. It also recognizes the return codes BUSY, NO ANSWER,
  842.        NO DIALTONE and NO CARRIER if one of these is returned by the modem
  843.        it is displayed for 1 second on the STATUS line of the auto redial
  844.        window. Any of these codes is taken as a failure to connect.
  845.  
  846. Version 1.50a
  847.      - Added user definable function keys. keys F5 through F10 are now
  848.        available as user definable keys. See the documentation above.
  849.      - Kermit File transfer protocol added. See documentation above.
  850.      - Some characters were getting lost after file transfers. this is now
  851.        fixed.
  852.  
  853. Version 1.42a
  854.  
  855.      - Fixed the horrid "Beep forever" bug.
  856.      - Fixed the rename command in EXEC_ME for HandShake.rev.
  857.  
  858. Version 1.41a
  859.      - Fixed bug in YMODEM Batch protocol. It would work with another Amiga
  860.        running HandShake, but not with any other YMODEM Batch
  861.        implementations.
  862.  
  863. Version 1.40a
  864.      - Fixed the horrible dialing bug which appeared in v1.30b. Boy am I
  865.        embarassed. Dialing would not work unless AUTO REDIAL was selected.
  866.      - AmigaDos requesters now appear in the HandShake screen instead of
  867.        popping the Workbench screen to the front. Big improvement.
  868.      - YMODEM and YMODEM Batch file transfer protocols are here. See the
  869.        File transfer section of this document and the Binary Protocol
  870.        item of the TRANSFER menu.
  871.      - Added a bell. HandShake now beeps upon receipt of a BEL character.
  872.        HandShake also now gived an audio indication of file transfer
  873.        completion and connection in auto redial mode. The user can
  874.        select audio bell, visual bell, both or none. See the new Bell Type
  875.        item in the TERMINAL menu.
  876.      - Added the VT100 Margin bell feature. See the new Margin Bell
  877.        item in the TERMINALcmenu.
  878.      - Added a blinking/non-blinking option for the cursor. If you are
  879.        using a parameter file from a previous version of HandShake,
  880.        the cursor will not blink initially. Go to the Cursor item of the
  881.        TERMINAL menu and select blinking. Now save your parameters. From
  882.        now on the cursor will blink again when you start HandShake.
  883.      - Speeded up CRC calculation for file transfers.
  884.      - Fixed a minor bug which caused XMODEM sends to always show 1 error
  885.        even there had not been one. This did not affect the transfer.
  886.      - Fixed a bug which sometimes caused inproper font selection after
  887.        going into VT52 mode and back out again.
  888.      - Fixed bug in UK Character set support.
  889.      - Speeded up CRC calculation for file transfers. I am now doing
  890.        bytewise instead of bitwise CRC calculation.
  891.  
  892. Version 1.30b
  893.     - Replaced the abort requesters with windows. The windows are used to
  894.       provide progress  information about file transfers and auto-dialing
  895.       as well as serving as abort devices. To abort a file transfer or
  896.       auto-dialing just click on the close gadget of the window in the
  897.       HandShake screen.
  898.     - The windows described above are also duplicated on the Workbench
  899.       screen. This is so that you can do other things while a large file
  900.       transfer is in progress and not have to keep flipping back to
  901.       HandShake to see if it is finished yet. Same for auto-dialing.
  902.     - Relinked with a "tiny" _main.o so that the lattice standard input/
  903.       output window no longer pops up in the workbench screen.
  904.     - Capture mode (ASCII Receive) can now remain active during binary
  905.       file transfers. HandShake will suspend it until the transfer is
  906.       over and then start it up again.
  907.     - Added XMODEM/CRC file transfer mode.
  908.  
  909. Version 1.21a
  910.     - Local echo mode did not work properly. This has been fixed.
  911.     - Reseting the terminal would sometimes leave a double cursor on the
  912.     - Screen. This has been fixed.
  913.     
  914. Version 1.20a
  915.  
  916.     - Improved Workbench interface. HandShake will now optionally create
  917.       create Telephone icons for saved parameter files. This allows the
  918.       user to select which paramter file to use from the Workbench. The
  919.       icons can also be created in such a way that HandShake will
  920.       automatically start dialing a specified number when it is invoked
  921.       with that icon.
  922.     - Fixed a bug which caused XMODEM transmits to sometimes hang.
  923.     - Changed autodialing support so that it now works with modems that
  924.       report status while they are dialing (Like the Volksmodem 1200).
  925.     - Dialing destinations which contained spaces on the command line did
  926.       not work, even when enclosed in quotes. This has been fixed.
  927.     - Selecting the Reset Terminal option from the menu or typing Amiga-V
  928.       would cause two cursors to appear on the screen. This has been fixed.
  929.  
  930. Version 1.10a
  931.  
  932.     - At last, a real 132 columns instead of 128.
  933.     - Added some intelligence to the routines that display the cursor. This
  934.       yielded a 35% performance improvement. HandShake now has an average
  935.       throughput of about 875 characters per second.
  936.     - Cleaned up parsing of command line parameters especially the dialing
  937.       directory entry.
  938.     - Put error checking into reading of parameter files. If the file does
  939.       not exist or is of the wrong size put up a requester advising the
  940.       user. If the default file HandShake.parms cannot be found do not
  941.       annoy the user with a requester (use the built in defaults).
  942.     - The command line dialing direcotry entry is now case insensitive.
  943.     - Added some register variables in several places. HandShake is now
  944.       about six percent faster because of this.
  945.     - Fixed a bug which caused the line attribute for the bottom line to
  946.       not be reset when the screen was cleared.
  947.     - Fixed a hideous bug which caused the input subtask to lock up
  948.       sometimes. This would appear to the user as a blank title bar. This
  949.       would only happen if the user interface task sent a "go to sleep"
  950.       message to the serial input task at the same instant that an IO
  951.       completed, therefore this was more likely to happen at higher baud
  952.       rates. Sorry about that one.
  953.  
  954. Version 1.02a ( not released to the public at large ).
  955.     - Added command line parameters to specify parameter file to use, and
  956.       to allow the user to specify a remote computer to dial from the
  957.       command line.
  958.     - Added 20 second dialing timeout to the dial timeout menu.
  959.     - In order to abort redialing it was sometimes necessary to select the
  960.       abort requester more than once. This is now fixed.
  961.     - Moved File transfer and redialing abort requester to upper right
  962.       portion of screen.
  963.     - General cleanup of the file transfer code. Receiveing to disk is now
  964.       much faster. Transfer aborts now work porperly at high baud rates.
  965.  
  966. Version 1.01a
  967.     - Auto redialing added.
  968.     - Pulse/Dial menu option replaced with user definable dialing string.
  969.     - Added menu item to allow user to specify backspace & del key
  970.       operation.
  971.     - Fixed bug which caused menus to not be updated after a reset if
  972.       no parameter file was present.
  973.  
  974. Version 1.00a
  975.     - HandShake Unleashed on an unsuspecting public. An historic Moment!
  976.