-------------------------------------------------------------------------- Eterm Technical Reference -------------------------------------------------------------------------- Reworked from XTerm documentation and from other sources Definitions c The literal character c. C A single (required) character. Ps A single (usually optional) numeric parameter, composed of one or more digits. Pm A multiple numeric parameter composed of any number of single numeric parameters, separated by ; character(s). Pt A text parameter composed of printable characters. [-] marks unimplemented sequences [*] marks Eterm-specific (non-ANSI/ISO) sequences -------------------------------------------------------------------------- ENQ Enquiry (Ctrl-E), Send Device Attributes (DA) -> request attributes from terminal -> ESC[?1;2c (``I am a VT100 with Advanced Video Option.'') BEL Bell (Ctrl-G) BS Backspace (Ctrl-H) TAB Horizontal Tab (HT) (Ctrl-I) LF Line Feed or New Line (NL) (Ctrl-J) VT Vertical Tab (Ctrl-K) same as LF FF Form Feed or New Page (NP) (Ctrl-L) same as LF CR Carriage Return (Ctrl-M) SO Shift Out (Ctrl-N), invokes the G1 character set -> Switch to Alternate Character Set SI Shift In (Ctrl-O), invokes the G0 character set (the default) -> Switch to Standard Character Set SPC Space Character ESC # 8 DEC Screen Alignment Test (DECALN) Character Sets -------------------------------------------------------------------------- ESC ( C Designate G0 Character Set (ISO 2022) ESC ) C Designate G1 Character Set (ISO 2022) ESC * C Designate G2 Character Set (ISO 2022) ESC + C Designate G3 Character Set (ISO 2022) ESC $ C Designate Kanji Character Set where C = 0 -> DEC Special Character and Line Drawing Set C = A -> United Kingdom (UK) C = B -> United States (USASCII) [-] C = < -> Multinational character set [-] C = 5 -> Finnish character set [-] C = C -> Finnish character set [-] C = K -> German character set ESC 7 Save Cursor (SC) ESC 8 Restore Cursor (RC) ESC = Application Keypad (SMKX) ESC > Normal Keypad (RMKX) - If the numeric keypad is activated, e.g. Num_Lock has been pressed, numbers or control functions are generated by the numeric keypad (see Key Codes section) ESC D Index (IND) ESC E Next Line (NEL) ESC H Tab Set (HTS) ESC M Reverse Index (RI) [-] ESC N Single Shift Select of G2 Character Set (SS2): affects next character only [-] ESC O Single Shift Select of G3 Character Set (SS3): affects next character only ESC Z Obsolete form of ESC [ c Optional (compile-time) returns -> ESC[?1;2C ESC [ Ps @ Insert Ps (Blank) Character(s) [default: 1] (ICH) ESC [ Ps A Cursor Up Ps Times [default: 1] (CUU) ESC [ Ps B Cursor Down Ps Times [default: 1] (CUD) ESC [ Ps C Cursor Forward Ps Times [default: 1] (CUF) ESC [ Ps D Cursor Backward Ps Times [default: 1] (CUB) ESC [ Ps E Cursor Down Ps Times [default: 1] and to first column ESC [ Ps F Cursor Up Ps Times [default: 1] and to first column ESC [ Ps G Cursor to Column Ps (HPA) ESC [ Ps;Ps H Cursor Position [row;column] [default: 1;1] (CUP) ESC [ Ps I Move forward Ps [default: 1] tab stops ESC [ Ps J Erase in Display (ED) Ps = 0 -> Clear Below (default) Ps = 1 -> Clear Above Ps = 2 -> Clear All ESC [ Ps K Erase in Line (EL) Ps = 0 -> Clear to Right (default) Ps = 1 -> Clear to Left (EL1) Ps = 2 -> Clear All ESC [ Ps L Insert Ps Line(s) [default: 1] (IL) ESC [ Ps M Delete Ps Line(s) [default: 1] (DL) ESC [ Ps P Delete Ps Character(s) [default: 1] (DCH) [-] ESC [ Ps;Ps;Ps;Ps;Ps T Initiate hilite mouse tracking. Parameters are [func;startx;starty;firstrow;lastrow]. See the section Mouse Tracking. ESC [ Ps W Tabulator functions Ps = 0 -> Tab Set (HTS) Ps = 2 -> Tab Clear (TBC), Clear Current Column (default) Ps = 5 -> Tab Clear (TBC), Clear All ESC [ Ps X Erase Ps Character(s) [default: 1] (ECH) ESC [ Ps Z Move backward Ps [default: 1] tab stops ESC [ PS ` == ESC [ PS G ESC [ Ps a == ESC [ Ps C ESC [ Ps c Send Device Attributes (DA) Ps = 0 or omitted -> request attributes from terminal -> ESC[?1;2c (``I am a VT100 with Advanced Video Option.'') ESC [ Ps d Cursor to Line Ps (VPA) ESC [ Ps e == ESC [ Ps A ESC [ Ps;Ps f Horizontal and Vertical Position [row;column] [default: 1;1] (HVP) ESC [ Ps g Tab Clear (TBC) Ps = 0 -> Clear Current Column (default) Ps = 3 -> Clear All (TBC) ESC [ Ps i Printing Ps = 4 -> disable transparent print mode (MC4) [-] Ps = 5 -> enable transparent print mode (MC5) ESC [ Pm h Set Mode (SM) ESC [ Pm l Reset Mode (RM) Ps = 4 h -> Insert Mode (SMIR) l -> Replace Mode (RMIR) [-] Ps = 20 h -> Automatic Newline (LNM) l -> Normal Linefeed (LNM) ESC [ Pm m Character Attributes (SGR) Ps = 0 -> Normal (default) Ps = 1 / 22 -> On / Off Bold (bright fg) Ps = 4 / 24 -> On / Off Underline Ps = 5 / 25 -> On / Off Blink (bright bg) Ps = 7 / 27 -> On / Off Inverse Ps = 30 / 40 -> fg / bg Black Ps = 31 / 41 -> fg / bg Red Ps = 32 / 42 -> fg / bg Green Ps = 33 / 43 -> fg / bg Yellow Ps = 34 / 44 -> fg / bg Blue Ps = 35 / 45 -> fg / bg Magenta Ps = 36 / 46 -> fg / bg Cyan Ps = 37 / 47 -> fg / bg White Ps = 39 / 49 -> fg / bg Default ESC [ Ps n Device Status Report (DSR) Ps = 5 -> Status Report ESC [ 0 n (``OK'') Ps = 6 -> Report Cursor Position (CPR) [row;column] as ESC [ r ; c R Ps = 7 -> Request Display Name Ps = 8 -> Request Version Number (place in window title) ESC [ Ps;Ps r Set Scrolling Region [top;bottom] [default: full size of window] (CSR) ESC [ Ps x Request Terminal Parameters (DECREQTPARM) ESC [ ? Pm h DEC Private Mode Set (DECSET) ESC [ ? Pm l DEC Private Mode Reset (DECRST) ESC [ ? Pm r Restore previously saved DEC Private Mode Values. ESC [ ? Pm s Save DEC Private Mode Values. ESC [ ? Pm t Toggle DEC Private Mode Values (Eterm extension). Ps = 1 h -> Application Cursor Keys (DECCKM) l -> Normal Cursor Keys (DECCKM) [-] Ps = 2 h -> Designate USASCII for character sets G0-G3. Ps = 3 h -> 132 Column Mode (DECCOLM) l -> 80 Column Mode (DECCOLM) [-] Ps = 4 h -> Smooth (Slow) Scroll (DECSCLM) l -> Jump (Fast) Scroll (DECSCLM) Ps = 5 h -> Reverse Video (DECSCNM) l -> Normal Video (DECSCNM) Ps = 6 h -> Origin Mode (DECOM) l -> Normal Cursor Mode (DECOM) Ps = 7 h -> Wraparound Mode (DECAWM) l -> No Wraparound Mode (DECAWM) [-] Ps = 8 h -> Auto-repeat Keys (DECARM) l -> No Auto-repeat Keys (DECARM) Ps = 9 (X10 XTerm mouse reporting) h -> Send Mouse X & Y on button press. l -> Don't Send Mouse X & Y on button press See the section Mouse Tracking. [*] Ps = 10 h -> menuBar visisble l -> menuBar invisisble Ps = 25 h -> Visible cursor {cnorm/cvvis} l -> Invisible cursor {civis} [*] Ps = 30 h -> scrollBar visisble l -> scrollBar invisisble [*] Ps = 35 h -> Allow XTerm Shift+key sequences l -> Disallow XTerm Shift+key sequences [-] Ps = 38 -> Enter Tektronix Mode (DECTEK) Ps = 40 h -> Allow 80 <--> 132 Mode l -> Disallow 80 <--> 132 Mode [-] Ps = 44 h -> Turn On Margin Bell l -> Turn Off Margin Bell [-] Ps = 45 h -> Reverse-wraparound Mode l -> No Reverse-wraparound Mode [-] Ps = 46 h -> Start Logging (normally disabled at compile-time) l -> Stop Logging (normally disabled at compile-time) Ps = 47 h -> Use Alternate Screen Buffer l -> Use Normal Screen Buffer Ps = 66 h -> Application Keypad (DECPAM) l -> Normal Keypad (DECPNM) Ps = 67 h -> Backspace key sends BS (DECBKM) l -> Backspace key sends DEL Ps = 1000 (X11 XTerm mouse reporting) h -> Send Mouse X & Y on button press and release. See the section Mouse Tracking. l -> Don't Send Mouse X & Y on button press and release [-] Ps = 1001 (X11 XTerm mouse tracking) h -> Use Hilite Mouse Tracking. See the section Mouse Tracking. l -> Don't Use Hilite Mouse Tracking ESC ] Ps;Pt BEL Set Text Parameters Ps = 0 -> Change Icon Name and Window Title to Pt Ps = 1 -> Change Icon Name to Pt Ps = 2 -> Change Window Title to Pt [*] Ps = 10 -> menuBar command Pt (compile-time option) see menuBar section below [*] Ps = 20 -> Change default background pixmap to Pt (compile-time option) see XPM section below [*] Ps = 39 -> Change default foreground color to Pt (compile-time option) [-] Ps = 46 -> Change Log File to Pt (normally disabled by a compile-time option) [*] Ps = 49 -> Change default background color to Pt (compile-time option) Ps = 50 -> Set Font to Pt [*] special values of Pt (Eterm extension) "#+n" change up font(s) "#-n" change down font(s) if is missing or 0, a value of 1 is used "" change to font0 "#n" change to font ESC c Full Reset (RIS) ESC n Invoke the G2 Character Set (LS2) ESC o Invoke the G3 Character Set (LS3) -------------------------------------------------------------------------- Eterm XPM -------------------------------------------------------------------------- For the XPM XTerm escape sequence, "ESC ] 20; Pt BEL", Pt can be the name of the background pixmap followed by a sequence of scaling/positioning commands separated by semi-colons. The scaling/positioning commands: `?' = query scale/position `WxH+X+Y' = change scale and position `WxH+X' -> Y = X `WxH' -> Y = X = 50 `W+X+Y' -> H = W `W+X' -> H = W, Y = X `W' -> H = W, X = Y = 50 `=+X+Y' = change position (absolute) `+X+Y' = change position (relative) `=+X' -> Y = X `+X' -> Y = X `Wx0' -> W *= W/100 `0xH' -> H *= H/100 For example: eg. "\E]20;mona.xpm;200" loads the pixmap `mona.xpm' and sets the scaling to 200% or "\E]20;;200;?\a" sets the scaling of the current pixmap to 200% and displays the image geometry in the title. -------------------------------------------------------------------------- Eterm menuBar -------------------------------------------------------------------------- For the menubar XTerm escape sequence, "ESC ] 10; Pt BEL", the syntax of Pt is as follows: = title set menuBar title +/ access menuBar top level -/ remove menuBar top level NUL remove menuBar top level + [/menu/path/]submenu add/access menu - [/menu/path/]submenu remove menu + [/menu/path/]{item}[{rtext}] [action] add/alter item - [/menu/path/]{item} remove item + [/menu/path/]{-} add separator - [/menu/path/]{-} remove separator + ../ access parent menu (1 level) + ../../ access parent menu (multiple levels) Define menu quick arrows BeginRightLeftUpDownEnd NB: the square brackets indicate optional values. The title may contain the following format specifiers: %% literal '%' character %v Eterm version In the `action' associated with a menu item, special characters must be backslash-escaped: `\a', `\b', `\E `\e', `\n', `\r', `\t', '\octal' or in control-character notation: ^@, ^A .. ^Z .. ^_, ^? If `action' begins with a NUL (^@) character followed by non-NUL characters, the leading NUL is stripped off and the balance is sent back to Eterm. To send a string starting with a NUL (^@) character to the program, start action with a pair of NUL characters (^@^@), the first of which will be stripped off and the balance directed to the program. As a concession and a convenience to the many Emacs work-alike editors, an action string can be be starting with the following: `M-...', eg, `M-$' == `\E$' and for Meta-x commands, a carriage-return will be appended if missing and leading space will be skipped eg, `M-x apropos' == `\Exapropos\r' The option {rtext} will be right-justified. In the absence of a specified action, this text will be as the used. So, for example, Pt = `+{Open}{^X^F}' is equivalent to Pt = `+{Open){^X^F}{^X^F}' To only have the right-justified text, either use the same name for both left and right labels, eg: Pt = `+{Open}{Open} Open-File-Action' or simply hide the left label by preceeding it with a dot, eg: Pt = `+{.anyLabel}{Open} Open-File-Action' Since the left label is used for matching, it is necessary. The menus also provide a hook for `quick arrows' to provide easier user access. If nothing has been explicitly set, the default is to emulate the curror keys. The syntax permits each arrow to be altered individually or all four at once with re-entering their common beginning/end text. For example, to explicitly associate cursor actions with the arrows, any of the following forms could be used: Pt = `\\E[A' Pt = `\\E[B' Pt = `\\E[C' Pt = `\\E[D' or Pt = `\\E[A\\E[B\\E[C\\E[D' or Pt = `\\E[ABCD' It is probably easiest just to see the examples. -------------------------------------------------------------------------- Mouse reporting -------------------------------------------------------------------------- ESC [ M report mouse position The lower 2 bits of indicate the button: Button = & 3 - SPACE 0 = Button1 pressed 1 = Button2 pressed 2 = Button3 pressed 3 = button released (X11 mouse report) The upper bits of indicate the modifiers when the button was pressed and are added together (X11 mouse report only): State = & 28 - SPACE 4 = Shift 8 = Meta 16 = Control Col = - SPACE Row = - SPACE -------------------------------------------------------------------------- Eterm special graphics mode: -------------------------------------------------------------------------- ESC G Q query if graphics are available -> ESC G 0 no graphics available -> ESC G 1 graphics available (color only) Add more documentation here, if anyone actually cares. ESC G W ;;;: create window ESC G G : query window -> ESC G ESC G L start line ESC G P start point ESC G F start fill ESC G C clear window ESC G T ;; ;;: place text -------------------------------------------------------------------------- Key Codes -------------------------------------------------------------------------- Normal Shift Control Application Up ESC [ A ESC [ a ESC O a ESC O A Down ESC [ B ESC [ b ESC O b ESC O B Right ESC [ C ESC [ c ESC O c ESC O C Left ESC [ D ESC [ d ESC O d ESC O D Normal Shift Control Tab ^I ESC [ Z ^I BackSpace ^H ^? ^? Normal Shift Control Ctrl+Shift Home == Find ESC [ 1 ~ ESC [ 1 $ ESC [ 1 ^ ESC [ 1 @ Insert ESC [ 2 ~ paste-mouse ESC [ 2 ^ ESC [ 2 @ Execute ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @ End == Select ESC [ 4 ~ ESC [ 4 $ ESC [ 4 ^ ESC [ 4 @ Prior ESC [ 5 ~ scroll-up ESC [ 5 ^ ESC [ 5 @ Next ESC [ 6 ~ scroll-down ESC [ 6 ^ ESC [ 6 @ Delete ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @ Function Keys: (Note: Shift + F1-10 generates F11-20) Norm Shift Control Ctrl+Shift F1 ESC [ 11 ~ ESC [ 23 ~ ESC [ 11 ^ ESC [ 23 ^ F2 ESC [ 12 ~ ESC [ 24 ~ ESC [ 12 ^ ESC [ 24 ^ F3 ESC [ 13 ~ ESC [ 25 ~ ESC [ 13 ^ ESC [ 25 ^ F4 ESC [ 14 ~ ESC [ 26 ~ ESC [ 14 ^ ESC [ 26 ^ F5 ESC [ 15 ~ ESC [ 28 ~ ESC [ 15 ^ ESC [ 28 ^ F6 ESC [ 17 ~ ESC [ 29 ~ ESC [ 17 ^ ESC [ 29 ^ F7 ESC [ 18 ~ ESC [ 31 ~ ESC [ 18 ^ ESC [ 31 ^ F8 ESC [ 19 ~ ESC [ 32 ~ ESC [ 19 ^ ESC [ 32 ^ F9 ESC [ 20 ~ ESC [ 33 ~ ESC [ 20 ^ ESC [ 33 ^ F10 ESC [ 21 ~ ESC [ 34 ~ ESC [ 21 ^ ESC [ 34 ^ F11 ESC [ 23 ~ ESC [ 23 $ ESC [ 23 ^ ESC [ 23 @ F12 ESC [ 24 ~ ESC [ 24 $ ESC [ 24 ^ ESC [ 24 @ F13 ESC [ 25 ~ ESC [ 25 $ ESC [ 25 ^ ESC [ 25 @ F14 ESC [ 26 ~ ESC [ 26 $ ESC [ 26 ^ ESC [ 26 @ F15 (Help) ESC [ 28 ~ ESC [ 28 $ ESC [ 28 ^ ESC [ 28 @ F16 (Menu) ESC [ 29 ~ ESC [ 29 $ ESC [ 29 ^ ESC [ 29 @ F17 ESC [ 31 ~ ESC [ 31 $ ESC [ 31 ^ ESC [ 31 @ F18 ESC [ 32 ~ ESC [ 32 $ ESC [ 32 ^ ESC [ 32 @ F19 ESC [ 33 ~ ESC [ 33 $ ESC [ 33 ^ ESC [ 33 @ F20 ESC [ 34 ~ ESC [ 34 $ ESC [ 34 ^ ESC [ 34 @ Keypad: use Shift to temporarily override Appl-Keypad setting use Num_Lock to toggle Appl-Keypad setting if Num_Lock is off, escape sequences toggle Appl-Keypad setting ------ Normal Application KP_Enter ^M ESC O M KP_F1 ESC O P ESC O P KP_F2 ESC O Q ESC O Q KP_F3 ESC O R ESC O R KP_F4 ESC O S ESC O S XK_KP_Multiply * ESC O j XK_KP_Add + ESC O k XK_KP_Separator , ESC O l XK_KP_Subtract - ESC O m XK_KP_Decimal . ESC O n XK_KP_Divide / ESC O o XK_KP_0 0 ESC O p XK_KP_1 1 ESC O q XK_KP_2 2 ESC O r XK_KP_3 3 ESC O s XK_KP_4 4 ESC O t XK_KP_5 5 ESC O u XK_KP_6 6 ESC O v XK_KP_7 7 ESC O w XK_KP_8 8 ESC O x XK_KP_9 9 ESC O y --------------------------------------------------------------------------