[net.sources.mac] D'Lab: SquirmTerm.doc

maclab@reed.UUCP (Mac DLab) (12/20/85)

This file describes SquirmTerm....


----------------------------------------------------------------------------

Happy Holidays from the Reed Academic Software Development Laboratory!

  Richard Crandall
  Marianne Colgrove
  Josh Doenias
  Scott Gillespie
  Michael McGreevy
  Greg Stein (in absentia)
  Ann Muir Thomas
   and :-)

   "Don't make me bust you up, dude." (The Late Boyfriend).

{decvax, ucbvax, pur-ee, uw-beaver, masscomp, cbosg, aat,
 mit-ems, psu-cs, uoregon, orstcs, ihnp4, uf-cgrl, ssc-vax}!tektronix 
								\
						                 +--!reed!maclab 
{teneron, ogcvax, muddcs, cadic, oresoft, grpwre,     		/
 	  harvard, psu-cs, omen, isonvax, nsc-pdc}-------------+

------------------------------------------------------------------------------


SquirmTerm

SquirmTerm is a simple terminal emulator -- it emulates GriffinTerminal.  
GriffinTerminal is a Tektronix 4012 terminal emulator for the Macintosh, 
developed at Reed College.   SquirmTerm does not emulate the graphics of the 
4012, rather it emulates the various cursor movement features which 
GriffinTerminal supports in Character (text) mode.  Squirmterm may be used 
with a modem, or with a direct serial line to link your macintosh to another 
computer.

If you are on Unix, and if your  terminal type is set to gt or grif, you  can 
use vi (a full-screen text editor) with SquirmTerm.  Here is the Unix termcap 
for GriffinTerminal/SquirmTerm:


gt|grif|GriffinTerminal|Tek 4012 emulator on Apple Macintosh:\
        :db:os:eo:bs:bc=^O:kb=^H:cl=\E^L:cm=\EY%+ %+ :co#80:li#26:\
        :sf=\EU:sr=\ED:kh=^A:nd=^N:up=^K:kl=^O:kr=^N:kd=^J:ku=^K:\
        :ce=\EK:cd=\Ek:al=\EM:dl=\El:ic=\EF:dc=\EE:


SquirmTerm Baud and Params Menus

Set the items in these two menus to agree with the communications parameters 
the host computer is using.  SquirmTerm will remember these settings between 
sessions -- just set them once, and you will never have to change them again.


SquirmTerm Options Menu

Send Break  Selecting this menu item will cause a 500 millisecond break 
condition to be set on the serial port.

Send...  Same as Send File to Host on GriffinTerminal.  You may select a 
Macintosh disk file (Text files only) to send to the host with the standard 
file  dialog box.  Note:   As does GriffinTerminal, SquirmTerm handshakes a 
Send... by waiting for echoed carriage returns. 

If SquirmTerm hangs during a Send... <Shift-Enter> will un-hang (continue the 
transfer).   <Enter> will halt Send...

Receive...  Same as Receive Next from Host on GriffinTerminal. You are asked 
to specify the disk file to save characters to.  No file chopping occurs (all 
following characters will be saved to a single file). If an error occurs 
during Receive... (such as disk full) SquirmTerm will beep, write "File 
Receive Error" to the screen, and close the file. No dialog box appears during 
Receive (like GT's "Now Receiving..." window), but a checkmark appears next to 
Receive... while you are receiving characters. Select Receive.. again to stop 
transfer -- the checkmark will go away.     

Note:  SquirmTerm buffers Receive... with a 1K block of RAM.  SquirmTerm will 
only write characters to the file when the buffer fills up, or when you stop 
the Receive....  

Delete... Very Handy.  Allows you to delete files on any disk. A dialog box 
showing all files on disk will appear:  select the file you want to delete, 
then click in the Open button.  Careful!  The dialog box will keep appearing 
until you click in the Cancel button.

Hard Copy   Select this item when you wish to send output to the printer, in 
addition to the screen.  SquirmTerm will print to an ImageWriter or 
LaserWriter printer.  A check mark will appear next to this item while it is 
selected.  Select Hard Copy again to turn it off (check mark will go away).  


Key Mapping

--  The back-quote character (`) is mapped to <esc>   from the keyboard.
--  <option-shift-`> produces the back-quote.     
--  <Enter> is mapped to <Delete> (ascii 127).  
--  The cloverleaf key  acts as a <Ctrl> key.


Mouse Clicks

Mouse clicks send vi-specific commands as follows:

Single Click:   Move to click location, using (-,CR, and column 
                addressing(|)).                
Double Click:   Move to click location, then command vi to 'change word 
                ('cw').                 
Triple Click:   Send escape, and 'u' to undo the double click command, then 
                command vi to 'change to end of line' ('C').