samperi@marob.masa.com (Dominick Samperi) (09/11/89)
In response to many requests, here is the document describing the xterm control sequences. Many thanks go to P. Allen Jensen for locating it, and to Edward Moy for writing it! If somebody figures out how to set the keyboard mapping via an escape sequence (or how to arrange for xterm to startup with a specified keyboard mapping), please let me know about it. All I can find in the xterm docs is a description of how to arrange for a dedicated key to select a given mapping (not very convenient for the end user). Dominick Samperi Citicorp uunet!ccorp!samperi samperi@marob.masa.com .\"#! troff -Q -ms $1 .\" This is the "Xterm Control Sequences" document, written by .\" Edward Moy .\" Academic Computing Services .\" University of California .\" Berkeley, CA 94720 .\" .\" edmoy@opal.Berkeley.EDU .\" ucbvax!opal!edmoy .\" .\" Run this file through troff and use the -ms macro package. .ND .de St .sp .nr PD 0 .nr PI 1.5i .nr VS 16 .. .de Ed .nr PD .3v .nr VS 12 .. .rm CH .ds LH Xterm Control Sequences .nr s 6*\n(PS/10 .ds L \s\nsBEL\s0 .ds E \s\nsESC\s0 .ds T \s\nsTAB\s0 .ds X \s\nsETX\s0 .ds N \s\nsENQ\s0 .ds e \s\nsETB\s0 .ds C \s\nsCAN\s0 .ds S \s\nsSUB\s0 .nr [W \w'\*L'u .nr w \w'\*E'u .if \nw>\n([W .nr [W \nw .nr w \w'\*T'u .if \nw>\n([W .nr [W \nw .nr w \w'\*X'u .if \nw>\n([W .nr [W \nw .nr w \w'\*N'u .if \nw>\n([W .nr [W \nw .nr w \w'\*e'u .if \nw>\n([W .nr [W \nw .nr w \w'\*C'u .if \nw>\n([W .nr [W \nw .nr w \w'\*S'u .if \nw>\n([W .nr [W \nw .nr [W +\w'\|\|'u .de [] .nr w \w'\\$2' .nr H \\n([Wu-\\nwu .nr h \\nHu/2u .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'\| .. .[] Et \v'-1p'\*X\v'1p' .[] En \v'-1p'\*N\v'1p' .[] Be \v'-1p'\*L\v'1p' .[] Bs \v'-1p'\s\nsBS\s0\v'1p' .[] Ta \v'-1p'\*T\v'1p' .[] Lf \v'-1p'\s\nsLF\s0\v'1p' .[] Vt \v'-1p'\s\nsVT\s0\v'1p' .[] Ff \v'-1p'\s\nsFF\s0\v'1p' .[] Cr \v'-1p'\s\nsCR\s0\v'1p' .[] So \v'-1p'\s\nsSO\s0\v'1p' .[] Si \v'-1p'\s\nsSI\s0\v'1p' .[] Eb \v'-1p'\*e\v'1p' .[] Ca \v'-1p'\*C\v'1p' .[] Su \v'-1p'\*S\v'1p' .[] Es \v'-1p'\*E\v'1p' .[] Fs \v'-1p'\s\nsFS\s0\v'1p' .[] Gs \v'-1p'\s\nsGS\s0\v'1p' .[] Rs \v'-1p'\s\nsRS\s0\v'1p' .[] Us \v'-1p'\s\nsUS\s0\v'1p' .[] # # .[] (( ( .[] ) ) .[] * * .[] + + .[] 0 0 .[] 1 1 .[] 2 2 .[] 3 3 .[] 4 4 .[] 5 5 .[] 6 6 .[] 7 7 .[] 8 8 .[] 9 9 .[] : : .[] ; ; .[] = = .[] > > .[] ? ? .[] @ @ .[] A A .[] cB B .[] C C .[] D D .[] E E .[] F F .[] H H .[] J J .[] K K .[] L L .[] M M .[] N N .[] O O .[] P P .[] R R .[] S S .[] T T .[] [[ [ .[] ] ] .[] ` \` .[] a a .[] b b .[] c c .[] d d .[] f f .[] g g .[] h h .[] i i .[] j j .[] k k .[] l l .[] m m .[] n n .[] p p .[] q q .[] r r .[] s s .[] t t .[] x x .ds Cc \fIC\fP .ds Ps \fIP\v'.3m'\h'-.2m'\s-2s\s0\v'-.3m'\fP .ds Pm \fIP\v'.3m'\h'-.2m'\s-2m\s0\v'-.3m'\fP .ds Pt \fIP\v'.3m'\h'-.2m'\s-2t\s0\v'-.3m'\fP .ds Ix \fIx\fP .ds Iy \fIy\fP .ds Iw \fIw\fP .ds Ih \fIh\fP .ds Ir \fIr\fP .ds Ic \fIc\fP .nr LL 6.5i .TL Xterm Control Sequences .am NP .ds CF % .. .SH Definitions .IP \*(Cc A single (required) character. .IP \*(Ps A single (usually optional) numeric parameter, composed of one of more digits. .IP \*(Pm A multiple numeric parameter composed of any number of single numeric parameters, separated by \*; character(s). .IP \*(Pt A text parameter composed of printable characters. .SH VT102 Mode .ds RH VT102 Mode .LP Most of these control sequences are standard VT102 control sequences. There are, however, additional ones to provide control of .I xterm dependent functions, like the scrollbar or window size. .St .IP \\*(Be Bell (Ctrl-G) .IP \\*(Bs Backspace (Ctrl-H) .IP \\*(Ta Horizontal Tab (Ctrl-I) .IP \\*(Lf Line Feed or New Line (Ctrl-J) .IP \\*(Vt Vertical Tab (Ctrl-K) .IP \\*(Ff Form Feed or New Page (Ctrl-L) .IP \\*(Cr Carriage Return (Ctrl-M) .IP \\*(So Shift Out (Ctrl-N) \(-> Switch to Alternate Character Set .IP \\*(Si Shift In (Ctrl-O) \(-> Switch to Standard Character Set .IP \\*(Es\\*#\\*8 DEC Screen Alignment Test (DECALN) .IP \\*(Es\\*(((\\*(Cc Select G0 Character Set (SCS) \*(Cc = \*0 \(-> Special Character and Line Drawing Set \*(Cc = \*1 \(-> Alternate Character ROM Standard Set \*(Cc = \*2 \(-> Alternate Character ROM Special Set \*(Cc = \*A \(-> United Kingdom (UK) \*(Cc = \*(cB \(-> United States (USASCII) .IP \\*(Es\\*)\\*(Cc Select G1 Character Set (SCS) \*(Cc = \*0 \(-> Special Character and Line Drawing Set \*(Cc = \*1 \(-> Alternate Character ROM Standard Set \*(Cc = \*2 \(-> Alternate Character ROM Special Set \*(Cc = \*A \(-> United Kingdom (UK) \*(Cc = \*(cB \(-> United States (USASCII) .IP \\*(Es\\**\\*(Cc Select G2 Character Set (SCS) \*(Cc = \*0 \(-> Special Character and Line Drawing Set \*(Cc = \*1 \(-> Alternate Character ROM Standard Set \*(Cc = \*2 \(-> Alternate Character ROM Special Set \*(Cc = \*A \(-> United Kingdom (UK) \*(Cc = \*(cB \(-> United States (USASCII) .IP \\*(Es\\*+\\*(Cc Select G3 Character Set (SCS) \*(Cc = \*0 \(-> Special Character and Line Drawing Set \*(Cc = \*1 \(-> Alternate Character ROM Standard Set \*(Cc = \*2 \(-> Alternate Character ROM Special Set \*(Cc = \*A \(-> United Kingdom (UK) \*(Cc = \*(cB \(-> United States (USASCII) .IP \\*(Es\\*7 Save Cursor (DECSC) .IP \\*(Es\\*8 Restore Cursor (DECRC) .IP \\*(Es\\*= Application Keypad (DECPAM) .IP \\*(Es\\*> Normal Keypad (DECPNM) .IP \\*(Es\\*D Index (IND) .IP \\*(Es\\*E Next Line (NEL) .IP \\*(Es\\*H Tab Set (HTS) .IP \\*(Es\\*M Reverse Index (RI) .IP \\*(Es\\*N Single Shift Select of G2 Character Set (SS2) .IP \\*(Es\\*O Single Shift Select of G3 Character Set (SS3) .IP \\*(Es\\*([[\\*(Ps\|\\*@ Insert \*(Ps (Blank) Character(s) (default = 1) (ICH) .IP \\*(Es\\*([[\\*(Ps\|\\*A Cursor Up \*(Ps Times (default = 1) (CUU) .IP \\*(Es\\*([[\\*(Ps\|\\*(cB Cursor Down \*(Ps Times (default = 1) (CUD) .IP \\*(Es\\*([[\\*(Ps\|\\*C Cursor Forward \*(Ps Times (default = 1) (CUF) .IP \\*(Es\\*([[\\*(Ps\|\\*D Cursor Backward \*(Ps Times (default = 1) (CUB) .IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*H Cursor Position [row;column] (default = [1,1]) (CUP) .IP \\*(Es\\*([[\\*(Ps\|\\*J Erase in Display (ED) \*(Ps = \*0 \(-> Clear Below (default) \*(Ps = \*1 \(-> Clear Above \*(Ps = \*2 \(-> Clear All .IP \\*(Es\\*([[\\*(Ps\|\\*K Erase in Line (EL) \*(Ps = \*0 \(-> Clear to Right (default) \*(Ps = \*1 \(-> Clear to Left \*(Ps = \*2 \(-> Clear All .IP \\*(Es\\*([[\\*(Ps\|\\*L Insert \*(Ps Line(s) (default = 1) (IL) .IP \\*(Es\\*([[\\*(Ps\|\\*M Delete \*(Ps Line(s) (default = 1) (DL) .IP \\*(Es\\*([[\\*(Ps\|\\*P Delete \*(Ps Character(s) (default = 1) (DCH) .IP \\*(Es\\*([[\\*(Ps\|\\*c Device Atrributes (DA1) .IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*f Cursor Position [row;column] (default = [1,1]) (HVP) .IP \\*(Es\\*([[\\*(Ps\|\\*g Tab Clear \*(Ps = \*0 \(-> Clear Current Column (default) \*(Ps = \*3 \(-> Clear All .IP \\*(Es\\*([[\\*(Ps\|\\*h Mode Set (SET) \*(Ps = \*4 \(-> Insert Mode (IRM) \*(Ps = \*2\*0 \(-> Automatic Linefeed (LNM) .IP \\*(Es\\*([[\\*(Ps\|\\*l Mode Reset (RST) \*(Ps = \*4 \(-> Insert Mode (IRM) \*(Ps = \*2\*0 \(-> Automatic Linefeed (LNM) .IP \\*(Es\\*([[\\*(Pm\|\\*m Character Attributes (SGR) \*(Ps = \*0 \(-> Normal (default) \*(Ps = \*1 \(-> Blink (appears as Bold) \*(Ps = \*4 \(-> Underscore \*(Ps = \*5 \(-> Bold \*(Ps = \*7 \(-> Inverse .IP \\*(Es\\*([[\\*(Ps\|\\*n Device Status Report (DSR) \*(Ps = 5 \(-> Status Report \*(Es\*([[\*0\*n \(-> OK \*(Ps = 6 \(-> Report Cursor Position (CPR) [row;column] as \*(Es\*([[\*(Ir\|\*;\*(Ic\|\*R .IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*r Set Scrolling Region [top;bottom] (default = full size of window) (DECSTBM) .IP \\*(Es\\*([[\\*(Pm\|\\*t Sun TTY Emulation \*(Pm = \*3\*;\*(Ix\|\*;\*(Iy \(-> Move Window to (\*(Ix, \*(Iy) \*(Pm = \*4\*;\*(Iw\|\*;\*(Ih \(-> Resize Window, Width \*(Iw, Height \*(Ih in Pixels \*(Pm = \*5 \(-> Raise Window \*(Pm = \*6 \(-> Lower Window \*(Pm = \*7 \(-> Redraw Window \*(Pm = \*8\*;\*(Ir\|\*;\*(Ic \(-> Resize Window, \*(Ir Rows, \*(Ic Columns \*(Pm = \*1\*3 \(-> Send Window Position as \*(Es\*([[\*3\*;\*(Ix\|\*;\*(Iy\|\*t \*(Pm = \*1\*4 \(-> Send Window Size in Pixels as \*(Es\*([[\*4\*;\*(Iw\|\*;\*(Ih\|\*t \*(Pm = \*1\*8 \(-> Send Window Size in Rows and Columns as \*(Es\*([[\*8\*;\*(Ir\|\*;\*(Ic\|\*t .IP \\*(Es\\*([[\\*(Ps\|\\*x Request Terminal Parameters (DECREQTPARM) .IP \\*(Es\\*([[\\*?\\*E Erase Status Line .IP \\*(Es\\*([[\\*?\\*F Return from Status Line .IP \\*(Es\\*([[\\*?\\*H Hide Status Line .IP \\*(Es\\*([[\\*?\\*S Show Status Line .IP \\*(Es\\*([[\\*?\\*(Ps\|\\*T Go To Column \*(Ps of Status Line .IP \\*(Es\\*([[\\*?\\*(Ps\|\\*h DEC Private Mode Set (DECSET) \*(Ps = \*1 \(-> Application Cursor Keys (DECCKM) \*(Ps = \*3 \(-> 132 Column Mode (DECCOLM) \*(Ps = \*4 \(-> Smooth (Slow) Scroll (DECSCLM) \*(Ps = \*5 \(-> Reverse Video (DECSCNM) \*(Ps = \*6 \(-> Origin Mode (DECOM) \*(Ps = \*7 \(-> Wraparound Mode (DECAWM) \*(Ps = \*8 \(-> Auto-repeat Keys (DECARM) \*(Ps = \*9 \(-> Send MIT Mouse Row & Column on Button Press \*(Ps = \*3\*8 \(-> Enter TekTronix Mode (DECTEK) \*(Ps = \*4\*0 \(-> Allow 80 \z\(<-\(-> 132 Mode \*(Ps = \*4\*1 \(-> \fIcurses\fP(5) fix \*(Ps = \*4\*2 \(-> Show Scrollbar \*(Ps = \*4\*3 \(-> Save Lines Scrolled of Top of Window \*(Ps = \*4\*4 \(-> Turn On Margin Bell \*(Ps = \*4\*5 \(-> Reverse-wraparound Mode \*(Ps = \*4\*6 \(-> Start Logging \*(Ps = \*4\*7 \(-> Use Alternate Screen Buffer \*(Ps = \*4\*8 \(-> Reverse Status Line \*(Ps = \*4\*9 \(-> Page Scroll Mode .IP \\*(Es\\*([[\\*?\\*(Ps\|\\*l DEC Private Mode Reset (DECRST) \*(Ps = \*1 \(-> Normal Cursor Keys (DECCKM) \*(Ps = \*3 \(-> 80 Column Mode (DECCOLM) \*(Ps = \*4 \(-> Jump (Fast) Scroll (DECSCLM) \*(Ps = \*5 \(-> Normal Video (DECSCNM) \*(Ps = \*6 \(-> Normal Cursor Mode (DECOM) \*(Ps = \*7 \(-> No Wraparound Mode (DECAWM) \*(Ps = \*8 \(-> No Auto-repeat Keys (DECARM) \*(Ps = \*9 \(-> Don't Send MIT Mouse Row & Column on Button Press \*(Ps = \*4\*0 \(-> Disallow 80 \z\(<-\(-> 132 Mode \*(Ps = \*4\*1 \(-> No \fIcurses\fP(5) fix \*(Ps = \*4\*2 \(-> Hide Scrollbar \*(Ps = \*4\*3 \(-> Don't Save Lines Scrolled of Top of Window \*(Ps = \*4\*4 \(-> Turn Off Margin Bell \*(Ps = \*4\*5 \(-> No Reverse-wraparound Mode \*(Ps = \*4\*6 \(-> Stop Logging \*(Ps = \*4\*7 \(-> Use Normal Screen Buffer \*(Ps = \*4\*8 \(-> Un-reverse Status Line \*(Ps = \*4\*9 \(-> Normal Scroll Mode .IP \\*(Es\\*([[\\*?\\*(Ps\|\\*r Restore DEC Private Mode \*(Ps = \*1 \(-> Normal/Application Cursor Keys (DECCKM) \*(Ps = \*3 \(-> 80/132 Column Mode (DECCOLM) \*(Ps = \*4 \(-> Jump (Fast)/Smooth (Slow) Scroll (DECSCLM) \*(Ps = \*5 \(-> Normal/Reverse Video (DECSCNM) \*(Ps = \*6 \(-> Normal/Origin Cursor Mode (DECOM) \*(Ps = \*7 \(-> No Wraparound/Wraparound Mode (DECAWM) \*(Ps = \*8 \(-> Auto-repeat/No Auto-repeat Keys (DECARM) \*(Ps = \*9 \(-> Don't Send/Send MIT Mouse Row & Column on Button Press \*(Ps = \*4\*0 \(-> Disallow/Allow 80 \z\(<-\(-> 132 Mode \*(Ps = \*4\*1 \(-> Off/On \fIcurses\fP(5) fix \*(Ps = \*4\*2 \(-> Hide/Show Scrollbar \*(Ps = \*4\*3 \(-> Don't Save/Save Lines Scrolled of Top of Window \*(Ps = \*4\*4 \(-> Turn Off/On Margin Bell \*(Ps = \*4\*5 \(-> No Reverse-wraparound/Reverse-wraparound Mode \*(Ps = \*4\*6 \(-> Stop/Start Logging \*(Ps = \*4\*7 \(-> Use Normal/Alternate Screen Buffer \*(Ps = \*4\*8 \(-> Un-reverse/Reverse Status Line \*(Ps = \*4\*9 \(-> Normal/Page Scroll Mode .IP \\*(Es\\*([[\\*?\\*(Ps\|\\*s Save DEC Private Mode \*(Ps = \*1 \(-> Normal/Application Cursor Keys (DECCKM) \*(Ps = \*3 \(-> 80/132 Column Mode (DECCOLM) \*(Ps = \*4 \(-> Jump (Fast)/Smooth (Slow) Scroll (DECSCLM) \*(Ps = \*5 \(-> Normal/Reverse Video (DECSCNM) \*(Ps = \*6 \(-> Normal/Origin Cursor Mode (DECOM) \*(Ps = \*7 \(-> No Wraparound/Wraparound Mode (DECAWM) \*(Ps = \*8 \(-> Auto-repeat/No Auto-repeat Keys (DECARM) \*(Ps = \*9 \(-> Don't Send/Send MIT Mouse Row & Column on Button Press \*(Ps = \*4\*0 \(-> Disallow/Allow 80 \z\(<-\(-> 132 Mode \*(Ps = \*4\*1 \(-> Off/On \fIcurses\fP(5) fix \*(Ps = \*4\*2 \(-> Hide/Show Scrollbar \*(Ps = \*4\*3 \(-> Don't Save/Save Lines Scrolled of Top of Window \*(Ps = \*4\*4 \(-> Turn Off/On Margin Bell \*(Ps = \*4\*5 \(-> No Reverse-wraparound/Reverse-wraparound Mode \*(Ps = \*4\*6 \(-> Stop/Start Logging \*(Ps = \*4\*7 \(-> Use Normal/Alternate Screen Buffer \*(Ps = \*4\*8 \(-> Un-reverse/Reverse Status Line \*(Ps = \*4\*9 \(-> Normal/Page Scroll Mode .IP \\*(Es\\*]\\*(Ps\|\\*;\\*(Pt\|\\*(Be Set Text Parameters \*(Ps = \*0 \(-> Change Window Name and Title to \*(Pt \*(Ps = \*4\*6 \(-> Change Log File to \*(Pt .IP \\*(Es\\*c Full Reset (RIS) .Ed .SH Tektronix 4015 Mode .ds RH Tektronix 4015 Mode .LP Most of these sequences are standard Tektronix 4015 control sequences. The major features missing are the alternate (APL) character set and the write-thru and defocused modes. .St .IP \\*(Be Bell (Ctrl-G) .IP \\*(Bs Backspace (Ctrl-H) .IP \\*(Ta Horizontal Tab (Ctrl-I) .IP \\*(Lf Line Feed or New Line (Ctrl-J) .IP \\*(Vt Vertical Tab (Ctrl-K) .IP \\*(Ff Form Feed or New Page (Ctrl-L) .IP \\*(Cr Carriage Return (Ctrl-M) .IP \\*(Es\\*(Et Switch to VT102 Mode .IP \\*(Es\\*(En Return Terminal Status .IP \\*(Es\\*(Lf PAGE (Clear Screen) .IP \\*(Es\\*(Eb COPY (Save Tektronix Codes to File) .IP \\*(Es\\*(Ca Bypass Condition .IP \\*(Es\\*(Su GIN mode .IP \\*(Es\\*(Fs Special Point Plot Mode .IP \\*(Es\\*(Gs Graph Mode (same as \*(Gs) .IP \\*(Es\\*(Rs Incremental Plot Mode (same as \*(Rs) .IP \\*(Es\\*(Us Alpha Mode (same as \*(Us) .IP \\*(Es\\*8 Select Large Character Set .IP \\*(Es\\*9 Select #2 Character Set .IP \\*(Es\\*: Select #3 Character Set .IP \\*(Es\\*; Select Small Character Set .IP \\*(Es\\*]\\*(Ps\|\\*;\\*(Pt\|\\*(Be Set Text Parameters \*(Ps = \*0 \(-> Change Window Name and Title to \*(Pt \*(Ps = \*4\*6 \(-> Change Log File to \*(Pt .IP \\*(Es\\*` Normal Z Axis and Normal (solid) Vectors .IP \\*(Es\\*a Normal Z Axis and Dotted Line Vectors .IP \\*(Es\\*b Normal Z Axis and Dot-Dashed Vectors .IP \\*(Es\\*c Normal Z Axis and Short-Dashed Vectors .IP \\*(Es\\*d Normal Z Axis and Long-Dashed Vectors .IP \\*(Es\\*h Defocused Z Axis and Normal (solid) Vectors .IP \\*(Es\\*i Defocused Z Axis and Dotted Line Vectors .IP \\*(Es\\*j Defocused Z Axis and Dot-Dashed Vectors .IP \\*(Es\\*k Defocused Z Axis and Short-Dashed Vectors .IP \\*(Es\\*l Defocused Z Axis and Long-Dashed Vectors .IP \\*(Es\\*p Write-Thru Mode and Normal (solid) Vectors .IP \\*(Es\\*q Write-Thru Mode and Dotted Line Vectors .IP \\*(Es\\*r Write-Thru Mode and Dot-Dashed Vectors .IP \\*(Es\\*s Write-Thru Mode and Short-Dashed Vectors .IP \\*(Es\\*t Write-Thru Mode and Long-Dashed Vectors .IP \\*(Fs Point Plot Mode .IP \\*(Gs Graph Mode .IP \\*(Rs Incremental Plot Mode .IP \\*(Us Alpha Mode .Ed -- Dominick Samperi -- ESCC samperi@marob.masa.com uunet!hombre!samperi
bob@tinman.cis.ohio-state.edu (Bob Sutterfield) (09/11/89)
In article <250B1A9D.11D7@marob.masa.com> samperi@marob.masa.com (Dominick Samperi) writes:
In response to many requests, here is the document describing the
xterm control sequences. Many thanks go to P. Allen Jensen for
locating it, and to Edward Moy for writing it!
This is still the X10R4 doc, which was already available as
expo.lcs.mit.edu:contrib/Control.doc.Z and
osu-cis!~/X.V11R3/contrib/Control.doc.Z. The world still needs for it
to be updated to correspond to X11's xterm, where they differ.guy@auspex.auspex.com (Guy Harris) (09/13/89)
>The world still needs for it to be updated to correspond to X11's xterm, >where they differ. Well, that's *this* month's "it needs to be updated to X11 posting".... Unfortunately, it's like the weather; everybody talks about it, but nobody does anything about it. Here is a version that's a start at it, generated by checking the code and trying a number of the apparent differences. Note: 1) I don't guarantee that this is 100% correct. I tried most of the things that seemed to be different, and this document reflects what I saw. Stuff that appears to be in the X10R4 document and missing from this document is so because it appears not to be present in the X11 version of "xterm" (e.g., the "Alternate Character ROM" character sets and the Sun TTY emulation). 2) It is definitely not 100% complete; some escape sequences that do something that's either unobservable - at least in the current state of the code - or not useful aren't documented. An example of the former are the Locking Shift sequences that modify the interpretation of the GR characters; at present, it sets a state variable that's unused, but perhaps some future version will use it (perhaps for displaying characters in the range 0200-0377?). An example of the latter is the sequence to set DECANM mode (ANSI/VT52 mode): it doesn't do what it does on a VT100, namely get the terminal to emulate a VT100, it only seems to fiddle the current character set a bit. 3) It doesn't document any of the mouse-related stuff, such as what the "Track Mouse" escape sequence does, or what the different mouse modes (MIT, VT220, "VT220 Hilite") do; I leave that to somebody familiar with that part of the code.... 4) I'm not supporting this document, I just did this as a one-shot to start the ball rolling. If anybody has fixes, or other improvements, post your fixed version, or otherwise make it publicly available; don't send the fixes to me. #! /bin/sh # This is a shell archive. Remove anything before this line, then unpack # it by saving it into a file and typing "sh file". To overwrite existing # files, type "sh file -c". You can also feed this as standard input via # unshar, or by typing "sh <file", e.g.. If this archive is complete, you # will see the following message at the end: # "End of shell archive." # Contents: xterm-cs.ms # Wrapped by guy@auspex on Tue Sep 12 10:11:23 1989 PATH=/bin:/usr/bin:/usr/ucb ; export PATH if test -f 'xterm-cs.ms' -a "${1}" != "-c" ; then echo shar: Will not clobber existing file \"'xterm-cs.ms'\" else echo shar: Extracting \"'xterm-cs.ms'\" \(13447 characters\) sed "s/^X//" >'xterm-cs.ms' <<'END_OF_FILE' X.\"#! troff -Q -ms $1 X.\" This is the "Xterm Control Sequences" document, written by X.\" Edward Moy X.\" Academic Computing Services X.\" University of California X.\" Berkeley, CA 94720 X.\" X.\" edmoy@opal.Berkeley.EDU X.\" ucbvax!opal!edmoy X.\" X.\" Run this file through troff and use the -ms macro package. X.ND X.de St X.sp X.nr PD 0 X.nr PI 1.5i X.nr VS 16 X.. X.de Ed X.nr PD .3v X.nr VS 12 X.. X.rm CH X.ds LH Xterm Control Sequences X.nr s 6*\n(PS/10 X.ds L \s\nsBEL\s0 X.ds E \s\nsESC\s0 X.ds T \s\nsTAB\s0 X.ds X \s\nsETX\s0 X.ds N \s\nsENQ\s0 X.ds e \s\nsETB\s0 X.ds C \s\nsCAN\s0 X.ds S \s\nsSUB\s0 X.nr [W \w'\*L'u X.nr w \w'\*E'u X.if \nw>\n([W .nr [W \nw X.nr w \w'\*T'u X.if \nw>\n([W .nr [W \nw X.nr w \w'\*X'u X.if \nw>\n([W .nr [W \nw X.nr w \w'\*N'u X.if \nw>\n([W .nr [W \nw X.nr w \w'\*e'u X.if \nw>\n([W .nr [W \nw X.nr w \w'\*C'u X.if \nw>\n([W .nr [W \nw X.nr w \w'\*S'u X.if \nw>\n([W .nr [W \nw X.nr [W +\w'\|\|'u X.de [] X.nr w \w'\\$2' X.nr H \\n([Wu-\\nwu X.nr h \\nHu/2u X.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'\| X.. X.[] Et \v'-1p'\*X\v'1p' X.[] En \v'-1p'\*N\v'1p' X.[] Be \v'-1p'\*L\v'1p' X.[] Bs \v'-1p'\s\nsBS\s0\v'1p' X.[] Ta \v'-1p'\*T\v'1p' X.[] Lf \v'-1p'\s\nsLF\s0\v'1p' X.[] Vt \v'-1p'\s\nsVT\s0\v'1p' X.[] Ff \v'-1p'\s\nsFF\s0\v'1p' X.[] Cr \v'-1p'\s\nsCR\s0\v'1p' X.[] So \v'-1p'\s\nsSO\s0\v'1p' X.[] Si \v'-1p'\s\nsSI\s0\v'1p' X.[] Eb \v'-1p'\*e\v'1p' X.[] Ca \v'-1p'\*C\v'1p' X.[] Su \v'-1p'\*S\v'1p' X.[] Es \v'-1p'\*E\v'1p' X.[] Fs \v'-1p'\s\nsFS\s0\v'1p' X.[] Gs \v'-1p'\s\nsGS\s0\v'1p' X.[] Rs \v'-1p'\s\nsRS\s0\v'1p' X.[] Us \v'-1p'\s\nsUS\s0\v'1p' X.[] # # X.[] (( ( X.[] ) ) X.[] * * X.[] + + X.[] 0 0 X.[] 1 1 X.[] 2 2 X.[] 3 3 X.[] 4 4 X.[] 5 5 X.[] 6 6 X.[] 7 7 X.[] 8 8 X.[] 9 9 X.[] : : X.[] ; ; X.[] = = X.[] > > X.[] ? ? X.[] @ @ X.[] A A X.[] cB B X.[] C C X.[] D D X.[] E E X.[] F F X.[] H H X.[] J J X.[] K K X.[] L L X.[] M M X.[] N N X.[] O O X.[] P P X.[] R R X.[] S S X.[] T T X.[] Z Z X.[] [[ [ X.[] ] ] X.[] ` \` X.[] a a X.[] b b X.[] c c X.[] d d X.[] f f X.[] g g X.[] h h X.[] i i X.[] j j X.[] k k X.[] l l X.[] m m X.[] n n X.[] o o X.[] p p X.[] q q X.[] r r X.[] s s X.[] t t X.[] x x X.[] | | X.[] } } X.[] c~ ~ X.ds Cc \fIC\fP X.ds Ps \fIP\v'.3m'\h'-.2m'\s-2s\s0\v'-.3m'\fP X.ds Pm \fIP\v'.3m'\h'-.2m'\s-2m\s0\v'-.3m'\fP X.ds Pt \fIP\v'.3m'\h'-.2m'\s-2t\s0\v'-.3m'\fP X.ds Ix \fIx\fP X.ds Iy \fIy\fP X.ds Iw \fIw\fP X.ds Ih \fIh\fP X.ds Ir \fIr\fP X.ds Ic \fIc\fP X.nr LL 6.5i X.TL XXterm Control Sequences X.am NP X.ds CF % X.. X.SH XDefinitions X.IP \*(Cc XA single (required) character. X.IP \*(Ps XA single (usually optional) numeric parameter, composed of one of more digits. X.IP \*(Pm XA multiple numeric parameter composed of any number of single numeric Xparameters, separated by \*; character(s). X.IP \*(Pt XA text parameter composed of printable characters. X.SH XVT102 Mode X.ds RH VT102 Mode X.LP XMost of these control sequences are standard VT102 control sequences. XThere are, however, additional ones to provide control of X.I xterm Xdependent functions, like the scrollbar or window size. X.St X.IP \\*(Be XBell (Ctrl-G) X.IP \\*(Bs XBackspace (Ctrl-H) X.IP \\*(Ta XHorizontal Tab (Ctrl-I) X.IP \\*(Lf XLine Feed or New Line (Ctrl-J) X.IP \\*(Vt XVertical Tab (Ctrl-K) X.IP \\*(Ff XForm Feed or New Page (Ctrl-L) X.IP \\*(Cr XCarriage Return (Ctrl-M) X.IP \\*(So XShift Out (Ctrl-N) \(-> Switch to Alternate Character Set X.IP \\*(Si XShift In (Ctrl-O) \(-> Switch to Standard Character Set X.IP \\*(Es\\*#\\*8 XDEC Screen Alignment Test (DECALN) X.IP \\*(Es\\*(((\\*(Cc XSelect G0 Character Set (SCS) X \*(Cc = \*0 \(-> Special Character and Line Drawing Set X \*(Cc = \*A \(-> United Kingdom (UK) X \*(Cc = \*(cB \(-> United States (USASCII) X.IP \\*(Es\\*)\\*(Cc XSelect G1 Character Set (SCS) X \*(Cc = \*0 \(-> Special Character and Line Drawing Set X \*(Cc = \*A \(-> United Kingdom (UK) X \*(Cc = \*(cB \(-> United States (USASCII) X.IP \\*(Es\\**\\*(Cc XSelect G2 Character Set (SCS) X \*(Cc = \*0 \(-> Special Character and Line Drawing Set X \*(Cc = \*A \(-> United Kingdom (UK) X \*(Cc = \*(cB \(-> United States (USASCII) X.IP \\*(Es\\*+\\*(Cc XSelect G3 Character Set (SCS) X \*(Cc = \*0 \(-> Special Character and Line Drawing Set X \*(Cc = \*A \(-> United Kingdom (UK) X \*(Cc = \*(cB \(-> United States (USASCII) X.IP \\*(Es\\*7 XSave Cursor (DECSC) X.IP \\*(Es\\*8 XRestore Cursor (DECRC) X.IP \\*(Es\\*= XApplication Keypad (DECPAM) X.IP \\*(Es\\*> XNormal Keypad (DECPNM) X.IP \\*(Es\\*D XIndex (IND) X.IP \\*(Es\\*E XNext Line (NEL) X.IP \\*(Es\\*H XTab Set (HTS) X.IP \\*(Es\\*M XReverse Index (RI) X.IP \\*(Es\\*N XSingle Shift Select of G2 Character Set (SS2) X.IP \\*(Es\\*O XSingle Shift Select of G3 Character Set (SS3) X.IP \\*(Es\\*Z XReturn Terminal ID (DECID) X.IP \\*(Es\\*([[\\*(Ps\|\\*@ XInsert \*(Ps (Blank) Character(s) (default = 1) (ICH) X.IP \\*(Es\\*([[\\*(Ps\|\\*A XCursor Up \*(Ps Times (default = 1) (CUU) X.IP \\*(Es\\*([[\\*(Ps\|\\*(cB XCursor Down \*(Ps Times (default = 1) (CUD) X.IP \\*(Es\\*([[\\*(Ps\|\\*C XCursor Forward \*(Ps Times (default = 1) (CUF) X.IP \\*(Es\\*([[\\*(Ps\|\\*D XCursor Backward \*(Ps Times (default = 1) (CUB) X.IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*H XCursor Position [row;column] (default = [1,1]) (CUP) X.IP \\*(Es\\*([[\\*(Ps\|\\*J XErase in Display (ED) X \*(Ps = \*0 \(-> Clear Below (default) X \*(Ps = \*1 \(-> Clear Above X \*(Ps = \*2 \(-> Clear All X.IP \\*(Es\\*([[\\*(Ps\|\\*K XErase in Line (EL) X \*(Ps = \*0 \(-> Clear to Right (default) X \*(Ps = \*1 \(-> Clear to Left X \*(Ps = \*2 \(-> Clear All X.IP \\*(Es\\*([[\\*(Ps\|\\*L XInsert \*(Ps Line(s) (default = 1) (IL) X.IP \\*(Es\\*([[\\*(Ps\|\\*M XDelete \*(Ps Line(s) (default = 1) (DL) X.IP \\*(Es\\*([[\\*(Ps\|\\*P XDelete \*(Ps Character(s) (default = 1) (DCH) X.IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*;\\*(Ps\|\\*;\\*(Ps\|\\*;\\*(Ps\|\\*T XTrack Mouse [func;startcol;startrow;firstrow;lastrow] XXX - describe X.IP \\*(Es\\*([[\\*(Ps\|\\*c XDevice Attributes (default 0) (DA) X.IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*f XHorizontal and Vertical Position [row;column] (default = [1,1]) (HVP) X.IP \\*(Es\\*([[\\*(Ps\|\\*g XTab Clear X \*(Ps = \*0 \(-> Clear Current Column (default) X \*(Ps = \*3 \(-> Clear All X.IP \\*(Es\\*([[\\*(Ps\|\\*h XMode Set (SET) X \*(Ps = \*4 \(-> Insert Mode (IRM) X \*(Ps = \*2\*0 \(-> Automatic Linefeed (LNM) X.IP \\*(Es\\*([[\\*(Ps\|\\*l XMode Reset (RST) X \*(Ps = \*4 \(-> Insert Mode (IRM) X \*(Ps = \*2\*0 \(-> Automatic Linefeed (LNM) X.IP \\*(Es\\*([[\\*(Pm\|\\*m XCharacter Attributes (SGR) X \*(Ps = \*0 \(-> Normal (default) X \*(Ps = \*1 \(-> Blink (appears as Bold) X \*(Ps = \*4 \(-> Underscore X \*(Ps = \*5 \(-> Bold X \*(Ps = \*7 \(-> Inverse X.IP \\*(Es\\*([[\\*(Ps\|\\*n XDevice Status Report (DSR) X \*(Ps = 5 \(-> Status Report \*(Es\*([[\*0\*n \(-> OK X \*(Ps = 6 \(-> Report Cursor Position (CPR) [row;column] as X\*(Es\*([[\*(Ir\|\*;\*(Ic\|\*R X.IP \\*(Es\\*([[\\*(Ps\|\\*;\\*(Ps\|\\*r XSet Scrolling Region [top;bottom] (default = full size of window) (DECSTBM) X.IP \\*(Es\\*([[\\*(Ps\|\\*x XRequest Terminal Parameters (DECREQTPARM) X.IP \\*(Es\\*([[\\*?\\*(Ps\|\\*h XDEC Private Mode Set (DECSET) X \*(Ps = \*1 \(-> Application Cursor Keys (DECCKM) X \*(Ps = \*3 \(-> 132 Column Mode (DECCOLM) X \*(Ps = \*4 \(-> Smooth (Slow) Scroll (DECSCLM) X \*(Ps = \*5 \(-> Reverse Video (DECSCNM) X \*(Ps = \*6 \(-> Origin Mode (DECOM) X \*(Ps = \*7 \(-> Wraparound Mode (DECAWM) X \*(Ps = \*8 \(-> Auto-repeat Keys (DECARM) X \*(Ps = \*9 \(-> Send MIT Mouse Row & Column on Button Press X \*(Ps = \*3\*8 \(-> Enter Tektronix Mode (DECTEK) X \*(Ps = \*4\*0 \(-> Allow 80 \z\(<-\(-> 132 Mode X \*(Ps = \*4\*1 \(-> \fIcurses\fP(5) fix X \*(Ps = \*4\*4 \(-> Turn On Margin Bell X \*(Ps = \*4\*5 \(-> Reverse-wraparound Mode X \*(Ps = \*4\*6 \(-> Start Logging X \*(Ps = \*4\*7 \(-> Use Alternate Screen Buffer X \*(Ps = \*1\*0\*0\*0 \(-> Send VT200 Mouse Row & Column on Button Press X \*(Ps = \*1\*0\*0\*3 \(-> Send VT200 Hilite Mouse Row & Column on Button Press X.IP \\*(Es\\*([[\\*?\\*(Ps\|\\*l XDEC Private Mode Reset (DECRST) X \*(Ps = \*1 \(-> Normal Cursor Keys (DECCKM) X \*(Ps = \*3 \(-> 80 Column Mode (DECCOLM) X \*(Ps = \*4 \(-> Jump (Fast) Scroll (DECSCLM) X \*(Ps = \*5 \(-> Normal Video (DECSCNM) X \*(Ps = \*6 \(-> Normal Cursor Mode (DECOM) X \*(Ps = \*7 \(-> No Wraparound Mode (DECAWM) X \*(Ps = \*8 \(-> No Auto-repeat Keys (DECARM) X \*(Ps = \*9 \(-> Don't Send Mouse Row & Column on Button Press X \*(Ps = \*4\*0 \(-> Disallow 80 \z\(<-\(-> 132 Mode X \*(Ps = \*4\*1 \(-> No \fIcurses\fP(5) fix X \*(Ps = \*4\*4 \(-> Turn Off Margin Bell X \*(Ps = \*4\*5 \(-> No Reverse-wraparound Mode X \*(Ps = \*4\*6 \(-> Stop Logging X \*(Ps = \*4\*7 \(-> Use Normal Screen Buffer X \*(Ps = \*1\*0\*0\*0 \(-> Don't Send Mouse Row & Column on Button Press X \*(Ps = \*1\*0\*0\*3 \(-> Don't Send Mouse Row & Column on Button Press X.IP \\*(Es\\*([[\\*?\\*(Ps\|\\*r XRestore DEC Private Mode X \*(Ps = \*1 \(-> Normal/Application Cursor Keys (DECCKM) X \*(Ps = \*3 \(-> 80/132 Column Mode (DECCOLM) X \*(Ps = \*4 \(-> Jump (Fast)/Smooth (Slow) Scroll (DECSCLM) X \*(Ps = \*5 \(-> Normal/Reverse Video (DECSCNM) X \*(Ps = \*6 \(-> Normal/Origin Cursor Mode (DECOM) X \*(Ps = \*7 \(-> No Wraparound/Wraparound Mode (DECAWM) X \*(Ps = \*8 \(-> Auto-repeat/No Auto-repeat Keys (DECARM) X \*(Ps = \*9 \(-> Don't Send/Send MIT Mouse Row & Column on Button Press X \*(Ps = \*4\*0 \(-> Disallow/Allow 80 \z\(<-\(-> 132 Mode X \*(Ps = \*4\*1 \(-> Off/On \fIcurses\fP(5) fix X \*(Ps = \*4\*4 \(-> Turn Off/On Margin Bell X \*(Ps = \*4\*5 \(-> No Reverse-wraparound/Reverse-wraparound Mode X \*(Ps = \*4\*6 \(-> Stop/Start Logging X \*(Ps = \*4\*7 \(-> Use Normal/Alternate Screen Buffer X \*(Ps = \*1\*0\*0\*0 \(-> Don't Send/Send VT220 Mouse Row & Column on Button Press X \*(Ps = \*1\*0\*0\*3 \(-> Don't Send/Send VT220 Hilite Mouse Row & Column on Button Press X.IP \\*(Es\\*([[\\*?\\*(Ps\|\\*s XSave DEC Private Mode X \*(Ps = \*1 \(-> Normal/Application Cursor Keys (DECCKM) X \*(Ps = \*3 \(-> 80/132 Column Mode (DECCOLM) X \*(Ps = \*4 \(-> Jump (Fast)/Smooth (Slow) Scroll (DECSCLM) X \*(Ps = \*5 \(-> Normal/Reverse Video (DECSCNM) X \*(Ps = \*6 \(-> Normal/Origin Cursor Mode (DECOM) X \*(Ps = \*7 \(-> No Wraparound/Wraparound Mode (DECAWM) X \*(Ps = \*8 \(-> Auto-repeat/No Auto-repeat Keys (DECARM) X \*(Ps = \*9 \(-> Don't Send/Send MIT Mouse Row & Column on Button Press X \*(Ps = \*4\*0 \(-> Disallow/Allow 80 \z\(<-\(-> 132 Mode X \*(Ps = \*4\*1 \(-> Off/On \fIcurses\fP(5) fix X \*(Ps = \*4\*4 \(-> Turn Off/On Margin Bell X \*(Ps = \*4\*5 \(-> No Reverse-wraparound/Reverse-wraparound Mode X \*(Ps = \*4\*6 \(-> Stop/Start Logging X \*(Ps = \*4\*7 \(-> Use Normal/Alternate Screen Buffer X \*(Ps = \*1\*0\*0\*0 \(-> Don't Send/Send VT220 Mouse Row & Column on Button Press X \*(Ps = \*1\*0\*0\*3 \(-> Don't Send/Send VT220 Hilite Mouse Row & Column on Button Press X.IP \\*(Es\\*]\\*(Ps\|\\*;\\*(Pt\|\\*(Be XSet Text Parameters X \*(Ps = \*0 \(-> Change Icon Name and Window Title to \*(Pt X \*(Ps = \*1 \(-> Change Icon Name to \*(Pt X \*(Ps = \*2 \(-> Change Window Title to \*(Pt X \*(Ps = \*4\*6 \(-> Change Log File to \*(Pt X.IP \\*(Es\\*c XFull Reset (RIS) X.IP \\*(Es\\*n XLocking Shift Select of G2 Character Set (LS2) X.IP \\*(Es\\*o XLocking Shift Select of G3 Character Set (LS3) X.Ed X.SH XTektronix 4015 Mode X.ds RH Tektronix 4015 Mode X.LP XMost of these sequences are standard Tektronix 4015 control sequences. XThe major features missing are the alternate (APL) character set and Xthe write-thru and defocused modes. X.St X.IP \\*(Be XBell (Ctrl-G) X.IP \\*(Bs XBackspace (Ctrl-H) X.IP \\*(Ta XHorizontal Tab (Ctrl-I) X.IP \\*(Lf XLine Feed or New Line (Ctrl-J) X.IP \\*(Vt XVertical Tab (Ctrl-K) X.IP \\*(Ff XForm Feed or New Page (Ctrl-L) X.IP \\*(Cr XCarriage Return (Ctrl-M) X.IP \\*(Es\\*(Et XSwitch to VT102 Mode X.IP \\*(Es\\*(En XReturn Terminal Status X.IP \\*(Es\\*(Lf XPAGE (Clear Screen) X.IP \\*(Es\\*(Eb XCOPY (Save Tektronix Codes to File) X.IP \\*(Es\\*(Ca XBypass Condition X.IP \\*(Es\\*(Su XGIN mode X.IP \\*(Es\\*(Fs XSpecial Point Plot Mode X.IP \\*(Es\\*(Gs XGraph Mode (same as \*(Gs) X.IP \\*(Es\\*(Rs XIncremental Plot Mode (same as \*(Rs) X.IP \\*(Es\\*(Us XAlpha Mode (same as \*(Us) X.IP \\*(Es\\*8 XSelect Large Character Set X.IP \\*(Es\\*9 XSelect #2 Character Set X.IP \\*(Es\\*: XSelect #3 Character Set X.IP \\*(Es\\*; XSelect Small Character Set X.IP \\*(Es\\*]\\*(Ps\|\\*;\\*(Pt\|\\*(Be XSet Text Parameters X \*(Ps = \*0 \(-> Change Icon Name and Window Title to \*(Pt X \*(Ps = \*1 \(-> Change Icon Name to \*(Pt X \*(Ps = \*2 \(-> Change Window Title to \*(Pt X \*(Ps = \*4\*6 \(-> Change Log File to \*(Pt X.IP \\*(Es\\*` XNormal Z Axis and Normal (solid) Vectors X.IP \\*(Es\\*a XNormal Z Axis and Dotted Line Vectors X.IP \\*(Es\\*b XNormal Z Axis and Dot-Dashed Vectors X.IP \\*(Es\\*c XNormal Z Axis and Short-Dashed Vectors X.IP \\*(Es\\*d XNormal Z Axis and Long-Dashed Vectors X.IP \\*(Es\\*h XDefocused Z Axis and Normal (solid) Vectors X.IP \\*(Es\\*i XDefocused Z Axis and Dotted Line Vectors X.IP \\*(Es\\*j XDefocused Z Axis and Dot-Dashed Vectors X.IP \\*(Es\\*k XDefocused Z Axis and Short-Dashed Vectors X.IP \\*(Es\\*l XDefocused Z Axis and Long-Dashed Vectors X.IP \\*(Es\\*p XWrite-Thru Mode and Normal (solid) Vectors X.IP \\*(Es\\*q XWrite-Thru Mode and Dotted Line Vectors X.IP \\*(Es\\*r XWrite-Thru Mode and Dot-Dashed Vectors X.IP \\*(Es\\*s XWrite-Thru Mode and Short-Dashed Vectors X.IP \\*(Es\\*t XWrite-Thru Mode and Long-Dashed Vectors X.IP \\*(Fs XPoint Plot Mode X.IP \\*(Gs XGraph Mode X.IP \\*(Rs XIncremental Plot Mode X.IP \\*(Us XAlpha Mode X.Ed END_OF_FILE if test 13447 -ne `wc -c <'xterm-cs.ms'`; then echo shar: \"'xterm-cs.ms'\" unpacked with wrong size! fi # end of 'xterm-cs.ms' fi echo shar: End of shell archive. exit 0