






.YODLTAGSTART. documenttype article .YODLTAGEND.<html><head><title>Rxvt Technical Reference</title>
.YODLTAGSTART. title Rxvt Technical Reference .YODLTAGEND.
<link rev="made" href="mailto:gcw@pobox.com">
</head>
<body BGCOLOR="#FFFFFF">
.YODLTAGSTART. bodytagopt  BGCOLOR="#FFFFFF" .YODLTAGEND.
<hr>

<h1>Rxvt Technical Reference</h1>
<h2>Geoff Wing (gcw@pobox.com)</h2>
<h2>18 April 1998</h2>

    

.YODLTAGSTART. label toc .YODLTAGEND.



.YODLTAGSTART. label masonyodl.yo .YODLTAGEND.
    






















<p><br><ul>
    <li ><a href=".YODLTAGSTART. solvelink Definitions .YODLTAGEND.">Definitions</a>
    <li ><a href=".YODLTAGSTART. solvelink Values .YODLTAGEND.">Values</a>
    <li ><a href=".YODLTAGSTART. solvelink Sequences .YODLTAGEND.">Escape Sequences</a>
    <li ><a href=".YODLTAGSTART. solvelink CSI .YODLTAGEND.">CSI (Code Sequence Introducer) Sequences</a>
    <li ><a href=".YODLTAGSTART. solvelink PrivateModes .YODLTAGEND.">DEC Private Modes</a>
    <li ><a href=".YODLTAGSTART. solvelink XTerm .YODLTAGEND.">XTerm Escape Sequences</a>
    <li ><a href=".YODLTAGSTART. solvelink menuBar .YODLTAGEND.">menuBar</a>
    <li ><a href=".YODLTAGSTART. solvelink XPM .YODLTAGEND.">XPM</a>
    <li ><a href=".YODLTAGSTART. solvelink Mouse .YODLTAGEND.">Mouse Reporting</a>
    <li ><a href=".YODLTAGSTART. solvelink Graphics .YODLTAGEND.">Special Graphics Mode</a>
    <li ><a href=".YODLTAGSTART. solvelink KeyCodes .YODLTAGEND.">Key Codes</a>
</ul>
<p><br>Reworked from XTerm documentation and other sources
.YODLTAGSTART. label rxvtRef-definitions.yo .YODLTAGEND.
    
.YODLTAGSTART. label Definitions .YODLTAGEND.
<h2>Definitions</h2>
    
<p><br><dl>
    <dt><strong><code>c</code></strong></dt><dd>The literal character c.</dd>
<p><dt><strong><code>C</code></strong></dt><dd>A single (required) character.</dd>
<p><dt><strong><code>Ps</code></strong></dt><dd>A single (usually optional) numeric parameter, composed of one or
	more digits.</dd>
<p><dt><strong><code>Pm</code></strong></dt><dd>A multiple numeric parameter composed of any number of single numeric
	parameters, separated by ; character(s).</dd>
<p><dt><strong><code>Pt</code></strong></dt><dd>A text parameter composed of printable characters.</dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-values.yo .YODLTAGEND.
    
.YODLTAGSTART. label Values .YODLTAGEND.
<h2>Values</h2>
    
