	Pocket Tera Term version 0.0 help
	T. Teranishi Aug. 9, 1999

	Copyright (C) 1998-1999 T. Teranishi
	All Rights Reserved.

1. Introduction
2. Basic usage
3. Commands
4. Keyboard operation
5. Stylus operation
6. Commandline format
7. Limitations
8. Tips

-------------------------------------------------------------------------------
1. Introduction

This document describes usage of Pocket Tera Term and some
useful tips. Please read the file readme.txt for copyright
information and installation/uninstallation procedures.

This text is for users who have experience in using
communication programs on PC or H/PC.
Novice users may feel difficulty in configuring dial,
modem and TCP/IP properties.
The author recommends such users to study how to configure
these properties by using the standard Terminal program and
Pocket Internet Explorer and then try Pocket Tera Term.
Please do not ask the author questions about usage of Pocket Tera Term.

-------------------------------------------------------------------------------
2. Basic usage

To run Pocket Tera Term, double tap the (shortcut) icon of teraterm.exe.

Pocket Tera Term supports three types of communication: 1) TCP/IP (telnet),
2) modem and 3) serial port. Types 1) and 2) are used to connect to a remote
host through telephone line using a modem (Win CE 2.0 supports also
ethernet). Type 3) is used for direct communication between H/PC and
a remote machine through a serial port.

1) TCP/IP (telnet) communication
	To connect to a remote host with the telnet protocol under
	TCP/IP (dial-up network or ethernet),
	execute the [File] TCP/IP connection command.

2) Modem communication
	To connect to a remote host by using a modem
	without TCP/IP, execute the [File] Modem connection command
	(once this was a typical method to connect to a BBS host).

3) Serial port communication
	To communicate with a remote machine directly through
	a serial port (COM1-4), execute the [File] Open serial port
	command.

To make a connection started automatically when Pocket
Tera Term is run, you need to specify a commandline parameter
for the shortcut link of teraterm.exe (see "6. Commandline format").

-------------------------------------------------------------------------------
3. Commands

...............................................................................
3.1 [File] TCP/IP connection command

Connects to a remote host by using the telnet protocol under
TCP/IP.

The configuration of TCP/IP (dial-up network) should be
done at "Remote network" on Windows CE before using Pocket Tera Term.
It is better to test the configuration by using other communication
programs such as Pocket Internet Explorer.

On "TCP/IP connection" dialog box, specify the name or IP address
of the remote host.

If the dial-up TCP/IP connection is not established, the execution
of this command makes the "Remote network" dialog box open to
start dialing. On the dialog box, select a network name (name of
an icon in "Remote network"), enter username and password, and
then push the "connect" button to start dialing. After the dial-up
TCP/IP connection is established, the telnet connection to the host
is started.

...............................................................................
3.2 [File] Modem connection command

Connects to a remote host by using modem without TCP/IP protocol.

On the "Modem connection" dialog box, select a modem and
enter country code, area code and phone number of the access point.
Dial and modem properties can be configured by pushing the
"Dial properties" and "Modem properties" buttons, respectively.
These properties can be configured by the same way as in
the case of Windows CE "Terminal" program. If you have
troubles with configuration, try "Terminal" program first.
Push the "Dial" button to start dialing.

...............................................................................
3.3 [File] Open serial port command

Opens a serial port to communicate with a remote machine.
This type of communication is used for controlling a remote
machine (e.g. modem) by sending command characters.

On the "Open serial port" dialog box,
specify a serial port ("COM1"-"COM4") and its parameters.
The parameters should match with those for the serial port
of remote machine.

...............................................................................
3.4 [File] Send text file command

Sends a text file to the host.

On the "Send text file" dialog box, specify an existing file
to be sent. The file should be in ASCII text format.
According to the "New-line-out" option at the "Terminal"
property page, new-line codes (CR+LF) in the file are
converted before they are sent.

...............................................................................
3.5 [File] Disconnect command

Closes the connection or serial port.

In the case of dial-up network (TCP/IP), executing this command
does not close the dial-up connection, but the telnet session
is closed. To close the dial-up connection, tap the icon
of ttras.exe on the task bar (the icon looks like two boxes
connected by a zig-zag line) and push the "Disconnect" button
on the "Remote network" dialog box.

