
	      LJS' TERMINAL (version: 2.1)
	Program	      by: 	Lasse Sundstrm (LJS)
	Documentation by: 	LJS
	RSC-file made by:	LJS 
	  ''   edited by:	Pekka Saarinen & Simo Siiri
	Thanks	      to:	My father, all beta testers and
				all of you who gave me some 
				ideas to be included in LJSTERM.

		COPYRIGHT  Lasse Sundstrm 1992-1994

SHAREWARE:
	  LJSTERM is ShareWare so you may try it for a few weeks
	(3 tops) and then you should decide if you will
	register it or not. If you don't register LJSTERM you
	are not permitted to use it any longer! An UNregistered
	copy of LJSTERM will remind you to register it. 
	You can copy or upload this software as many times as you
	like, BUT never should you gain money by that.

HOW TO REGISTER:
	  It's rather simple to register LJSTERM. If you can,
	transfer 50.- FIM to my bank account in Finland:
	POSTIPANKKI 800024-11115560
	(It's a Finnish bank!!!)
	Please include your name, address and
	"LJSTERM REGISTRATION"-text in the field reserved for
	more information.
	Then send me a letter that contains:
	- YOUR name and address (and Internet address if you've got one!)
	- Your telephone number if you live in Finland
	- A copy of the money transfer order
	- And some comments concerning LJSTERM
	If it's impossible for you to transfer money into my finnish
	bank account, you should send me an international money order
	for 100.- FIM (50.- for me and 50.- for the bank).Make it payable
	to: Lasse Sundstrm. Then send the letter WITH the
	MONEY ORDER to me!

	My address is:

		Lasse Sundstrm
		Pohjoiskaari 26 A
		FIN-00200 Helsinki
		FINLAND 

	  In return you will get a LJSTERM key file that 
	tells LJSTERM you have registered it. You are NOT
	permitted to copy, give, transfer, hire or lend the key
	file to any other person. Nor is there any possibility 
	that YOUR key file is used by 2 or more persons at the 
	same time! Violations against this simple rule are
	treated as unauthorized copying and piracy. 

	Of course you will then lose your status as a registered
	user of LJSTERM! 


DISCLAIMER:
	  LJSTERM has been tested on ST,STe,STfm,STm,MEGA ST,
	MEGA STe, TT and Falcon 030. It works fine with MULTITOS.
	(but it does not YET support MULTITOS due to the lack of
	 money to buy some documentation!)
	It should work fine on all machines running TOS. 

	I haven't found any fatal bugs, but USE this program at

			 YOUR OWN RISK.

	I disclaim any liability that might arise from data loss,
	program crashing or anything like that. Or anything else.


FILES:
	This program package needs the following files to
	work correctly.

	 TERM2_1.PRG (LJSTERM program file)
	 LJSTERM.RSC (graphics part of LJSTERM)
	 LJSTERM.CFG (configuration file)
	 LJSTERM.TXT (this document)

	These files (listed above) are protected by the Finnish
	Copyright Law and International Treaties relating to intellectual
	property. YOU should NOT edit them without a written
	permission from me. 

INSTALLATION:
	It's rather easy to install LJSTERM on any ST-computer or
	compatible. You just create a folder called "LJSTERM" 
	(see your computer's manual for details) and copy every
	file mentioned in this archive into it.
	Then just execute (double click on the program icon in desktop)
	TERM2_1.PRG and select the menu entry
	named "PATHS". Here you can select the default
	paths used by the terminal. If you already have a copy of "XYZ.TTP"
	you can select it to be used. Then select the entry
	named "EDIT DIALDIR..."
	Well, now you probably want to install your own list of BBS's,
	so you can click on the EMPTY space under the BBS names and edit
	the empty slot...  

FEATURES:
	This is a list of all menu entries and what they are for.

	Desk
	- About this program
	  A  dialog box appears containing the name of the registered
	  user or the text "Register". In non-registered copies there
	  is  a  another  box that tells you how to register LJSTERM.

	- Your favorite ACCessories
	  If you have  installed  any ACCessories  you will find them
	  here.

	File
	- Quit
	  Allows  you  to quit LJSTERM. First LJSTERM checks whether 
	  there are  some  important tasks running in the background
	  and  warns  you  if there  are  some. Then it warns you if
	  the  buffer contains data. Finally  you are able to choose
	  whether to quit or not.
	  LJSTERM only saves the configuration if you select "YES(save)".
	  You can quit LJSTERM also by closing the main window or by
	  pressing the "Undo" key in GEM-mode.

	- Run program
	  LJSTERM lets you run other programs. First you should
	  select the program with the file selector. Then you can
	  enter a command line passed to the program. Finally click
	  on the button that contains the right file extension.
	  The "windowed"- mode uses a program (called TOSWIN.APP)
	  to run the selected program in a window.
	  The key short cut is <ALT+R>.

	- Free diskspace
	  Sometimes it is useful to know how much free space there
	  is on a disk. Just select the drive and you will get the
	  information.

	- Erase file
	  Select the file to be deleted with the file selector.
	  LJSTERM then asks you to confirm the delete-command.
	  By clicking on the "YES" the file is PERMANENTLY erased
	  from the disk. LJSTERM accepts wildcards but just
	  deletes one file per command.

	- Rename File
	  Select the file to be renamed with the fileselector.
	  Then enter the new filename and click on the "OK".

	RS-232
	- Local Echo
	  When activated every character sent is shown also on
	  the screen. This is useful when chatting with your
	  friends without any BBS-program. The key shortcut for
	  this operation is <Alternate+E>. Default setting is OFF

	- Hang Up
	  After confirmation sends the hang-up-string to the modem
	  (or to MIDI, if selected). The string may be edited with
	  [CONFIGURE/MODEM].The key shortcut is <Alternate+H>.

	- Translation
	  Select which translation tables are to be used. There are
	  three tables: Incoming, Outgoing and Printing tables.
	  When one of them is selected the characters are translated.
	  This selection can be altered by LJSTERM if you connect to
	  a BBS and have made changes to the BBS-entry.
	  You can edit the actual tables with [CONFIGURE/Translation]
	  Default setting is no translations activated.

	- Emulation
	  LJSTERM can emulate VT-52 and ANSI protocols.
	  The selection only affects the colour routines and
	  the cursor keys, so all the incoming text is shown
	  independant from emulation mode. This selection can
	  be altered by LJSTERM if you connect to a BBS and
	  have made changes to the BBS-entry. Default setting
	  is VT-52.

	- Filter
	  Select how many bits are going to be used. This selection 
	  is altered by many LJSTERM routines, so it is not a very
	  good idea to change the setting without knowing what you are
	  doing. There is only one good reason to alter this setting:
	  ensuring that your messages are 7 or 8 bit characters.
	  Default setting is 8 bits. 

	- Port
	  LJSTERM supports only two ports: MODEM and MIDI.
	  You can choose between these two. Key shortcut is <Alternate+P>
	  Default setting is MODEM-port. 

	- Configuration
	  Alter the configuration of the MODEM-port. LJSTERM only supports
	  bps-rates up to 19200 bits per second. "CR -> CR+LF" means that
	  when you press the return LJSTERM sends a additional linefeed
	  character. This is useful when chatting with your friends without
	  a BBS-program. Clicking on the "OK" sends also "AT"-command to the
	  modem, so that it knows that the configuration was changed. 
	  Default settings are: 2400 bps,8/n/1,No handshake,no linefeeds.
	  These settings are altered when connecting to a BBS,
	  that has been fully installed in LJSTERM dial directory.

	TRANSFER
	- Upload ASCII
	  Upload a textfile as if you had typed it in. The upload is
	  done in the background so you can continue to work.
	  Uploading is done with the upload-task that is activated.
	  You can see a arrow pointing up in the information line.

	- Upload X-modem
	  Upload a file using the X-modem protocol. LJSTERM has no
	  built-in transfer protocols, so you need a copy of XYZ.TTP
	  in order to transfer files. Choose the file to be uploaded,
	  and LJSTERM runs XYZ.TTP.

	- Upload Y-modem
	  Upload a file using the Y-modem protocol. LJSTERM has no
	  built-in transfer protocols, so you need a copy of XYZ.TTP
	  in order to transfer files. Choose the file to be uploaded,
	  and LJSTERM runs XYZ.TTP.

	- Upload Z-modem
	  Upload a file using the Z-modem protocol. LJSTERM has no
	  built-in transfer protocols, so you need a copy of XYZ.TTP
	  in order to transfer files. Choose the file to be uploaded,
	  and LJSTERM runs XYZ.TTP.
 
	- Download X-modem
	  Download a file using X-modem protocol. LJSTERM has no built-in
	  transfer protocols so you need a copy of XYZ.TTP in order to
	  transfer files. You should choose a filename for the incoming file.
	  Then LJSTERM runs XYZ.TTP and alerts you when the transfer is
	  finished. The key shortcut is <Alternate+X>

	- Download Y-modem
	  Download a file using Y-modem protocol. LJSTERM has no built-in
	  transfer protocols so you need a copy of XYZ.TTP in order to
	  transfer files. You should choose the path for the incoming file(s).
	  Then LJSTERM runs XYZ.TTP and alerts you when the transfer is
	  finished. The key shortcut is <Alternate+Y>

	- Download Z-modem
	  Download a file using Z-modem protocol. LJSTERM has no built-in
	  transfer protocols so you need a copy of XYZ.TTP in order to
	  transfer files. You should choose the path for the incoming file(s).
	  Then LJSTERM runs XYZ.TTP and alerts you when the transfer is
	  finished. The key shortcut is <Alternate+Z>

	- Speed (for ASCII)
	  Choose the speed for ASCII-upload. The unit is characters per
	  LJSTERM-cycle (that depends on your computer). The greater the
	  selected value the faster the characters are sent.
	  Default setting is one character per LJSTERM-cycle.

	BUFFER
	- Open
	  Activates the capture buffer. It installs the buffer is necessary.
	  After activation LJSTERM stores every character
	  received in the buffer.

	- Close
	  Closes the capture buffer. Characters are not appended to the
	  buffer. This is the default state of the capture buffer.

	- Size
	  Choose the size for the capture buffer. One line is 80 characters.
	  The default size is 200 lines (=16000 bytes of memory).

	- View
	  View the contents of the capture buffer. You can use the 
	  up and down arrows to move around the text.

	- Free
	  Frees the memory reserved for the capture buffer.
	  Should be used if you get a "out of memory"-message.

	- Save
	  Save the buffer contents. The file produced is not modified
	  in any way, so there are the VT-52 or ANSI escape sequences
	  left.

	- Print
	  Send buffer contents to the printer. Because of that the data
	  is not altered in any way it is not wise to print anything else
	  than PURE ASCII-texts.

	- Load
	  Load a file into the capture buffer. The buffer is installed
	  if needed.

	- Send
	  Send the buffer contents as they are to the modem. The text
	  is uploaded using the ASCII-upload task. 

	Others
	- Dial a BBS
 	  Dial a BBS and if connection is established, LJSTERM will
 	  alert you. Select the BBS in the window. Pressing <Shift>
 	  lets you choose many BBS. Pressing <Control> will use
 	  repeat dilaling, which dial the BBS until a connection
 	  is established. The key shortcut is <Alternate+D>.

	- Dial a Number
	  Lets you dial a number. Enter the number and select
	  "OK". The number is dialed only once.

	- Screen saver
	  LJSTERM has a built-in screen saver. When activated the
	  saver changes the colours, so the picture doesn't
	  burn in. When the saver is activated LJSTERM will
	  also keep sending a idle-character.
	  The "ON(port)"-selection means that LJSTERM also notices
	  the incoming characters.

	- Full Screen
	  Access a 80*25 VT-52 emulator. When in Full Screen-mode 
	  you can not access all the features. You can QUIT Full
	  Screen-mode by pressing the <Undo> key. The key short
	  cut is <Alternate+F>.

	- Cycle windows
	  Change the active window. Only LJSTERM-windows are affected.
	  The key short cut is <Alternate+W>.

	- System Status
	  This feature shows you some information about your computer.
	  Please include this information when contacting me!
	  You should always keep in mind that GEM needs some memory so
	  always ensure that there is at least enough memory for a quarter
	  of the screen size available.

	- All Characters
	  Open a window that contains all the characters. Click with
	  the mouse on one character and it is sent. You can also send
	  characters in the Main Window. The key shortcut is 
	  <Alternate+S>.

	- HELP
	  Enters the On-Line help. After selecting "Yes" and a menu entry
	  LJSTERM shows you some useful information about the feature.
	  To exit the On-Line help, just close the Help window.
	  The key short cut is surprisingly <Help>!

	CONFIGURE
	- Main Window
	  Select the window components and the font size. Try various
	  combinations and select the best. You can see the size of
	  the main window in its information line (if you have selected
	  to use one.)

	- Date & Time
	  Set your computer's time and date. The format is
	  DD/MM/YYYY and HH:MM:SS.
	  The key short cut is <Alternate+T>

	- Paths
	  Change the paths used by LJSTERM. 
	  To change the path you should just click on the appropriate
	  path and then select the path with the file selector.
	  Upload path 1 is used for X,Y and Z file transfers.
	  XYZ.TTP is the file that does the transfers.
	  Buffer path is used when saving the buffer contents.
	  Program path is used when running a program.
	  Upload path 2 is used for ASCII-upload.
	  Download path is used for X,Y and Z file downloads.
	  TOSWIN is used for the RUN in window.

	- F-keys
	  Edit your Function keys. You can send the text by
	  pressing one of the function keys. A <Return> can be inserted
	  with <Control+M>.

	- Translation
	  Edit the translation tables. FIRST choose the substitute
	  character (the one that is replacing another character)
	  THEN choose the character to be replaced. 

	- Colours
	  LJSTERM can use other colours than the default ones. The
	  "Colour 0" is the index. For example, if you are running
	  LJSTERM in a resolution offering 256 colours, you can change the
	  colours 240-248 to suit your needs (with an accessory) and then
	  enter the number 240 here. LJSTERM will then use your colours.
	  The "OK (bw)" means that no colour changes are allowed. It is
	  useful when calling to some PC- BBS's that are assuming white
	  text on black background.

	- Dial Directory
	  Edit the BBS-entries or add new ones.
	  Click on the BBS that you want to edit or on the blank area
	  to add a new one. Then enter the name and telephone number
	  and the other information. Then you can select the translations
	  and PORT-configuration (if the port is not configured LJSTERM
	  uses the defaults). 

	- Modem
	  Edit the modem strings. The "dial command" is sent to the modem 
	  before the telephone number.
	  The connection character is the first character that the modem
	  sends when it has established a connection. (i.e. the 'C' is the
	  first letter of "CONNECT")
	  The Hang-up string is sent to the modem when you have chosen to
	  hang-up. The '~' means half a second pause (and can be used only
	  with the Hang-up string, NOT with the dial command).
	  Look at your modem's user guide for the correct ones. The defaults
	  only apply for HAYES-compatible modems.
	  The key short cut is <Alternate+M>.

	- Save
	  Save your current configuration. This is also done when
	  you exit LJSTERM if you choose "YES(save)" in the dialog
	  that appears.

TASKER:
	LJSTERM has a built-in tasker that enables LJSTERM to do
	several things (almost) simultaneously. LJSTERM changes the
	tasks when needed but it is possible for you to change them too.
	The menu is hidden in the information line of the main window.
	There you see something like "_____". Click on it until the menu
	appears. Then select (or deselect) the task. The ASCII-upload
	and the printer tasks can not be switched on manually if LJSTERM
	has not turned them on.
	Here are the symbols that are used in the information line:
	Arrow up	ASCII upload
	Arrow down	Normal datareceive
	Note		Dialer
	Copyright	ShareWare code (which shows the "REGISTER LJSTERM"
			dialog box.
	Some other	Printer

MORE INFORMATION:
	Can be obtained by calling me on one of the BBS's I use.
	Or by snail-mail:

		Lasse Sundstrm
		Pohjoiskaari 26 A
		FIN-00200 Helsinki
		FINLAND

	You can also send electronic mail via Internet to:
		ljs@mits.mdata.fi
		lasundst@freenet.hut.fi

TRADEMARKS:
	All registered trademarks mentioned in this text file are
	registered and owned by the companies owning them.
