PalmTelnet 0.21
---------------

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
(br is for Brazil, before you ask :-)

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 character font.
 - 32/64 columns x 15 lines screen.
 - Configurable string macros.

What is new in 0.2:
 - Configurable screen width: 32 or 64 columns.
 - Reverse video (VT100).
 - Hardware buttons generate VT100 up-arrow, down-arrow, right-arrow and
   left-arrow key codes.
 - Error messages.
 - Corrected a bug that caused a connection to fail sometimes.
 - Corrected a bug that caused a fatal exception in the Macros form.

What is new in 0.21:
 - Corrected a bug that caused a fatal exception everytime a connection
   failed.

Missing features (may be added in the future, priority depends on feedback):
 - Bookmarks with host names / port numbers.
 - Session logging.

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.
 - 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.
   There is no "Send" button.
 - 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) 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 cause PalmTelnet to 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.
   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.