...............................................................................
3.6 [File] Close command

Closes Pocket Tera Term.

...............................................................................
3.7 [Edit] Copy command

Copies selected text to the clipboard.

Normally, you don't need to use this command,
because dragging text automatically copies text to the clipboard
(see "5. Stylus operation").
Use this command to re-copy selected text to the clipboard.

...............................................................................
3.8 [Edit] Paste command

Sends text in the clipboard to the host.

...............................................................................
3.9 [Edit] Clear screen command

Erases the screen.

...............................................................................
3.10 [Edit] Clear buffer command

Erases the screen and scroll buffer.

...............................................................................
3.11 [Edit] Save & clear buffer command

Copies text in the screen and scroll buffer to a file,
and then erases the screen and scroll buffer.

On the "Save buffer" dialog box, specify the file name.

...............................................................................
3.12 [Setup] Properties command

Changes properties of a configuration
(see "3.13 [Setup] Choose configuration" for "configuration").

The "Properties for XXXX" dialog box (XXXX is the configuration name)
has the "Terminal" and "Display" pages.

  On the "Terminal" page, terminal emulation properties can
  be changed.

        Width:  Width of logical screen (number of columns).

        Height: Height of logical screen (number of lines).
		
	  ** Note ** The logical screen size is not necessarily
	    equal to the actual screen size. The typical logical
	    screen size is 80 columns * 24 lines.

	New-line-in:	New-line code to be received.
			If the "CR+LF option is selected,
			received CR characters ($0D) are
			converted to CR+LF ($0D $0A) pairs.

	New-line-out:	New-line code to be sent.
			If the "CR+LF" option is selected,
			CR ($0D) characters to be sent are
			converted to CR+LF ($0D $0A) pairs
			before they are actually sent.

	Terminal ID:	Terminal ID to be reported to the host
			when the host requests it.
			Note that the terminal ID is not identical
			to the telnet terminal type.

	Local echo:	Enables local echoing of characters sent.

	BS key:		Character to be sent when the backspace key
			is pressed. BS ($08) or DEL ($7F).

	Answerback:	Character string to be answered back to the host,
			when the ENQ ($05) character is received.
			Each non-printable character in the string
			can be expressed as a "$" followed by
			ASCII code in two-character hex number.
			For example, the string "ABC<CR><LF>" is
			expressed as the following:

			ABC$0D$0A

	Telnet term type: Terminal type to be reported to the host
			when the telnet connection is established.

  On the "Display" page, properties for display can be changed.

	Font:	Font for displaying text.

	Size:	Size of the font (in point).

	Horizontal scroll bar: Displays the horizontal scroll
		bar if the logical screen width is wider than
		the actual screen width.

	Auto cursor tracking: When the cursor is getting out of
		the screen, scrolls the screen so that the cursor
		is kept in the screen. Normally this option
		should be turned on.
		For the case that the logical screen is larger
		than the actual screen and the cursor frequently
		jumps out from the screen, it may be better
		to turn off this option and scroll the screen
		manually.

Press the OK button on the "Properties for XXXX" dialog box,
to make changed properties effective.				

...............................................................................
3.13 [Setup] Choose configuration command

Chooses or creates or removes a configuration.

Configuration is a set of properties for Pocket Tera Term.
Multiple configurations can be created and kept.
One configuration is always selected and effective.
Each configuration may be specific to a host or
a communication type (telnet/modem/serial port).

On the "Choose configuration" dialog box,
select an existing configuration and push the
"Ok" button. To create a new configuration,
push the "New" button. To delete an existing configuration,
select it and push the "Remove" button.

