home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d114 / vt100 / readme < prev    next >
Text File  |  1987-11-21  |  12KB  |  256 lines
  1. This archive contains a vt100 emulator with KERMIT and XMODEM file
  2. transfer protocols.  Original work by Dave Wecker, V2.7 by Tony Sumrall.
  3.  
  4. Thanks:
  5. -------
  6.     To everyone who sent in code and suggestions!
  7.  
  8. Releases:
  9. ---------
  10.     v2.7 870825 ACS - See Release Notes.
  11.     v2.6 870227 DBW - bug fixes for all the stuff in v2.5
  12.     v2.5 870214 DBW - more additions (see readme file)
  13.     v2.4 861214 DBW - lots of fixes/additions
  14.     v2.3 861101 DBW - minor bug fixes
  15.     v2.2 861012 DBW - more of the same
  16.      v2.1 860915 DBW - new features (see README)
  17.     v2.0 860823 DBW - Major rewrite
  18.     v1.1 860720 DBW    - Switches, 80 cols, colors, bug fixes
  19.     v1.0 860712 DBW    - First version released
  20.  
  21. Usage:
  22. ------
  23.     Please read VT100.DOC for usage information and examples.
  24.  
  25. Release Notes:
  26. --------------
  27. v2.7 870825 ACS - Requester is only used for input.  A new window (the
  28.       Info/Xfer Status window) now shows what used to go there and the
  29.       requester now comes up in this window.  The window is sizable,
  30.       draggable, closeable and front-to-backable; when re-opened it
  31.       will appear in its last location with its last dimensions.  The
  32.       window ignores input but will become active when it's first
  33.       displayed as well as when a requester is put up in it.  To
  34.       cancel a transfer request, first ensure that the mail VT100
  35.       windiw is active then hit ESC in it.
  36.     - KERMIT mode has been hardened and wildcarded files can be sent
  37.       to a KERMIT that is *not* in server mode.  E.g. you may say
  38.       RECEIVE to your host's KERMIT then send Foo* -- all files
  39.       starting with Foo in the current directory will be sent.
  40.     - New command line switches -i and +i.  -I says don't use an init
  41.       file, +i file says use "file".  User may also specify script
  42.       files on the command line which will be executed in sequence.
  43.     - New init file command SHORTCUT.  See vt100.doc.
  44.     - Nagging bug: On 2nd and subsequent uses of the requester, the
  45.       1st character of the last use is redisplayed.  Intuition bug?
  46. v2.6 870227 DBW - bug fixes for all the stuff in v2.5
  47.     - Input requestors are now self selecting (ignore comment in 2.5)
  48.     - Added a BS<->DEL menu item and startup option (SWAP ON/OFF)
  49.     - Renamed dopen/dnext/dclose to diropen/dirnext/dirclose for LATTICE
  50.     - Added a CONVERT option that tells whether KERMIT should downcase
  51.     - MAJOR CHANGE: re write the INPUT/SCRIPT commands, see VT100.DOC
  52.     - Fixed a major problem with Set Directory causing LOCK conflicts
  53.     - Moved the Title up 1 pixel so that it doesn't get cut off anymore
  54.     - I've included the font code.  It looks for an env variable named
  55.       "font" (yes, lowercase) and, if found, uses that font for its
  56.       test.  If you don't like it you may wanna remove it.  I was gonna
  57.       ifdef it but I ran out of time.  Remember that there's a PD set
  58.       cmd to allow Lattice users to set env vars.
  59.  
  60. v2.5 870214 DBW - more additions (see readme file)
  61.     - All prompting now done through a string requester/gadget.
  62.       NOTE: YOU MUST SELECT THE INPUT STRING OF THE REQUESTER BEFORE
  63.         YOU CAN TYPE A RESPONSE.
  64.     - Local echo mode added (half duplex for Carolyn)
  65.     - BEEP command added to SCRIPT
  66.     - New menu/init/script items:
  67.         CLEAR SCREEN    - clears the screen
  68.          ECHO        - turns on/off half duplex mode
  69.         WRAP        - turns on/off autowrap on long lines
  70.         NUMKEY        - turns on/off numeric keypad mode
  71.         APPCUR        - turns on/off application cursor mode
  72.     - Rewrote toasc() to use qualifier field (no more getting the
  73.       keyboard "stuck")
  74.     - Fixed locking of directories (should now run under workbench ok)
  75.     - Cleaned up VT100.H to really check includes on compile
  76.     - Setting font explicitly to TOPAZ 8 (no more dumb assumptions)
  77.  
  78. v2.4 861214 DBW - lots of fixes/additions
  79.     - Beep should now work under Lattice
  80.     - CreatePort now passes longs (as it should always have)
  81.     - Nested comments in KERMIT.C removed
  82.     - Beep volume of 0 (DisplayBeep) now works
  83.     - snum[] declaration in KERMIT.C fixed
  84.     - multi_xfer is now void and return fixed (in kermit)
  85.     - "." can no longer get "stuck" as the break key
  86.  
  87.     - RIGHT-AMIGA-keys have been added for most menu items
  88.     - The ALT key is now an EIGHTth bit shifter
  89.     - Control-@, Control-2, Control-space send the NULL character
  90.     - Control-6 now sends Control-^
  91.     - Control-- and Control-? now sends Control-_
  92.     - Cursor application mode (<esc>[?1h and <esc>[?1l) now work
  93.     - XMODEM now masks the eighth bit if parity is other than NONE
  94.  
  95. v2.3 861101 DBW - minor bug fixes:
  96.     - added p_wbcolors to allow workbench colors on custom screen
  97.       (In the init file you can specify WBCOLORS to be NO (use color
  98.        definitions in INIT FILE or VT100.H) or YES (use WORKBENCH
  99.        colors for everything)).
  100.     - "$" now sends a kermit-bye (like it says in VT100.DOC).
  101.     - made window/screen heights more reasonable
  102.     - Added ANSI insert line and delete line (<csi><num>L and
  103.       <csi><num>M) to speed up various editors (like emacs).
  104.       NOTE: This is NOT a VT100 sequence (new extension).
  105.     - ctrl-space now also sends a null (along with ^@ and ^`)
  106.     - RAWKEY fixed in WINDOW.C
  107.     - p_wrap fixed in WINDOW.C
  108.     - removed WRDMAX from VT100.H
  109.     - fixed exit with no params in SCRIPT.C
  110.     - fixed parity comparisons in KERMIT.C
  111.     - init file [n+1] changed to [nplus1] to make Lattice happy.
  112.     - cursoron(), cursoroff() changed to one routine cursorflip().
  113.     - long lines shortened to less than 80 characters (for gateways).
  114.     - blanks following exit (or comments) now work in scripts.
  115.  
  116. v2.2 861012 DBW - more of the same:
  117.     - The INIT file "exit" can now chain to a script
  118.     - The SCRIPT command "exit" can now chain to another script
  119.     - Hangup menu item now works.
  120.     - Autowrap can now be set from VT100.H, VT100.INIT (<esc>[?7h l)
  121.     - Control-G is now handled with an audible beep
  122.     - Script now used "^chr" to send control characters
  123.     - The graphics "box" character (a) was added
  124.     - Control-@ and Control-` now send the NULL character
  125.     - Alternate color for BOLD has been re-instated by popular demand
  126.     - Menus have been cleaned up.
  127.     - Lattice compilation cleaned up.
  128.     - No more wordsize parameter since PARITY takes care of all cases
  129.     - Function keys can now call scripts
  130.     - Double shift keys are now handled correctly.
  131.     - Version has been added to the title bar (for bug reports).
  132.  
  133. v2.1 860915 DBW - new features / bug fixes
  134.     - Now identifies as a VT100 (including the response to <esc>Z)
  135.     - Cursor color now gets read in as hex (instead of decimal)
  136.     - REPORTMOUSE taken out of definitions (not needed)
  137.     - XON/XOFF now being handled by the device driver instead of me
  138.     - Literal escape characters have been replaced with \033
  139.     - At init time the user can now specify the input BUFFER size
  140.       (typically between 512 and 2048 bytes) depending on baud rate
  141.     - Script files are now case insensitive for commands
  142.     - XMODEM now turns off the driver XON/XOFF during transfers
  143.     - Graphic rendition now done by the OS instead of me.
  144.     - Initialization files are now searched for in S: instead of C:
  145.     - Forward GOTO bug fixed in the script package.
  146.     - Keypad can now be used in both numeric and application mode
  147.     - General purpose cleanup() routine added for all exits.
  148.     - Utility menu added (sendbreak, hangup, change directory).
  149.       NOTE: hangup is not implemented yet.
  150.     - Full wild card support in file transfers (see vt100.doc).
  151.     - Kermit cleaned up with better filename handling (from host).
  152.     - Script now has CD (changed directory) and SB (send break) commands
  153.     - Added Parity and Wordsize choices in VT100.H, VT100.INIT, menu
  154.       and scripts. (Generates parity from a table).
  155.     - Added 8th bit quoting in KERMIT when using 7 bit words (ODD or
  156.       EVEN parity).
  157.     - Break time can be set from VT100.H, VT100.INIT or a script file.
  158.     - Transfer mode (image or CRLF) can now be set from a script file.
  159.     - Control characters in escape sequences now act like a true VT100.
  160.     - F10 now works from init files.
  161.     - Right (or Left) AMIGA with period (".") sends a BREAK to the host
  162.       from the keyboard.
  163.     - XMODEM status kept down to one line for a file transfer.
  164.  
  165. v2.0 860823 DBW    - Major rewrite:
  166.     - Emulator now compiles under either MANX or LATTICE by defining
  167.       the appropriate compiler type in VT100.H.
  168.     - Sped up code to an effective baud rate of (about) 8k. This means
  169.       that clear text at 4800 baud should be no problem.
  170.     - Added XON/XOFF generation so that characters should not get lost
  171.       any more at 9600 baud (when receiving clear text).
  172.     - Got rid of all command line switches and environment variables.
  173.       Instead upon invocation the program searches first for any file
  174.       named on the command line, then looks for VT100.INIT in the
  175.       current directory and finally searches for C:VT100.INIT.
  176.       All parameters can be set in the init file, and a sample VT100.INIT
  177.       is provided in VT100.DOC that shows all possible options.
  178.     - All parameters that are set by VT100.INIT are defined in VT100.H
  179.       (variables starting with "p_"). This allows you to compile your
  180.       own defaults into the code.
  181.     - You can now set the number of lines (for all you EMACS freaks :-).
  182.       On an interlaced screen this gives you upto a 48 line terminal.
  183.     - WORKBENCH colors are NEVER touched.
  184.     - In an attempt to keep the size down, the color palette menu item
  185.       has been removed (current). Code is about 36K in size with a
  186.       run time image (using workbench screen) of about 88k.
  187.     - Many bugs fixed including reverse scrolling with descenders,
  188.       reverse video at end of line, clearing with scrolling regions,
  189.         ... and 20 or more others.
  190.     - File capture now no longer sends the filename to the host.
  191.     - BOLD (<esc>[1m) has now been added by using an additional color
  192.       when you specify a depth of 2 (instead of 1) bitplane.
  193.     - UNDERLINE (<esc>[4m) has now been added.
  194.     - The handling of remote (host) escape sequences has been completly
  195.       re-written (thanks to Dawn Banks for all the work).
  196.     - Function keys (and shifted function keys) can now be bound to
  197.       arbitrary strings (Jim Ravan gets his macros). See VT100.DOC
  198.       for details.
  199.     - Cursor has no been reduced to the size of a normal character for
  200.       easier readability.
  201.     - XMODEM has been improved (by Steve Drew) to use a timer device
  202.       (for timeouts) and to abort immediately if the user types <ESC>.
  203.     - KERMIT has been completely re-written and appears to work fine,
  204.       thanks to the efforts of Steve Drew.
  205.     - New menu item allows script file support. Module written by
  206.       Steve Drew. See VT100.DOC for details.
  207.  
  208. Known problems:
  209. ---------------
  210.     none
  211.  
  212. Suggestions/bug fixes not implemented (as of yet):
  213. --------------------------------------------------
  214.     - Custom screen should use a borderless backdrop window
  215.     - Quit from keyboard should be supported (for above)
  216.     - Automatic maximum sizing of window should happen
  217.     - Screen should be resizable
  218.     - AT TIME should be implemented in scripts (besides DELAY)
  219.     - Kermit should create sub directories (when necessary)
  220.     - Use the system keymap
  221.     - Use a disk font for graphic character set
  222.     - Allow the mouse to be sent to the host (for various EMACSs)
  223.     - Kermit VM/CMS (IBM) protocol support
  224.  
  225. Installation:
  226. -------------
  227.     The files in this archive may be extracted by the bourne shell
  228.     (/bin/sh) or the shar program using the "unshar switch (-u)",
  229.     contact me if you need a copy of this version of shar.
  230.  
  231.     REMEMBER: Set the correct compiler definition in VT100.H
  232.  
  233. Files:
  234. ------
  235.     README        - this file
  236.     vt100.doc    - documentation for the terminal emulator
  237.     makefile    - make file for the emulator (under MANX AZTEC-C)
  238.     vt100.h        - include file used by all other modules
  239.     window.c    - manager for window and keyboard
  240.     vt100.c        - main module, handles menus
  241.     remote.c    - handle remote characters (vt100 emulation)
  242.     kermit.c    - kermit protocol (to transfer text files on VMS
  243.               select the CRLF option on the transfer mode menu,
  244.               otherwise use image mode).
  245.     init.c        - startup code
  246.     xmodem.c    - xmodem protocol that understands AMIGA binary and
  247.               text file formats (automatically).
  248.     script.c    - script control package
  249.     expand.c    - filename expansion (wildcards) and dir setting
  250.  
  251. Contact:
  252. --------
  253. Please send bugs/comments/suggestions/praise for V2.7 to:
  254.  
  255.     Tony Sumrall at USENET: acs@amdahl.com
  256.