510Connectbot: xml/510connectbot.in annotate

annotate xml/510connectbot.in @ 413:da2814f6f05e

code cleanup

author	Carl Byington <carl@five-ten-sg.com>
date	Fri, 24 Oct 2014 19:02:32 -0700
parents	d26faad31533
children	9c6a269fabb5

rev	line source
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	1 <reference>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	2 <title>@PACKAGE@ - Version @VERSION@</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	3 <partintro>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	4 <title>Packages</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	5
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	6 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	7 The various source and binary packages are available at <ulink
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	8 url="http://www.five-ten-sg.com/@PACKAGE@/packages/">http://www.five-ten-sg.com/@PACKAGE@/packages/</ulink>.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	9 The most recent documentation is available at <ulink
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	10 url="http://www.five-ten-sg.com/@PACKAGE@/">http://www.five-ten-sg.com/@PACKAGE@/</ulink>.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	11 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	12
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	13 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	14 A <ulink url="http://www.selenic.com/mercurial/wiki/">Mercurial</ulink> source
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	15 code repository for this project is available at <ulink
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	16 url="http://hg.five-ten-sg.com/@PACKAGE@/">http://hg.five-ten-sg.com/@PACKAGE@/</ulink>.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	17 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	18
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	19 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	20 A companion terminal monitor project is available at <ulink
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	21 url="http://www.five-ten-sg.com/510ConnectbotMonitor">http://www.five-ten-sg.com/510ConnectbotMonitor</ulink>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	22 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	23 </partintro>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	24
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	25 <refentry id="x@PACKAGE@.1">
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	26 <refentryinfo>
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	27 <date>2014-07-15</date>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	28 <author>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	29 <firstname>Carl</firstname>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	30 <surname>Byington</surname>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	31 <affiliation><orgname>510 Software Group</orgname></affiliation>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	32 </author>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	33 </refentryinfo>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	34
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	35 <refmeta>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	36 <refentrytitle>@PACKAGE@</refentrytitle>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	37 <manvolnum>1</manvolnum>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	38 <refmiscinfo>@PACKAGE@ @VERSION@</refmiscinfo>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	39 </refmeta>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	40
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	41 <refnamediv id='name.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	42 <refname>@PACKAGE@</refname>
382 41fa02fdb9c6 cleanup help pages Carl Byington <carl@five-ten-sg.com> parents: 381 diff changeset	43 <refpurpose>an android vt320 tn5250 terminal emulator for telnet and ssh connections</refpurpose>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	44 </refnamediv>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	45
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	46 <refsect1 id='build.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	47 <title>Build method</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	48 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	49 This is an android project with native code, so
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	50 "ndk-build clean; ndk-build; android update project -p . -t android-16; ant debug"
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	51 should build cleanly.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	52 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	53 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	54
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	55 <refsect1 id='introduction.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	56 <title>Introduction</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	57 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	58 I belive that the previous connectbot projects are improperly licensed.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	59 They contain a mix of Apache 2.0 and GPLv2+ code, and those two licenses
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	60 are incompatible. I have relicensed this as GPLv3+, since that is
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	61 compatible with the licenses of all the sub-parts.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	62 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	63 <para>
388 ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	64 This fork extends previous Connectbot projects in two ways. It includes
73 accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	65 tn5250 terminal emulation, in addition to the previous vt320 terminal
accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	66 emulation. It also contains hooks for a separate monitoring process
accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	67 that has access to some of the internal operations in this emulator.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	68 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	69 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	70
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	71 <refsect1 id='changes.1'>
388 ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	72 <title>Other changes from previous Connectbots</title>
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	73 <itemizedlist>
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	74 <listitem><para>
344 b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	75 The Android SecureRandom bug has been fixed in newer versions
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	76 of Android, but this code now compensates for that bug in
388 ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	77 older versions. If you have keys generated on older Android
344 b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	78 devices, those keys should be discarded, and you should generate
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	79 new keys.
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	80 </para></listitem>
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	81
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	82 <listitem><para>
358 37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	83 The underlying compression code from jcraft has
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	84 been updated. The underlying socks proxy code has
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	85 been updated. The underlying ssh code has been
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	86 updated from trilead to ganymed. Elliptic curve
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	87 crypto is now supported, but the NIST curves are
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	88 placed after the RSA and DH types in the list of
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	89 key exchange algorithms, so they should only be
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	90 used if the server does not support RSA or
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	91 DH. This change is based on on a general lack of
37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	92 trust in NIST curves that have possibly been
390 d26faad31533 test buffer changed when 5250 keyboard unlocks Carl Byington <carl@five-ten-sg.com> parents: 388 diff changeset	93 compromised by the NSA.
344 b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	94 </para></listitem>
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	95
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	96 <listitem><para>
225 c6157535e180 update version; consistent defaults for hardware buttons Carl Byington <carl@five-ten-sg.com> parents: 221 diff changeset	97 The soft function keypad now has better labels, and can generate
c6157535e180 update version; consistent defaults for hardware buttons Carl Byington <carl@five-ten-sg.com> parents: 221 diff changeset	98 all 24 function keys for 5250 emulation. A hardware button can
c6157535e180 update version; consistent defaults for hardware buttons Carl Byington <carl@five-ten-sg.com> parents: 221 diff changeset	99 be configured to display that function keypad.
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	100 </para></listitem>
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	101
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	102 <listitem><para>
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	103 A deployment.connections text file is read (and deleted) on
4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	104 startup. This may be used to preconfigure the global options
388 ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	105 and to create an initial set of host connections. This is only
ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	106 useful for bulk deployments.
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	107 </para></listitem>
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	108
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	109 <listitem><para>
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	110 The font sizes are now kept with one decimal point, and font
4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	111 size changes are done by scaling by a constant factor of 1.1,
4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	112 rather than the linear additive 2 point factor.
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	113 </para></listitem>
254 5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	114
5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	115 <listitem><para>
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	116 On a per-host basis, you can either allow the font size to change
266 c922a60043db update documentation Carl Byington <carl@five-ten-sg.com> parents: 262 diff changeset	117 the number of rows and columns depending on the visibility
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	118 of the soft keyboard, or you can fix the number of rows and colums.
388 ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	119 Using a larger font with a fixed number of rows and columns, you
266 c922a60043db update documentation Carl Byington <carl@five-ten-sg.com> parents: 262 diff changeset	120 may only be able to see the top left part of the logical screen that
c922a60043db update documentation Carl Byington <carl@five-ten-sg.com> parents: 262 diff changeset	121 is being used by the host system. There is no vertical or horizontal
c922a60043db update documentation Carl Byington <carl@five-ten-sg.com> parents: 262 diff changeset	122 scrolling yet.
254 5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	123 </para></listitem>
5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	124
5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	125 <listitem><para>
258 89bad826152b fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 254 diff changeset	126 The configurable hardware buttons can now change the font size.
254 5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	127 </para></listitem>
5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	128
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	129 <listitem><para>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	130 The soft function keypad now includes the cursor movement keys.
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	131 </para></listitem>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	132
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	133 </itemizedlist>
4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	134 </refsect1>
4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	135
361 395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	136 <refsect1 id='helppages.1'>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	137 <title>Help Pages</title>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	138 <itemizedlist>
381 95188bd4badb cleanup help pages Carl Byington <carl@five-ten-sg.com> parents: 379 diff changeset	139 <listitem><para><ulink url="About.html">About</ulink> - including list of credits</para></listitem>
361 395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	140 <listitem><para><ulink url="Hints.html">Hints</ulink></para></listitem>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	141 <listitem><para><ulink url="PhysicalKeyboard.html">Physical Keyboard</ulink></para></listitem>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	142 <listitem><para><ulink url="5250Keys.html">5250 Keys</ulink></para></listitem>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	143 <listitem><para><ulink url="ScreenGestures.html">Screen Gestures</ulink></para></listitem>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	144 <listitem><para><ulink url="VirtualKeyboard.html">Virtual Keyboard</ulink></para></listitem>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	145 </itemizedlist>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	146 </refsect1>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	147
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	148 <refsect1 id='monitor.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	149 <title>Terminal Monitor</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	150 <para>
73 accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	151 For every terminal session (local, telnet, ssh or tn5250), this
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	152 terminal emulator also makes a connection to a terminal monitor
150 83bb2734b14c more setfield testing Carl Byington <carl@five-ten-sg.com> parents: 147 diff changeset	153 process, which can see cursor movement and screen contents, and can
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	154 inject characters to send to the host.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	155 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	156
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	157 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	158 The terminal monitor is invoked by calling an android Intent
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	159 named "com.five_ten_sg.connectbot.monitor.MonitorService". That
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	160 ensures that the monitor process is running, and should then
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	161 be listening on TCP port 6000 for incoming connections. The terminal
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	162 emulator then connects to the terminal monitor on port 6000.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	163 The native android Intent and Service communication mechanisms
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	164 are not used.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	165 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	166
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	167 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	168 The messages exchanged between the terminal emulator and the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	169 terminal monitor are arrays of uint16 values in network byte
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	170 order. Each message starts with a uint16 message byte length,
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	171 followed by that many bytes of data. Note that the message length
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	172 will always be even. The next uint16 contains the message
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	173 command value, and the remaining uint16 values are the arguments
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	174 if any for that command.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	175 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	176
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	177 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	178 Any arguments that are keystrokes or characters are represented
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	179 as 16 bit unicode. Note that the first 256 such characters are
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	180 identical to the ISO-8859-1 latin character set.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	181 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	182
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	183 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	184 INIT = 0 (TE -> Monitor). The argument is a string of uint16
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	185 characters. The meaning of these characters is defined by the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	186 monitor. It might be a fully qualified path name, or some other
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	187 data used by the monitor to drive the monitoring of this
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	188 connection.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	189 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	190
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	191 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	192 ACTIVATE = 1 (TE -> Monitor). The first argument is the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	193 number of lines. The second argument is the number of columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	194 That is followed by lines*columns uint16 character codes.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	195 This connection is now the active connection. It is the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	196 topmost (or only) window visible to the user - typed keystrokes
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	197 will be sent to the host on the other end of this connection.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	198 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	199
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	200 <para>
147 1350adb077b1 monitor key state tracking Carl Byington <carl@five-ten-sg.com> parents: 73 diff changeset	201 KEYSTATE = 2 (TE -> Monitor). The argument is a single uint16
1350adb077b1 monitor key state tracking Carl Byington <carl@five-ten-sg.com> parents: 73 diff changeset	202 value, 1 for key down, 0 for key up. The TE tracks a single special
1350adb077b1 monitor key state tracking Carl Byington <carl@five-ten-sg.com> parents: 73 diff changeset	203 key for the monitor, and reports key up/down state when it changes.
1350adb077b1 monitor key state tracking Carl Byington <carl@five-ten-sg.com> parents: 73 diff changeset	204 The actual key is configurable.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	205 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	206
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	207 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	208 CURSORMOVE = 3 (TE -> Monitor).
229 594101a0876a add why argument on cursor updates Carl Byington <carl@five-ten-sg.com> parents: 225 diff changeset	209 The first argument is the line number (0..23),
594101a0876a add why argument on cursor updates Carl Byington <carl@five-ten-sg.com> parents: 225 diff changeset	210 the second argument is the column number (0..79), and the third
594101a0876a add why argument on cursor updates Carl Byington <carl@five-ten-sg.com> parents: 225 diff changeset	211 argument is the reason for sending this cursor update. REASON=0 is
594101a0876a add why argument on cursor updates Carl Byington <carl@five-ten-sg.com> parents: 225 diff changeset	212 from a previous CURSORREQUEST command. REASON=1 is a cursor update
594101a0876a add why argument on cursor updates Carl Byington <carl@five-ten-sg.com> parents: 225 diff changeset	213 related to the previous SCREENCHANGE buffer update. REASON=2 is
594101a0876a add why argument on cursor updates Carl Byington <carl@five-ten-sg.com> parents: 225 diff changeset	214 a cursor update caused by user keystrokes.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	215 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	216
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	217 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	218 SCREENCHANGE = 4 (TE -> Monitor). The first argument is the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	219 number of lines. The second argument is the number of columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	220 That is followed by lines*columns uint16 character codes.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	221 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	222
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	223 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	224 FIELDVALUE = 5 (TE -> Monitor).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	225 SETFIELD = 5 (Monitor -> TE).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	226 The first argument is the line number (0..23)
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	227 and the second argument is the column number (0..79).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	228 That is followed by the field value, a sequence of uint16
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	229 character codes from the screen buffer. The field
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	230 covers N columns, where N = (message length - 4) / 2.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	231 When sent from the monitor to the emulator, this causes
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	232 the emulator to send the field codes to the host. This is
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	233 also used as the reply message from the emulator to the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	234 monitor for a previous GETFIELD from the monitor.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	235 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	236
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	237 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	238 GETFIELD = 6 (Monitor -> TE).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	239 The first argument is the line number (0..23)
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	240 and the second argument is the starting column number (0..79),
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	241 and the third argument is the field length in columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	242 This command causes the emulator to send a FIELDVALUE message
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	243 back to the monitor.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	244 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	245
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	246 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	247 SCREENWATCH = 7 (Monitor -> TE).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	248 The first argument is the line number (0..23)
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	249 and the second argument is the starting column number (0..79),
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	250 and the third argument is the field length in columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	251 This command causes the emulator to watch the specified
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	252 part of the screen for changes. When that part of the screen
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	253 changes, the emulator will send a SCREENCHANGE message back
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	254 to the monitor.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	255 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	256
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	257 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	258 DEPRESS = 8 (Monitor -> TE). The argument is a single uint16
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	259 value containing the vk_key value. This command causes the emulator
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	260 to simulate a keypress for that key. The codes are defined
160 4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	261 <ulink url="http://msdn.microsoft.com/en-us/library/windows/desktop/dd375731">here</ulink>.
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	262 </para>
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	263
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	264 <para>
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	265 SHOWURL = 9 (Monitor -> TE). The single argument is a sequence
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	266 of uint16 character codes forming a URL to be displayed.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	267 </para>
206 f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	268
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	269 <para>
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	270 SWITCHSESSION = 10 (Monitor -> TE). There are no arguments. The TE
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	271 should display this session.
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	272 </para>
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	273
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	274 <para>
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	275 CURSORREQUEST = 11 (Monitor -> TE). There are no arguments. The TE
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	276 should send a CURSORMOVE update to the monitor. Cursor movement caused
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	277 by SETFIELD or DEPRESS commands does not trigger CURSORMOVE updates
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	278 in block mode (tn5250) sessions. Those commands do trigger CURSORMOVE
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	279 updates in async mode (telnet, ssh) sessions.
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	280 </para>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	281 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	282
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	283 <refsect1 id='todo.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	284 <title>TODO</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	285 <para>
73 accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	286 The tn5250 ssl/tls key storage should use the same storage mechanism
accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	287 as the base ssh key storage.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	288 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	289 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	290
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	291 <refsect1 id='copyright.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	292 <title>Copyright</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	293 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	294 Copyright (C) 2014 by 510 Software Group <carl@five-ten-sg.com>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	295 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	296 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	297 This program is free software; you can redistribute it and/or modify it
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	298 under the terms of the GNU General Public License as published by the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	299 Free Software Foundation; either version 3, or (at your option) any
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	300 later version.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	301 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	302 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	303 You should have received a copy of the GNU General Public License along
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	304 with this program; see the file COPYING. If not, please write to the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	305 Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	306 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	307 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	308
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	309 <refsect1 id='version.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	310 <title>Version</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	311 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	312 @VERSION@
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	313 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	314 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	315 </refentry>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	316
268 2ce1ad6ffe6b fix xml syntax Carl Byington <carl@five-ten-sg.com> parents: 266 diff changeset	317 <refentry id="x@PACKAGE@.5">
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	318 <refentryinfo>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	319 <date>2014-07-15</date>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	320 <author>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	321 <firstname>Carl</firstname>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	322 <surname>Byington</surname>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	323 <affiliation><orgname>510 Software Group</orgname></affiliation>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	324 </author>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	325 </refentryinfo>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	326
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	327 <refmeta>
270 45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	328 <refentrytitle>deployment.connections</refentrytitle>
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	329 <manvolnum>5</manvolnum>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	330 <refmiscinfo>@PACKAGE@ @VERSION@</refmiscinfo>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	331 </refmeta>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	332
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	333 <refnamediv id='name.5'>
270 45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	334 <refname>deployment.connections</refname>
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	335 <refpurpose>deployment file for @PACKAGE@</refpurpose>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	336 </refnamediv>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	337
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	338 <refsect1 id='description.5'>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	339 <title>Description</title>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	340
270 45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	341 <para>The <command>deployment.connections</command> file
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	342 is show by this example. If this file exists at the top
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	343 level of the external storage (as returned by
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	344 Environment.getExternalStorageDirectory().getAbsolutePath()),
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	345 it is read, parsed, and deleted. Comments start with #
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	346 and extend to the end of the line.
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	347 </para>
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	348
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	349 <literallayout class="monospaced"><![CDATA[
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	350 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	351 # available host keys:
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	352 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	353 # nickname (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	354 # color (string) ("red", "green", "blue", "gray")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	355 # fontsize (float)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	356 # fixed_size (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	357 # fixed_width (integer)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	358 # fixed_height (integer)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	359 # pubkeyid (integer) (-2, -1) -2=none, -1=any
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	360 # useauthagent (string) ("no", "confirm", "yes")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	361 # postlogin (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	362 # compression (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	363 # httpproxy (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	364 # wantsession (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	365 # stayconnected (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	366 # delkey (string) ("del", "backspace")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	367 # encoding (string) ("UTF-8", etc)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	368 # username (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	369 # hostname (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	370 # port (integer)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	371 # monitor (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	372 # emulation (string) ("xterm-color", "xterm-256color", "xterm", "vt100", "ansi", "screen", or other answerback string)
272 ce2f4e397703 document encryption settings for 5250 emulation Carl Byington <carl@five-ten-sg.com> parents: 270 diff changeset	373 # encryption5250 (string) ("NONE", "SSLv2", "SSLv3", "TLS")
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	374 # library5250 (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	375 # menu5250 (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	376 # program5250 (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	377 # wantx11forward (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	378 # x11host (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	379 # x11port (integer)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	380
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	381
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	382 tn5250://pub1.rzkh.de:23#battleship
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	383 encryption5250=NONE
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	384 fontsize=20
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	385 fixed_size=true
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	386 fixed_width=80
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	387 fixed_height=25
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	388
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	389
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	390 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	391 # global settings are under global:// tag
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	392 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	393 # available global keys:
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	394 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	395 # memkeys (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	396 # connPersist (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	397 # emulation (string) ("xterm-color", "xterm-256color", "xterm", "vt100", "ansi", "screen")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	398 # scrollback (integer)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	399 # rotation (string) ("Default", "Force landscape", "Force portrait", "Automatic")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	400 # shiftfkeys (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	401 # ctrlfkeys (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	402 # keymode (string) ("Use right-side keys", "Use left-side keys", "none")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	403 # camera (string) ("CTRL", "Esc", "Tab", "Screen Capture", "Ctrl+A then Space", "Ctrl+A", "Esc+A", "Monitor Key", "Soft Function Keypad", "Increase Font Size", "Decrease Font Size", "None")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	404 # volup (string) ("CTRL", "Esc", "Tab", "Screen Capture", "Ctrl+A then Space", "Ctrl+A", "Esc+A", "Monitor Key", "Soft Function Keypad", "Increase Font Size", "Decrease Font Size", "None")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	405 # voldn (string) ("CTRL", "Esc", "Tab", "Screen Capture", "Ctrl+A then Space", "Ctrl+A", "Esc+A", "Monitor Key", "Soft Function Keypad", "Increase Font Size", "Decrease Font Size", "None")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	406 # search (string) ("CTRL", "Esc", "Tab", "Screen Capture", "Ctrl+A then Space", "Ctrl+A", "Esc+A", "Monitor Key", "Soft Function Keypad", "Increase Font Size", "Decrease Font Size", "None")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	407 # ptt (string) ("CTRL", "Esc", "Tab", "Screen Capture", "Ctrl+A then Space", "Ctrl+A", "Esc+A", "Monitor Key", "Soft Function Keypad", "Increase Font Size", "Decrease Font Size", "None")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	408 # keepalive (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	409 # wifilock (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	410 # bumpyarrows (boolean)
379 aaf1599a8656 document eula key in deployment.connections Carl Byington <carl@five-ten-sg.com> parents: 361 diff changeset	411 # eula (boolean)
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	412 # extended_longpress (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	413 # ctrl_string (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	414 # picker_string (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	415 # picker_keep_open (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	416 # list_custom_keymap (string) ("none", "full", "asus_tf", "sgh_i927", "sgh_i927_ics", "se_xppro")
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	417 # bell (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	418 # bellVolume (float)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	419 # bellVibrate (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	420 # bellNotification (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	421 # screen_capture_folder (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	422 # screen_capture_popup (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	423 # file_dialog (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	424 # download_folder (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	425 # remote_upload_folder (string)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	426 # upload_dest_prompt (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	427 # background_file_transfer (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	428 # debug_keycodes (boolean)
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	429 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	430
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	431 global://
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	432 emulation=xterm-256color
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	433 scrollback=200
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	434 rotation=Force landscape
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	435 camera=None
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	436 volup=Soft Function Keypad
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	437 voldn=Tab
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	438 search=None
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	439 ptt=Monitor Key
379 aaf1599a8656 document eula key in deployment.connections Carl Byington <carl@five-ten-sg.com> parents: 361 diff changeset	440 eula=true
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	441
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	442 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	443 # end
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	444 ]]></literallayout>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	445 </refsect1>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	446
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	447 <refsect1 id='version.5'>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	448 <title>Version</title>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	449 <para>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	450 @VERSION@
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	451 </para>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	452 </refsect1>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	453
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	454 </refentry>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	455 </reference>

Mercurial > 510Connectbot

annotate xml/510connectbot.in @ 413:da2814f6f05e