PalmTelnet 0.31
---------------

PalmTelnet is a Telnet client with VT100 support for PalmOS 2.x.

Since it is in the initial development stages,
it is still missing some features and may contain some bugs.

PalmTelnet is distributed as freeware but is not in the public domain.
PalmTelnet is Copyright (c) 1997 Marcio M. Andrade.

The software can not be reverse engineered or modified in any form
(including this readme). To include PalmTelnet in any software collection,
online or not, first contact the author for permission.

This software comes with absolutely NO warranty, so use it at your own risk.

Send comments or suggestions to this email address: mar@sis.dcc.ufmg.br
The PalmTelnet Home-Page is located at: http://www.sis.dcc.ufmg.br/~mar/pilot

Regards,

  Marcio Migueletto de Andrade
  mar@sis.dcc.ufmg.br

--

Requirements:
 - PalmOS 2.x (PalmPilot Pro)

Features:
 - RFC 854 Telnet protocol.
 - VT100 terminal emulation (almost complete).
 - 5x10 fixed font (ISO 8859-1 character set).
 - 32/64 columns x 15 lines screen.
 - Configurable string macros.

What is new in 0.31:
 - Implemented VT100 Scrolling Regions: now PamlTelnet works correctly with
   ircII client on UNIX !

Known bugs:
 - If you put a "Prompt" statement in the script of your Network service and
   use the "On" button of PalmTelnet to open the connection, it will cause a
   fatal exception as soon as you enter the prompt value and tap "Ok".
   Note that if you connect using Prefs/Network and THEN switch to PalmTelnet
   this error will not occur. Also this error occurs ONLY if you have a
   "Prompt" statement.
 - There seems to be a conflict with CorrectHack.
   As reported by other users: sending a return causes a fatal exception.

Operation:
 - Enter a host and a port in Network Options and tap the "On" button
   on the lower left corner.
   Before connecting to the host, PalmTelnet will start the TCP/IP stack
   by activating the service defined in PalmOS Prefs/Network (if it is
   not already started).
   If the connection is successful, the "On" button will turn black,
   otherwise it will remain blank and an error message will be displayed.
   Possible reasons for failing are: DNS lookup failure, host is unreachable,
   timeout, etc. Current timeouts are: 10 seconds for DNS lookup and another
   10 seconds for connection.
 - To disconnect from the host, either logout or tap the "On" button again.
   Note that the TCP/IP stack will NOT be shut down. To do this, go
   to the PalmOS Prefs/Network and disconnect.

 - The cursor position is marked by a fixed underscore in the screen.
 - To send characters, simply write them in the Graffiti area.
   You can also tap the "Kbd" button, which will bring up the built-in keyboard.
   After tapping "Done", the characters you have typed will be sent. 
   Note that there is no editable text field on the screen, so every time
   you call the keyboard it will NOT edit the current line, and will start
   empty.
   If you type the sequence "\r" (without quotes) in the keyboard panel,
   PalmTelnet will send the "return key" you chose in Terminal options.
   The sequence "\\" sends a single "\".
   Naturally, you can also use Graffiti ShortCuts to send text.
 - To send Control-x, where x is A-Z, tap the "Ctl" button and write
   the appropriate letter. Case is not important. Tapping "Ctl" without
   writing a letter will deactivate the "control state".
 - Shift and Caps lock are the same as in Graffiti.
 - To send an ESC, tap the "Esc" button.
 - To send one of the six configurable macros, select the "Macros" listbox
   and choose the macro name. The macro definition will be sent.

 - If you connect to a Telnet daemon on a Unix machine, check that
   your terminal is set to VT100 (set term=vt100, if csh, or TERM=vt100,
   if sh) and that the screen is the correct size: stty rows 15 cols 32 (or 64).
   Better yet, put this commands in a shell script and create a macro in
   PalmTelnet that executes this script.
 - If choose 64 for screen width, you still can see only 32 columns at a time.
   To view the left half, tap on left of the screen.
   To view the right half, tap on right of the screen.
   If you choose 32 for screen width, tapping on the screen will have no efect.
   It is better to change the screen width before you run a program that
   relies on it (like vi, pine, lynx, etc), or it may get confused.
 - These hardware buttons generate the following VT100 key codes:
   PageUp: up-arrow
   PageDown: down-arrow
   Address Book: left-arrow
   Todo List: right-arrow
   If your terminal is set properly, programs like vi, pine, lynx, etc
   recognize these key codes.

Options:
   PalmTelnet has four menu options:

 - Network:
   Enter a host name or IP address and a port number (decimal).
   Every time you tap the "On" button, PalmTelnet will try to connect
   to this port on this host.

 - Terminal:
   Checking "Local echo" will make PalmTelnet echo locally every
   character you write.
   Choose what kind of "return key" you are using: when you write a
   Graffiti return, PalmTelnet will send a CR, a LF or both.
   Choose the screen width: 32 or 64 columns.

 - Macros:
   In the left column, you choose up to six macro names. These names
   are shown in the "Macros" listbox in the bottom of the main screen.
   In the right column, you choose their definitions. If you insert
   the sequence "\r" (without quotes) in the macro definition,
   PalmTelnet will send the "return key" you chose in Terminal options.
   The sequence "\\" sends a single "\".
   Common uses for macros are: login names, passwords, terminal
   configuration commands, logout command, etc.
   Here is an example of a useful set of macros for a user that has
   a csh account on a Unix machine:

   Name		Definition
   -----------	---------------
   Login	mylogin\r
   Password	mypasswd\r
   Init		source .pilot\r
   Logout	logout\r
   Mail		pine\r
   Web		lynx\r

   In this example, the .pilot file could have these lines:
   stty sane
   stty erase ^H
   stty rows 15 cols 64
   set term=vt100
  
 - About: About box.

--

3Com, PalmOS, PalmPilot and Graffiti are service marks of 3Com Corporation.