By using a commandline parameter, you can specify
a configuration to be selected as the initial one
(see "6. Command line format).
The default configuration is "Standard".
The "Standard" configuration can not be deleted.

...............................................................................
3.14 [Control] Reset terminal command

Resets various terminal modes.

...............................................................................
3.15 [Control] Are you there command

Sends an AYT (Are You There) telnet signal.
Usually, the host sends back some message responding to it.
This command is available only with a telnet connection.

...............................................................................
3.16 [Control] Send break command

Sends a break signal to the host.

...............................................................................
3.17 [Help] About command

Displays information about Pocket Tera Term.

-------------------------------------------------------------------------------
4. Keyboard operation

...............................................................................
4.1 Shortcut keys for the menu commands

Alt+N		[File] TCP/IP connection command
Alt+C		[Edit] Copy command
Alt+V		[Edit] Paste command
Alt+T		[Control] Are you there command
Alt+B		[Control] Send break command

...............................................................................
4.2 Shortcut keys for scrolling screen

Ctrl+Up-arrow				Scrolls up screen by 1 line.
Ctrl+Down-arrow				Scrolls down screen by 1 line.
Ctrl+PageUp (Ctrl+Alt+Up-arrow)		Scrolls up screen by 1 page.
Ctrl+PageDown (Ctrl+Alt+Down-arrow)	Scrolls down screen by 1 page.
Ctrl+Home (Ctrl+Alt+Left-arrow)		Scrolls screen to buffer top.
Ctrl+End (Ctrl+Alt+Right-arrow)		Scrolls screen to buffer bottom.

...............................................................................
4.3 Assignments of H/PC keys to VT terminal keys

H/PC key		VT key
-----------------------------------------------
Up-arrow		Up-arrow
Down-arrow		Down-arrow
Left-arrow		Left-arrow
Right-arrow		Right-arrow
Ctrl+0			Numeric keypad 0
Ctrl+1			Numeric keypad 1
Ctrl+2			Numeric keypad 2
Ctrl+3			Numeric keypad 3
Ctrl+4			Numeric keypad 4
Ctrl+5			Numeric keypad 5
Ctrl+6			Numeric keypad 6
Ctrl+7			Numeric keypad 7
Ctrl+8			Numeric keypad 8
Ctrl+9			Numeric keypad 9
Ctrl+-			Numeric keypad -
Ctrl+,			Numeric keypad ,
Ctrl+.			Numeric keypad .
Ctrl+Enter		Numeric keypad Enter
Ctrl+Shift+1		PF1
Ctrl+Shift+2		PF2
Ctrl+Shift+3		PF3
Ctrl+Shift+4		PF4
Shift+Left-arrow	Find
Home (Alt+Left-arrow)	Insert
End  (Alt+Right-arrow)	Remove
Shift+Right-arrow	Select
PageUp (Alt+Up-arrow)	Prev
PageDown (Alt+Down-arrow) Next
Ctrl+Shift+5		Xterm F1
Ctrl+Shift+6		Xterm F2
Ctrl+Shift+7		Xterm F3
Ctrl+Shift+8		Xterm F4
Ctrl+Shift+9		Xterm F5

-------------------------------------------------------------------------------
5. Stylus operation

Dragging text           Selects text, and copies it to the clipboard.

Double tap		Selects a word, and copies it to the clipboard.

Tripple tap		Selects a line, and copies it to the clipboard.

-------------------------------------------------------------------------------
6. Commandline (shortcut link) format


"<Tera Term directory>\teraterm.exe" [<host>[[:]<TCP port#>]] 
				     [/C=1|2|3|4]
				     [/D]
                                     [/F="<configuration name>"]

	where:

	<host>			Host name or IP address.
				TCP port number is 23
				(standard for telnet).
		
	<host>:<TCP port#>	<host> with a TCP number.
				":" is placed between <host> and
				 <TCP port#>.

	<host> <TCP port#>	<host> with a TCP number.
				Space character(s) between <host>
				and <TCP port#>.
				Number just after <host> is
				interpreted as a port number.

	/C=1|2|3|4		Serial port number.
	  /C=1  COM1
	  /C=2	COM2
	  /C=3  COM3
	  /C=4	COM4

	/D			Modem connection.

        /F="<configuration name>" Configuration to be loaded
				at the start-up time.
				The default is "Standard".

If any one of <host>, /C and /D is specified, Pocket Tera Term
tries to start the corresponding type of communication.

** Note 1 **
Only if <TCP port#> is 23 (default value), Tera Term starts
spontaneously sending telnet commands to the host for the
option negotiation when the connection to the host is established.
In any cases, Tera Term can respond to telnet commands sent
by the host.

** Note 2 **
For a non-telnet TCP/IP connection (usually with a port other than 23),
you may need to set the "Local echo" option on, and the "New-line-out"
option to "CR+LF" at the "Terminal" property page. 

Example:
        "\Program Files\teraterm\teraterm.exe" myhost.mydomain
        "\Program Files\teraterm\teraterm.exe" myhost.mydomain:23
        "\Program Files\teraterm\teraterm.exe" /C=1 /F="COM1"
        "\Program Files\teraterm\teraterm.exe" /D /F="modem"

-------------------------------------------------------------------------------
7. Limitations

Due to limited H/PC performance or for the sake of simplicity,
Pocket Tera Term has the following limitations:

- Unsupported VT100 functions
	Blink and bold attributes.

	Double width/height characters.

	Special characters.

	Some other emulation functions that Tera Term (Pro) for
	Windows 3.1/95/NT supports.

- Character attribute such as reverse is guaranteed to be
  kept only within the logical terminal screen.
  When a character move into the scroll buffer region,
  its attribute may be lost.

- H/PC may freeze for several seconds after the dialup TCP/IP
  connection is established and before the telnet session
  is started.

- When the telephone line is hung up at the end of modem communication,
  Pocket Tera Term may not enter the disconnected state.
  In this case, you need to execute the [File] Disconnect command
  to set Pocket Tera Term to the disconnected state.

- On the "Modem connection" dialog box, the "Modem" list may
  contain something like "Ir port" or "serial cable" which
  does not work for the modem connection.

-------------------------------------------------------------------------------
8. Tips

- Opening multiple windows of Pocket Tera Term

	Multiple windows (sessions) can be opened at the same
	time. For example, after a dial-up TCP/IP connection is
	established, you can open multiple Tera Term windows
	and start telnet sessions for the windows.
	For modem and serial port connections, one modem (port)
	can not be shared with multiple windows.
	Note that opening too many windows may cause
	shortage of system resources.

- Connecting non-telnet host by specifying TCP port number

	See "6. Commandline format" and see also
	"Note 1" and "Note2" in the section 6.
	You can also use the same format ("hostname:portnumber")
	at the "TCP/IP connection" dialog box.

- Setup for a dial-up (TCP/IP) connection

	Create a configuration for the connection at
	"Remote Network" of Windows CE.
        To test the configuration, try to use "Pocket IE",
	for example.

- Setup for a modem connection

	As the first step, study how to configure the dial and
	modem properties by using the standard "Terminal"
	application of Windows CE.
        When you get familiar with configuring properties for
	the "Terminal" application, it should be easy
	to configure properties at the "Modem connection"
	dialog box of Pocket Tera Term.

- About fonts

	Pocket Tera Term supports fixed pitch fonts and
	does not support proportional fonts.

- To increase number of lines/columns visible in the window.

	Chose a smaller font.
	If the "Horizontal scroll bar" option at the "Display"
        property page is turned off, the number of lines may
        increase as the horizontal scroll bar disappears.

- Screen shaking caused by frequent cursor jumping.

	The standard VT terminal size, 80 columns * 24 lines,
	may be larger than the actual window size. In this case,
	a part of the logical terminal screen is visible
	in the window. If the cursor is going to go out
	of the window, the window is scrolled to keep the
	cursor inside the window. This behavior may not be
	useful for remote host applications (e.g. screen editor)
        which jump the cursor frequently.
	Frequent cursor jumping often makes the screen shaking
	left and right or up and down.
	To avoid this, disable the "Auto cursor tracking" option
	at the "Display" property page.

- About scroll buffer

	Scrolling makes lines of characters go out of
	the logical terminal screen and move into the scroll buffer.
	Text in the scroll buffer is stored in a temporary file
	created in the "\Windows" directory. The temporary file
        grows as scrolling occurs.
	The file is deleted when Pocket Tera Term is closed.
	The [Edit] Clear buffer command clears the file
	to be 0 byte size.

	Capacity of the scroll buffer depends on the disk (memory)
	free space of Windows CE. Assuming that 60 bytes of memory
	is the average to store one line of text, storing 1000
	lines requires 60 Kbytes of memory.
	If you run Pocket Tera Term for a long time and
	too many lines are stored in the scroll buffer,
	the free space may become extremely small and that
	causes bad system performance. You need to execute
	the [Edit] Clear buffer command before such a
	situation occurs.
