510Connectbot: xml/510connectbot.in annotate

annotate xml/510connectbot.in @ 453:f65d8bb11eb0

update build directions

author	Carl Byington <carl@five-ten-sg.com>
date	Mon, 21 Mar 2016 09:50:22 -0700
parents	9c6a269fabb5
children	6dff6933879c

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>
435 9c6a269fabb5 add bitcoin donation address Carl Byington <carl@five-ten-sg.com> parents: 390 diff changeset	23
9c6a269fabb5 add bitcoin donation address Carl Byington <carl@five-ten-sg.com> parents: 390 diff changeset	24 <para>
9c6a269fabb5 add bitcoin donation address Carl Byington <carl@five-ten-sg.com> parents: 390 diff changeset	25 Bitcoin donations for this project may be sent to
9c6a269fabb5 add bitcoin donation address Carl Byington <carl@five-ten-sg.com> parents: 390 diff changeset	26 <ulink url="bitcoin:1EkbpYhcbAwmU3L7xXPisHQdwWSyjdaY2A">bitcoin:1EkbpYhcbAwmU3L7xXPisHQdwWSyjdaY2A</ulink>
9c6a269fabb5 add bitcoin donation address Carl Byington <carl@five-ten-sg.com> parents: 390 diff changeset	27 </para>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	28 </partintro>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	29
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	30 <refentry id="x@PACKAGE@.1">
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	31 <refentryinfo>
435 9c6a269fabb5 add bitcoin donation address Carl Byington <carl@five-ten-sg.com> parents: 390 diff changeset	32 <date>2015-04-09</date>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	33 <author>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	34 <firstname>Carl</firstname>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	35 <surname>Byington</surname>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	36 <affiliation><orgname>510 Software Group</orgname></affiliation>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	37 </author>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	38 </refentryinfo>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	39
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	40 <refmeta>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	41 <refentrytitle>@PACKAGE@</refentrytitle>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	42 <manvolnum>1</manvolnum>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	43 <refmiscinfo>@PACKAGE@ @VERSION@</refmiscinfo>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	44 </refmeta>
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 <refnamediv id='name.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	47 <refname>@PACKAGE@</refname>
382 41fa02fdb9c6 cleanup help pages Carl Byington <carl@five-ten-sg.com> parents: 381 diff changeset	48 <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	49 </refnamediv>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	50
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	51 <refsect1 id='build.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	52 <title>Build method</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	53 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	54 This is an android project with native code, so
453 f65d8bb11eb0 update build directions Carl Byington <carl@five-ten-sg.com> parents: 435 diff changeset	55 "make builder style=debug" should build cleanly.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	56 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	57 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	58
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	59 <refsect1 id='introduction.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	60 <title>Introduction</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	61 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	62 I belive that the previous connectbot projects are improperly licensed.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	63 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	64 are incompatible. I have relicensed this as GPLv3+, since that is
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	65 compatible with the licenses of all the sub-parts.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	66 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	67 <para>
388 ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	68 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	69 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	70 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	71 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	72 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	73 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	74
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	75 <refsect1 id='changes.1'>
388 ebcb4aea03ec fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 382 diff changeset	76 <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	77 <itemizedlist>
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	78 <listitem><para>
344 b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	79 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	80 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	81 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	82 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	83 new keys.
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	84 </para></listitem>
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	85
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	86 <listitem><para>
358 37f4a3b506d9 move nist ec curves to lower priority Carl Byington <carl@five-ten-sg.com> parents: 344 diff changeset	87 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	88 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	89 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	90 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	91 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	92 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	93 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	94 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	95 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	96 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	97 compromised by the NSA.
344 b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	98 </para></listitem>
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	99
b40bc65fa09a compensate for SecureRandom bug on older devices Carl Byington <carl@five-ten-sg.com> parents: 273 diff changeset	100 <listitem><para>
225 c6157535e180 update version; consistent defaults for hardware buttons Carl Byington <carl@five-ten-sg.com> parents: 221 diff changeset	101 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	102 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	103 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	104 </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	105
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	106 <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	107 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	108 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	109 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	110 useful for bulk deployments.
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	111 </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	112
221 70ecbf70eadb document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 220 diff changeset	113 <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	114 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	115 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	116 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	117 </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	118
5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	119 <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	120 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	121 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	122 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	123 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	124 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	125 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	126 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	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
5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	129 <listitem><para>
258 89bad826152b fix documentation typos Carl Byington <carl@five-ten-sg.com> parents: 254 diff changeset	130 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	131 </para></listitem>
5517cca2bd81 update version; help shows full version info; update change list Carl Byington <carl@five-ten-sg.com> parents: 229 diff changeset	132
262 db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	133 <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	134 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	135 </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	136
220 4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	137 </itemizedlist>
4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	138 </refsect1>
4fdf6b5a6f43 update to 1.8.4; document changes from previous forks Carl Byington <carl@five-ten-sg.com> parents: 206 diff changeset	139
361 395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	140 <refsect1 id='helppages.1'>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	141 <title>Help Pages</title>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	142 <itemizedlist>
381 95188bd4badb cleanup help pages Carl Byington <carl@five-ten-sg.com> parents: 379 diff changeset	143 <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	144 <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	145 <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	146 <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	147 <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	148 <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	149 </itemizedlist>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	150 </refsect1>
395a16681ae1 add help files to the web documentation Carl Byington <carl@five-ten-sg.com> parents: 358 diff changeset	151
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	152 <refsect1 id='monitor.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	153 <title>Terminal Monitor</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	154 <para>
73 accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	155 For every terminal session (local, telnet, ssh or tn5250), this
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	156 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	157 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	158 inject characters to send to the host.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	159 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	160
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	161 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	162 The terminal monitor is invoked by calling an android Intent
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	163 named "com.five_ten_sg.connectbot.monitor.MonitorService". That
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	164 ensures that the monitor process is running, and should then
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	165 be listening on TCP port 6000 for incoming connections. The terminal
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	166 emulator then connects to the terminal monitor on port 6000.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	167 The native android Intent and Service communication mechanisms
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	168 are not used.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	169 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	170
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	171 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	172 The messages exchanged between the terminal emulator and the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	173 terminal monitor are arrays of uint16 values in network byte
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	174 order. Each message starts with a uint16 message byte length,
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	175 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	176 will always be even. The next uint16 contains the message
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	177 command value, and the remaining uint16 values are the arguments
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	178 if any for that command.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	179 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	180
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 Any arguments that are keystrokes or characters are represented
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	183 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	184 identical to the ISO-8859-1 latin character set.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	185 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	186
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	187 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	188 INIT = 0 (TE -> Monitor). The argument is a string of uint16
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	189 characters. The meaning of these characters is defined by the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	190 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	191 data used by the monitor to drive the monitoring of this
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	192 connection.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	193 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	194
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	195 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	196 ACTIVATE = 1 (TE -> Monitor). The first argument is the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	197 number of lines. The second argument is the number of columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	198 That is followed by lines*columns uint16 character codes.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	199 This connection is now the active connection. It is the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	200 topmost (or only) window visible to the user - typed keystrokes
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	201 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	202 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	203
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	204 <para>
147 1350adb077b1 monitor key state tracking Carl Byington <carl@five-ten-sg.com> parents: 73 diff changeset	205 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	206 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	207 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	208 The actual key is configurable.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	209 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	210
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	211 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	212 CURSORMOVE = 3 (TE -> Monitor).
229 594101a0876a add why argument on cursor updates Carl Byington <carl@five-ten-sg.com> parents: 225 diff changeset	213 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	214 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	215 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	216 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	217 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	218 a cursor update caused by user keystrokes.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	219 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	220
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 SCREENCHANGE = 4 (TE -> Monitor). The first argument is the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	223 number of lines. The second argument is the number of columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	224 That is followed by lines*columns uint16 character codes.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	225 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	226
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	227 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	228 FIELDVALUE = 5 (TE -> Monitor).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	229 SETFIELD = 5 (Monitor -> TE).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	230 The first argument is the line number (0..23)
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	231 and the second argument is the column number (0..79).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	232 That is followed by the field value, a sequence of uint16
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	233 character codes from the screen buffer. The field
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	234 covers N columns, where N = (message length - 4) / 2.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	235 When sent from the monitor to the emulator, this causes
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	236 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	237 also used as the reply message from the emulator to the
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	238 monitor for a previous GETFIELD from the monitor.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	239 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	240
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	241 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	242 GETFIELD = 6 (Monitor -> TE).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	243 The first argument is the line number (0..23)
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	244 and the second argument is the starting column number (0..79),
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	245 and the third argument is the field length in columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	246 This command causes the emulator to send a FIELDVALUE message
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	247 back to the monitor.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	248 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	249
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	250 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	251 SCREENWATCH = 7 (Monitor -> TE).
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	252 The first argument is the line number (0..23)
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	253 and the second argument is the starting column number (0..79),
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	254 and the third argument is the field length in columns.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	255 This command causes the emulator to watch the specified
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	256 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	257 changes, the emulator will send a SCREENCHANGE message back
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	258 to the monitor.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	259 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	260
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	261 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	262 DEPRESS = 8 (Monitor -> TE). The argument is a single uint16
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	263 value containing the vk_key value. This command causes the emulator
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	264 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	265 <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	266 </para>
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	267
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	268 <para>
4bccac50fd0b update version number and documentation Carl Byington <carl@five-ten-sg.com> parents: 150 diff changeset	269 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	270 of uint16 character codes forming a URL to be displayed.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	271 </para>
206 f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	272
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	273 <para>
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	274 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	275 should display this session.
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	276 </para>
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	277
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	278 <para>
f60d4b1e8c39 add cursor request command to the TE Carl Byington <carl@five-ten-sg.com> parents: 160 diff changeset	279 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	280 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	281 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	282 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	283 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	284 </para>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	285 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	286
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	287 <refsect1 id='todo.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	288 <title>TODO</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	289 <para>
73 accf93be8c12 update documentation; use xterm-256color as default terminal type Carl Byington <carl@five-ten-sg.com> parents: 0 diff changeset	290 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	291 as the base ssh key storage.
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	292 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	293 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	294
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	295 <refsect1 id='copyright.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	296 <title>Copyright</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	297 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	298 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	299 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	300 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	301 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	302 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	303 Free Software Foundation; either version 3, or (at your option) any
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	304 later version.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	305 </para>
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 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	308 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	309 Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	310 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	311 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	312
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	313 <refsect1 id='version.1'>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	314 <title>Version</title>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	315 <para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	316 @VERSION@
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	317 </para>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	318 </refsect1>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	319 </refentry>
0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	320
268 2ce1ad6ffe6b fix xml syntax Carl Byington <carl@five-ten-sg.com> parents: 266 diff changeset	321 <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	322 <refentryinfo>
435 9c6a269fabb5 add bitcoin donation address Carl Byington <carl@five-ten-sg.com> parents: 390 diff changeset	323 <date>2015-04-09</date>
262 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 <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	326 <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	327 <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	328 </author>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	329 </refentryinfo>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	330
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>
270 45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	332 <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	333 <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	334 <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	335 </refmeta>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	336
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	337 <refnamediv id='name.5'>
270 45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	338 <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	339 <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	340 </refnamediv>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	341
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	342 <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	343 <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	344
270 45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	345 <para>The <command>deployment.connections</command> file
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	346 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	347 level of the external storage (as returned by
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	348 Environment.getExternalStorageDirectory().getAbsolutePath()),
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	349 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	350 and extend to the end of the line.
45d1fcc1a356 document deployment.connections usage Carl Byington <carl@five-ten-sg.com> parents: 268 diff changeset	351 </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	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 <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	354 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	355 # 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	356 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	357 # 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	358 # 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	359 # 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	360 # 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	361 # 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	362 # 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	363 # 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	364 # 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	365 # 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	366 # 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	367 # 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	368 # 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	369 # 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	370 # 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	371 # 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	372 # 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	373 # 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	374 # 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	375 # 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	376 # 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	377 # 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	378 # 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	379 # 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	380 # 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	381 # 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	382 # 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	383 # 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	384
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	385
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	386 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	387 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	388 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	389 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	390 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	391 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	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
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 # 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	396 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	397 # 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	398 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	399 # 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	400 # 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	401 # 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	402 # 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	403 # 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	404 # 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	405 # 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	406 # 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	407 # 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	408 # 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	409 # 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	410 # 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	411 # 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	412 # 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	413 # 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	414 # bumpyarrows (boolean)
379 aaf1599a8656 document eula key in deployment.connections Carl Byington <carl@five-ten-sg.com> parents: 361 diff changeset	415 # 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	416 # 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	417 # 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	418 # 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	419 # 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	420 # 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	421 # 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	422 # 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	423 # 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	424 # 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	425 # 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	426 # 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	427 # 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	428 # 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	429 # 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	430 # 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	431 # 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	432 # 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	433 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	434
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	435 global://
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	436 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	437 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	438 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	439 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	440 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	441 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	442 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	443 ptt=Monitor Key
379 aaf1599a8656 document eula key in deployment.connections Carl Byington <carl@five-ten-sg.com> parents: 361 diff changeset	444 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	445
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 # end
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	448 ]]></literallayout>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	449 </refsect1>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	450
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	451 <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	452 <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	453 <para>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	454 @VERSION@
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	455 </para>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	456 </refsect1>
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	457
db26984b69f5 update version; add cursor movement keys to the soft function keypad Carl Byington <carl@five-ten-sg.com> parents: 258 diff changeset	458 </refentry>
0 0ce5cc452d02 initial version Carl Byington <carl@five-ten-sg.com> parents: diff changeset	459 </reference>

Mercurial > 510Connectbot

annotate xml/510connectbot.in @ 453:f65d8bb11eb0