rxvtRef.txt 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917
  1. TITLE INFORMATION: Rxvt Technical Reference
  2. AUTHOR INFORMATION: Geoff Wing (gcw@pobox.com)
  3. DATE INFORMATION: 18 April 1998
  4. o Definitions
  5. o Values
  6. o Escape Sequences
  7. o CSI (Code Sequence Introducer) Sequences
  8. o DEC Private Modes
  9. o XTerm Operating System Commands
  10. o menuBar
  11. o XPM
  12. o Mouse Reporting
  13. o Special Graphics Mode
  14. o Key Codes
  15. Reworked from XTerm documentation and other sources
  16. Definitions
  17. o c
  18. The literal character c.
  19. o C
  20. A single (required) character.
  21. o Ps
  22. A single (usually optional) numeric parameter, composed of one or
  23. more digits.
  24. o Pm
  25. A multiple numeric parameter composed of any number of single numeric
  26. parameters, separated by ; character(s).
  27. o Pt
  28. A text parameter composed of printable characters.
  29. Top
  30. Values
  31. o ENQ
  32. Enquiry (Ctrl-E) = Send Device Attributes (DA)
  33. request attributes from terminal == ESC[Psc
  34. o BEL
  35. Bell (Ctrl-G)
  36. o BS
  37. Backspace (Ctrl-H)
  38. o TAB
  39. Horizontal Tab (HT) (Ctrl-I)
  40. o LF
  41. Line Feed or New Line (NL) (Ctrl-J)
  42. o VT
  43. Vertical Tab (Ctrl-K) same as LF
  44. o FF
  45. Form Feed or New Page (NP) (Ctrl-L) same as LF
  46. o CR
  47. Carriage Return (Ctrl-M)
  48. o SO
  49. Shift Out (Ctrl-N), invokes the G1 character set.
  50. Switch to Alternate Character Set
  51. o SI
  52. Shift In (Ctrl-O), invokes the G0 character set (the default)
  53. Switch to Standard Character Set
  54. o SPC
  55. Space Character
  56. Top
  57. Escape Sequences
  58. o ESC # 8
  59. DEC Screen Alignment Test (DECALN)
  60. o ESC 7
  61. ESC 8
  62. Save Cursor (SC)
  63. Restore Cursor
  64. o ESC =
  65. ESC >
  66. Application Keypad (SMKX) == ESC[?66h
  67. Normal Keypad (RMKX) == ESC[?66l
  68. Note: If the numeric keypad is activated, eg, Num_Lock has been
  69. pressed, numbers or control functions are generated by the numeric keypad
  70. (see Key Codes)
  71. o ESC D
  72. Index (IND)
  73. o ESC E
  74. Next Line (NEL)
  75. o ESC H
  76. Tab Set (HTS)
  77. o ESC M
  78. Reverse Index (RI)
  79. o ESC N
  80. Single Shift Select of G2 Character Set (SS2): affects next character
  81. only unimplemented
  82. o ESC O
  83. Single Shift Select of G3 Character Set (SS3): affects next character
  84. only unimplemented
  85. o ESC Z
  86. Obsolete form of ESC[c
  87. returns: ESC[?1;2C rxvt compile-time option
  88. o ESC c
  89. Full reset (RIS)
  90. o ESC n
  91. Invoke the G2 Character Set (LS2)
  92. o ESC o
  93. Invoke the G3 Character Set (LS3)
  94. o ESC ( C
  95. ESC ) C
  96. ESC * C
  97. ESC + C
  98. ESC $ C
  99. Designate G0 Character Set (ISO 2022)
  100. Designate G1 Character Set (ISO 2022)
  101. Designate G2 Character Set (ISO 2022)
  102. Designate G3 Character Set (ISO 2022)
  103. Designate Kanji Character Set
  104. where C is
  105. C = 0 DEC Special Character and Line Drawing Set
  106. C = A United Kingdom (UK)
  107. C = B United States (USASCII)
  108. C = < Multinational character set unimplemented
  109. C = 5 Finnish character set unimplemented
  110. C = C Finnish character set unimplemented
  111. C = K German character set unimplemented
  112. Top
  113. CSI (Code Sequence Introducer) Sequences
  114. o ESC [ Ps @
  115. Insert Ps (Blank) Character(s) [default: 1] (ICH)
  116. o ESC [ Ps A
  117. Cursor Up Ps Times [default: 1] (CUU)
  118. o ESC [ Ps B
  119. Cursor Down Ps Times [default: 1] (CUD)
  120. o ESC [ Ps C
  121. Cursor Forward Ps Times [default: 1] (CUF)
  122. o ESC [ Ps D
  123. Cursor Backward Ps Times [default: 1] (CUB)
  124. o ESC [ Ps E
  125. Cursor Down Ps Times [default: 1] and to first column
  126. o ESC [ Ps F
  127. Cursor Up Ps Times [default: 1] and to first column
  128. o ESC [ Ps G
  129. Cursor to Column Ps (HPA)
  130. o ESC [ Ps;Ps H
  131. Cursor Position [row;column] [default: 1;1] (CUP)
  132. o ESC [ Ps I
  133. Move forward Ps tab stops [default: 1]
  134. o ESC [ Ps J
  135. Erase in Display (ED)
  136. Ps = 0 Clear Below (default)
  137. Ps = 1 Clear Above
  138. Ps = 2 Clear All
  139. o ESC [ Ps K
  140. Erase in Line (EL)
  141. Ps = 0 Clear to Right (default)
  142. Ps = 1 Clear to Left
  143. Ps = 2 Clear All
  144. o ESC [ Ps L
  145. Insert Ps Line(s) [default: 1] (IL)
  146. o ESC [ Ps M
  147. Delete Ps Line(s) [default: 1] (DL)
  148. o ESC [ Ps P
  149. Delete Ps Character(s) [default: 1] (DCH)
  150. o ESC [ Ps;Ps;Ps;Ps;Ps T
  151. Initiate hilite mouse tracking. unimplemented
  152. Parameters are [func;startx;starty;firstrow;lastrow].
  153. o ESC [ Ps W
  154. Tabulator functions
  155. Ps = 0 Tab Set (HTS)
  156. Ps = 2 Tab Clear (TBC), Clear Current Column (default)
  157. Ps = 5 Tab Clear (TBC), Clear All
  158. o ESC [ Ps X
  159. Erase Ps Character(s) [default: 1] (ECH)
  160. o ESC [ Ps Z
  161. Move backward Ps [default: 1] tab stops
  162. o ESC [ Ps '
  163. == ESC [ Ps G
  164. o ESC [ Ps a
  165. == ESC [ Ps C
  166. o ESC [ Ps c
  167. Send Device Attributes (DA)
  168. Ps = 0 (or omitted) : request attributes from terminal
  169. returns: ESC[?1;2c (``I am a VT100 with Advanced Video
  170. Option'')
  171. o ESC [ Ps d
  172. Cursor to Line Ps (VPA)
  173. o ESC [ Ps e
  174. == ESC [ Ps A
  175. o ESC [ Ps;Ps f
  176. Horizontal and Vertical Position [row;column] (HVP) [default: 1;1]
  177. o ESC [ Ps g
  178. Tab Clear (TBC)
  179. Ps = 0 Clear Current Column (default)
  180. Ps = 3 Clear All (TBC)
  181. o ESC [ Ps i
  182. Printing
  183. Ps = 4 disable transparent print mode (MC4)
  184. Ps = 5 enable transparent print mode (MC5) unimplemented
  185. o ESC [ Pm h
  186. ESC [ Pm l
  187. Set Mode (SM)
  188. Reset Mode (RM)
  189. o Ps = 4
  190. h Insert Mode (SMIR)
  191. l Replace Mode (RMIR)
  192. o Ps = 20 unimplemented
  193. h Automatic Newline (LNM)
  194. h Normal Linefeed (LNM)
  195. o ESC [ Pm m
  196. Character Attributes (SGR)
  197. Ps = 0 Normal (default)
  198. Ps = 1 / 22 On / Off Bold (bright fg)
  199. Ps = 4 / 24 On / Off Underline
  200. Ps = 5 / 25 On / Off Blink (bright bg)
  201. Ps = 7 / 27 On / Off Inverse
  202. Ps = 30 / 40 fg/bg Black
  203. Ps = 31 / 41 fg/bg Red
  204. Ps = 32 / 42 fg/bg Green
  205. Ps = 33 / 43 fg/bg Yellow
  206. Ps = 34 / 44 fg/bg Blue
  207. Ps = 35 / 45 fg/bg Magenta
  208. Ps = 36 / 46 fg/bg Cyan
  209. Ps = 37 / 47 fg/bg White
  210. Ps = 39 / 49 fg/bg Default
  211. o ESC [ Ps n
  212. Device Status Report (DSR)
  213. Ps = 5 Status Report ESC [ 0 n (``OK'')
  214. Ps = 6 Report Cursor Position (CPR) [row;column] as ESC [ r ; c R
  215. Ps = 7 Request Display Name
  216. Ps = 8 Request Version Number (place in window title)
  217. o ESC [ Ps;Ps r
  218. Set Scrolling Region [top;bottom]
  219. [default: full size of window] (CSR)
  220. o ESC [ s
  221. Save Cursor (SC)
  222. o ESC [ Ps x
  223. Request Terminal Parameters (DECREQTPARM)
  224. o ESC [ u
  225. Restore Cursor
  226. Top
  227. DEC Private Modes
  228. o ESC [ ? Pm h
  229. DEC Private Mode Set (DECSET)
  230. o ESC [ ? Pm l
  231. DEC Private Mode Reset (DECRST)
  232. o ESC [ ? Pm r
  233. Restore previously saved DEC Private Mode Values.
  234. o ESC [ ? Pm s
  235. Save DEC Private Mode Values.
  236. o ESC [ ? Pm t
  237. Toggle DEC Private Mode Values (rxvt extension).
  238. where
  239. o Ps = 1 (DECCKM)
  240. h Application Cursor Keys
  241. l Normal Cursor Keys
  242. o Ps = 2 (ANSI/VT52 mode)
  243. h Enter VT52 mode
  244. l Enter VT52 mode
  245. o Ps = 3
  246. h 132 Column Mode (DECCOLM)
  247. l 80 Column Mode (DECCOLM)
  248. o Ps = 4
  249. h Smooth (Slow) Scroll (DECSCLM)
  250. l Jump (Fast) Scroll (DECSCLM)
  251. o Ps = 5
  252. h Reverse Video (DECSCNM)
  253. l Normal Video (DECSCNM)
  254. o Ps = 6
  255. h Origin Mode (DECOM)
  256. l Normal Cursor Mode (DECOM)
  257. o Ps = 7
  258. h Wraparound Mode (DECAWM)
  259. l No Wraparound Mode (DECAWM)
  260. o Ps = 8 unimplemented
  261. h Auto-repeat Keys (DECARM)
  262. l No Auto-repeat Keys (DECARM)
  263. o Ps = 9 X10 XTerm mouse reporting
  264. h Send Mouse X & Y on button press.
  265. l No mouse reporting.
  266. o Ps = 10 (rxvt)
  267. h menuBar visible
  268. l menuBar invisible
  269. o Ps = 25
  270. h Visible cursor {cnorm/cvvis}
  271. l Invisible cursor {civis}
  272. o Ps = 30
  273. h scrollBar visisble
  274. l scrollBar invisisble
  275. o Ps = 35 (rxvt)
  276. h Allow XTerm Shift+key sequences
  277. l Disallow XTerm Shift+key sequences
  278. o Ps = 38 unimplemented
  279. Enter Tektronix Mode (DECTEK)
  280. o Ps = 40
  281. h Allow 80/132 Mode
  282. l Disallow 80/132 Mode
  283. o Ps = 44 unimplemented
  284. h Turn On Margin Bell
  285. l Turn Off Margin Bell
  286. o Ps = 45 unimplemented
  287. h Reverse-wraparound Mode
  288. l No Reverse-wraparound Mode
  289. o Ps = 46 unimplemented
  290. o Ps = 47
  291. h Use Alternate Screen Buffer
  292. l Use Normal Screen Buffer
  293. o Ps = 66
  294. h Application Keypad (DECPAM) == ESC =
  295. l Normal Keypad (DECPNM) == ESC >
  296. o Ps = 67
  297. h Backspace key sends BS (DECBKM)
  298. l Backspace key sends DEL
  299. o Ps = 1000 (X11 XTerm mouse reporting)
  300. h Send Mouse X & Y on button press and release.
  301. l No mouse reporting.
  302. o Ps = 1001 (X11 XTerm mouse tracking) unimplemented
  303. h Use Hilite Mouse Tracking.
  304. l No mouse reporting.
  305. o Ps = 1010
  306. h Don't scroll to bottom on TTY output
  307. l Scroll to bottom on TTY output
  308. o Ps = 1011
  309. h Scroll to bottom when a key is pressed
  310. l Don't scroll to bottom when a key is pressed
  311. o Ps = 1047
  312. h Use Alternate Screen Buffer
  313. l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
  314. o Ps = 1048
  315. h Save cursor position
  316. l Restore cursor position
  317. Top
  318. XTerm Operating System Commands
  319. o ESC ] Ps;Pt ST
  320. Set XTerm Parameters
  321. 8-bit ST: 0x9c,
  322. 7-bit ST sequence: ESC \ (0x1b, 0x5c),
  323. backwards compatible terminator BEL (0x07) is also accepted.
  324. Ps = 0 Change Icon Name and Window Title to Pt
  325. Ps = 1 Change Icon Name to Pt
  326. Ps = 2 Change Window Title to Pt
  327. Ps = 4 Pt is a semi-colon separated sequence of one or more semi-colon separated number/name pairs, where number is an index to a colour and name is the name of a colour. Each pair causes the numbered colour to be changed to name.
  328. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white
  329. Ps = 10 (NB: may change in future) menuBar command Pt rxvt compile-time option
  330. Ps = 12 Change colour of text cursor foreground to Pt
  331. Ps = 13 Change colour of mouse foreground to Pt
  332. Ps = 17 Change colour of highlight characters to Pt
  333. Ps = 18 Change colour of bold characters to Pt
  334. Ps = 19 Change colour of underlined characters to Pt
  335. Ps = 20 Change default background pixmap to Pt
  336. Ps = 39 Change default foreground colour to Pt rxvt compile-time option
  337. Ps = 46 Change Log File to Pt unimplemented
  338. Ps = 49 Change default background colour to Pt rxvt compile-time option
  339. Ps = 50 Set Font to Pt, with the following special values of Pt (rxvt)
  340. #+n change up n font(s)
  341. #-n change down n font(s)
  342. if n is missing of 0, a value of 1 is used
  343. empty change to font0
  344. n change to font n
  345. Ps = 55 Log all scrollback buffer and all of screen to Pt
  346. Top
  347. menuBar
  348. The exact syntax used is almost solidified.
  349. In the menus, DON'T try to use menuBar commands that add or remove a
  350. menuBar.
  351. Note that in all of the commands, the /path/ cannot be omitted:
  352. use ./ to specify a menu relative to the current menu.
  353. Overview of menuBar operation
  354. For the menuBar XTerm escape sequence ESC ] 10 ; Pt ST, the
  355. syntax of Pt can be used for a variety of tasks:
  356. o Commands
  357. o Adding and accessing menus
  358. o Removing menus
  359. o Quick Arrows
  360. o Command Summary
  361. At the top level is the current menuBar which is a member of a circular
  362. linked-list of other such menuBars.
  363. The menuBar acts as a parent for the various drop-down menus, which in turn,
  364. may have labels, separator lines, menuItems and subMenus.
  365. The menuItems are the useful bits: you can use them to mimic keyboard input
  366. or even to send text or escape sequences back to rxvt.
  367. The menuBar syntax is intended to provide a simple yet robust method of
  368. constructing and manipulating menus and navigating through the menuBars.
  369. The first step is to use the tag [menu:name] which creates the
  370. menuBar called name and allows access.
  371. You may now add or remove menus,
  372. subMenus, and menuItems. Finally, use the tag [done] to set the menuBar
  373. access as readonly to prevent accidental corruption of the menus.
  374. To re-access the current menuBar for alterations, use the tag [menu],
  375. make the alterations and then use [done]
  376. Commands
  377. o [menu:name]
  378. access the named menuBar for creation or alteration. If a new menuBar
  379. is created, it is called name (max of 15 chars) and the current
  380. menuBar is pushed onto the stack
  381. o [menu]
  382. access the current menuBar for alteration
  383. o [title:string]
  384. set the current menuBar's title to string, which may contain the
  385. following format specifiers:
  386. %% : literal % character
  387. %n : rxvt name (as per the -name command-line option)
  388. %v : rxvt version
  389. o [done]
  390. set menuBar access as readonly.
  391. End-of-file tag for [read:file] operations.
  392. o [read:file]
  393. read menu commands directly from file (extension ".menu" will be
  394. appended if required.) Start reading at a line with [menu] or
  395. [menu:name and continuing until [done] is encountered.
  396. Blank and comment lines (starting with #) are ignored.
  397. Actually, since any invalid menu commands are also ignored, almost
  398. anything could be construed as a comment line, but this may be
  399. tightened up in the future ... so don't count on it!.
  400. o [read:file;name]
  401. The same as [read:file], but start reading at a line with
  402. [menu:name] and continuing until [done:name] or
  403. [done] is encountered.
  404. o [dump]
  405. dump all menuBars to the file /tmp/rxvt-PID in a format suitable
  406. for later rereading.
  407. o [rm:name]
  408. [rm] [rm:]
  409. [rm*] [rm:*]
  410. remove the named menuBar
  411. remove the current menuBar
  412. remove all menuBars
  413. o [swap]
  414. swap the top two menuBars
  415. o [prev]
  416. [next]
  417. access the previous or next menuBar
  418. o [show]
  419. [hide]
  420. control display of the menuBar ... just like
  421. ESC[?10 h/l
  422. o [pixmap:name]
  423. [pixmap:name;scaling]
  424. set the background pixmap globally ... just like
  425. ESC ] 20 ; Pt ST
  426. A Future implementation may make this local to the menubar
  427. o [:command:]
  428. ignore the menu readonly status and issue a command to
  429. Add/Modify or Remove a menu or
  430. menuitem or change the Quick Arrows; a useful
  431. shortcut for setting the quick arrows from a menuBar.
  432. Adding and accessing menus
  433. The following commands may also be + prefixed.
  434. o /
  435. ./
  436. ../
  437. ../../
  438. access menuBar top level
  439. access current menu level
  440. access parent menu (1 level up)
  441. access parent menu (multiple levels up)
  442. o /path/menu
  443. add/access menu
  444. o /path/menu/*
  445. add/access menu and clear it if it exists
  446. o /path/{-}
  447. add separator
  448. o /path/{item}
  449. add item as a label
  450. o /path/{item} action
  451. add/alter menuitem with an associated action
  452. o /path/{item}{right-text}
  453. add/alter menuitem with right-text as the right-justified
  454. text and as the associated action
  455. o /path/{item}{rtext} action
  456. add/alter menuitem with an associated action and with
  457. rtext as the right-justified text.
  458. o Special characters in action must be backslash-escaped:
  459. \a \b \E \e \n \r \t \octal
  460. o or in control-character notation:
  461. ^@, ^A .. ^Z .. ^_, ^?
  462. To send a string starting with a NUL (^@) character to the program,
  463. start action with a pair of NUL characters (^@^@), the first of
  464. which will be stripped off and the balance directed to the program.
  465. Otherwise if action begins with NUL followed by non-NUL
  466. characters, the leading NUL is stripped off and the balance is sent back
  467. to rxvt.
  468. As a convenience for the many Emacs-type editors, action may start
  469. with M- (eg, M-$ is equivalent to \E$) and a CR will be
  470. appended if missed from M-x commands.
  471. As a convenience for issuing XTerm ESC] sequences from a menubar
  472. (or quick arrow), a BEL (^G) will be appended if needed.
  473. o For example,
  474. M-xapropos is equivalent to \Exapropos\r
  475. o and
  476. \E]10;mona;100 is equivalent to \E]10;mona;100\a
  477. The option {right-rtext} will be right-justified. In the absence of
  478. a specified action, this text will be used as the action as well.
  479. o For example,
  480. /File/{Open}{^X^F} is equivalent to /File/{Open}{^X^F} ^X^F
  481. The left label is necessary, since it's used for matching,
  482. but implicitly hiding the left label (by using same name for both left
  483. and right labels), or explicitly hiding the left label (by preceeding
  484. it with a dot), makes it possible to have right-justified text only.
  485. o For example,
  486. /File/{Open}{Open} Open-File-Action
  487. o or hiding it
  488. /File/{.anylabel}{Open} Open-File-Action
  489. Removing menus
  490. o -/*
  491. -/pathmenu
  492. -/path{item}
  493. -/path{-}
  494. remove all menus from the menuBar, the same as [clear]
  495. remove menu
  496. remove item
  497. remove separator
  498. o -/path/menu/*
  499. remove all items, separators and submenus from menu
  500. Quick Arrows
  501. The menus also provide a hook for quick arrows to provide easier user
  502. access. If nothing has been explicitly set, the default is to emulate the
  503. curror keys. The syntax permits each arrow to be altered individually or
  504. all four at once without re-entering their common beginning/end text. For
  505. example, to explicitly associate cursor actions with the arrows, any of
  506. the following forms could be used:
  507. o <r>Right
  508. <l>Left
  509. <u>Up
  510. <d>Down
  511. Define actions for the respective arrow buttons
  512. o <b>Begin
  513. <e>End
  514. Define common beginning/end parts for quick arrows which used
  515. in conjunction with the above <r> <l> <u> <d> constructs
  516. o For example, define arrows individually,
  517. <u>\E[A
  518. <d>\E[B
  519. <r>\E[C
  520. <l>\E[D
  521. o or all at once
  522. <u>\E[A<d>\E[B<r>\E[C<l>\E[D
  523. o or more compactly (factoring out common parts)
  524. <b>\E[<u>A<d>B<r>C<l>D
  525. Command Summary
  526. A short summary of the most common commands:
  527. o [menu:name]
  528. use an existing named menuBar or start a new one
  529. o [menu]
  530. use the current menuBar
  531. o [title:string]
  532. set menuBar title
  533. o [done]
  534. set menu access to readonly and, if reading from a file, signal EOF
  535. o [done:name]
  536. if reading from a file using [read:file;name] signal EOF
  537. o [rm:name]
  538. [rm] [rm:]
  539. [rm*] [rm:*]
  540. remove named, current, or all menuBar(s)
  541. o [swap]
  542. swap top two menuBars
  543. o [prev]
  544. [next]
  545. access the previous/next menuBar
  546. o [show]
  547. [hide]
  548. map/unmap menuBar
  549. o [pixmap;file]
  550. [pixmap;file;scaling]
  551. set a background pixmap
  552. o [read:file]
  553. [read:file;name]
  554. read in a menu from a file
  555. o [dump]
  556. dump out all menuBars to /tmp/rxvt-PID
  557. o /
  558. access menuBar top level
  559. o ./
  560. ../
  561. ../../
  562. access current or parent menu level
  563. o /path/menu
  564. add/access menu
  565. o /path/{-}
  566. add separator
  567. o /path/{item}{rtext} action
  568. add/alter menu item
  569. ({rtext} and/or action, may be omitted)
  570. o -/*
  571. remove all menus from the menuBar
  572. o -/path/menu
  573. remove menu items, separators and submenus from menu
  574. o -/path/menu
  575. remove menu
  576. o -/path/{item}
  577. remove item
  578. o -/path/{-}
  579. remove separator
  580. o <b>Begin<r>Right<l>Left<u>Up<d>Down<e>End
  581. menu quick arrows
  582. Top
  583. XPM
  584. For the XPM XTerm escape sequence ESC ] 20 ; Pt ST then value of
  585. Pt can be the name of the background pixmap followed by a sequence of
  586. scaling/positioning commands separated by semi-colons. The scaling/positioning
  587. commands are as follows:
  588. o query scale/position
  589. ?
  590. o change scale and position
  591. WxH+X+Y
  592. WxH+X (== WxH+X+X)
  593. WxH (same as WxH+50+50)
  594. W+X+Y (same as WxW+X+Y)
  595. W+X (same as WxW+X+X)
  596. W (same as WxW+50+50)
  597. o change position (absolute)
  598. =+X+Y
  599. =+X (same as =+X+Y)
  600. o change position (relative)
  601. +X+Y
  602. +X (same as +X+Y)
  603. o rescale (relative)
  604. Wx0 -> W *= (W/100)
  605. 0xH -> H *= (H/100)
  606. For example:
  607. o \E]20;funky\a
  608. load funky.xpm as a tiled image
  609. o \E]20;mona;100\a
  610. load mona.xpm with a scaling of 100%
  611. o \E]20;;200;?\a
  612. rescale the current pixmap to 200% and display the image geometry in the title
  613. Top
  614. Mouse Reporting
  615. o ESC [ M <b> <x> <y>
  616. report mouse position
  617. The lower 2 bits of <b> indicate the button:
  618. o Button = (<b> - SPACE) & 3
  619. 0 = Button1 pressed
  620. 1 = Button2 pressed
  621. 2 = Button3 pressed
  622. 3 = button released (X11 mouse report)
  623. The upper bits of <b> indicate the modifiers when the button was
  624. pressed and are added together (X11 mouse report only):
  625. o State = (<b> - SPACE) & 60
  626. 4 = Shift
  627. 8 = Meta
  628. 16 = Control
  629. 32 = Double Click (Rxvt extension)
  630. Col = <x> - SPACE
  631. Row = <y> - SPACE
  632. Top
  633. Special Graphics Mode
  634. Add more documentation here, if anyone actually cares.
  635. o ESC G Q
  636. query if graphics are available
  637. returns: ESC G 0 no graphics available
  638. returns: ESC G 1 graphics available (colour only)
  639. o ESC G W <;x>;<y>;<w>;<h>:
  640. create window
  641. o ESC G C <id>
  642. clear window
  643. o ESC G G <it>:
  644. query window
  645. returns: ESC G <id> <x> <y> <w> <h> <fw> <fh> <nw> <nh>
  646. o ESC G L <id>
  647. ESC G P <id>
  648. ESC G F <id>
  649. start point
  650. start line
  651. start fill
  652. o ;<x>;<y>
  653. extend point/line/fill
  654. o ESC G T <id>;<x>;<y>;<mode>;<len>:<text>
  655. place text
  656. Top
  657. Key Codes
  658. Note: Shift + F1-F10 generates F11-F20
  659. For the keypad, use Shift to temporarily override Application-Keypad
  660. setting use Num_Lock to toggle Application-Keypad setting if Num_Lock
  661. is off, escape sequences toggle Application-Keypad setting.
  662. Also note that values of Home, End, Delete may have been compiled
  663. differently on your system.
  664. Normal Shift Control Ctrl+Shift
  665. Tab ^I ESC [ Z ^I ESC [ Z
  666. BackSpace ^H ^? ^? ^?
  667. Find ESC [ 1 ~ ESC [ 1 $ ESC [ 1 ^ ESC [ 1 @
  668. Insert ESC [ 2 ~ paste ESC [ 2 ^ ESC [ 2 @
  669. Execute ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @
  670. Select ESC [ 4 ~ ESC [ 4 $ ESC [ 4 ^ ESC [ 4 @
  671. Prior ESC [ 5 ~ scroll-up ESC [ 5 ^ ESC [ 5 @
  672. Next ESC [ 6 ~ scroll-down ESC [ 6 ^ ESC [ 6 @
  673. Home ESC [ 7 ~ ESC [ 7 $ ESC [ 7 ^ ESC [ 7 @
  674. End ESC [ 8 ~ ESC [ 8 $ ESC [ 8 ^ ESC [ 8 @
  675. Delete ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @
  676. F1 ESC [ 11 ~ ESC [ 23 ~ ESC [ 11 ^ ESC [ 23 ^
  677. F2 ESC [ 12 ~ ESC [ 24 ~ ESC [ 12 ^ ESC [ 24 ^
  678. F3 ESC [ 13 ~ ESC [ 25 ~ ESC [ 13 ^ ESC [ 25 ^
  679. F4 ESC [ 14 ~ ESC [ 26 ~ ESC [ 14 ^ ESC [ 26 ^
  680. F5 ESC [ 15 ~ ESC [ 28 ~ ESC [ 15 ^ ESC [ 28 ^
  681. F6 ESC [ 17 ~ ESC [ 29 ~ ESC [ 17 ^ ESC [ 29 ^
  682. F7 ESC [ 18 ~ ESC [ 31 ~ ESC [ 18 ^ ESC [ 31 ^
  683. F8 ESC [ 19 ~ ESC [ 32 ~ ESC [ 19 ^ ESC [ 32 ^
  684. F9 ESC [ 20 ~ ESC [ 33 ~ ESC [ 20 ^ ESC [ 33 ^
  685. F10 ESC [ 21 ~ ESC [ 34 ~ ESC [ 21 ^ ESC [ 34 ^
  686. F11 ESC [ 23 ~ ESC [ 23 $ ESC [ 23 ^ ESC [ 23 @
  687. F12 ESC [ 24 ~ ESC [ 24 $ ESC [ 24 ^ ESC [ 24 @
  688. F13 ESC [ 25 ~ ESC [ 25 $ ESC [ 25 ^ ESC [ 25 @
  689. F14 ESC [ 26 ~ ESC [ 26 $ ESC [ 26 ^ ESC [ 26 @
  690. F15 (Help) ESC [ 28 ~ ESC [ 28 $ ESC [ 28 ^ ESC [ 28 @
  691. F16 (Menu) ESC [ 29 ~ ESC [ 29 $ ESC [ 29 ^ ESC [ 29 @
  692. F17 ESC [ 31 ~ ESC [ 31 $ ESC [ 31 ^ ESC [ 31 @
  693. F18 ESC [ 32 ~ ESC [ 32 $ ESC [ 32 ^ ESC [ 32 @
  694. F19 ESC [ 33 ~ ESC [ 33 $ ESC [ 33 ^ ESC [ 33 @
  695. F20 ESC [ 34 ~ ESC [ 34 $ ESC [ 34 ^ ESC [ 34 @
  696. Application
  697. Up ESC [ A ESC [ a ESC O a ESC O A
  698. Down ESC [ B ESC [ b ESC O b ESC O B
  699. Right ESC [ C ESC [ c ESC O c ESC O C
  700. Left ESC [ D ESC [ d ESC O d ESC O D
  701. KP_Enter ^M ESC O M
  702. KP_F1 ESC O P ESC O P
  703. KP_F2 ESC O Q ESC O Q
  704. KP_F3 ESC O R ESC O R
  705. KP_F4 ESC O S ESC O S
  706. XK_KP_Multiply * ESC O j
  707. XK_KP_Add + ESC O k
  708. XK_KP_Separator , ESC O l
  709. XK_KP_Subtract - ESC O m
  710. XK_KP_Decimal . ESC O n
  711. XK_KP_Divide / ESC O o
  712. XK_KP_0 0 ESC O p
  713. XK_KP_1 1 ESC O q
  714. XK_KP_2 2 ESC O r
  715. XK_KP_3 3 ESC O s
  716. XK_KP_4 4 ESC O t
  717. XK_KP_5 5 ESC O u
  718. XK_KP_6 6 ESC O v
  719. XK_KP_7 7 ESC O w
  720. XK_KP_8 8 ESC O x
  721. XK_KP_9 9 ESC O y
  722. Top