Communications Programs (Disk 102) (Aug 1988) : GT12 / GT.Doc

The GT terminal program  version 1.2   by Greg Cunningham      August 5th 1988.

This is now a demo becuase I'm working on a commercial version for
Progressive Peripherals & Software.


The first thing you'll notice is all of the nice cryptic items across the menu
bar.  These may be selected by clicking the menu button while the pointer is
over the item.

I'll try to document them as well as possible, but I know I'm bad at writing
documentation.

In order from left to right, I have them labeled with letters.
Also right Amiga command sequences will work with some items, as noted.


***** The Reason for right mouse button on these, since everone *****
***** is wondering why it seems non-standard			*****

Intuition won't send my window a message for left mouse button since it's
out of the window, it's the screens title bar/drag bar.  When the left
button is down, the screen's drag gadget is selected.


    2400  CCF8N1 S |XC X D/L U/L| SEND CAPT SUS B HU DN Phone Config TEXT
     |    |||||| |  || |  |   |    |    |    |  | |  |    |     |     |
     A    BCDEFG H  IJ K  L   M    N    O    P  Q R  S    T     U     V


A. Baud -  Clicking on this will flip it thru 19200, 9600, 4800, 2400, 1200,
 Amiga-B   then back to 19200.  It decriments because normally you have to go
	   down one quickly at connection. (I'll have to see if it can be auto)

B. Recieve	CR 'C' or CR+LF 'L'.

C. Transmit	CR or CR+LF.

D. Duplex	'F'ull or 'H'alf.

E. Lenght	'7' or '8'.

F. Parity	'N'one, 'O'dd, 'E'ven, 'M'ark, or 'S'pace.

G. Stop bits	'1' or '2'.

H. SplitScreen	Use this for sending lines of text only at CR.
 Amiga-/

I. X Disable	Highlighted for auto x0N/x0FF, else off.
 Ctrl-Q/S

J. CRC		Highlighted CRC, else Checksum.

K. Protocol	'X'Modem, 'Y'Modem, XModem & WXModem 'T'ext, and 'W'XModem.
 Amiga-X

L. DownLoad	Calls up what I hope to be a good immitation TxEd
 Amiga-D	(the standard) file requestor, like in the other terms.
		The arrows beside the devices will scroll showing whatever
		devices are currently active, including	S: and C:.
		Enter the filename in the string on the bottom,	and the directory
		(and PC-DOS/Amiga pattern if needed) in the string at the top.
		Hitting return or Okay will start the process.

M. UpLoad	see L.
 Amiga-U

N. Text Send	Opens that requestor for a name (see L.).
 Amiga-S	The SEND item will dehighlight when done.
		To stop the send prematurely, select this item again.
		SUS will toggle suspending it.

O. Text Capture
 Amiga-C	Opens that requestor for a name (see L.).
		If you use the default 'Capture' it will open a file named
		'Capture.1'.  For my own reasons if the file exists and is
		not 0 bytes, it will open a new file with a number higher
		than what exists (i.e. Capture.2,3,4,5,6,ect.)
		I like lots of capture files all over the place.

		The CAPT item will dehighlight when done.
		To stop the capture prematurely, select this item again.

P. Suspend	Selecting SUS will toggle suspending Text capture/send.

Q. Send Break	Send break.
 Amiga-L

R. Hang Up	Send (config) Hangup string.
 Amiga-H

S. Dial Next	This will dial the first selected name in the phonebook.
 Amiga-N	If the line was busy, selecting it will dial the next
		number selected.

	Note:	If a connection was made, the name is deselected,
		and the next time DN is selected, it will dial the next
		selected name.

T. PhoneBook	This will bring up the phonebook.
 Amiga-P	this should be placed in the current 'S:' directory.

  Dial		Selecting 'Dial' will dial the top selected name and set it's
   Amiga-N	parameters (see A. thru G.) accordingly.

  Script	There is also an optional script set, placed after the setup.
		These work in pairs, and must be enclosed in parens '()',
		and must have a '=' dividing them.

		The first of a pair is the prompt, the BBS that sends this
		prompt must send a space, (, =, or ) after it to be detected.
		And must be one word, such as for 'Your name: ' you would
		use 'name:' as the prompt.  Also this is case sensitive.

		The second is the string to send.
		Exaple: (Name:=Greg\r)

		BBS says:	Name:
		GT  says:	Greg\r

		Here's one I use for BBS-PC

		([RETURN]=\r^PMy Name\rPassword\r)

		BBS says:	Press [RETURN]
		GT  says:	return, control-P, name, password.

   *  Limits	400 names per phone lib.
		200 chars per name (line).
		 20 pairs per name (line).


  Selecting names should be easy, just think of it like DPaint

  Editing names. When selecting 'Edit' the top selected name will appear
		in the edit line, hitting return will enter it in.

		To Add to the list, select Edit with no files selected.
		When return is hit the name will appear at the bottom of
		the list.

  Queue 	Dials all selected numbers in the phone book untill all
		are deselected or ESC is pressed while dialing.

  Load		to load another phonebook in.

  Save		to save the current phonebook.

  AUTO		Toggles ON/OFF.
		This hopefully makes the phonebook open before you can say GT.
		(when a connection is not made, at logoff, and other nifty times)

  Quit		Select the close gadget, or hit Amiga-P again to exit
		the phonebook.


U. Config	This is kinda like the phonebook.
 Amiga-M

  Palette	Open the color palette.  Cancel restores, close gadget keeps
		new colors.

  LACE		Toggles interlace.

  Planes	Flips planes between 1 (2 color), 2 (4 color) and 3 (8 color).
		16 colors?  escape codes can't go over 10 colors.

  127C or 255C	127/255 character mask.

  Buffer size	Used for review and capture buffer.
		Left mouse button increments. (+=2046)
		Right mouse button decrements.
		(This is the only thing that does'nt take effect untill rerun)

  Save Config	Saves all config strings, color, lace, planes, mask, auto,
		buffer size, protocol, and current baud to 'S:GT.Config' only

  Edit		works like the phone edit (200 chars max).
		But you don't have to hit Edit if you don't want to edit the
		current string.
		Just entering the text and hitting return will place the text
		in the highlighted string.
		For editing macros and config strings.
		Slide the bar down to get to the config strings:

			Phone : Path & phonebook file to load first.
			Macro : Path & key macro file to load first.
			Data  : Initial path for file requestor to use for
				Capture, send, U/L, and D/L.
			Init  : String to send modem when run.
			Exit  : String to send modem when quiting GT.
			Dial  : Prifix dial sequence.
			Hangup: String to send modem for Amiga-H.
			Font  : font [space] size.  Like 'Opal 9'

		Special commands for FKeys:

		 \w  Wiat half second
		 \r  [RETURN]
		 \l  Send break
		 \t  TAB
		 \b  BACK SPACE
		 \f  Form Feed (Clear Screen)

		 ^c  Control character,  'c' being any character from A to Z


  Load Keys	load another set of macros in.

  Save Keys	save the current macros.

  Quit		Select the close gadget or hit Amiga-M again to exit the
		macro screen.

V. Flip to Time

		Time shows current time, and connect time.

		CT will initialize at DCD, and show how long you've been online.
		CT will keep the time online after losing carrier.
		While online, it may be reset by clicking somwhere in the
		area.
		Also a helpfull input line display that updates ever so often
		for use with the script stuff.

Review Buffer	Hit any of the cursor keys to open the review window.
		Cursor up goes up one line.
		Cursor down goes down one line.
		Shift+Cursor up goes up one page.
		Shift+Cursor down goes down one page.
		Cursor left or right closes the window.


 Quick Key Reference


	Amiga-B 	Flip Baud rate.

	Amiga-C 	Start/End capture.

	Amiga-D 	D/L

	Amiga-H 	Send hangup string.

	Amiga-K 	'Kill' or deselect last number dialed.

	Amiga-L 	send break. You can also use \L in FKeys & splitscreen.

	Amiga-M 	Toggle Config/Macro screen.

	Amiga-N 	Dial Next, names are deselected automaticaly on DCD.

	Amiga-P 	Toggle phone screen.

	Amiga-Q 	quits GT if no DCD, Close Gadget works always.

	Amiga-R 	Redial last number.  Dials top number selected in list.

	Amiga-S 	Start/End ASCII send.

	Amiga-U 	U/L

	Amiga-X 	flip thru protocol.

	Amiga-W		reset color/alt chars & clear screen.

	HELP		Shows all of these Amiga keys and the text send delay
			slide bar.

	ESC		Turns off script when online.
			Turns off Queue when offline.

**** NEW:

HELP window with send delay speed.

Send break.

Had to change script chars to parenthasis '()' becuase [ and ] are different
chars in norwiegen, Thanks Björn!

No need to save config, quit and reload for anything but changing buffer size.

And many other bugs fixed.

***

Also a special thanks goes to Harv Lazer and the poeple on PLink who helped
me the most with fixing the bugs.

If it goes out of San Antonio, the area code for the phone numbers is (512)

All modem I/O & timing routines were designed using the Anchor 2400E.

If you gotta contact me, I'm on all the boards in the example phonebook,
and this my address:

	Greg Cunningham     Nomad Development.
	2014 Encino White
	San Antonio, TX  78259

Other options:

	Phone (512) 490-0055
	BIX: gcunningham

contact Progressive Peripherals & Software for further info.

	464 Kalamath Street, Denver Colorado 80204
	Phone (303) 825-4144
	


			Enjoy,
				Greg Cunningham, Nomad Development