<p><br><dl>
    <dt><strong><code>ENQ</code></strong></dt><dd>Enquiry (Ctrl-E) = Send Device Attributes (DA) <br>request attributes from terminal == <a href=".YODLTAGSTART. solvelink ESCOBPsc .YODLTAGEND.">ESC[Psc</a></dd>
<p><dt><strong><code>BEL</code></strong></dt><dd>Bell (Ctrl-G)</dd>
<p><dt><strong><code>BS</code></strong></dt><dd>Backspace (Ctrl-H)</dd>
<p><dt><strong><code>TAB</code></strong></dt><dd>Horizontal Tab (HT) (Ctrl-I)</dd>
<p><dt><strong><code>LF</code></strong></dt><dd>Line Feed or New Line (NL) (Ctrl-J)</dd>
<p><dt><strong><code>VT</code></strong></dt><dd>Vertical Tab (Ctrl-K) same as <strong><code>LF</code></strong></dd>
<p><dt><strong><code>FF</code></strong></dt><dd>Form Feed or New Page (NP) (Ctrl-L) same as <strong><code>LF</code></strong></dd>
<p><dt><strong><code>CR</code></strong></dt><dd>Carriage Return (Ctrl-M)</dd>
<p><dt><strong><code>SO</code></strong></dt><dd>Shift Out (Ctrl-N), invokes the G1 character set. <br>Switch to Alternate Character Set</dd>
<p><dt><strong><code>SI</code></strong></dt><dd>Shift In (Ctrl-O), invokes the G0 character set (the default) <br>Switch to Standard Character Set</dd>
<p><dt><strong><code>SPC</code></strong></dt><dd>Space Character</dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-sequences.yo .YODLTAGEND.
    
.YODLTAGSTART. label Sequences .YODLTAGEND.
<h2>Escape Sequences</h2>
    
<p><br><dl>
    <dt><strong><code>ESC # 8</code></strong></dt><dd>DEC Screen Alignment Test (DECALN)</dd>
<p><dt><strong><code>ESC 7</code><br><code>ESC 8</code></strong></dt><dd>Save Cursor (SC)<br>Restore Cursor</dd><p>.YODLTAGSTART. label ESCequals .YODLTAGEND.
    <dt><strong><code>ESC =</code><br><code>ESC &gt;</code></strong></dt><dd>Application Keypad (SMKX) == <a href=".YODLTAGSTART. solvelink Priv66 .YODLTAGEND."><code>ESC[?66h</code></a><br>Normal Keypad (RMKX) == <a href=".YODLTAGSTART. solvelink Priv66 .YODLTAGEND."><code>ESC[?66l</code></a></dd><br><strong>Note:</strong> If the numeric keypad is activated, eg, <strong>Num_Lock</strong> has been
    pressed, numbers or control functions are generated by the numeric keypad
    (see <a href=".YODLTAGSTART. solvelink KeyCodes .YODLTAGEND.">Key Codes</a>)
<p><dt><strong><code>ESC D</code></strong></dt><dd>Index (IND)</dd>
<p><dt><strong><code>ESC E</code></strong></dt><dd>Next Line (NEL)</dd>
<p><dt><strong><code>ESC H</code></strong></dt><dd>Tab Set (HTS)</dd>
<p><dt><strong><code>ESC M</code></strong></dt><dd>Reverse Index (RI)</dd>
<p><dt><strong><code>ESC N</code></strong></dt><dd>Single Shift Select of G2 Character Set (SS2): affects next character
	only <em>unimplemented</em></dd>
<p><dt><strong><code>ESC O</code></strong></dt><dd>Single Shift Select of G3 Character Set (SS3): affects next character
	only <em>unimplemented</em></dd>
<p><dt><strong><code>ESC Z</code></strong></dt><dd>Obsolete form of <a href=".YODLTAGSTART. solvelink ESCOBPsc .YODLTAGEND."><code>ESC[c</code></a> <br>returns: <strong><code>ESC[?1;2C</code></strong> <em>rxvt compile-time option</em></dd>
<p><dt><strong><code>ESC c</code></strong></dt><dd>Full reset (RIS)</dd>
<p><dt><strong><code>ESC n</code></strong></dt><dd>Invoke the G2 Character Set (LS2)</dd>
<p><dt><strong><code>ESC o</code></strong></dt><dd>Invoke the G3 Character Set (LS3)</dd>
<p><dt><strong><code>ESC </code>(<code> C</code><br><code>ESC </code>)<code> C</code><br><code>ESC * C</code><br><code>ESC + C</code><br><code>ESC $ C</code></strong></dt><dd>Designate G0 Character Set (ISO 2022)<br>Designate G1 Character Set (ISO 2022)<br>Designate G2 Character Set (ISO 2022)<br>Designate G3 Character Set (ISO 2022)<br>Designate Kanji Character Set <br><em>where</em> <strong><code>C</code></strong> is <br><table>
<tr> 
<td> <strong><code>C = 0</code></strong> </td> 
<td> DEC Special Character and Line Drawing Set <br></td> 
 
</tr>
<tr> 
<td> <strong><code>C = A</code></strong> </td> 
<td> United Kingdom (UK) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>C = B</code></strong> </td> 
<td> United States (USASCII) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>C = &lt;</code></strong> </td> 
<td> Multinational character set <em>unimplemented</em> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>C = 5</code></strong> </td> 
<td> Finnish character set <em>unimplemented</em> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>C = C</code></strong> </td> 
<td> Finnish character set <em>unimplemented</em> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>C = K</code></strong> </td> 
<td> German character set <em>unimplemented</em> <br></td> 
 
</tr>
</table>  </dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-csi.yo .YODLTAGEND.
    
.YODLTAGSTART. label CSI .YODLTAGEND.
<h2>CSI (Code Sequence Introducer) Sequences</h2>
    
<p><br><dl>
    <dt><strong><code>ESC [ Ps @</code></strong></dt><dd>Insert <strong><code>Ps</code></strong> (Blank) Character(s) [default: 1] (ICH)</dd><p>.YODLTAGSTART. label ESCOBPsA .YODLTAGEND.
    <dt><strong><code>ESC [ Ps A</code></strong></dt><dd>Cursor Up <strong><code>Ps</code></strong> Times [default: 1] (CUU)</dd>
<p><dt><strong><code>ESC [ Ps B</code></strong></dt><dd>Cursor Down <strong><code>Ps</code></strong> Times [default: 1] (CUD)</dd>.YODLTAGSTART. label ESCOBPsC .YODLTAGEND.
    <dt><strong><code>ESC [ Ps C</code></strong></dt><dd>Cursor Forward <strong><code>Ps</code></strong> Times [default: 1] (CUF)</dd>
<p><dt><strong><code>ESC [ Ps D</code></strong></dt><dd>Cursor Backward <strong><code>Ps</code></strong> Times [default: 1] (CUB)</dd>
<p><dt><strong><code>ESC [ Ps E</code></strong></dt><dd>Cursor Down <strong><code>Ps</code></strong> Times [default: 1] and to first column</dd>
<p><dt><strong><code>ESC [ Ps F</code></strong></dt><dd>Cursor Up <strong><code>Ps</code></strong> Times [default: 1] and to first column</dd><p>.YODLTAGSTART. label ESCOBPsG .YODLTAGEND.
    <dt><strong><code>ESC [ Ps G</code></strong></dt><dd>Cursor to Column <strong><code>Ps</code></strong> (HPA)</dd>
<p><dt><strong><code>ESC [ Ps;Ps H</code></strong></dt><dd>Cursor Position [row;column] [default: 1;1] (CUP)</dd>
<p><dt><strong><code>ESC [ Ps I</code></strong></dt><dd>Move forward <strong><code>Ps</code></strong> tab stops [default: 1]</dd>
<p><dt><strong><code>ESC [ Ps J</code></strong></dt><dd>Erase in Display (ED) <br><table>
<tr> 
<td> <strong><code>Ps = 0</code></strong> </td> 
<td> Clear Below (default) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 1</code></strong> </td> 
<td> Clear Above <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 2</code></strong> </td> 
<td> Clear All <br></td> 
 
</tr>
</table>  </dd>
    <dt><strong><code>ESC [ Ps K</code></strong></dt><dd>Erase in Line (EL) <br><table>
<tr> 
<td> <strong><code>Ps = 0</code></strong> </td> 
<td> Clear to Right (default) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 1</code></strong> </td> 
<td> Clear to Left <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 2</code></strong> </td> 
<td> Clear All <br></td> 
 
</tr>
</table>  </dd>
    <dt><strong><code>ESC [ Ps L</code></strong></dt><dd>Insert <strong><code>Ps</code></strong> Line(s) [default: 1] (IL)</dd>
<p><dt><strong><code>ESC [ Ps M</code></strong></dt><dd>Delete <strong><code>Ps</code></strong> Line(s) [default: 1] (DL)</dd>
<p><dt><strong><code>ESC [ Ps P</code></strong></dt><dd>Delete <strong><code>Ps</code></strong> Character(s) [default: 1] (DCH)</dd>
<p><dt><strong><code>ESC [ Ps;Ps;Ps;Ps;Ps T</code></strong></dt><dd>Initiate <a href=".YODLTAGSTART. solvelink Mouse .YODLTAGEND.">hilite mouse tracking</a>.  <em>unimplemented</em>
	Parameters are [func;startx;starty;firstrow;lastrow].</dd>
<p><dt><strong><code>ESC [ Ps W</code></strong></dt><dd>Tabulator functions <br><table>
<tr> 
<td> <strong><code>Ps = 0</code></strong> </td> 
<td> Tab Set (HTS) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 2</code></strong> </td> 
<td> Tab Clear (TBC), Clear Current Column (default) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 5</code></strong> </td> 
<td> Tab Clear (TBC), Clear All <br></td> 
 
</tr>
</table>  </dd>
    <dt><strong><code>ESC [ Ps X</code></strong></dt><dd>Erase <strong><code>Ps</code></strong> Character(s) [default: 1] (ECH)</dd>
<p><dt><strong><code>ESC [ Ps Z</code></strong></dt><dd>Move backward <strong><code>Ps</code></strong> [default: 1] tab stops</dd>
<p><dt><strong><code>ESC [ Ps '</code></strong></dt><dd>== <a href=".YODLTAGSTART. solvelink ESCOBPsG .YODLTAGEND."><code>ESC [ Ps G</code></a></dd>
<p><dt><strong><code>ESC [ Ps a</code></strong></dt><dd>== <a href=".YODLTAGSTART. solvelink ESCOBPsC .YODLTAGEND."><code>ESC [ Ps C</code></a></dd><p>.YODLTAGSTART. label ESCOBPsc .YODLTAGEND.
    <dt><strong><code>ESC [ Ps c</code></strong></dt><dd>Send Device Attributes (DA)<br><strong><code>Ps = 0</code></strong> (or omitted) : request attributes from terminal <br>returns: <strong><code>ESC[?1;2c</code></strong> (``I am a VT100 with Advanced Video
	Option'')</dd>
<p><dt><strong><code>ESC [ Ps d</code></strong></dt><dd>Cursor to Line <strong><code>Ps</code></strong> (VPA)</dd>
<p><dt><strong><code>ESC [ Ps e</code></strong></dt><dd>== <a href=".YODLTAGSTART. solvelink ESCOBPsA .YODLTAGEND.">ESC [ Ps A</a></dd>
<p><dt><strong><code>ESC [ Ps;Ps f</code></strong></dt><dd>Horizontal and Vertical Position [row;column] (HVP) [default: 1;1]</dd>
<p><dt><strong><code>ESC [ Ps g</code></strong></dt><dd>Tab Clear (TBC) <br><table>
<tr> 
<td> <strong><code>Ps = 0</code></strong> </td> 
<td> Clear Current Column (default) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 3</code></strong> </td> 
<td> Clear All (TBC) <br></td> 
 
</tr>
</table>  </dd>
    <dt><strong><code>ESC [ Ps i</code></strong></dt><dd>Printing <br><table>
<tr> 
<td> <strong><code>Ps = 4</code></strong> </td> 
<td> disable transparent print mode (MC4) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 5</code></strong> </td> 
<td> enable transparent print mode (MC5) <em>unimplemented</em> <br></td> 
 
</tr>
</table>  </dd>
    <dt><strong><code>ESC [ Pm h</code><br><code>ESC [ Pm l</code></strong></dt><dd>Set Mode (SM) <br>Reset Mode (RM)<dl>
	    <dt><strong><code>Ps = 4</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Insert Mode (SMIR) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Replace Mode (RMIR) <br></td> 
 
</tr>
</table>  </dd>
	    <dt><strong><code>Ps = 20</code></strong> <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Automatic Newline (LNM) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Normal Linefeed (LNM) <br></td> 
 
</tr>
</table>  </dd>
	</dl></dd>
    <dt><strong><code>ESC [ Pm m</code></strong></dt><dd>Character Attributes (SGR) <br><table>
<tr> 
<td> <strong><code>Ps = 0</code></strong> </td> 
<td> Normal (default) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 1 / 22</code></strong> </td> 
<td> On / Off Bold (bright fg) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 4 / 24</code></strong> </td> 
<td> On / Off Underline <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 5 / 25</code></strong> </td> 
<td> On / Off Blink (bright bg) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 7 / 27</code></strong> </td> 
<td> On / Off Inverse <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 30 / 40</code></strong> </td> 
<td> fg/bg Black <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 31 / 41</code></strong> </td> 
<td> fg/bg Red <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 32 / 42</code></strong> </td> 
<td> fg/bg Green <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 33 / 43</code></strong> </td> 
<td> fg/bg Yellow <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 34 / 44</code></strong> </td> 
<td> fg/bg Blue <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 35 / 45</code></strong> </td> 
<td> fg/bg Magenta <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 36 / 46</code></strong> </td> 
<td> fg/bg Cyan <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 37 / 47</code></strong> </td> 
<td> fg/bg White <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 39 / 49</code></strong> </td> 
<td> fg/bg Default <br></td> 
 
</tr>
</table>  </dd>
    <dt><strong><code>ESC [ Ps n</code></strong></dt><dd>Device Status Report (DSR) <br><table>
<tr> 
<td> <strong><code>Ps = 5</code></strong> </td> 
<td> Status Report <strong><code>ESC [ 0 n</code></strong> (``OK'') <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 6</code></strong> </td> 
<td> Report Cursor Position (CPR) [row;column] as <strong><code>ESC [ r ; c R</code></strong> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 7</code></strong> </td> 
<td> Request Display Name <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 8</code></strong> </td> 
<td> Request Version Number (place in window title) <br></td> 
 
</tr>
</table>  </dd>
    <dt><strong><code>ESC [ Ps;Ps r</code></strong></dt><dd>Set Scrolling Region [top;bottom] <br>[default: full size of window] (CSR)</dd>
<p><dt><strong><code>ESC [ Ps x</code></strong></dt><dd>Request Terminal Parameters (DECREQTPARM)</dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-privatemodes.yo .YODLTAGEND.
    
.YODLTAGSTART. label PrivateModes .YODLTAGEND.
<h2>DEC Private Modes</h2>
    
<p><br><dl>
    <dt><strong><code>ESC [ ? Pm h</code></strong></dt><dd>DEC Private Mode Set (DECSET)</dd>
<p><dt><strong><code>ESC [ ? Pm l</code></strong></dt><dd>DEC Private Mode Reset (DECRST)</dd>
<p><dt><strong><code>ESC [ ? Pm r</code></strong></dt><dd>Restore previously saved DEC Private Mode Values.</dd>
<p><dt><strong><code>ESC [ ? Pm s</code></strong></dt><dd>Save DEC Private Mode Values.</dd>
<p><dt><strong><code>ESC [ ? Pm t</code></strong></dt><dd>Toggle DEC Private Mode Values (rxvt extension).</dd>
    <em>where</em> <br><dl>
        <dt><strong><code>Ps = 1</code></strong> (DECCKM)</dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Application Cursor Keys <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Normal Cursor Keys <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 2</code></strong> <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Designate USASCII for character sets G0-G3. <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 3</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> 132 Column Mode (DECCOLM) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> 80 Column Mode (DECCOLM) <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 4</code></strong> <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Smooth (Slow) Scroll (DECSCLM) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Jump (Fast) Scroll (DECSCLM) <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 5</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Reverse Video (DECSCNM) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Normal Video (DECSCNM) <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 6</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Origin Mode (DECOM) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Normal Cursor Mode (DECOM) <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 7</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Wraparound Mode (DECAWM) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> No Wraparound Mode (DECAWM) <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 8</code></strong> <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Auto-repeat Keys (DECARM) <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> No Auto-repeat Keys (DECARM) <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 9</code></strong> X10 XTerm <a href=".YODLTAGSTART. solvelink Mouse .YODLTAGEND.">mouse reporting</a></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Send Mouse X &amp; Y on button press. <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> No mouse reporting. <br></td> 
 
</tr>
</table>  </dd>.YODLTAGSTART. label Priv10 .YODLTAGEND.
        <dt><strong><code>Ps = 10</code></strong> (<strong>rxvt</strong>)</dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> <a href=".YODLTAGSTART. solvelink menuBar .YODLTAGEND.">menuBar</a> visible <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> <a href=".YODLTAGSTART. solvelink menuBar .YODLTAGEND.">menuBar</a> invisible <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 25</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Visible cursor {cnorm/cvvis} <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Invisible cursor {civis} <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 30</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> scrollBar visisble <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> scrollBar invisisble <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 35</code></strong> (<strong>rxvt</strong>)</dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Allow XTerm Shift+key sequences <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Disallow XTerm Shift+key sequences <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 38</code></strong> <em>unimplemented</em></dt><dd>Enter Tektronix Mode (DECTEK)</dd>
        <dt><strong><code>Ps = 40</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Allow 80/132 Mode <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Disallow 80/132 Mode <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 44</code></strong> <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Turn On Margin Bell <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Turn Off Margin Bell <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 45</code></strong> <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Reverse-wraparound Mode <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> No Reverse-wraparound Mode <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 46</code></strong> <em>unimplemented</em></dt><dd></dd>
<p><dt><strong><code>Ps = 47</code></strong> <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Use Alternate Screen Buffer <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Use Normal Screen Buffer <br></td> 
 
</tr>
</table>  </dd>.YODLTAGSTART. label Priv66 .YODLTAGEND.   
        <dt><strong><code>Ps = 66</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Application Keypad (DECPAM) == <a href=".YODLTAGSTART. solvelink ESCequals .YODLTAGEND."><code>ESC =</code></a> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Normal Keypad (DECPNM) == <a href=".YODLTAGSTART. solvelink ESCequals .YODLTAGEND."><code>ESC &gt;</code></a> <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 67</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Backspace key sends <strong><code>BS</code> (DECBKM)</strong> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Backspace key sends <strong><code>DEL</code></strong> <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 1000</code></strong> (X11 XTerm <a href=".YODLTAGSTART. solvelink Mouse .YODLTAGEND.">mouse reporting</a>)</dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Send Mouse X &amp; Y on button press and release. <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> No mouse reporting. <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 1001</code></strong> (X11 XTerm <a href=".YODLTAGSTART. solvelink Mouse .YODLTAGEND.">mouse tracking</a>) <em>unimplemented</em></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Use Hilite Mouse Tracking. <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> No mouse reporting. <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 1010</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Don't scroll to bottom on TTY output <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Scroll to bottom on TTY output <br></td> 
 
</tr>
</table>  </dd>
        <dt><strong><code>Ps = 1011</code></strong></dt><dd><table>
<tr> 
<td> <strong><code>h</code></strong> </td> 
<td> Scroll to bottom when a key is pressed <br></td> 
 
</tr>
<tr> 
<td> <strong><code>l</code></strong> </td> 
<td> Don't scroll to bottom when a key is pressed <br></td> 
 
</tr>
</table>  </dd>
   </dl>
</dl>
<p><br>
<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-xterm.yo .YODLTAGEND.
    
.YODLTAGSTART. label XTerm .YODLTAGEND.
<h2>XTerm Escape Sequences</h2>
    
<p><br><dl>
    <dt><strong><code>ESC ] Ps;Pt BEL</code></strong></dt><dd>Set XTerm Parameters <br><table>
<tr> 
<td> <strong><code>Ps = 0</code></strong> </td> 
<td> Change Icon Name and Window Title to <strong><code>Pt</code></strong> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 1</code></strong> </td> 
<td> Change Icon Name to <strong><code>Pt</code></strong> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 2</code></strong> </td> 
<td> Change Window Title to <strong><code>Pt</code></strong> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 10</code></strong> </td> 
<td> <a href=".YODLTAGSTART. solvelink menuBar .YODLTAGEND.">menuBar</a> command <strong><code>Pt</code></strong> <em>rxvt compile-time option</em> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 20</code></strong> </td> 
<td> Change default background <a href=".YODLTAGSTART. solvelink XPM .YODLTAGEND.">pixmap</a> to <strong><code>Pt</code></strong> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 39</code></strong> </td> 
<td> Change default foreground colour to <strong><code>Pt</code></strong> <em>rxvt compile-time option</em> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 46</code></strong> </td> 
<td> Change Log File to <strong><code>Pt</code></strong> <em>unimplemented</em> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 49</code></strong> </td> 
<td> Change default background colour to <strong><code>Pt</code></strong> <em>rxvt compile-time option</em> <br></td> 
 
</tr>
<tr> 
<td> <strong><code>Ps = 50</code></strong> </td> 
<td> Set Font to <strong><code>Pt</code></strong>, with the following special values of <strong><code>Pt</code></strong> (<strong>rxvt</strong>) <br><strong><code>#+n</code></strong> change up <strong><code>n</code></strong> font(s) <br><strong><code>#-n</code></strong> change down <strong><code>n</code></strong> font(s) <br>if <strong><code>n</code></strong> is missing of 0, a value of 1 is used <br><em>empty</em> change to font0 <br><strong><code>n</code></strong> change to font <strong><code>n</code></strong> <br></td> 
 
</tr>
</table>  </dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-menubar.yo .YODLTAGEND.
    
.YODLTAGSTART. label menuBar .YODLTAGEND.
<h2>menuBar</h2>
    
<p><br><strong>The exact syntax used is <em>almost</em> solidified.</strong> <br>In the menus, <strong>DON'T</strong> try to use menuBar commands that add or remove a
menuBar.
<p><br>Note that in all of the commands, the <strong><em>/path/</em></strong> <em>cannot</em> be omitted:
use <strong>./</strong> to specify a menu relative to the current menu.
<p><br><h3>Overview of menuBar operation</h3><p>
<p><br>For the menuBar XTerm escape sequence <code>ESC ] 10; Pt BEL</code>, the
syntax of <code>Pt</code> can be used for a variety of tasks:
<ul>
    <li ><a href=".YODLTAGSTART. solvelink menuBarCommands .YODLTAGEND.">Commands</a>
    <li ><a href=".YODLTAGSTART. solvelink menuBarAdd .YODLTAGEND.">Adding and accessing menus</a>
    <li ><a href=".YODLTAGSTART. solvelink menuBarRemove .YODLTAGEND.">Removing menus</a>
    <li ><a href=".YODLTAGSTART. solvelink menuBarArrows .YODLTAGEND.">Quick Arrows</a>
    <li ><a href=".YODLTAGSTART. solvelink menuBarSummary .YODLTAGEND.">Command Summary</a>
</ul>
<p><br>At the top level is the current menuBar which is a member of a circular
linked-list of other such menuBars.
<p><br>The menuBar acts as a parent for the various drop-down menus, which in turn,
may have labels, separator lines, menuItems and subMenus.
<p><br>The menuItems are the useful bits: you can use them to mimic keyboard input
or even to send text or escape sequences back to rxvt.
<p><br>The menuBar syntax is intended to provide a simple yet robust method of
constructing and manipulating menus and navigating through the menuBars.
<p><br>The first step is to use the tag <strong>[menu:<em>name</em>]</strong> which creates the
menuBar called <em>name</em> and allows access.
You may now <a href=".YODLTAGSTART. solvelink menuBarAdd .YODLTAGEND.">add</a> or <a href=".YODLTAGSTART. solvelink menuBarRemove .YODLTAGEND.">remove</a> menus,
subMenus, and menuItems. Finally, use the tag <strong>[done]</strong> to set the menuBar
access as <strong>readonly</strong> to prevent accidental corruption of the menus.
To re-access the current menuBar for alterations, use the tag <strong>[menu]</strong>,
make the alterations and then use <strong>[done]</strong>
<p><br>.YODLTAGSTART. label menuBarCommands .YODLTAGEND.
<h3>Commands</h3><p>
<p><br><dl>
    <dt><strong>[menu:<em>name</em>]</strong></dt><dd>access the named menuBar for creation or alteration. If a new menuBar
	is created, it is called <em>name</em> (max of 15 chars) and the current
	menuBar is pushed onto the stack</dd>
<p><dt><strong>[menu]</strong></dt><dd>access the current menuBar for alteration</dd>
<p><dt><strong>[title:<em>string</em>]</strong></dt><dd>set the current menuBar's title to <em>string</em>, which may contain the
	following format specifiers: <br><strong>%%</strong> : literal <strong>%</strong> character <br><strong>%n</strong> : rxvt name (as per the <strong>-name</strong> command-line option) <br><strong>%v</strong> : rxvt version</dd>
<p><dt><strong>[done]</strong></dt><dd>set menuBar access as <strong>readonly</strong>. <br>End-of-file tag for <strong>[read:<em>file</em>]</strong> operations.</dd>
<p><dt><strong>[read:<em>file</em>]</strong></dt><dd>read menu commands directly from <em>file</em> (extension ".menu" will be
	appended if required.) Start reading at a line with <strong>[menu]</strong> or
	<strong>[menu:<em>name</em></strong> and continuing until <strong>[done]</strong> is encountered.
<p><br>Blank and comment lines (starting with <strong>#</strong>) are ignored.
	Actually, since any invalid menu commands are also ignored, almost
	anything could be construed as a comment line, but this may be
	tightened up in the future ... so don't count on it!.</dd>
<p><dt><strong>[read:<em>file</em>;<em>name</em>]</strong></dt><dd>The same as <strong>[read:<em>file</em>]</strong>, but start reading at a line with
	<strong>[menu:<em>name</em>]</strong> and continuing until <strong>[done:<em>name</em>]</strong> or
	<strong>[done]</strong> is encountered.</dd>
<p><dt><strong>[dump]</strong></dt><dd>dump all menuBars to the file <strong>/tmp/rxvt-PID</strong> in a format suitable
	for later rereading.</dd>
<p><dt><strong>[rm:name]<br>[rm] [rm:]<br>[rm*] [rm:*]</strong></dt><dd>remove the named menuBar <br>remove the current menuBar <br>remove all menuBars</dd>
<p><dt><strong>[swap]</strong></dt><dd>swap the top two menuBars</dd>
<p><dt><strong>[prev]<br>[next]</strong></dt><dd>access the previous or next menuBar</dd>
<p><dt><strong>[show]<br>[hide]</strong></dt><dd>control display of the menuBar ... just like
	<a href=".YODLTAGSTART. solvelink Priv10 .YODLTAGEND.">ESC[?10 h/l</a></dd>
<p><dt><strong>[pixmap:<em>name</em>]<br>[pixmap:<em>name</em>;<em>scaling</em>]</strong></dt><dd>set the background pixmap globally ... just like
	<a href=".YODLTAGSTART. solvelink XPM .YODLTAGEND.">ESC]20; Pt BEL</a>
<p><br><strong>A Future implementation <em>may</em> make this local to the menubar</strong></dd>
<p><dt><strong>[:<em>command</em>:]</strong></dt><dd>ignore the menu readonly status and issue a <em>command</em> to
	<a href=".YODLTAGSTART. solvelink menuBarAdd .YODLTAGEND.">Add/Modify</a> or <a href=".YODLTAGSTART. solvelink menuBarRemove .YODLTAGEND.">Remove</a> a menu or
	menuitem or change the <a href=".YODLTAGSTART. solvelink menuBarArrows .YODLTAGEND.">Quick Arrows</a>; a useful
	shortcut for setting the quick arrows from a menuBar.</dd>
</dl>
<p><br>.YODLTAGSTART. label menuBarAdd .YODLTAGEND.
<h3>Adding and accessing menus</h3><p>
<p><br>The following commands may also be <strong>+</strong> prefixed.
<dl>
    <dt><strong>/<br>./<br>../<br>../../</strong></dt><dd>access menuBar top level <br>access current menu level <br>access parent menu (1 level up) <br>access parent menu (multiple levels up)</dd>
    <dt><strong><em>/path/</em>menu</strong></dt><dd>add/access menu</dd>
    <dt><strong><em>/path/</em>menu/*</strong></dt><dd>add/access menu and clear it if it exists</dd>
    <dt><strong><em>/path/</em>{-}</strong></dt><dd>add separator</dd>
    <dt><strong><em>/path/</em>{item}</strong></dt><dd>add <strong>item</strong> as a label</dd>
    <dt><strong><em>/path/</em>{item} action</strong></dt><dd>add/alter <em>menuitem</em> with an associated <em>action</em></dd>
    <dt><strong><em>/path/</em>{item}{right-text}</strong></dt><dd>add/alter <em>menuitem</em> with <strong>right-text</strong> as the right-justified
	text and as the associated <em>action</em></dd>
    <dt><strong><em>/path/</em>{item}{rtext} action</strong></dt><dd>add/alter <em>menuitem</em> with an associated <em>action</em> and with
	<strong>rtext</strong> as the right-justified text.</dd>
</dl>
<dl>
    <dt>Special characters in <em>action</em> must be backslash-escaped:</dt><dd><strong>\a \b \E \e \n \r \t \octal</strong></dd>
    <dt>or in control-character notation:</dt><dd><strong>^@, ^A .. ^Z .. ^_, ^?</strong></dd>
</dl>
<p><br>To send a string starting with a <strong>NUL</strong> (<strong>^@</strong>) character to the program,
start <em>action</em> with a pair of <strong>NUL</strong> characters (<strong>^@^@</strong>), the first of
which will be stripped off and the balance directed to the program.
Otherwise if <em>action</em> begins with <strong>NUL</strong> followed by non-<strong>NUL</strong>
characters, the leading <strong>NUL</strong> is stripped off and the balance is sent back
to rxvt.
<p><br>As a convenience for the many Emacs-type editors, <em>action</em> may start
with <strong>M-</strong> (eg, <strong>M-$</strong> is equivalent to <strong>\E$</strong>) and a <strong>CR</strong> will be
appended if missed from <strong>M-x</strong> commands.
<p><br>As a convenience for issuing XTerm <strong>ESC]</strong> sequences from a menubar
(or quick arrow), a <strong>BEL</strong> (<strong>^G</strong>) will be appended if needed.
<p><br><dl>
    <dt>For example,</dt><dd><strong>M-xapropos</strong> is equivalent to <strong>\Exapropos\r</strong></dd>
    <dt>and</dt><dd><strong>\E]10;mona;100</strong> is equivalent to <strong>\E]10;mona;100\a</strong></dd>
</dl>
<p><br>The option <strong>{<em>right-rtext</em>}</strong> will be right-justified.  In the absence of
a specified action, this text will be used as the <em>action</em> as well.
<p><br><dl>
    <dt>For example,</dt><dd><strong>/File/{Open}{^X^F}</strong> is equivalent to <strong>/File/{Open}{^X^F} ^X^F</strong></dd>
</dl>
<p><br>The left label <em>is</em> necessary, since it's used for matching,
but implicitly hiding the left label (by using same name for both left
and right labels), or explicitly hiding the left label (by preceeding
it with a dot), makes it possible to have right-justified text only.
<dl>
    <dt>For example,</dt><dd><strong>/File/{Open}{Open} Open-File-Action</strong></dd>
    <dt>or hiding it</dt><dd><strong>/File/{.anylabel}{Open} Open-File-Action</strong></dd>
</dl>
<p><br>.YODLTAGSTART. label menuBarRemove .YODLTAGEND.
<h3>Removing menus</h3><p>
<p><br><dl>
    <dt><strong>-/*<br>-<em>/path</em>menu<br>-<em>/path</em>{item}<br>-<em>/path</em>{-}</strong></dt><dd>remove all menus from the menuBar, the same as <strong>[clear]</strong><br>remove menu <br>remove item <br>remove separator</dd>
    <dt><strong>-/path/menu/*</strong></dt><dd>remove all items, separators and submenus from menu</dd>
</dl>
<p><br>.YODLTAGSTART. label menuBarArrows .YODLTAGEND.
<h3>Quick Arrows</h3><p>
<p><br>The menus also provide a hook for <em>quick arrows</em> 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 without 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:
<p><br><dl>
    <dt><strong>&lt;r&gt;<em>Right</em><br>&lt;l&gt;<em>Left</em><br>&lt;u&gt;<em>Up</em><br>&lt;d&gt;<em>Down</em></strong></dt><dd>Define actions for the respective arrow buttons</dd>
    <dt><strong>&lt;b&gt;<em>Begin</em><br>&lt;e&gt;<em>End</em></strong></dt><dd>Define common beginning/end parts for <em>quick arrows</em> which used
	in conjunction with the above &lt;r&gt; &lt;l&gt; &lt;u&gt; &lt;d&gt; constructs</dd>
</dl>
<p><br><dl>
    <dt>For example, define arrows individually,</dt><dd><strong>&lt;u&gt;\E[A <br>&lt;d&gt;\E[B <br>&lt;r&gt;\E[C <br>&lt;l&gt;\E[D</strong></dd>
    <dt>or all at once</dt><dd><strong>&lt;u&gt;\E[A&lt;d&gt;\E[B&lt;r&gt;\E[C&lt;l&gt;\E[D</strong></dd>
    <dt>or more compactly (factoring out common parts)</dt><dd><strong>&lt;b&gt;\E[&lt;u&gt;A&lt;d&gt;B&lt;r&gt;C&lt;l&gt;D</strong></dd>
</dl>
<p><br>.YODLTAGSTART. label menuBarSummary .YODLTAGEND.
<h3>Command Summary</h3><p>
<p><br>A short summary of the most <em>common</em> commands:
<p><br><dl>
    <dt>[menu:name]</dt><dd>use an existing named menuBar or start a new one</dd>
    <dt>[menu]</dt><dd>use the current menuBar</dd>
    <dt>[title:string]</dt><dd>set menuBar title</dd>
    <dt>[done]</dt><dd>set menu access to readonly and, if reading from a file, signal EOF</dd>
    <dt>[done:name]</dt><dd>if reading from a file using [read:file;name] signal EOF</dd>
    <dt>[rm:name]<br>[rm] [rm:]<br>[rm*] [rm:*]</dt><dd>remove named, current, or all menuBar(s)</dd>
    <dt>[swap]</dt><dd>swap top two menuBars</dd>
    <dt>[prev]<br>[next]</dt><dd>access the previous/next menuBar</dd>
    <dt>[show]<br>[hide]</dt><dd>map/unmap menuBar</dd>
    <dt>[pixmap;file]<br>[pixmap;file;scaling]</dt><dd>set a background pixmap</dd>
    <dt>[read:file]<br>[read:file;name]</dt><dd>read in a menu from a file</dd>
    <dt>[dump]</dt><dd>dump out all menuBars to /tmp/rxvt-PID</dd>
    <dt>/</dt><dd>access menuBar top level</dd>
    <dt>./<br>../<br>../../</dt><dd>access current or parent menu level</dd>
    <dt>/path/menu</dt><dd>add/access menu</dd>
    <dt>/path/{-}</dt><dd>add separator</dd>
    <dt>/path/{item}{rtext} action</dt><dd>add/alter menu item<br>({rtext} and/or action, may be omitted)</dd>
    <dt>-/*</dt><dd>remove all menus from the menuBar</dd>
    <dt>-/path/menu</dt><dd>remove menu items, separators and submenus from menu</dd>
    <dt>-/path/menu</dt><dd>remove menu</dd>
    <dt>-/path/{item}</dt><dd>remove item</dd>
    <dt>-/path/{-}</dt><dd>remove separator</dd>
    <dt>&lt;b&gt;Begin&lt;r&gt;Right&lt;l&gt;Left&lt;u&gt;Up&lt;d&gt;Down&lt;e&gt;End</dt><dd>menu quick arrows</dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-xpm.yo .YODLTAGEND.
    
.YODLTAGSTART. label background image .YODLTAGEND.
<h2>background image</h2>
    
<p><br>For the background image XTerm escape sequence <strong><code>ESC ] 20; Pt BEL</code></strong> then value of
<strong><code>Pt</code></strong> can be the name of the background pixmap followed by a sequence of
scaling/positioning commands separated by semi-colons. The scaling/positioning
commands are as follows:
<p><br><dl>
    <dt>query scale/position</dt><dd><strong>?</strong></dd>
<p><dt>background image change scale and position</dt><dd><strong>WxH+X+Y</strong><br><strong>WxH+X</strong> (== <strong>WxH+X+X</strong>)<br><strong>WxH</strong> (same as <strong>WxH+50+50</strong>)<br><strong>W+X+Y</strong> (same as <strong>WxW+X+Y</strong>)<br><strong>W+X</strong> (same as <strong>WxW+X+X</strong>)<br><strong>W</strong> (same as <strong>WxW+50+50</strong>)</dd>
<p><dt>change position (absolute)</dt><dd><strong>=+X+Y</strong><br><strong>=+X</strong> (same as <strong>=+X+Y</strong>)</dd>
<p><dt>change position (relative)</dt><dd><strong>+X+Y</strong><br><strong>+X</strong> (same as <strong>+X+Y</strong>)</dd>
<p><dt>rescale (relative)</dt><dd><strong>Wx0</strong> -&gt; <strong>W *= (W/100)</strong><br><strong>0xH</strong> -&gt; <strong>H *= (H/100)</strong></dd>
</dl>
<p><br>Note:
    when width is 1, the pixmap is not tiled across and if x is also -0 it
    is centred.  Similarly, for height and y.
<p><br>For example:
<p><br><dl>
    <dt><strong>\E]20;funky\a</strong></dt><dd>load <strong>funky.xpm</strong> as a tiled image</dd>
<p><dt><strong>\E]20;mona;100\a</strong></dt><dd>load <strong>mona.xpm</strong> with a scaling of 100%</dd>
<p><dt><strong>\E]20;;200;?\a</strong></dt><dd>rescale the current pixmap to 200% and display the image geometry in the title</dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-mouse.yo .YODLTAGEND.
    
.YODLTAGSTART. label Mouse .YODLTAGEND.
<h2>Mouse Reporting</h2>
    
<p><br><dl>
    <dt><strong><code>ESC [ M &lt;b&gt; &lt;x&gt; &lt;y&gt;</code></strong></dt><dd>report mouse position</dd>
</dl>
The lower 2 bits of <strong><code>&lt;b&gt;</code></strong> indicate the button:
<dl>
    <dt>Button = <strong><code>(&lt;b&gt; - SPACE) &amp; 3</code></strong></dt><dd>0 = Button1 pressed <br>1 = Button2 pressed <br>2 = Button3 pressed <br>3 = button released (X11 mouse report)</dd>
</dl>
<p><br>The upper bits of <strong><code>&lt;b&gt;</code></strong> indicate the modifiers when the button was
pressed and are added together (X11 mouse report only):
<p><br><dl>
    <dt>State = <strong><code>(&lt;b&gt; - SPACE) &amp; 60</code></strong></dt><dd>4 = Shift <br>8 = Meta <br>16 = Control <br>32 = Double Click <em>(Rxvt extension)</em> <br>Col = <strong><code>&lt;x&gt; - SPACE</code></strong> <br>Row = <strong><code>&lt;y&gt; - SPACE</code></strong></dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-graphics.yo .YODLTAGEND.
    
.YODLTAGSTART. label Graphics .YODLTAGEND.
<h2>Special Graphics Mode</h2>
    
<p><br>Add more documentation here, <em>if anyone actually cares.</em>
<p><br><dl>
    <dt><strong><code>ESC G Q</code></strong></dt><dd>query if graphics are available <br>returns: <strong><code>ESC G 0</code></strong> no graphics available <br>returns: <strong><code>ESC G 1</code></strong> graphics available (colour only)</dd>
<p><dt><strong><code>ESC G W &lt;;x&gt;;&lt;y&gt;;&lt;w&gt;;&lt;h&gt;:</code></strong></dt><dd>create window</dd>
<p><dt><strong><code>ESC G C &lt;id&gt;</code></strong></dt><dd>clear window</dd>
<p><dt><strong><code>ESC G G &lt;it&gt;:</code></strong></dt><dd>query window <br>returns: <strong><code>ESC G &lt;id&gt; &lt;x&gt; &lt;y&gt; &lt;w&gt; &lt;h&gt; &lt;fw&gt; &lt;fh&gt; &lt;nw&gt; &lt;nh&gt;</code></strong></dd>
<p><dt><strong><code>ESC G L &lt;id&gt;</code><br><code>ESC G P &lt;id&gt;</code><br><code>ESC G F &lt;id&gt;</code></strong></dt><dd>start point <br>start line <br>start fill</dd>
<p><dt><strong><code>;&lt;x&gt;;&lt;y&gt;</code></strong></dt><dd>extend point/line/fill</dd>
<p><dt><strong><code>ESC G T &lt;id&gt;;&lt;x&gt;;&lt;y&gt;;&lt;mode&gt;;&lt;len&gt;:&lt;text&gt;</code></strong></dt><dd>place text</dd>
</dl>

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
<p><hr><p><br>
.YODLTAGSTART. label rxvtRef-keycodes.yo .YODLTAGEND.
    
.YODLTAGSTART. label KeyCodes .YODLTAGEND.
<h2>Key Codes</h2>
    
<p><br>Note: <strong>Shift</strong> + <strong>F1</strong>-<strong>F10</strong> generates <strong>F11</strong>-<strong>F20</strong>
<p><br>For the keypad, use <strong>Shift</strong> to temporarily override Application-Keypad
setting use <strong>Num_Lock</strong> to toggle Application-Keypad setting if <strong>Num_Lock</strong>
is off, <a href=".YODLTAGSTART. solvelink ESCequals .YODLTAGEND.">escape sequences</a> toggle Application-Keypad setting.
Also note that values of <strong>Home</strong>, <strong>End</strong>, <strong>Delete</strong> may have been compiled
differently on your system.
<p><br>
<table border=1>
<tr> 
<td>                 </td> 
<td> <strong>Normal</strong>      </td> 
<td> <strong>Shift</strong>       </td> 
<td> <strong>Control</strong>     </td> 
<td> <strong>Ctrl+Shift</strong> <br></td> 
 
</tr>
<tr> 
<td> Tab             </td> 
<td> ^I          </td> 
<td> ESC [ Z     </td> 
<td> ^I          </td> 
<td> ESC [ Z <br></td> 
 
</tr>
<tr> 
<td> BackSpace       </td> 
<td> ^H          </td> 
<td> ^?          </td> 
<td> ^?          </td> 
<td> ^? <br></td> 
 
</tr>
<tr> 
<td> Find            </td> 
<td> ESC [ 1 ~   </td> 
<td> ESC [ 1 $   </td> 
<td> ESC [ 1 ^   </td> 
<td> ESC [ 1 @ <br></td> 
 
</tr>
<tr> 
<td> Insert          </td> 
<td> ESC [ 2 ~   </td> 
<td> <em>paste</em>       </td> 
<td> ESC [ 2 ^   </td> 
<td> ESC [ 2 @ <br></td> 
 
</tr>
<tr> 
<td> Execute         </td> 
<td> ESC [ 3 ~   </td> 
<td> ESC [ 3 $   </td> 
<td> ESC [ 3 ^   </td> 
<td> ESC [ 3 @ <br></td> 
 
</tr>
<tr> 
<td> Select          </td> 
<td> ESC [ 4 ~   </td> 
<td> ESC [ 4 $   </td> 
<td> ESC [ 4 ^   </td> 
<td> ESC [ 4 @ <br></td> 
 
</tr>
<tr> 
<td> Prior           </td> 
<td> ESC [ 5 ~   </td> 
<td> <em>scroll-up</em>   </td> 
<td> ESC [ 5 ^   </td> 
<td> ESC [ 5 @ <br></td> 
 
</tr>
<tr> 
<td> Next            </td> 
<td> ESC [ 6 ~   </td> 
<td> <em>scroll-down</em> </td> 
<td> ESC [ 6 ^   </td> 
<td> ESC [ 6 @ <br></td> 
 
</tr>
<tr> 
<td> Home            </td> 
<td> ESC [ 7 ~   </td> 
<td> ESC [ 7 $   </td> 
<td> ESC [ 7 ^   </td> 
<td> ESC [ 7 @ <br></td> 
 
</tr>
<tr> 
<td> End             </td> 
<td> ESC [ 8 ~   </td> 
<td> ESC [ 8 $   </td> 
<td> ESC [ 8 ^   </td> 
<td> ESC [ 8 @ <br></td> 
 
</tr>
<tr> 
<td> Delete          </td> 
<td> ESC [ 3 ~   </td> 
<td> ESC [ 3 $   </td> 
<td> ESC [ 3 ^   </td> 
<td> ESC [ 3 @ <br></td> 
 
</tr>
<tr> 
<td> F1              </td> 
<td> ESC [ 11 ~  </td> 
<td> ESC [ 23 ~  </td> 
<td> ESC [ 11 ^  </td> 
<td> ESC [ 23 ^ <br></td> 
 
</tr>
<tr> 
<td> F2              </td> 
<td> ESC [ 12 ~  </td> 
<td> ESC [ 24 ~  </td> 
<td> ESC [ 12 ^  </td> 
<td> ESC [ 24 ^ <br></td> 
 
</tr>
<tr> 
<td> F3              </td> 
<td> ESC [ 13 ~  </td> 
<td> ESC [ 25 ~  </td> 
<td> ESC [ 13 ^  </td> 
<td> ESC [ 25 ^ <br></td> 
 
</tr>
<tr> 
<td> F4              </td> 
<td> ESC [ 14 ~  </td> 
<td> ESC [ 26 ~  </td> 
<td> ESC [ 14 ^  </td> 
<td> ESC [ 26 ^ <br></td> 
 
</tr>
<tr> 
<td> F5              </td> 
<td> ESC [ 15 ~  </td> 
<td> ESC [ 28 ~  </td> 
<td> ESC [ 15 ^  </td> 
<td> ESC [ 28 ^ <br></td> 
 
</tr>
<tr> 
<td> F6              </td> 
<td> ESC [ 17 ~  </td> 
<td> ESC [ 29 ~  </td> 
<td> ESC [ 17 ^  </td> 
<td> ESC [ 29 ^ <br></td> 
 
</tr>
<tr> 
<td> F7              </td> 
<td> ESC [ 18 ~  </td> 
<td> ESC [ 31 ~  </td> 
<td> ESC [ 18 ^  </td> 
<td> ESC [ 31 ^ <br></td> 
 
</tr>
<tr> 
<td> F8              </td> 
<td> ESC [ 19 ~  </td> 
<td> ESC [ 32 ~  </td> 
<td> ESC [ 19 ^  </td> 
<td> ESC [ 32 ^ <br></td> 
 
</tr>
<tr> 
<td> F9              </td> 
<td> ESC [ 20 ~  </td> 
<td> ESC [ 33 ~  </td> 
<td> ESC [ 20 ^  </td> 
<td> ESC [ 33 ^ <br></td> 
 
</tr>
<tr> 
<td> F10             </td> 
<td> ESC [ 21 ~  </td> 
<td> ESC [ 34 ~  </td> 
<td> ESC [ 21 ^  </td> 
<td> ESC [ 34 ^ <br></td> 
 
</tr>
<tr> 
<td> F11             </td> 
<td> ESC [ 23 ~  </td> 
<td> ESC [ 23 $  </td> 
<td> ESC [ 23 ^  </td> 
<td> ESC [ 23 @ <br></td> 
 
</tr>
<tr> 
<td> F12             </td> 
<td> ESC [ 24 ~  </td> 
<td> ESC [ 24 $  </td> 
<td> ESC [ 24 ^  </td> 
<td> ESC [ 24 @ <br></td> 
 
</tr>
<tr> 
<td> F13             </td> 
<td> ESC [ 25 ~  </td> 
<td> ESC [ 25 $  </td> 
<td> ESC [ 25 ^  </td> 
<td> ESC [ 25 @ <br></td> 
 
</tr>
<tr> 
<td> F14             </td> 
<td> ESC [ 26 ~  </td> 
<td> ESC [ 26 $  </td> 
<td> ESC [ 26 ^  </td> 
<td> ESC [ 26 @ <br></td> 
 
</tr>
<tr> 
<td> F15 (Help)      </td> 
<td> ESC [ 28 ~  </td> 
<td> ESC [ 28 $  </td> 
<td> ESC [ 28 ^  </td> 
<td> ESC [ 28 @ <br></td> 
 
</tr>
<tr> 
<td> F16 (Menu)      </td> 
<td> ESC [ 29 ~  </td> 
<td> ESC [ 29 $  </td> 
<td> ESC [ 29 ^  </td> 
<td> ESC [ 29 @ <br></td> 
 
</tr>
<tr> 
<td> F17             </td> 
<td> ESC [ 31 ~  </td> 
<td> ESC [ 31 $  </td> 
<td> ESC [ 31 ^  </td> 
<td> ESC [ 31 @ <br></td> 
 
</tr>
<tr> 
<td> F18             </td> 
<td> ESC [ 32 ~  </td> 
<td> ESC [ 32 $  </td> 
<td> ESC [ 32 ^  </td> 
<td> ESC [ 32 @ <br></td> 
 
</tr>
<tr> 
<td> F19             </td> 
<td> ESC [ 33 ~  </td> 
<td> ESC [ 33 $  </td> 
<td> ESC [ 33 ^  </td> 
<td> ESC [ 33 @ <br></td> 
 
</tr>
<tr> 
<td> F20             </td> 
<td> ESC [ 34 ~  </td> 
<td> ESC [ 34 $  </td> 
<td> ESC [ 34 ^  </td> 
<td> ESC [ 34 @ <br></td> 
 
</tr>
<tr> 
<td>                 </td> 
<td>             </td> 
<td>             </td> 
<td>             </td> 
<td> <strong>Application</strong> <br></td> 
 
</tr>
<tr> 
<td> Up              </td> 
<td> ESC [ A     </td> 
<td> ESC [ a     </td> 
<td> ESC O a     </td> 
<td> ESC O A <br></td> 
 
</tr>
<tr> 
<td> Down            </td> 
<td> ESC [ B     </td> 
<td> ESC [ b     </td> 
<td> ESC O b     </td> 
<td> ESC O B <br></td> 
 
</tr>
<tr> 
<td> Right           </td> 
<td> ESC [ C     </td> 
<td> ESC [ c     </td> 
<td> ESC O c     </td> 
<td> ESC O C <br></td> 
 
</tr>
<tr> 
<td> Left            </td> 
<td> ESC [ D     </td> 
<td> ESC [ d     </td> 
<td> ESC O d     </td> 
<td> ESC O D <br></td> 
 
</tr>
<tr> 
<td> KP_Enter        </td> 
<td> ^M          </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O M <br></td> 
 
</tr>
<tr> 
<td> KP_F1           </td> 
<td> ESC O P     </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O P <br></td> 
 
</tr>
<tr> 
<td> KP_F2           </td> 
<td> ESC O Q     </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O Q <br></td> 
 
</tr>
<tr> 
<td> KP_F3           </td> 
<td> ESC O R     </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O R <br></td> 
 
</tr>
<tr> 
<td> KP_F4           </td> 
<td> ESC O S     </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O S <br></td> 
 
</tr>
<tr> 
<td> XK_KP_Multiply  </td> 
<td> *           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O j <br></td> 
 
</tr>
<tr> 
<td> XK_KP_Add       </td> 
<td> +           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O k <br></td> 
 
</tr>
<tr> 
<td> XK_KP_Separator </td> 
<td> ,           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O l <br></td> 
 
</tr>
<tr> 
<td> XK_KP_Subtract  </td> 
<td> -           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O m <br></td> 
 
</tr>
<tr> 
<td> XK_KP_Decimal   </td> 
<td> .           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O n <br></td> 
 
</tr>
<tr> 
<td> XK_KP_Divide    </td> 
<td> /           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O o <br></td> 
 
</tr>
<tr> 
<td> XK_KP_0         </td> 
<td> 0           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O p <br></td> 
 
</tr>
<tr> 
<td> XK_KP_1         </td> 
<td> 1           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O q <br></td> 
 
</tr>
<tr> 
<td> XK_KP_2         </td> 
<td> 2           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O r <br></td> 
 
</tr>
<tr> 
<td> XK_KP_3         </td> 
<td> 3           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O s <br></td> 
 
</tr>
<tr> 
<td> XK_KP_4         </td> 
<td> 4           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O t <br></td> 
 
</tr>
<tr> 
<td> XK_KP_5         </td> 
<td> 5           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O u <br></td> 
 
</tr>
<tr> 
<td> XK_KP_6         </td> 
<td> 6           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O v <br></td> 
 
</tr>
<tr> 
<td> XK_KP_7         </td> 
<td> 7           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O w <br></td> 
 
</tr>
<tr> 
<td> XK_KP_8         </td> 
<td> 8           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O x <br></td> 
 
</tr>
<tr> 
<td> XK_KP_9         </td> 
<td> 9           </td> 
<td>             </td> 
<td>             </td> 
<td> ESC O y <br></td> 
 
</tr>
</table>  

<a href=".YODLTAGSTART. solvelink toc .YODLTAGEND.">Top</a>
