home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / m / mxterm.zip / mxterm / ctlseqs.ms < prev    next >
Text File  |  1992-10-17  |  18KB  |  588 lines
  1. .\"#! troff -ms $1        -*- Nroff -*-
  2. .\" "Xterm Control Sequences" document
  3. .\" $XConsortium: ctlseqs.ms,v 1.8 91/07/21 15:30:31 gildea Exp $
  4. .\" 
  5. .\" Copyright 1991 by the Massachusetts Institute of Technology
  6. .\"
  7. .\" Permission to use, copy, modify, and distribute this documentation
  8. .\" for any purpose and without fee is hereby granted, provided 
  9. .\" that the above copyright notice appears in all copies,
  10. .\" and that the name of M.I.T. not be used in advertising
  11. .\" or publicity pertaining to distribution of the software without specific, 
  12. .\" written prior permission.  M.I.T. makes no representations about the 
  13. .\" suitability of the software described here for any purpose, nor
  14. .\" about the accuracy of this documentation.  It is provided "as is"
  15. .\" without express or implied warranty.
  16. .\"
  17. .\" The X Window System is a Trademark of MIT.
  18. .\"
  19. .\" Originally written by Edward Moy, University of California,
  20. .\" Berkeley, edmoy@violet.berkeley.edu, for the X.V10R4 xterm.
  21. .\" The X Consortium staff has since updated it for X11.
  22. .\"
  23. .\" Run this file through troff and use the -ms macro package.
  24. .ND
  25. .de St
  26. .sp
  27. .nr PD 0
  28. .nr PI 1.5i
  29. .nr VS 16
  30. ..
  31. .de Ed
  32. .nr PD .3v
  33. .nr VS 12
  34. ..
  35. .rm CH
  36. .ds LH Xterm Control Sequences
  37. .nr s 6*\n(PS/10
  38. .ds L \s\nsBEL\s0
  39. .ds E \s\nsESC\s0
  40. .ds T \s\nsTAB\s0
  41. .ds X \s\nsETX\s0
  42. .ds N \s\nsENQ\s0
  43. .ds e \s\nsETB\s0
  44. .ds C \s\nsCAN\s0
  45. .ds S \s\nsSUB\s0
  46. .nr [W \w'\*L'u
  47. .nr w \w'\*E'u
  48. .if \nw>\n([W .nr [W \nw
  49. .nr w \w'\*T'u
  50. .if \nw>\n([W .nr [W \nw
  51. .nr w \w'\*X'u
  52. .if \nw>\n([W .nr [W \nw
  53. .nr w \w'\*N'u
  54. .if \nw>\n([W .nr [W \nw
  55. .nr w \w'\*e'u
  56. .if \nw>\n([W .nr [W \nw
  57. .nr w \w'\*C'u
  58. .if \nw>\n([W .nr [W \nw
  59. .nr w \w'\*S'u
  60. .if \nw>\n([W .nr [W \nw
  61. .nr [W +\w'\|\|'u
  62. .de []
  63. .nr w \w'\\$2'
  64. .nr H \\n([Wu-\\nwu
  65. .nr h \\nHu/2u
  66. .ds \\$1 \(br\v'-1p'\(br\v'1p'\h'\\nhu'\\$2\h'\\nHu-\\nhu'\(br\l'-\\n([Wu\(ul'\v'-1p'\(br\l'-\\n([Wu\(rn'\v'1p'\|
  67. ..
  68. .[] Et \v'-1p'\*X\v'1p'
  69. .[] En \v'-1p'\*N\v'1p'
  70. .[] Be \v'-1p'\*L\v'1p'
  71. .[] Bs \v'-1p'\s\nsBS\s0\v'1p'
  72. .[] Ta \v'-1p'\*T\v'1p'
  73. .[] Lf \v'-1p'\s\nsLF\s0\v'1p'
  74. .[] Vt \v'-1p'\s\nsVT\s0\v'1p'
  75. .[] Ff \v'-1p'\s\nsFF\s0\v'1p'
  76. .[] Cr \v'-1p'\s\nsCR\s0\v'1p'
  77. .[] So \v'-1p'\s\nsSO\s0\v'1p'
  78. .[] Si \v'-1p'\s\nsSI\s0\v'1p'
  79. .[] Eb \v'-1p'\*e\v'1p'
  80. .[] Ca \v'-1p'\*C\v'1p'
  81. .[] Su \v'-1p'\*S\v'1p'
  82. .[] Es \v'-1p'\*E\v'1p'
  83. .[] Fs \v'-1p'\s\nsFS\s0\v'1p'
  84. .[] Gs \v'-1p'\s\nsGS\s0\v'1p'
  85. .[] Rs \v'-1p'\s\nsRS\s0\v'1p'
  86. .[] Us \v'-1p'\s\nsUS\s0\v'1p'
  87. .[] ! !
  88. .[] # #
  89. .[] (( (
  90. .[] ) )
  91. .[] * *
  92. .[] + +
  93. .[] 0 0
  94. .[] 1 1
  95. .[] 2 2
  96. .[] 3 3
  97. .[] 4 4
  98. .[] 5 5
  99. .[] 6 6
  100. .[] 7 7
  101. .[] 8 8
  102. .[] 9 9
  103. .[] : :
  104. .[] ; ;
  105. .[] = =
  106. .[] > >
  107. .[] ? ?
  108. .[] @ @
  109. .[] A A
  110. .[] cB B
  111. .[] C C
  112. .[] D D
  113. .[] E E
  114. .[] F F
  115. .[] H H
  116. .[] J J
  117. .[] K K
  118. .[] L L
  119. .[] M M
  120. .[] N N
  121. .[] O O
  122. .[] P P
  123. .[] R R
  124. .[] S S
  125. .[] T T
  126. .[] Z Z
  127. .[] [[ [
  128. .[] bS \\e
  129. .[] ] ]
  130. .[] ^ ^
  131. .[] _ _
  132. .[] ` \`
  133. .[] a a
  134. .[] b b
  135. .[] c c
  136. .[] d d
  137. .[] f f
  138. .[] g g
  139. .[] h h
  140. .[] i i
  141. .[] j j
  142. .[] k k
  143. .[] l l
  144. .[] m m
  145. .[] n n
  146. .[] o o
  147. .[] p p
  148. .[] q q
  149. .[] r r
  150. .[] s s
  151. .[] t t
  152. .[] x x
  153. .[] | |
  154. .[] } }
  155. .[] c~ ~
  156. .[] Sc \fIc\fP
  157. .ds Cc \fIC\fP
  158. .ds Cb \fIC\v'.3m'\h'-.2m'\s-2b\s0\v'-.3m'\fP
  159. .ds Cx \fIC\v'.3m'\h'-.2m'\s-2x\s0\v'-.3m'\fP
  160. .ds Cy \fIC\v'.3m'\h'-.2m'\s-2y\s0\v'-.3m'\fP
  161. .ds Ps \fIP\v'.3m'\h'-.2m'\s-2s\s0\v'-.3m'\fP
  162. .ds Pm \fIP\v'.3m'\h'-.2m'\s-2m\s0\v'-.3m'\fP
  163. .ds Pt \fIP\v'.3m'\h'-.2m'\s-2t\s0\v'-.3m'\fP
  164. .ds Ix \fIx\fP
  165. .ds Iy \fIy\fP
  166. .ds Iw \fIw\fP
  167. .ds Ih \fIh\fP
  168. .ds Ir \fIr\fP
  169. .ds Ic \fIc\fP
  170. .nr LL 6.5i
  171. .TL
  172. Xterm Control Sequences
  173. .AU
  174. Edward Moy
  175. .AI
  176. University of California, Berkeley
  177. .sp
  178. Revised by
  179. .AU
  180. Stephen Gildea
  181. .AI
  182. MIT X Consortium
  183.  
  184. .am NP
  185. .ds CF %
  186. ..
  187. .SH
  188. Definitions
  189. .IP \*(Sc
  190. The literal character \fIc\fP.
  191. .IP \*(Cc
  192. A single (required) character.
  193. .IP \*(Ps
  194. A single (usually optional) numeric parameter, composed of one of more digits.
  195. .IP \*(Pm
  196. A multiple numeric parameter composed of any number of single numeric
  197. parameters, separated by \*; character(s).
  198. .IP \*(Pt
  199. A text parameter composed of printable characters.
  200. .SH
  201. VT100 Mode
  202. .ds RH VT100 Mode
  203. .LP
  204. Most of these control sequences are standard VT102 control sequences,
  205. but there are some sequences here from later DEC VT terminals, too.
  206. Major VT102 features not supported are smooth scrolling, double size
  207. characters, blinking characters, and VT52 mode.
  208. There are additional control sequences to provide
  209. \fIxterm-\fPdependent functions, like the scrollbar or window size.
  210. Where the function is specified by DEC or ISO 6429, the code assigned
  211. to it is given in parentheses.  The escape codes to designate
  212. character sets are specified by ISO 2022; see that document for a
  213. discussion of character sets.
  214. .St
  215. .IP \\*(Be
  216. Bell (Ctrl-G)
  217. .IP \\*(Bs
  218. Backspace (Ctrl-H)
  219. .IP \\*(Ta
  220. Horizontal Tab (HT) (Ctrl-I)
  221. .IP \\*(Lf
  222. Line Feed or New Line (NL) (Ctrl-J)
  223. .IP \\*(Vt
  224. Vertical Tab (Ctrl-K) same as LF
  225. .IP \\*(Ff
  226. Form Feed or New Page (NP) (Ctrl-L) same as LF
  227. .IP \\*(Cr
  228. Carriage Return (Ctrl-M)
  229. .IP \\*(So
  230. Shift Out (Ctrl-N) \(-> Switch to Alternate Character Set: invokes the
  231. G1 character set.
  232. .IP \\*(Si
  233. Shift In (Ctrl-O) \(-> Switch to Standard Character Set: invokes the
  234. G0 character set (the default).
  235. .IP \\*(Es\\*#\\*8
  236. DEC Screen Alignment Test (DECALN)
  237. .IP \\*(Es\\*(((\\*(Cc
  238. Designate G0 Character Set (ISO 2022)
  239.   \*(Cc = \*0 \(-> DEC Special Character and Line Drawing Set
  240.   \*(Cc = \*A \(-> United Kingdom (UK)
  241.   \*(Cc = \*(cB \(-> United States (USASCII)
  242. .IP \\*(Es\\*)\\*(Cc
  243. Designate G1 Character Set (ISO 2022)
  244.   \*(Cc = \*0 \(-> DEC Special Character and Line Drawing Set
  245.   \*(Cc = \*A \(-> United Kingdom (UK)
  246.   \*(Cc = \*(cB \(-> United States (USASCII)
  247. .IP \\*(Es\\**\\*(Cc
  248. Designate G2 Character Set (ISO 2022)
  249.   \*(Cc = \*0 \(-> DEC Special Character and Line Drawing Set
  250.   \*(Cc = \*A \(-> United Kingdom (UK)
  251.   \*(Cc = \*(cB \(-> United States (USASCII)
  252. .IP \\*(Es\\*+\\*(Cc
  253. Designate G3 Character Set (ISO 2022)
  254.   \*(Cc = \*0 \(-> DEC Special Character and Line Drawing Set
  255.   \*(Cc = \*A \(-> United Kingdom (UK)
  256.   \*(Cc = \*(cB \(-> United States (USASCII)
  257. .IP \\*(Es\\*7
  258. Save Cursor (DECSC)
  259. .IP \\*(Es\\*8
  260. Restore Cursor (DECRC)
  261. .IP \\*(Es\\*=
  262. Application Keypad (DECPAM)
  263. .IP \\*(Es\\*>
  264. Normal Keypad (DECPNM)
  265. .IP \\*(Es\\*D
  266. Index (IND)
  267. .IP \\*(Es\\*E
  268. Next Line (NEL)
  269. .IP \\*(Es\\*H
  270. Tab Set (HTS)
  271. .IP \\*(Es\\*M
  272. Reverse Index (RI)
  273. .IP \\*(Es\\*N
  274. Single Shift Select of G2 Character Set (SS2): affects next character only
  275. .IP \\*(Es\\*O
  276. Single Shift Select of G3 Character Set (SS3): affects next character only
  277. .IP \\*(Es\\*P\\*(Pt\|\\*(Es\\*(bS
  278. Device Control String (DCS)
  279.   \fIxterm\fP implements no DCS functions; \*(Pt is ignored.
  280. \*(Pt need not be printable characters.
  281. .IP \\*(Es\\*Z
  282. Return Terminal ID (DECID).  Obsolete form of \*(Es\*([[\*c (DA).
  283. .IP \\*(Es\\*([[\\*(Ps\|\\*@
  284. Insert \*(Ps (Blank) Character(s) (default = 1) (ICH)
  285. .IP \\*(Es\\*([[\\*(Ps\|\\*A
  286. Cursor Up \*(Ps Times (default = 1) (CUU)
  287. .IP \\*(Es\\*([[\\*(Ps\|\\*(cB
  288. Cursor Down \*(Ps Times (default = 1) (CUD)
  289. .IP \\*(Es\\*([[\\*(Ps\|\\*C
  290. Cursor Forward \*(Ps Times (default = 1) (CUF)
  291. .IP \\*(Es\\*([[\\*(Ps\|\\*D
  292. Cursor Backward \*(Ps Times (default = 1) (CUB)
  293. .IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*H
  294. Cursor Position [row;column] (default = [1,1]) (CUP)
  295. .IP \\*(Es\\*([[\\*(Ps\|\\*J
  296. Erase in Display (ED)
  297.   \*(Ps = \*0 \(-> Clear Below (default)
  298.   \*(Ps = \*1 \(-> Clear Above
  299.   \*(Ps = \*2 \(-> Clear All
  300. .IP \\*(Es\\*([[\\*(Ps\|\\*K
  301. Erase in Line (EL)
  302.   \*(Ps = \*0 \(-> Clear to Right (default)
  303.   \*(Ps = \*1 \(-> Clear to Left
  304.   \*(Ps = \*2 \(-> Clear All
  305. .IP \\*(Es\\*([[\\*(Ps\|\\*L
  306. Insert \*(Ps Line(s) (default = 1) (IL)
  307. .IP \\*(Es\\*([[\\*(Ps\|\\*M
  308. Delete \*(Ps Line(s) (default = 1) (DL)
  309. .IP \\*(Es\\*([[\\*(Ps\|\\*P
  310. Delete \*(Ps Character(s) (default = 1) (DCH)
  311. .IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*;\\*(Ps\|\\*;\\*(Ps\|\\*;\\*(Ps\|\\*T
  312. Initiate hilite mouse tracking.
  313. Parameters are [func;startx;starty;firstrow;lastrow].
  314. See the section \fBMouse Tracking\fP.
  315. .IP \\*(Es\\*([[\\*(Ps\|\\*c
  316. Send Device Attributes (DA)
  317.   \*(Ps = \*0 or omitted \(-> request attributes from terminal
  318.   \(-> \*(Es\*([[\*?\*1\*;\*2\*c (``I am a VT100 with Advanced
  319. Video Option.'')
  320. .IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*f
  321. Horizontal and Vertical Position [row;column] (default = [1,1]) (HVP)
  322. .IP \\*(Es\\*([[\\*(Ps\|\\*g
  323. Tab Clear (TBC)
  324.   \*(Ps = \*0 \(-> Clear Current Column (default)
  325.   \*(Ps = \*3 \(-> Clear All
  326. .IP \\*(Es\\*([[\\*(Pm\|\\*h
  327. Set Mode (SM)
  328.   \*(Ps = \*4 \(-> Insert Mode (IRM)
  329.   \*(Ps = \*2\*0 \(-> Automatic Newline (LNM)
  330. .IP \\*(Es\\*([[\\*(Pm\|\\*l
  331. Reset Mode (RM)
  332.   \*(Ps = \*4 \(-> Replace Mode (IRM)
  333.   \*(Ps = \*2\*0 \(-> Normal Linefeed (LNM)
  334. .IP \\*(Es\\*([[\\*(Pm\|\\*m
  335. Character Attributes (SGR)
  336.   \*(Ps = \*0 \(-> Normal (default)
  337.   \*(Ps = \*1 \(-> Bold
  338.   \*(Ps = \*4 \(-> Underscore
  339.   \*(Ps = \*5 \(-> Blink (appears as Bold)
  340.   \*(Ps = \*7 \(-> Inverse
  341. .IP \\*(Es\\*([[\\*(Ps\|\\*n
  342. Device Status Report (DSR)
  343.   \*(Ps = \*5 \(-> Status Report \*(Es\*([[\*0\*n (``OK'')
  344.   \*(Ps = \*6 \(-> Report Cursor Position (CPR) [row;column] as
  345. \*(Es\*([[\*(Ir\|\*;\*(Ic\|\*R
  346. .IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*r
  347. Set Scrolling Region [top;bottom] (default = full size of window) (DECSTBM)
  348. .IP \\*(Es\\*([[\\*(Ps\|\\*x
  349. Request Terminal Parameters (DECREQTPARM)
  350. .IP \\*(Es\\*([[\\*?\\*(Pm\|\\*h
  351. DEC Private Mode Set (DECSET)
  352.   \*(Ps = \*1 \(-> Application Cursor Keys (DECCKM)
  353.   \*(Ps = \*2 \(-> Designate USASCII for character sets G0-G3.
  354. (In the VT102, this selects VT52 mode (DECANM), which \fIxterm\fP
  355. doesn't support.)
  356.   \*(Ps = \*3 \(-> 132 Column Mode (DECCOLM)
  357.   \*(Ps = \*4 \(-> Smooth (Slow) Scroll (DECSCLM)
  358.   \*(Ps = \*5 \(-> Reverse Video (DECSCNM)
  359.   \*(Ps = \*6 \(-> Origin Mode (DECOM)
  360.   \*(Ps = \*7 \(-> Wraparound Mode (DECAWM)
  361.   \*(Ps = \*8 \(-> Auto-repeat Keys (DECARM)
  362.   \*(Ps = \*9 \(-> Send Mouse X & Y on button press.
  363. See the section \fBMouse Tracking\fP.
  364.   \*(Ps = \*3\*8 \(-> Enter Tektronix Mode (DECTEK)
  365.   \*(Ps = \*4\*0 \(-> Allow 80 \z\(<-\(-> 132 Mode
  366.   \*(Ps = \*4\*1 \(-> \fIcurses\fP(5) fix
  367.   \*(Ps = \*4\*4 \(-> Turn On Margin Bell
  368.   \*(Ps = \*4\*5 \(-> Reverse-wraparound Mode
  369.   \*(Ps = \*4\*6 \(-> Start Logging
  370.   \*(Ps = \*4\*7 \(-> Use Alternate Screen Buffer (unless
  371. disabled by the \fBtiteInhibit\fP resource)
  372.   \*(Ps = \*1\*0\*0\*0 \(-> Send Mouse X & Y on button press and release.
  373. See the section \fBMouse Tracking\fP.
  374.   \*(Ps = \*1\*0\*0\*1 \(-> Use Hilite Mouse Tracking.
  375. See the section \fBMouse Tracking\fP.
  376. .IP \\*(Es\\*([[\\*?\\*(Pm\|\\*l
  377. DEC Private Mode Reset (DECRST)
  378.   \*(Ps = \*1 \(-> Normal Cursor Keys (DECCKM)
  379.   \*(Ps = \*3 \(-> 80 Column Mode (DECCOLM)
  380.   \*(Ps = \*4 \(-> Jump (Fast) Scroll (DECSCLM)
  381.   \*(Ps = \*5 \(-> Normal Video (DECSCNM)
  382.   \*(Ps = \*6 \(-> Normal Cursor Mode (DECOM)
  383.   \*(Ps = \*7 \(-> No Wraparound Mode (DECAWM)
  384.   \*(Ps = \*8 \(-> No Auto-repeat Keys (DECARM)
  385.   \*(Ps = \*9 \(-> Don't Send Mouse X & Y on button press
  386.   \*(Ps = \*4\*0 \(-> Disallow 80 \z\(<-\(-> 132 Mode
  387.   \*(Ps = \*4\*1 \(-> No \fIcurses\fP(5) fix
  388.   \*(Ps = \*4\*4 \(-> Turn Off Margin Bell
  389.   \*(Ps = \*4\*5 \(-> No Reverse-wraparound Mode
  390.   \*(Ps = \*4\*6 \(-> Stop Logging
  391.   \*(Ps = \*4\*7 \(-> Use Normal Screen Buffer
  392.   \*(Ps = \*1\*0\*0\*0 \(-> Don't Send Mouse X & Y on button press and
  393. release
  394.   \*(Ps = \*1\*0\*0\*1 \(-> Don't Use Hilite Mouse Tracking
  395. .IP \\*(Es\\*([[\\*?\\*(Pm\|\\*r
  396. Restore DEC Private Mode Values.  The value of \*(Ps previously saved is
  397. restored.  \*(Ps values are the same as for DECSET.
  398. .IP \\*(Es\\*([[\\*?\\*(Pm\|\\*s
  399. Save DEC Private Mode Values.  \*(Ps values are the same as for DECSET.
  400. .IP \\*(Es\\*]\\*(Ps\|\\*;\\*(Pt\|\\*(Be
  401. Set Text Parameters
  402.   \*(Ps = \*0 \(-> Change Icon Name and Window Title to \*(Pt
  403.   \*(Ps = \*1 \(-> Change Icon Name to \*(Pt
  404.   \*(Ps = \*2 \(-> Change Window Title to \*(Pt
  405.   \*(Ps = \*4\*6 \(-> Change Log File to \*(Pt (normally disabled by a
  406. compile-time option)
  407.   \*(Ps = \*5\*0 \(-> Set Font to \*(Pt
  408. .IP \\*(Es\\*^\\*(Pt\|\\*(Es\\*(bS
  409. Privacy Message (PM)
  410.   \fIxterm\fP implements no PM functions; \*(Pt is ignored.
  411. \*(Pt need not be printable characters.
  412. .IP \\*(Es\\*_\\*(Pt\|\\*(Es\\*(bS
  413. Application Program Command (APC)
  414.   \fIxterm\fP implements no APC functions; \*(Pt is ignored.
  415. \*(Pt need not be printable characters.
  416. .IP \\*(Es\\*c
  417. Full Reset (RIS)
  418. .IP \\*(Es\\*n
  419. Select the G2 Character Set (LS2)
  420. .IP \\*(Es\\*o
  421. Select the G3 Character Set (LS3)
  422. .IP \\*(Es\\*|
  423. Invoke the G3 Character Set as GR (LS3R).  Has no visible effect in \fIxterm\fP.
  424. .IP \\*(Es\\*}
  425. Invoke the G2 Character Set as GR (LS2R).  Has no visible effect in \fIxterm\fP.
  426. .IP \\*(Es\\*(c~
  427. Invoke the G1 Character Set as GR (LS1R).  Has no visible effect in \fIxterm\fP.
  428. .Ed
  429. .SH
  430. Mouse Tracking
  431. .LP
  432. The VT widget can be set to send the mouse position and other
  433. information on button presses.  These modes are typically used by
  434. editors and other full-screen applications that want to make use of
  435. the mouse.
  436. .LP
  437. There are three mutually exclusive modes, each enabled (or disabled)
  438. by a different parameter in the DECSET (or DECRST) escape sequence.
  439. Parameters for all mouse tracking escape sequences generated by
  440. \fIxterm\fP encode numeric parameters in a single character as
  441. \fIvalue\fP+040.  For example, \*! is 1.  The screen
  442. coodinate system is 1-based.
  443. .LP
  444. X10 compatibility mode sends an escape sequence on button press
  445. encoding the location and the mouse button pressed.
  446. It is enabled by specifying parameter 9 to DECSET.
  447. On button press, \fIxterm\fP sends
  448. \*(Es\*([[\*M\*(Cb\*(Cx\*(Cy (6 characters).  \*(Cb is button\-1.
  449. \*(Cx and \*(Cy are the x and y coordinates of the mouse when the
  450. button was pressed.
  451. .LP
  452. Normal tracking mode sends an escape sequence on both button press and
  453. release.  Modifier information is also sent.
  454. It is enabled by specifying parameter 1000 to DECSET.
  455. On button press or release, \fIxterm\fP sends
  456. \*(Es\*([[\*M\*(Cb\*(Cx\*(Cy.
  457. The low two bits of \*(Cb encode button information:
  458. 0=MB1 pressed, 1=MB2 pressed, 2=MB3 pressed, 3=release.
  459. The upper bits encode what modifiers were down when the button was
  460. pressed and are added together.  4=Shift, 8=Meta, 16=Control.
  461. \*(Cx and \*(Cy are the x and y coordinates of the mouse event.  The
  462. upper left corner is (1,1).
  463. .LP
  464. Mouse hilite tracking notifies a program of a button press, receives a
  465. range of lines from the program, highlights the region covered by
  466. the mouse within that range until button release, and then sends the
  467. program the release coordinates.
  468. It is enabled by specifying parameter 1001 to DECSET.
  469. Warning: use of this mode requires a cooperating program or it will
  470. hang \fIxterm.\fP
  471. On button press, the same information as for normal tracking is
  472. generated; \fIxterm\fP then waits for the program to send mouse
  473. tracking information.
  474. \fIAll X events are ignored until the proper escape sequence is
  475. received from the pty:\fP 
  476. \*(Es\*([[\*(Ps\|\*;\*(Ps\|\*;\*(Ps\|\*;\*(Ps\|\*;\*(Ps\|\*T.
  477. The parameters are \fIfunc, startx, starty, firstrow,\fP and \fIlastrow.\fP
  478. \fIfunc\fP is non-zero to initiate hilite tracking and zero to abort.
  479. \fIstartx\fP and \fIstarty\fP give the starting x and y location for
  480. the highlighted region.  The ending location tracks the mouse, but
  481. will never be above row \fIfirstrow\fP and will always be above row
  482. \fIlastrow.\fP  (The top of the screen is row 1.)
  483. When the button is released, \fIxterm\fP reports the ending position
  484. one of two ways: if the start and end coordinates are valid text
  485. locations: \*(Es\*([[\*t\*(Cx\*(Cy.  If either coordinate is past
  486. the end of the line:
  487. \*(Es\*([[\*T\*(Cx\*(Cy\*(Cx\*(Cy\*(Cx\*(Cy.
  488. The parameters are \fIstartx, starty, endx, endy, mousex,\fP and \fImousey.\fP
  489. \fIstartx, starty, endx, \fPand\fI endy\fP give the starting and
  490. ending character positions of the region. \fImousex\fP and \fImousey\fP
  491. give the location of the mouse at button up, which may not be over a
  492. character.
  493. .SH
  494. Tektronix 4014 Mode
  495. .ds RH Tektronix 4014 Mode
  496. .LP
  497. Most of these sequences are standard Tektronix 4014 control sequences.
  498. The major features missing are
  499. the write-thru and defocused modes.
  500. This document does not describe the commands used in the various
  501. Tektronix plotting modes but does describe the commands to switch modes.
  502. .St
  503. .IP \\*(Be
  504. Bell (Ctrl-G)
  505. .IP \\*(Bs
  506. Backspace (Ctrl-H)
  507. .IP \\*(Ta
  508. Horizontal Tab (Ctrl-I)
  509. .IP \\*(Lf
  510. Line Feed or New Line (Ctrl-J)
  511. .IP \\*(Vt
  512. Cursor up (Ctrl-K)
  513. .IP \\*(Ff
  514. Form Feed or New Page (Ctrl-L)
  515. .IP \\*(Cr
  516. Carriage Return (Ctrl-M)
  517. .IP \\*(Es\\*(Et
  518. Switch to VT100 Mode (ESC Ctrl-C)
  519. .IP \\*(Es\\*(En
  520. Return Terminal Status (ESC Ctrl-E)
  521. .IP \\*(Es\\*(Lf
  522. PAGE (Clear Screen)
  523. .IP \\*(Es\\*(So
  524. Begin 4015 APL mode (ignored by \fIxterm\fP) (ESC Ctrl-N)
  525. .IP \\*(Es\\*(Si
  526. End 4015 APL mode (ignored by \fIxterm\fP) (ESC Ctrl-O)
  527. .IP \\*(Es\\*(Eb
  528. COPY (Save Tektronix Codes to file COPYyy-mm-dd.hh:mm:ss) (ESC Ctrl-W)
  529. .IP \\*(Es\\*(Ca
  530. Bypass Condition (ESC Ctrl-X)
  531. .IP \\*(Es\\*(Su
  532. GIN mode (ESC Ctrl-Z)
  533. .IP \\*(Es\\*(Fs
  534. Special Point Plot Mode (ESC Ctrl-\e)
  535. .IP \\*(Es\\*8
  536. Select Large Character Set
  537. .IP \\*(Es\\*9
  538. Select #2 Character Set
  539. .IP \\*(Es\\*:
  540. Select #3 Character Set
  541. .IP \\*(Es\\*;
  542. Select Small Character Set
  543. .IP \\*(Es\\*]\\*(Ps\|\\*;\\*(Pt\|\\*(Be
  544. Set Text Parameters of VT window
  545.   \*(Ps = \*0 \(-> Change Icon Name and Window Title to \*(Pt
  546.   \*(Ps = \*1 \(-> Change Icon Name to \*(Pt
  547.   \*(Ps = \*2 \(-> Change Window Title to \*(Pt
  548.   \*(Ps = \*4\*6 \(-> Change Log File to \*(Pt
  549. .IP \\*(Es\\*`
  550. Normal Z Axis and Normal (solid) Vectors
  551. .IP \\*(Es\\*a
  552. Normal Z Axis and Dotted Line Vectors
  553. .IP \\*(Es\\*b
  554. Normal Z Axis and Dot-Dashed Vectors
  555. .IP \\*(Es\\*c
  556. Normal Z Axis and Short-Dashed Vectors
  557. .IP \\*(Es\\*d
  558. Normal Z Axis and Long-Dashed Vectors
  559. .IP \\*(Es\\*h
  560. Defocused Z Axis and Normal (solid) Vectors
  561. .IP \\*(Es\\*i
  562. Defocused Z Axis and Dotted Line Vectors
  563. .IP \\*(Es\\*j
  564. Defocused Z Axis and Dot-Dashed Vectors
  565. .IP \\*(Es\\*k
  566. Defocused Z Axis and Short-Dashed Vectors
  567. .IP \\*(Es\\*l
  568. Defocused Z Axis and Long-Dashed Vectors
  569. .IP \\*(Es\\*p
  570. Write-Thru Mode and Normal (solid) Vectors
  571. .IP \\*(Es\\*q
  572. Write-Thru Mode and Dotted Line Vectors
  573. .IP \\*(Es\\*r
  574. Write-Thru Mode and Dot-Dashed Vectors
  575. .IP \\*(Es\\*s
  576. Write-Thru Mode and Short-Dashed Vectors
  577. .IP \\*(Es\\*t
  578. Write-Thru Mode and Long-Dashed Vectors
  579. .IP \\*(Fs
  580. Point Plot Mode (Ctrl-\e)
  581. .IP \\*(Gs
  582. Graph Mode (Ctrl-])
  583. .IP \\*(Rs
  584. Incremental Plot Mode (Ctrl-^)
  585. .IP \\*(Us
  586. Alpha Mode (Ctrl-_)
  587. .Ed
  588.