summaryrefslogtreecommitdiffstats
path: root/konsole/doc/More/Eterm.ref
blob: 849be1f3bf042a28a62ce16cd5aefda7818f84d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
--------------------------------------------------------------------------
			 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 <n> font(s)
		     "#-n"	change down <n> font(s)
		    	if <n> is missing or 0, a value of 1 is used
		     ""		change to font0
		     "#n"	change to font<n>

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
	<b>Begin<r>Right<l>Left<u>Up<d>Down<e>End

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 = `<u>\\E[A'
		Pt = `<d>\\E[B'
		Pt = `<r>\\E[C'
		Pt = `<l>\\E[D'
	or
		Pt = `<u>\\E[A<d>\\E[B<r>\\E[C<l>\\E[D'
	or
		Pt = `<b>\\E[<u>A<d>B<r>C<l>D'

	It is probably easiest just to see the examples.

--------------------------------------------------------------------------
			     Mouse reporting
--------------------------------------------------------------------------

ESC [ M <b> <x> <y>	report mouse position
			The lower 2 bits of <b> indicate the button:
			Button = <b> & 3 - SPACE
			  0 = Button1 pressed
			  1 = Button2 pressed
			  2 = Button3 pressed
			  3 = button released (X11 mouse report)

			The upper bits of <b> indicate the modifiers when
			the button was pressed and are added together
			(X11 mouse report only):
			State  = <b> & 28 - SPACE
			   4 = Shift
			   8 = Meta
			  16 = Control

			Col = <x> - SPACE
			Row = <y> - 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 <x>;<y>;<w>;<h>:	create window
ESC G G <id>:		query window
-> ESC G <id> <x> <y> <w> <h> <fw> <fh> <nw> <nh>
ESC G L <id>		start line
ESC G P <id>		start point
ESC G F <id>		start fill
ESC G C <id>		clear window
ESC G T <id>;<x>; <y>;<mode>;<len>:<text>	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
--------------------------------------------------------------------------