summaryrefslogtreecommitdiffabout
path: root/help
Side-by-side diff
Diffstat (limited to 'help') (more/less context) (show whitespace changes)
-rw-r--r--help/kinsole.cnt9
-rw-r--r--help/kinsole.hpj17
-rw-r--r--help/kinsole.rtf97
-rw-r--r--help/kinsole.xml72
4 files changed, 195 insertions, 0 deletions
diff --git a/help/kinsole.cnt b/help/kinsole.cnt
new file mode 100644
index 0000000..9a8af90
--- a/dev/null
+++ b/help/kinsole.cnt
@@ -0,0 +1,9 @@
+:Base KINSole.hlp>Standard
+:Title KINSole
+1 KINSole
+2 About KINSole=About
+2 Using KINSole=Using
+2 Command Line Options=CmdOptions
+2 Keyboard Shortcuts=HotKeys
+2 Beta Notes=BetaNotes
+2 Beta News=News
diff --git a/help/kinsole.hpj b/help/kinsole.hpj
new file mode 100644
index 0000000..62b1b55
--- a/dev/null
+++ b/help/kinsole.hpj
@@ -0,0 +1,17 @@
+; This file is maintained by HCW. Do not modify this file directly.
+
+[OPTIONS]
+HCW=0
+COMPRESS=12 Hall Zeck
+LCID=0x409 0x0 0x0 ;English (United States)
+REPORT=Yes
+CONTENTS=About
+TITLE=KINSole
+CNT=kinsole.cnt
+HLP=KINSOLE.HLP
+
+[FILES]
+KINSole.rtf
+
+[WINDOWS]
+Standard="",(32,64,949,175),28932,(r14876671),(r12632256),f2
diff --git a/help/kinsole.rtf b/help/kinsole.rtf
new file mode 100644
index 0000000..2cfd296
--- a/dev/null
+++ b/help/kinsole.rtf
@@ -0,0 +1,97 @@
+{\rtf1\ansi
+@{\footnote
+THIS FILE WAS AUTOMATICALLY GENERATED FROM XML DOCUMENT.
+DO NOT MODIFY THIS FILE DIRECTLY. EDIT XML DOCUMENT INSTEAD
+}
+{\fonttbl{\f0\froman Times New Roman;}{\f1\fswiss Arial;}{\f3\froman Symbol;}}{\colortbl;
+ \red0\green0\blue0;\red0\green0\blue255;\red0\green255\blue255;\red0\green255\blue0;
+ \red255\green0\blue255;\red255\green0\blue0;\red255\green255\blue0;\red255\green255\blue255;
+ \red0\green0\blue128;\red0\green128\blue128;\red0\green128\blue0;\red128\green0\blue128;
+ \red128\green0\blue0;\red128\green128\blue0;\red128\green128\blue128;\red192\green192\blue192;}
+
+\pard\plain\keepn
+#{\footnote About}
+${\footnote About KINSole}
+{ \f1\fs18\b\sb120 About KINSole}
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 {\b KINSole} is our {\i Win32} implementation of client side of the {\i telnet} protocol described in details in the {\uldb {\b RFC854}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc854.txt")} and related RFCs (namely {\uldb {\b RFC855}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc855.txt")}, {\uldb {\b RFC857}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc857.txt")}, {\uldb {\b RFC1091}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc1091.txt")}, {\uldb {\b RFC1073}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc1073.txt")}, {\uldb {\b RFC1572}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc1572.txt")} and others). It uses {\i Win32} console and, therefore, can be run both windowed and in fullscreen mode.
+\par\sa120\sb120\qj\pard \f1\fs18\sb120
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 {\b {\i Enjoy!}}
+{
+\par\pard\plain\sb360\sa120 \f1\fs16 Copyright (c) 1998, 2002 {\uldb\cf0 Klever Group (http://www.klever.net/)}{\v %!ExecFile("http://www.klever.net/")}
+\par\qj\sb120\sa120Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+\par The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+\par \sa360 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+}
+\par \sa0\sb120\ql \f1\fs16 Author: {\b\uldb\cf11 Michael Krelin ({\i hacker@klever.net})}{\v %!ExecFile("mailto:hacker@klever.net")}
+\par \sa0\sb0 Fan mail send to {\i\uldb gefilte@klever.net}{\v %!ExecFile("mailto:gefilte@klever.net")}
+\page
+
+\pard\plain\keepn
+#{\footnote News}
+${\footnote Beta News}
+{ \f1\fs18\b\sb120 Beta News}
+\par\pard\plain\f1\fs24\qc\cf2\b 1.00 Beta 3 - August 19st, 2002
+\par\pard\plain\fi0\li0\f1\fs18 \bullet No changes in code. License change.
+\par\pard\plain\f1\fs24\qc\cf2\b 1.00 Beta 2 - March 7th, 1998
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Better copying from {\b KINSole} window.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Better handling of cursor position when resizing window.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Sending {\b CR/LF} pair when pressing {\b ENTER}. This is of help when telnetting to non-telnet ports.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Corrected bug, preventing {\b KINSole} from pasting text to remote twice.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Improved handling of echoing. Previously {\b KINSole} didn't turn echo off on some systems, namely {\b Solaris}.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Typo causing {\b KINSole} not to show diamond characters in {\b VT10x} mode corrected.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet {\b GPF} when invoking {\b KINSole} with {\b -t} option fixed.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Hotkey ({\b Alt-INS}) for copy operation added. Not supposed to work under {\b\cf6 Windows NT}.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet {\b Paste} is made aware of local echoing.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Default terminal type when telnetting to non-telnet port is now {\b TTY}.
+\par\pard\plain\fi0\li0\f1\fs18 \bullet {\b Timing Mark} telnet option ({\uldb {\b RFC860}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc860.txt")}) implemented ({\b Alt-T}).
+\par\pard\plain\fi0\li0\f1\fs18 \bullet Improved handling of window icon when starting from other {\i Win32} command line application.
+\page
+
+\pard\plain\keepn
+#{\footnote Using}
+${\footnote Using KINSole}
+{ \f1\fs18\b\sb120 Using {\b KINSole}}
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 You may run {\b KINSole} from your MS-DOS prompt by typing '{\i kinsole host port}'.
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 If you need to know more about custom options, please proceed to the {\uldb Command Line Options}{\v CmdOptions} section.
+\page
+
+\pard\plain\keepn
+#{\footnote CmdOptions}
+${\footnote Command Line Options}
+{ \f1\fs18\b\sb120 Command Line Options}
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Usage:
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 KINSole [{\i options} ]{\i host}[ {\i port}]
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Available options are:\pard
+\par \fi0\li0 \bullet {\b -r {\i ##}} or {\b -{\i ##}} - Try to set the number of rows in console screen buffer.
+\par \fi0\li0 \bullet {\b -c {\i ##}} - Try to set the number of columns in console screenbuffer.
+\par \fi0\li0 \bullet
+\par\sa120\sb120\qj\f1\fs16 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.
+\par \fi0\li0 \bullet {\b -l {\i username}} - Pass username to remote server in environment if remote server allows.
+\par \fi0\li0 \bullet {\b -e {\i var}={\i val}} - Pass environment variable to remote server.
+\par \fi0\li0 \bullet {\b -v {\i var}={\i val}} - Pass user environment variable to remote server.
+\par \fi0\li0 \bullet {\b -t {\i 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 {\b vt102}.\pard
+\page
+
+\pard\plain\keepn
+#{\footnote HotKeys}
+${\footnote Hot Keys}
+{ \f1\fs18\b\sb120 Hot Keys}
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 While running {\b KINSole} you may use these key combinations:\pard
+\par \fi0\li0 \bullet {\b Alt-X/Alt-Q} - Terminate telnet session and leave {\b KINSole}.
+\par \fi0\li0 \bullet {\b Alt-Y} - Send {\b 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.
+\par \fi0\li0 \bullet {\b Shift-INS} Paste text from Windows Clipboard.
+\par \fi0\li0 \bullet {\b Ctrl-Break} Send {\b 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.
+\par \fi0\li0 \bullet {\b Alt-INS} - Invoke {\b copying} from {\b KINSole} screen buffer.
+\par \fi0\li0 \bullet {\b Alt-T} - Send {\b TIMING-MARK} request. As soon as response comes {\b KINSole} will flash window thrice or beep if window handle is not available for some reason.\pard
+\page
+
+\pard\plain\keepn
+#{\footnote BetaNotes}
+${\footnote Beta Notes}
+{ \f1\fs18\b\sb120 Beta Notes}
+\par\sa120\sb120\qj\pard \f1\fs18\sb120 A few things you may want to know about this Beta Release:\pard
+\par \fi0\li0 \bullet 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?
+\par \fi0\li0 \bullet Telnet {\b LINEMODE} option ({\uldb {\b RFC1184}}{\v %!ExecFile("http://www.rfc-editor.org/rfc/rfc1184.txt")}) is still to come.
+\par \fi0\li0 \bullet Pasting of text using console toolbar button may cause {\b KINSole} to lock up. Use {\b Shift-INS} instead.\pard
+\page
+} \ No newline at end of file
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 @@
+<?xml version="1.0"?>
+<winhelp>
+ <topic id="About" title="About KINSole">
+ <heading scroll="no">About KINSole</heading>
+ <p><kin>KINSole</kin> is our <term>Win32</term> implementation of client side of the <term>telnet</term> protocol described in details in the <rfc num="854"/> and related RFCs (namely <rfc num="855"/>, <rfc num="857"/>, <rfc num="1091"/>, <rfc num="1073"/>, <rfc num="1572"/> and others). It uses <term>Win32</term> console and, therefore, can be run both windowed and in fullscreen mode.</p>
+ <p/>
+ <p><b><i>Enjoy!</i></b></p>
+ <license years="1998, 2002"/>
+ <credits/>
+ </topic>
+ <topic id="News" title="Beta News">
+ <heading scroll="no">Beta News</heading>
+ <newsfor version="1.00 Beta 3" date="August 19st, 2002">
+ <ni>No changes in code. License change.</ni>
+ </newsfor>
+ <newsfor version="1.00 Beta 2" date="March 7th, 1998">
+ <ni>Better copying from <kin>KINSole</kin> window.</ni>
+ <ni>Better handling of cursor position when resizing window.</ni>
+ <ni>Sending <b>CR/LF</b> pair when pressing <b>ENTER</b>. This is of help when telnetting to non-telnet ports.</ni>
+ <ni>Corrected bug, preventing <kin>KINSole</kin> from pasting text to remote twice.</ni>
+ <ni>Improved handling of echoing. Previously <kin>KINSole</kin> didn't turn echo off on some systems, namely <b>Solaris</b>.</ni>
+ <ni>Typo causing <kin>KINSole</kin> not to show diamond characters in <b>VT10x</b> mode corrected.</ni>
+ <ni><b>GPF</b> when invoking <kin>KINSole</kin> with <b>-t</b> option fixed.</ni>
+ <ni>Hotkey (<b>Alt-INS</b>) for copy operation added. Not supposed to work under <product>Windows NT</product>.</ni>
+ <ni><b>Paste</b> is made aware of local echoing.</ni>
+ <ni>Default terminal type when telnetting to non-telnet port is now <b>TTY</b>.</ni>
+ <ni><b>Timing Mark</b> telnet option (<rfc num="860"/>) implemented (<b>Alt-T</b>).</ni>
+ <ni>Improved handling of window icon when starting from other <term>Win32</term> command line application.</ni>
+ </newsfor>
+ </topic>
+ <topic id="Using" title="Using KINSole">
+ <heading scroll="no">Using <kin>KINSole</kin></heading>
+ <p>You may run <kin>KINSole</kin> from your MS-DOS prompt by typing '<i>kinsole host port</i>'.</p>
+ <p>If you need to know more about custom options, please proceed to the <a href="#CmdOptions">Command Line Options</a> section.</p>
+ </topic>
+ <topic id="CmdOptions" title="Command Line Options">
+ <heading scroll="no">Command Line Options</heading>
+ <p>Usage:</p>
+ <p>KINSole [<i>options</i> ]<i>host</i>[ <i>port</i>]</p>
+ <p>Available options are:</p>
+ <ul>
+ <li><b>-r <i>##</i></b> or <b>-<i>##</i></b> - Try to set the number of rows in console screen buffer.</li>
+ <li><b>-c <i>##</i></b> - Try to set the number of columns in console screenbuffer.</li>
+ <li><note>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.</note></li>
+ <li><b>-l <i>username</i></b> - Pass username to remote server in environment if remote server allows.</li>
+ <li><b>-e <i>var</i>=<i>val</i></b> - Pass environment variable to remote server.</li>
+ <li><b>-v <i>var</i>=<i>val</i></b> - Pass user environment variable to remote server.</li>
+ <li><b>-t <i>termtype</i></b> - 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 <b>vt102</b>.</li>
+ </ul>
+ </topic>
+ <topic id="HotKeys" title="Hot Keys">
+ <heading scroll="no">Hot Keys</heading>
+ <p>While running <kin>KINSole</kin> you may use these key combinations:</p>
+ <ul>
+ <li><b>Alt-X/Alt-Q</b> - Terminate telnet session and leave <kin>KINSole</kin>.</li>
+ <li><b>Alt-Y</b> - Send <b>AYT (Are You There)</b> 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.</li>
+ <li><b>Shift-INS</b> Paste text from Windows Clipboard.</li>
+ <li><b>Ctrl-Break</b> Send <b>IP (Interrupt Process)</b> telnet command. Usually effectively equivalent to Ctrl-C, but it's up to server to decide what to do in each case.</li>
+ <li><b>Alt-INS</b> - Invoke <b>copying</b> from <kin>KINSole</kin> screen buffer.</li>
+ <li><b>Alt-T</b> - Send <b>TIMING-MARK</b> request. As soon as response comes <kin>KINSole</kin> will flash window thrice or beep if window handle is not available for some reason.</li>
+ </ul>
+ </topic>
+ <topic id="BetaNotes" title="Beta Notes">
+ <heading scroll="no">Beta Notes</heading>
+ <p>A few things you may want to know about this Beta Release:</p>
+ <ul>
+ <li>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?</li>
+ <li>Telnet <b>LINEMODE</b> option (<rfc num="1184"/>) is still to come.</li>
+ <li>Pasting of text using console toolbar button may cause <kin>KINSole</kin> to lock up. Use <b>Shift-INS</b> instead.</li>
+ </ul>
+ </topic>
+</winhelp>