From 885f8cc426a8840ae61023b75f3f0e4a1e268082 Mon Sep 17 00:00:00 2001 From: Michael Krelin Date: Mon, 05 Jul 2004 01:53:09 +0000 Subject: initial commit into svn repository git-svn-id: http://svn.klever.net/kin/kinsole/trunk@1 fe716a7a-6dde-0310-88d9-d003556173a8 --- (limited to 'help/kinsole.xml') diff --git a/help/kinsole.xml b/help/kinsole.xml new file mode 100644 index 0000000..7d15eed --- a/dev/null +++ b/help/kinsole.xml @@ -0,0 +1,72 @@ + + + + About KINSole +

KINSole is our Win32 implementation of client side of the telnet protocol described in details in the and related RFCs (namely , , , , and others). It uses Win32 console and, therefore, can be run both windowed and in fullscreen mode.

+

+

Enjoy!

+ + + + + Beta News + + No changes in code. License change. + + + Better copying from KINSole window. + Better handling of cursor position when resizing window. + Sending CR/LF pair when pressing ENTER. This is of help when telnetting to non-telnet ports. + Corrected bug, preventing KINSole from pasting text to remote twice. + Improved handling of echoing. Previously KINSole didn't turn echo off on some systems, namely Solaris. + Typo causing KINSole not to show diamond characters in VT10x mode corrected. + GPF when invoking KINSole with -t option fixed. + Hotkey (Alt-INS) for copy operation added. Not supposed to work under Windows NT. + Paste is made aware of local echoing. + Default terminal type when telnetting to non-telnet port is now TTY. + Timing Mark telnet option () implemented (Alt-T). + Improved handling of window icon when starting from other Win32 command line application. + + + + Using KINSole +

You may run KINSole from your MS-DOS prompt by typing 'kinsole host port'.

+

If you need to know more about custom options, please proceed to the Command Line Options section.

+ + + Command Line Options +

Usage:

+

KINSole [options ]host[ port]

+

Available options are:

+
    +
  • -r ## or -## - Try to set the number of rows in console screen buffer.
    • +
  • -c ## - Try to set the number of columns in console screenbuffer.
    • +
  • Note: Changing of console's screenbuffer size either from command line or on remote host's request (ESC[?3h vt100/vt102 control sequence) may not work when in fullscreen mode.
    • +
  • -l username - Pass username to remote server in environment if remote server allows.
    • +
  • -e var=val - Pass environment variable to remote server.
    • +
  • -v var=val - Pass user environment variable to remote server.
    • +
  • -t termtype - Change preferred terminal type to pass to remote server. This option does not really force specific terminal emulation. Final decision on terminal type is left up to server. Both sides are supposed to negotiate terminal type when connecting so that both sides may feel satisfied. Default preference is vt102.
    • +
+ + + Hot Keys +

While running KINSole you may use these key combinations:

+
    +
  • Alt-X/Alt-Q - Terminate telnet session and leave KINSole.
    • +
  • Alt-Y - Send AYT (Are You There) telnet command. Remote host (if it supports telnet protocol as it's supposed to) should provide you with visible/printable/audible feedback stating that it's alive. You may want to use it when running program which takes unusually long time to finish and you suspect that your connection is dead.
    • +
  • Shift-INS Paste text from Windows Clipboard.
    • +
  • Ctrl-Break Send IP (Interrupt Process) telnet command. Usually effectively equivalent to Ctrl-C, but it's up to server to decide what to do in each case.
    • +
  • Alt-INS - Invoke copying from KINSole screen buffer.
    • +
  • Alt-T - Send TIMING-MARK request. As soon as response comes KINSole will flash window thrice or beep if window handle is not available for some reason.
    • +
+ + + Beta Notes +

A few things you may want to know about this Beta Release:

+
    +
  • Only two terminal emulation modules are included in this beta release - one for dumb terminal and one for vt100/102. If you try to select ANSI terminal type vt100 emulation will be selected, which is actually close enough to ANSI so you shouldn't suffer too much. Why would one want to use ANSI terminal emulation, anyway?
    • +
  • Telnet LINEMODE option () is still to come.
    • +
  • Pasting of text using console toolbar button may cause KINSole to lock up. Use Shift-INS instead.
    • +
+ + -- cgit v0.9.0.2