ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.html
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.html (file contents):
Revision 1.26 by root, Sat Dec 17 20:55:45 2005 UTC vs.
Revision 1.43 by root, Thu Jan 12 05:37:34 2006 UTC

… …
46<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 46<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
47<p> 47<p>
48</p> 48</p>
49<hr /> 49<hr />
50<h1><a name="description">DESCRIPTION</a></h1> 50<h1><a name="description">DESCRIPTION</a></h1>
51<p><strong>rxvt-unicode</strong>, version <strong>5.9</strong>, is a colour vt102 terminal 51<p><strong>rxvt-unicode</strong>, version <strong>7.0</strong>, is a colour vt102 terminal
52emulator intended as an <em>xterm</em>(1) replacement for users who do not 52emulator intended as an <em>xterm</em>(1) replacement for users who do not
53require features such as Tektronix 4014 emulation and toolkit-style 53require features such as Tektronix 4014 emulation and toolkit-style
54configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 54configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
55a significant advantage on a machine serving many X sessions.</p> 55a significant advantage on a machine serving many X sessions.</p>
56<p> 56<p>
… …
266</dd> 266</dd>
267<p></p> 267<p></p>
268<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br /> 268<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br />
269</dt> 269</dt>
270<dd> 270<dd>
271Compile font-styles: The bold font list to use when bold characters are to 271Compile <em>font-styles</em>: The bold font list to use when <strong>bold</strong> characters
272be printed. See resource <strong>boldFont</strong> for details. 272are to be printed. See resource <strong>boldFont</strong> for details.
273</dd> 273</dd>
274<p></p> 274<p></p>
275<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br /> 275<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br />
276</dt> 276</dt>
277<dd> 277<dd>
278Compile font-styles: The italic font list to use when bold characters are to 278Compile <em>font-styles</em>: The italic font list to use when <em>italic</em>
279be printed. See resource <strong>italicFont</strong> for details. 279characters are to be printed. See resource <strong>italicFont</strong> for details.
280</dd> 280</dd>
281<p></p> 281<p></p>
282<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br /> 282<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br />
283</dt> 283</dt>
284<dd> 284<dd>
285Compile font-styles: The bold italic font list to use when bold characters are to 285Compile <em>font-styles</em>: The bold italic font list to use when <strong><em>bold
286be printed. See resource <strong>boldItalicFont</strong> for details. 286italic</em> </strong>&gt; characters are to be printed. See resource <strong>boldItalicFont</strong>
287for details.
288</dd>
289<p></p>
290<dt><strong><a name="item__2dis_7c_2bis"><strong>-is</strong>|<strong>+is</strong></a></strong><br />
291</dt>
292<dd>
293Compile <em>font-styles</em>: Bold/Italic font styles imply high intensity
294foreground/background (default). See resource <strong>intensityStyles</strong> for
295details.
287</dd> 296</dd>
288<p></p> 297<p></p>
289<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br /> 298<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br />
290</dt> 299</dt>
291<dd> 300<dd>
… …
404</dt> 413</dt>
405<dd> 414<dd>
406Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e. 415Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e.
407if honoured by the WM, the rxvt-unicode window will not have window 416if honoured by the WM, the rxvt-unicode window will not have window
408decorations; resource <strong>borderLess</strong>. 417decorations; resource <strong>borderLess</strong>.
418</dd>
419<p></p>
420<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br />
421</dt>
422<dd>
423Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
424drawing characters and just rely on what the specified fonts provide. Use
425this if you have a good font and want to use its block graphic glyphs;
426resource <strong>skipBuiltinGlyphs</strong>.
409</dd> 427</dd>
410<p></p> 428<p></p>
411<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br /> 429<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br />
412</dt> 430</dt>
413<dd> 431<dd>
… …
434given on the command line. If this option is used, it must be the last 452given on the command line. If this option is used, it must be the last
435on the command-line. If there is no <strong>-e</strong> option then the default is to 453on the command-line. If there is no <strong>-e</strong> option then the default is to
436run the program specified by the <strong>SHELL</strong> environment variable or, 454run the program specified by the <strong>SHELL</strong> environment variable or,
437failing that, <em>sh(1)</em>. 455failing that, <em>sh(1)</em>.
438</dd> 456</dd>
457<dd>
458<p>Please note that you must specify a program with arguments. If you want to
459run shell commands, you have to specify the shell, like this:</p>
460</dd>
461<dd>
462<pre>
463 rxvt -e sh -c &quot;shell commands&quot;</pre>
464</dd>
439<p></p> 465<p></p>
440<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br /> 466<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br />
441</dt> 467</dt>
442<dd> 468<dd>
443Window title (<strong>-T</strong> still respected); the default title is the basename 469Window title (<strong>-T</strong> still respected); the default title is the basename
… …
522<dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong><br /> 548<dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong><br />
523</dt> 549</dt>
524<dd> 550<dd>
525Turn on/off secondary screen scroll (default enabled); resource 551Turn on/off secondary screen scroll (default enabled); resource
526<strong>secondaryScroll</strong>. 552<strong>secondaryScroll</strong>.
553</dd>
554<p></p>
555<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br />
556</dt>
557<dd>
558Turn on/off hold window after exit support. If enabled, rxvt
559will not immediately destroy its window when the program executed within
560it exits. Instead, it will wait till it is being killed or closed by the
561user; resource <strong>hold</strong>.
527</dd> 562</dd>
528<p></p> 563<p></p>
529<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br /> 564<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br />
530</dt> 565</dt>
531<dd> 566<dd>
… …
565 my $xid = $_[0]-&gt;window-&gt;get_xid; 600 my $xid = $_[0]-&gt;window-&gt;get_xid;
566 system &quot;rxvt -embed $xid &amp;&quot;; 601 system &quot;rxvt -embed $xid &amp;&quot;;
567 });</pre> 602 });</pre>
568</dd> 603</dd>
569<p></p> 604<p></p>
570<dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br /> 605<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong><br />
571</dt> 606</dt>
572<dd> 607<dd>
573Tells rxvt NOT to execute any commands or create a new pty/tty 608Tells rxvt NOT to execute any commands or create a new pty/tty
574pair but instead use the given filehandle as the tty master. This is 609pair but instead use the given filehandle as the tty master. This is
575useful if you want to drive rxvt as a generic terminal emulator 610useful if you want to drive rxvt as a generic terminal emulator
… …
577</dd> 612</dd>
578<dd> 613<dd>
579<p>If this switch is given, rxvt will not create any utmp/wtmp 614<p>If this switch is given, rxvt will not create any utmp/wtmp
580entries and will not tinker with pty/tty permissions - you have to do that 615entries and will not tinker with pty/tty permissions - you have to do that
581yourself if you want that.</p> 616yourself if you want that.</p>
617</dd>
618<dd>
619<p>As an extremely special case, specifying <code>-1</code> will completely suppress
620pty/tty operations.</p>
582</dd> 621</dd>
583<dd> 622<dd>
584<p>Here is a example in perl that illustrates how this option can be used (a 623<p>Here is a example in perl that illustrates how this option can be used (a
585longer example is in <em>doc/pty-fd</em>):</p> 624longer example is in <em>doc/pty-fd</em>):</p>
586</dd> 625</dd>
… …
599<dd> 638<dd>
600<pre> 639<pre>
601 # now communicate with rxvt 640 # now communicate with rxvt
602 my $slave = $pty-&gt;slave; 641 my $slave = $pty-&gt;slave;
603 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; }</pre> 642 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; }</pre>
643</dd>
644<p></p>
645<dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong><br />
646</dt>
647<dd>
648Comma-separated list of perl extension scripts to use (or not to use) in
649this terminal instance. See resource <strong>perl-ext</strong> for details.
604</dd> 650</dd>
605<p></p></dl> 651<p></p></dl>
606<p> 652<p>
607</p> 653</p>
608<hr /> 654<hr />
609<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> 655<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1>
610<p>Note: `rxvt --help' gives a list of all resources (long 656<p>Note: `rxvt --help' gives a list of all resources (long
611options) compiled into your version.</p> 657options) compiled into your version.</p>
612<p>There are two different methods that rxvt can use to get the 658<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
613Xresource data: using the X libraries (Xrm*-functions) or internal
614Xresources reader (<strong>~/.Xdefaults</strong>). For the first method (ie.
615<strong>rxvt -h</strong> lists <strong>XGetDefaults</strong>), you can set and change the
616resources using X11 tools like <strong>xrdb</strong>. Many distribution do also load
617settings from the <strong>~/.Xresources</strong> file when X starts. rxvt 659distribution do also load settings from the <strong>~/.Xresources</strong> file when X
618will consult the following files/resources in order, with later settings 660starts. rxvt will consult the following files/resources in order,
619overwriting earlier ones:</p> 661with later settings overwriting earlier ones:</p>
620<pre> 662<pre>
621 1. system-wide app-defaults file, either locale-dependent OR global 663 1. system-wide app-defaults file, either locale-dependent OR global
622 2. app-defaults file in $XAPPLRESDIR 664 2. app-defaults file in $XAPPLRESDIR
623 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 665 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
624 4. SCREEN_RESOURCES for the current screen 666 4. SCREEN_RESOURCES for the current screen
625 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre> 667 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre>
626<p>If compiled with internal Xresources support (i.e. <strong>rxvt -h</strong>
627lists <strong>.Xdefaults</strong>) then <strong>rxvt</strong> accepts application defaults
628set in XAPPLOADDIR/URxvt (compile-time defined: usually
629<strong>/usr/lib/X11/app-defaults/URxvt</strong>) and resources set in
630<strong>~/.Xdefaults</strong>, or <strong>~/.Xresources</strong> if <strong>~/.Xdefaults</strong> does not exist.
631Note that when reading X resources, <strong>rxvt</strong> recognizes two 668<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
632class names: <strong>XTerm</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows 669names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
633resources common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be 670common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily
634easily configured, while the class name <strong>URxvt</strong> allows resources 671configured, while the class name <strong>URxvt</strong> allows resources unique to
635unique to <strong>rxvt</strong>, notably colours and key-handling, to be 672<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
636shared between different <strong>rxvt</strong> configurations. If no 673configurations. If no resources are specified, suitable defaults will
637resources are specified, suitable defaults will be used. Command-line 674be used. Command-line arguments can be used to override resource
638arguments can be used to override resource settings. The following 675settings. The following resources are supported (you might want to
639resources are allowed:</p> 676check the <code>rxvtperl(3)</code> manpage for additional settings by perl
677extensions not documented here):</p>
640<dl> 678<dl>
641<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br /> 679<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
642</dt> 680</dt>
643<dd> 681<dd>
644Create the window with the specified X window geometry [default 80x24]; 682Create the window with the specified X window geometry [default 80x24];
… …
830<dd> 868<dd>
831Select the fonts to be used. This is a comma separated list of font 869Select the fonts to be used. This is a comma separated list of font
832names that are used in turn when trying to display Unicode characters. 870names that are used in turn when trying to display Unicode characters.
833The first font defines the cell size for characters; other fonts might 871The first font defines the cell size for characters; other fonts might
834be smaller, but not larger. A reasonable default font list is always 872be smaller, but not larger. A reasonable default font list is always
835appended to it. option <strong>-fn</strong>. 873appended to it; option <strong>-fn</strong>.
836</dd> 874</dd>
837<dd> 875<dd>
838<p>Each font can either be a standard X11 core font (XLFD) name, with 876<p>Each font can either be a standard X11 core font (XLFD) name, with
839optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p> 877optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p>
840</dd> 878</dd>
… …
901<dd> 939<dd>
902<p>If set, but empty, then this specific style is disabled and the normal 940<p>If set, but empty, then this specific style is disabled and the normal
903text font will being used for the given style.</p> 941text font will being used for the given style.</p>
904</dd> 942</dd>
905<p></p> 943<p></p>
944<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong><br />
945</dt>
946<dd>
947When font styles are not enabled, or this option is enabled (<strong>True</strong>,
948option <strong>-is</strong>, the default), bold and italic font styles imply high
949intensity foreground/backround colours. Disabling this option (<strong>False</strong>,
950option <strong>+is</strong>) disables this behaviour, the high intensity colours are not
951reachable.
952</dd>
953<p></p>
906<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br /> 954<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br />
907</dt> 955</dt>
908<dd> 956<dd>
909Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is 957Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is
910xterm style with 2.20 old word selection, or anything else which gives 958xterm style with 2.20 old word selection, or anything else which gives
… …
1065<dd> 1113<dd>
1066Set MWM hints to request a borderless window, i.e. if honoured by the 1114Set MWM hints to request a borderless window, i.e. if honoured by the
1067WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>. 1115WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>.
1068</dd> 1116</dd>
1069<p></p> 1117<p></p>
1118<dt><strong><a name="item_skipbuiltinglyphs_3a_boolean"><strong>skipBuiltinGlyphs:</strong> <em>boolean</em></a></strong><br />
1119</dt>
1120<dd>
1121Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
1122drawing characters and just rely on what the specified fonts provide. Use
1123this if you have a good font and want to use its block graphic glyphs;
1124option <strong>-sbg</strong>.
1125</dd>
1126<p></p>
1070<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br /> 1127<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br />
1071</dt> 1128</dt>
1072<dd> 1129<dd>
1073Specifies the terminal type name to be set in the <strong>TERM</strong> environment 1130Specifies the terminal type name to be set in the <strong>TERM</strong> environment
1074variable; option <strong>-tn</strong>. 1131variable; option <strong>-tn</strong>.
… …
1179</dt> 1236</dt>
1180<dd> 1237<dd>
1181The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g. 1238The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
1182<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the 1239<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the
1183input extension to be able to input japanese characters while staying in 1240input extension to be able to input japanese characters while staying in
1184another locale. option <strong>-imlocale</strong>. 1241another locale; option <strong>-imlocale</strong>.
1185</dd> 1242</dd>
1186<p></p> 1243<p></p>
1187<dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br /> 1244<dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br />
1188</dt> 1245</dt>
1189<dd> 1246<dd>
… …
1198<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br /> 1255<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br />
1199</dt> 1256</dt>
1200<dd> 1257<dd>
1201Change the meaning of triple-click selection with the left mouse 1258Change the meaning of triple-click selection with the left mouse
1202button. Instead of selecting a full line it will extend the selection to 1259button. Instead of selecting a full line it will extend the selection to
1203the end of the logical line only. option <strong>-tcw</strong>. 1260the end of the logical line only; option <strong>-tcw</strong>.
1204</dd> 1261</dd>
1205<p></p> 1262<p></p>
1206<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br /> 1263<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br />
1207</dt> 1264</dt>
1208<dd> 1265<dd>
… …
1250option is enabled, scrolls on the secondary screen will change the 1307option is enabled, scrolls on the secondary screen will change the
1251scrollback buffer and switching to/from the secondary screen will 1308scrollback buffer and switching to/from the secondary screen will
1252instead scroll the screen up. 1309instead scroll the screen up.
1253</dd> 1310</dd>
1254<p></p> 1311<p></p>
1312<dt><strong><a name="item_hold_3a_bool"><strong>hold</strong>: <em>bool</em></a></strong><br />
1313</dt>
1314<dd>
1315Turn on/off hold window after exit support. If enabled, rxvt
1316will not immediately destroy its window when the program executed within
1317it exits. Instead, it will wait till it is being killed or closed by the
1318user.
1319</dd>
1320<p></p>
1255<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br /> 1321<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br />
1256</dt> 1322</dt>
1257<dd> 1323<dd>
1258Compile <em>frills</em>: Associate <em>string</em> with keysym <em>sym</em>. The 1324Compile <em>frills</em>: Associate <em>string</em> with keysym <em>sym</em>. The
1259intervening resource name <strong>keysym.</strong> cannot be omitted. 1325intervening resource name <strong>keysym.</strong> cannot be omitted.
… …
1284<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete, 1350<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete,
1285<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it 1351<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it
1286can start or end with whitespace.</p> 1352can start or end with whitespace.</p>
1287</dd> 1353</dd>
1288<dd> 1354<dd>
1289<p>Please note that you need to double the <code>\</code> when using 1355<p>Please note that you need to double the <code>\</code> in resource files, as
1290<code>--enable-xgetdefault</code>, as X itself does it's own de-escaping (you can 1356Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of
1291use <code>\033</code> instead of <code>\e</code> (and so on), which will work with both Xt and 1357<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1292rxvt's own processing).</p> 1358processing).</p>
1293</dd> 1359</dd>
1294<dd> 1360<dd>
1295<p>You can define a range of keysyms in one shot by providing a <em>string</em> 1361<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1296with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' 1362with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/'
1297should be a character not used by the strings.</p> 1363should be a character not used by the strings.</p>
… …
1319when Control-Meta-c is being pressed'':</p> 1385when Control-Meta-c is being pressed'':</p>
1320</dd> 1386</dd>
1321<dd> 1387<dd>
1322<pre> 1388<pre>
1323 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> 1389 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre>
1390</dd>
1391<dd>
1392<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong>
1393is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code>
1394manpage. For example, the <em>selection</em> extension (activated via
1395<code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
1396</dd>
1397<dd>
1398<pre>
1399 URxvt.keysym.M-C-c: perl:selection:rot13</pre>
1324</dd> 1400</dd>
1325<dd> 1401<dd>
1326<p>Due the the large number of modifier combinations, a defined key mapping 1402<p>Due the the large number of modifier combinations, a defined key mapping
1327will match if at <em>at least</em> the specified identifiers are being set, and 1403will match if at <em>at least</em> the specified identifiers are being set, and
1328no other key mappings with those and more bits are being defined. That 1404no other key mappings with those and more bits are being defined. That
… …
1362</dd> 1438</dd>
1363<dd> 1439<dd>
1364<pre> 1440<pre>
1365 URxvt.keysym.M-C-3: command:\033[8;25;80t 1441 URxvt.keysym.M-C-3: command:\033[8;25;80t
1366 URxvt.keysym.M-C-4: command:\033[8;48;110t</pre> 1442 URxvt.keysym.M-C-4: command:\033[8;48;110t</pre>
1443</dd>
1444<p></p>
1445<dt><strong><a name="item_perl_2dext_2dcommon_3a_string"><strong>perl-ext-common</strong>: <em>string</em></a></strong><br />
1446</dt>
1447<dt><strong><a name="item_perl_2dext_3a_string"><strong>perl-ext</strong>: <em>string</em></a></strong><br />
1448</dt>
1449<dd>
1450Comma-separated <code>list(s)</code> of perl extension scripts (default: <code>default</code>) to
1451use in this terminal instance; option <strong>-pe</strong>.
1452</dd>
1453<dd>
1454<p>Extension names can be prefixed with a <code>-</code> sign to prohibit using
1455them. This can be useful to selectively disable some extensions loaded
1456by default, or specified via the <code>perl-ext-common</code> resource. For
1457example, <code>default,-selection</code> will use all the default extension except
1458<code>selection</code>.</p>
1459</dd>
1460<dd>
1461<p>Extension names can also be followed by an argument in angle brackets
1462(e.g. <code>searchable-scrollback&lt;M-s&gt;</code>, which binds the hotkey for
1463searchable scorllback to Alt/Meta-s). Mentioning the same extension
1464multiple times with different arguments will pass multiple arguments to
1465the extension.</p>
1466</dd>
1467<dd>
1468<p>Each extension is looked up in the library directories, loaded if
1469necessary, and bound to the current terminal instance.</p>
1470</dd>
1471<dd>
1472<p>If both of these resources are the empty string, then the perl
1473interpreter will not be initialized. The idea behind two options is that
1474<strong>perl-ext-common</strong> will be used for extensions that should be available to
1475all instances, while <strong>perl-ext</strong> is used for specific instances.</p>
1476</dd>
1477<p></p>
1478<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br />
1479</dt>
1480<dd>
1481Perl code to be evaluated when all extensions have been registered. See
1482the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource
1483will be ignored when running setuid/setgid.
1484</dd>
1485<p></p>
1486<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br />
1487</dt>
1488<dd>
1489Colon-separated list of additional directories that hold extension
1490scripts. When looking for extensions specified by the <code>perl</code> resource,
1491rxvt will first look in these directories and then in
1492<em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource
1493will be ignored when running setuid/setgid.
1494</dd>
1495<dd>
1496<p>See the <code>rxvtperl(3)</code> manpage.</p>
1497</dd>
1498<p></p>
1499<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong><br />
1500</dt>
1501<dd>
1502Sets the hotkey that starts the incremental scrollback buffer search
1503(default: <code>M-s</code>).
1504</dd>
1505<p></p>
1506<dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong><br />
1507</dt>
1508<dd>
1509Specifies the program to be started with a URL argument. Used by the
1510<code>selection-popup</code> and <code>mark-urls</code> perl extensions.
1511</dd>
1512<p></p>
1513<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br />
1514</dt>
1515<dd>
1516Sets the WM_TRANSIENT_FOR property to the given window iw.
1367</dd> 1517</dd>
1368<p></p></dl> 1518<p></p></dl>
1369<p> 1519<p>
1370</p> 1520</p>
1371<hr /> 1521<hr />
… …
1407(which can span multiple screen lines), unless modified by resource 1557(which can span multiple screen lines), unless modified by resource
1408<strong>tripleclickwords</strong>. 1558<strong>tripleclickwords</strong>.
1409</dd> 1559</dd>
1410<dd> 1560<dd>
1411<p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys) 1561<p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys)
1412(Compile: <em>frills</em>) will create a rectangular selection instead of a normal 1562(Compile: <em>frills</em>) will create a rectangular selection instead of a
1413one.</p> 1563normal one. In this mode, every selected row becomes its own line in the
1564selection, and trailing whitespace is visually underlined and removed from
1565the selection.</p>
1414</dd> 1566</dd>
1415<p></p> 1567<p></p>
1416<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> 1568<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
1417</dt> 1569</dt>
1418<dd> 1570<dd>

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines