annotate xml/510connectbot.in @ 507:f7498bd7621b

Added tag stable-1.9.4-5 for changeset b8cc360e1550
author Carl Byington <carl@five-ten-sg.com>
date Wed, 16 Nov 2022 12:07:04 -0700
parents ece82b571900
children 2eb4fa13b9ef
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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>
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
32 <date>2019-10-04</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>
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
107 A deployment.connections text file is read (and optionally deleted) on
220
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
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
174 order. Each message starts with a uint16 message length,
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
175 followed by that many uint16 values.
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
176 The next uint16 contains the message
0
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>
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
182 Any arguments that are characters are represented as 16 bit
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
183 unicode. Note that the first 256 such characters are identical to the
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
184 ISO-8859-1 latin character set. There is no provision for handling
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
185 surrogate pairs as in UTF-16. Keystroke arguments (see DEPRESS) are
472
9ff443085f00 cleanup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 470
diff changeset
186 represented as Microsoft Virtual-Key codes, defined
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
187 <ulink url="https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes">here</ulink>.
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
188 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
189
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
190 <para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
191 INIT = 0 (TE -> Monitor). The argument is a string of uint16
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
192 characters. The meaning of these characters is defined by the
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
193 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
194 data used by the monitor to drive the monitoring of this
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
195 connection.
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
196 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
197
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 ACTIVATE = 1 (TE -> Monitor). The first argument is the
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
200 number of lines. The second argument is the number of columns.
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
201 That is followed by lines*columns uint16 character codes for
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
202 the current screen contents.
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
203 This connection is now the active connection. It is the
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
204 topmost (or only) window visible to the user - typed keystrokes
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
205 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
206 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
207
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
208 <para>
147
1350adb077b1 monitor key state tracking
Carl Byington <carl@five-ten-sg.com>
parents: 73
diff changeset
209 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
210 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
211 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
212 The actual key is configurable.
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
213 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
214
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 CURSORMOVE = 3 (TE -> Monitor).
229
594101a0876a add why argument on cursor updates
Carl Byington <carl@five-ten-sg.com>
parents: 225
diff changeset
217 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
218 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
219 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
220 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
221 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
222 a cursor update caused by user keystrokes.
0
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
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 SCREENCHANGE = 4 (TE -> Monitor). The first argument is the
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
227 number of lines. The second argument is the number of columns.
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
228 That is followed by lines*columns uint16 character codes for
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
229 the current screen contents.
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
230 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
231
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
232 <para>
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
233 Every SCREENCHANGE message from the TE will be followed by a
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
234 CURSORMOVE message.
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
235 </para>
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
236
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
237 <para>
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
238 When the TE sends the screen contents as a result of a previous screen
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
239 watch, the screen watch area is then reset to the entire screen. The
472
9ff443085f00 cleanup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 470
diff changeset
240 monitor is then responsible for sending a screenwatch
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
241 command to set the watch area to something appropriate for that new
472
9ff443085f00 cleanup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 470
diff changeset
242 screen. Once the monitor has set the watch area to some part of a
9ff443085f00 cleanup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 470
diff changeset
243 single line, there is no mechanism for the monitor to reset it to
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
244 back to the entire screen. That reset only happens when the TE sends
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
245 the screen contents.
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
246 </para>
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
247
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
248 <para>
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
249 FIELDVALUE = 5 (TE -> Monitor).
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
250 SETFIELD = 5 (Monitor -> TE).
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
251 The first argument is the line number (0..23)
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
252 and the second argument is the column number (0..79).
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
253 That is followed by the field value, a sequence of uint16
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
254 character codes from the screen buffer. The field
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
255 covers N columns, where N = (message length - 4).
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
256 When sent from the monitor to the emulator, this causes
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
257 the emulator to send the field codes to the host (for async
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
258 modes) or to set the specified field contents (for block modes).
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
259 If the field length is zero, the TE should move the cursor to the specified line/column.
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
260 </para>
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
261
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
262 <para>
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
263 This is also used as the reply message from the emulator to the
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
264 monitor for a previous GETFIELD from the monitor.
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
265 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
266
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
267 <para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
268 GETFIELD = 6 (Monitor -> TE).
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
269 The first argument is the line number (0..23)
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
270 and the second argument is the starting column number (0..79),
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
271 and the third argument is the field length in columns.
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
272 This command causes the emulator to send a FIELDVALUE message
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
273 back to the monitor.
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
274 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
275
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
276 <para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
277 SCREENWATCH = 7 (Monitor -> TE).
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
278 The first argument is the line number (0..23)
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
279 and the second argument is the starting column number (0..79),
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
280 and the third argument is the field length in columns.
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
281 This command causes the emulator to watch the specified
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
282 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
283 changes, the emulator will send a SCREENCHANGE message back
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
284 to the monitor. The initial screen watch area is the entire
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
285 screen.
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
286 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
287
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
288 <para>
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
289 Subsequent screenwatch requests replace the current one, so the TE
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
290 has only one watch area at any time.
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
291 </para>
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
292
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
293 <para>
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
294 DEPRESS = 8 (Monitor -> TE). The argument is a single uint16
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
295 value containing the vk_key value. This command causes the emulator
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
296 to simulate a keypress for that key. The codes are defined
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
297 <ulink url="https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes">here</ulink>.
160
4bccac50fd0b update version number and documentation
Carl Byington <carl@five-ten-sg.com>
parents: 150
diff changeset
298 </para>
4bccac50fd0b update version number and documentation
Carl Byington <carl@five-ten-sg.com>
parents: 150
diff changeset
299
4bccac50fd0b update version number and documentation
Carl Byington <carl@five-ten-sg.com>
parents: 150
diff changeset
300 <para>
4bccac50fd0b update version number and documentation
Carl Byington <carl@five-ten-sg.com>
parents: 150
diff changeset
301 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
302 of uint16 character codes forming a URL to be displayed.
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
303 </para>
206
f60d4b1e8c39 add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents: 160
diff changeset
304
f60d4b1e8c39 add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents: 160
diff changeset
305 <para>
f60d4b1e8c39 add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents: 160
diff changeset
306 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
307 should display this session.
f60d4b1e8c39 add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents: 160
diff changeset
308 </para>
f60d4b1e8c39 add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents: 160
diff changeset
309
f60d4b1e8c39 add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents: 160
diff changeset
310 <para>
f60d4b1e8c39 add cursor request command to the TE
Carl Byington <carl@five-ten-sg.com>
parents: 160
diff changeset
311 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
312 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
313 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
314 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
315 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
316 </para>
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
317
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
318 <para>
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
319 SAYSTRING = 12 (TE -> Monitor). The first argument is nonzero if
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
320 any current speech should be flushed. The second argument is nonzero
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
321 if this speech should be synchronous. That is followed by uint16
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
322 character codes to be spoken. Note that the language is specified
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
323 by the monitor, not the TE.
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
324 </para>
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
325 </refsect1>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
326
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
327 <refsect1 id='todo.1'>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
328 <title>TODO</title>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
329 <para>
73
accf93be8c12 update documentation; use xterm-256color as default terminal type
Carl Byington <carl@five-ten-sg.com>
parents: 0
diff changeset
330 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
331 as the base ssh key storage.
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
332 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
333 </refsect1>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
334
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
335 <refsect1 id='copyright.1'>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
336 <title>Copyright</title>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
337 <para>
463
6dff6933879c fixup documentation
Carl Byington <carl@five-ten-sg.com>
parents: 453
diff changeset
338 Copyright (C) 2019 by 510 Software Group &lt;carl@five-ten-sg.com&gt;
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
339 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
340 <para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
341 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
342 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
343 Free Software Foundation; either version 3, or (at your option) any
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
344 later version.
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
345 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
346 <para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
347 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
348 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
349 Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
350 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
351 </refsect1>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
352
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
353 <refsect1 id='version.1'>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
354 <title>Version</title>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
355 <para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
356 @VERSION@
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
357 </para>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
358 </refsect1>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
359 </refentry>
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
360
268
2ce1ad6ffe6b fix xml syntax
Carl Byington <carl@five-ten-sg.com>
parents: 266
diff changeset
361 <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
362 <refentryinfo>
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
363 <date>2019-10-04</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
364 <author>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
365 <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
366 <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
367 <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
368 </author>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
369 </refentryinfo>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
370
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
371 <refmeta>
270
45d1fcc1a356 document deployment.connections usage
Carl Byington <carl@five-ten-sg.com>
parents: 268
diff changeset
372 <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
373 <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
374 <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
375 </refmeta>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
376
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
377 <refnamediv id='name.5'>
270
45d1fcc1a356 document deployment.connections usage
Carl Byington <carl@five-ten-sg.com>
parents: 268
diff changeset
378 <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
379 <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
380 </refnamediv>
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 <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
383 <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
384
465
7c8aebcc882a request permissions if not already granted
Carl Byington <carl@five-ten-sg.com>
parents: 463
diff changeset
385 <para>The <command>deployment.connections</command> sample
7c8aebcc882a request permissions if not already granted
Carl Byington <carl@five-ten-sg.com>
parents: 463
diff changeset
386 file is below. If this file exists at the top
270
45d1fcc1a356 document deployment.connections usage
Carl Byington <carl@five-ten-sg.com>
parents: 268
diff changeset
387 level of the external storage (as returned by
45d1fcc1a356 document deployment.connections usage
Carl Byington <carl@five-ten-sg.com>
parents: 268
diff changeset
388 Environment.getExternalStorageDirectory().getAbsolutePath()),
466
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
389 it is read, parsed, and optionally deleted. Comments start with #
270
45d1fcc1a356 document deployment.connections usage
Carl Byington <carl@five-ten-sg.com>
parents: 268
diff changeset
390 and extend to the end of the line.
45d1fcc1a356 document deployment.connections usage
Carl Byington <carl@five-ten-sg.com>
parents: 268
diff changeset
391 </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
392
466
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
393 <para>
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
394 The deployment file is deleted unless it contains "delete_deployment=false"
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
395 in the global options section. In that case, the file remains, and
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
396 it is read and parsed every time the app is launched.
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
397 </para>
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
398
262
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
399 <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
400 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
401 # 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
402 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
403 # 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
404 # 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
405 # 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
406 # 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
407 # 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
408 # 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
409 # 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
410 # 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
411 # 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
412 # 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
413 # 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
414 # 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
415 # 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
416 # 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
417 # 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
418 # 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
419 # 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
420 # 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
421 # 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
422 # 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
423 # 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
424 # 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
425 # 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
426 # 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
427 # 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
428 # 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
429 # x11port (integer)
466
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
430 # autolaunch (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
431
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
432
466
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
433 tn5250://pub400.com:23#battleship
262
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
434 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
435 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
436 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
437 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
438 fixed_height=25
470
2cc170e3fc9b audible bell checkbox enables/disables bell volume setting; monitor init string is now a url socket://target/initstring
Carl Byington <carl@five-ten-sg.com>
parents: 466
diff changeset
439 monitor=socket://localhost/pub400
262
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
440
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 # 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
444 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
445 # 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
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 # 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
448 # 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
449 # 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
450 # 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
451 # 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
452 # 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
453 # 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
454 # 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
455 # 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
456 # 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
457 # 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
458 # 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
459 # 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
460 # 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
461 # 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
462 # bumpyarrows (boolean)
379
aaf1599a8656 document eula key in deployment.connections
Carl Byington <carl@five-ten-sg.com>
parents: 361
diff changeset
463 # 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
464 # 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
465 # 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
466 # 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
467 # 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
468 # 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
469 # 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
470 # 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
471 # 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
472 # 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
473 # 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
474 # 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
475 # 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
476 # 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
477 # 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
478 # 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
479 # 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
480 # debug_keycodes (boolean)
466
12e2d9dd95df add delete_deployment and autolaunch keys to the deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 465
diff changeset
481 # delete_deployment (boolean)
473
ece82b571900 add fg/bg color setting to global:// section of deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 472
diff changeset
482 # fg_color (integer) (1 based just as shown by color activity)
ece82b571900 add fg/bg color setting to global:// section of deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 472
diff changeset
483 # bg_color (integer) (1 based just as shown by color activity)
262
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
484 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
485
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
486 global://
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
487 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
488 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
489 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
490 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
491 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
492 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
493 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
494 ptt=Monitor Key
379
aaf1599a8656 document eula key in deployment.connections
Carl Byington <carl@five-ten-sg.com>
parents: 361
diff changeset
495 eula=true
473
ece82b571900 add fg/bg color setting to global:// section of deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 472
diff changeset
496 fg_color=11
ece82b571900 add fg/bg color setting to global:// section of deployment.connections file
Carl Byington <carl@five-ten-sg.com>
parents: 472
diff changeset
497 bg_color=1
262
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
498
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
499 #
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
500 # end
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
501 ]]></literallayout>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
502 </refsect1>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
503
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
504 <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
505 <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
506 <para>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
507 @VERSION@
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
508 </para>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
509 </refsect1>
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
510
db26984b69f5 update version; add cursor movement keys to the soft function keypad
Carl Byington <carl@five-ten-sg.com>
parents: 258
diff changeset
511 </refentry>
0
0ce5cc452d02 initial version
Carl Byington <carl@five-ten-sg.com>
parents:
diff changeset
512 </reference>