comparison xml/510connectbotmonitor.in @ 31:0bc0b4798d9e

fix saystring(12) command for proper unicode and document it
author Carl Byington <carl@five-ten-sg.com>
date Sun, 28 Apr 2019 14:45:56 -0700
parents 3975d341e3dd
children
comparison
equal deleted inserted replaced
30:89b6389aa5b2 31:0bc0b4798d9e
17 17
18 </partintro> 18 </partintro>
19 19
20 <refentry id="x@PACKAGE@.1"> 20 <refentry id="x@PACKAGE@.1">
21 <refentryinfo> 21 <refentryinfo>
22 <date>2015-05-01</date> 22 <date>2019-04-28</date>
23 <author> 23 <author>
24 <firstname>Carl</firstname> 24 <firstname>Carl</firstname>
25 <surname>Byington</surname> 25 <surname>Byington</surname>
26 <affiliation><orgname>510 Software Group</orgname></affiliation> 26 <affiliation><orgname>510 Software Group</orgname></affiliation>
27 </author> 27 </author>
40 40
41 <refsect1 id='build.1'> 41 <refsect1 id='build.1'>
42 <title>Build method</title> 42 <title>Build method</title>
43 <para> 43 <para>
44 This is an android project with no native code, so 44 This is an android project with no native code, so
45 "android update project -p . -t android-16; ant debug" 45 "make docs; make builder style=release" should build cleanly.
46 should build cleanly.
47 </para> 46 </para>
48 </refsect1> 47 </refsect1>
49 48
50 <refsect1 id='introduction.1'> 49 <refsect1 id='introduction.1'>
51 <title>Introduction</title> 50 <title>Introduction</title>
75 </para> 74 </para>
76 75
77 <para> 76 <para>
78 The messages exchanged between the terminal emulator and the 77 The messages exchanged between the terminal emulator and the
79 terminal monitor are arrays of uint16 values in network byte 78 terminal monitor are arrays of uint16 values in network byte
80 order. Each message starts with a uint16 message byte length, 79 order. Each message starts with a uint16 message length,
81 followed by that many bytes of data. Note that the message length 80 followed by that many uint16 values.
82 will always be even. The next uint16 contains the message 81 The next uint16 contains the message
83 command value, and the remaining uint16 values are the arguments 82 command value, and the remaining uint16 values are the arguments
84 if any for that command. 83 if any for that command.
85 </para> 84 </para>
86 85
87 <para> 86 <para>
137 SETFIELD = 5 (Monitor -> TE). 136 SETFIELD = 5 (Monitor -> TE).
138 The first argument is the line number (0..23) 137 The first argument is the line number (0..23)
139 and the second argument is the column number (0..79). 138 and the second argument is the column number (0..79).
140 That is followed by the field value, a sequence of uint16 139 That is followed by the field value, a sequence of uint16
141 character codes from the screen buffer. The field 140 character codes from the screen buffer. The field
142 covers N columns, where N = (message length - 4) / 2. 141 covers N columns, where N = (message length - 4).
143 When sent from the monitor to the emulator, this causes 142 When sent from the monitor to the emulator, this causes
144 the emulator to send the field codes to the host (for async 143 the emulator to send the field codes to the host (for async
145 modes) or to set the specified field contents (for block modes). 144 modes) or to set the specified field contents (for block modes).
146 This is also used as the reply message from the emulator to the 145 This is also used as the reply message from the emulator to the
147 monitor for a previous GETFIELD from the monitor. 146 monitor for a previous GETFIELD from the monitor.
190 should send a CURSORMOVE update to the monitor. Cursor movement caused 189 should send a CURSORMOVE update to the monitor. Cursor movement caused
191 by SETFIELD or DEPRESS commands does not trigger CURSORMOVE updates 190 by SETFIELD or DEPRESS commands does not trigger CURSORMOVE updates
192 in block mode (tn5250) sessions. Those commands do trigger CURSORMOVE 191 in block mode (tn5250) sessions. Those commands do trigger CURSORMOVE
193 updates in async mode (telnet, ssh) sessions. 192 updates in async mode (telnet, ssh) sessions.
194 </para> 193 </para>
194
195 <para>
196 SAYSTRING = 12 (TE -> Monitor). The first argument is nonzero if
197 any current speech should be flushed. The second argument is nonzero
198 if this speech should be synchronous. That is followed by uint16
199 character codes to be spoken.
200 </para>
195 </refsect1> 201 </refsect1>
196 202
197 <refsect1 id='synchronization.1'> 203 <refsect1 id='synchronization.1'>
198 <title>Synchronization issues</title> 204 <title>Synchronization issues</title>
199 <para> 205 <para>