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.60 by root, Thu Jul 6 19:43:21 2006 UTC vs.
Revision 1.66 by root, Sat Jun 2 04:58:58 2007 UTC

… …
21 <li><a href="#rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></li> 21 <li><a href="#rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></li>
22 <li><a href="#options">OPTIONS</a></li> 22 <li><a href="#options">OPTIONS</a></li>
23 <li><a href="#resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></li> 23 <li><a href="#resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></li>
24 <li><a href="#the_scrollbar">THE SCROLLBAR</a></li> 24 <li><a href="#the_scrollbar">THE SCROLLBAR</a></li>
25 <li><a href="#mouse_reporting">MOUSE REPORTING</a></li> 25 <li><a href="#mouse_reporting">MOUSE REPORTING</a></li>
26 <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li> 26 <li><a href="#the_selection__selecting_and_pasting_text">THE SELECTION: SELECTING AND PASTING TEXT</a></li>
27 <li><a href="#changing_fonts">CHANGING FONTS</a></li> 27 <li><a href="#changing_fonts">CHANGING FONTS</a></li>
28 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li> 28 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li>
29 <li><a href="#login_stamp">LOGIN STAMP</a></li> 29 <li><a href="#login_stamp">LOGIN STAMP</a></li>
30 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> 30 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li>
31 <ul> 31 <ul>
… …
53<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 53<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
54<p> 54<p>
55</p> 55</p>
56<hr /> 56<hr />
57<h1><a name="description">DESCRIPTION</a></h1> 57<h1><a name="description">DESCRIPTION</a></h1>
58<p><strong>rxvt-unicode</strong>, version <strong>7.7</strong>, is a colour vt102 terminal 58<p><strong>rxvt-unicode</strong>, version <strong>8.2</strong>, is a colour vt102 terminal
59emulator intended as an <em>xterm</em>(1) replacement for users who do not 59emulator intended as an <em>xterm</em>(1) replacement for users who do not
60require features such as Tektronix 4014 emulation and toolkit-style 60require features such as Tektronix 4014 emulation and toolkit-style
61configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 61configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
62a significant advantage on a machine serving many X sessions.</p> 62a significant advantage on a machine serving many X sessions.</p>
63<p> 63<p>
… …
65<hr /> 65<hr />
66<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 66<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
67<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of 67<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of
68frequently asked questions and answer to them and some common 68frequently asked questions and answer to them and some common
69problems. That document is also accessible on the World-Wide-Web at 69problems. That document is also accessible on the World-Wide-Web at
70<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p> 70<a href="http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html</a>.</p>
71<p> 71<p>
72</p> 72</p>
73<hr /> 73<hr />
74<h1><a name="rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></h1> 74<h1><a name="rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></h1>
75<p>Unlike the original rxvt, <strong>rxvt-unicode</strong> stores all text in Unicode 75<p>Unlike the original rxvt, <strong>rxvt-unicode</strong> stores all text in Unicode
… …
77world. Being a terminal emulator, however, some things are very difficult, 77world. Being a terminal emulator, however, some things are very difficult,
78especially cursive scripts such as arabic, vertically written scripts 78especially cursive scripts such as arabic, vertically written scripts
79like mongolian or scripts requiring extremely complex combining rules, 79like mongolian or scripts requiring extremely complex combining rules,
80like tibetan or devenagari. Don't expect pretty output when using these 80like tibetan or devenagari. Don't expect pretty output when using these
81scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work 81scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work
82fine, though. A somewhat difficult case are left-to-right scripts, such 82fine, though. A somewhat difficult case are right-to-left scripts, such
83as hebrew: <strong>rxvt-unicode</strong> adopts the view that bidirectional algorithms 83as hebrew: <strong>rxvt-unicode</strong> adopts the view that bidirectional algorithms
84belong into the application, not the terminal emulator (too many things -- 84belong into the application, not the terminal emulator (too many things --
85such as cursor-movement while editing -- break otherwise), but that might 85such as cursor-movement while editing -- break otherwise), but that might
86change.</p> 86change.</p>
87<p>If you are looking for a terminal that supports more exotic scripts, let 87<p>If you are looking for a terminal that supports more exotic scripts, let
88me recommend <code>mlterm</code>, which is a very userfriendly, lean and clean 88me recommend <code>mlterm</code>, which is a very user friendly, lean and clean
89terminal emulator. In fact, the reason rxvt-unicode was born was solely 89terminal emulator. In fact, the reason rxvt-unicode was born was solely
90because the author couldn't get <code>mlterm</code> to use one font for latin1 and 90because the author couldn't get <code>mlterm</code> to use one font for latin1 and
91another for japanese.</p> 91another for japanese.</p>
92<p>Therefore another design rationale was the use of multiple fonts to 92<p>Therefore another design rationale was the use of multiple fonts to
93display characters: The idea of a single unicode font which many other 93display characters: The idea of a single unicode font which many other
94programs force onto its users never made sense to me: You should be able 94programs force onto its users never made sense to me: You should be able
95to choose any font for any script freely.</p> 95to choose any font for any script freely.</p>
96<p>Apart from that, rxvt-unicode is also much better internationalised than 96<p>Apart from that, rxvt-unicode is also much better internationalised than
97its predecessor, supports things such as XFT and ISO 14755 that are handy 97its predecessor, supports things such as XFT and ISO 14755 that are handy
98in i18n-environments, is faster, and has a lot less bugs than the original 98in i18n-environments, is faster, and has a lot bugs less than the original
99rxvt. This all in addition to dozens of other small improvements.</p> 99rxvt. This all in addition to dozens of other small improvements.</p>
100<p>It is still faithfully following the original rxvt idea of being lean 100<p>It is still faithfully following the original rxvt idea of being lean
101and nice on resources: for example, you can still configure rxvt-unicode 101and nice on resources: for example, you can still configure rxvt-unicode
102without most of its features to get a lean binary. It also comes with 102without most of its features to get a lean binary. It also comes with
103a client/daemon pair that lets you open any number of terminal windows 103a client/daemon pair that lets you open any number of terminal windows
104from within a single process, which makes startup time very fast and 104from within a single process, which makes startup time very fast and
105drastically reduces memory usage. See <code>rxvtd(1)</code> (daemon) and 105drastically reduces memory usage. See <code>rxvtd(1)</code> (daemon) and
106<code>rxvtc(1)</code> (client).</p> 106<code>rxvtc(1)</code> (client).</p>
107<p>It also makes technical information about escape sequences (which have 107<p>It also makes technical information about escape sequences (which have
108been extended) easier accessible: see <code>rxvt(7)</code> for technical 108been extended) more accessible: see <code>rxvt(7)</code> for technical
109reference documentation (escape sequences etc.).</p> 109reference documentation (escape sequences etc.).</p>
110<p> 110<p>
111</p> 111</p>
112<hr /> 112<hr />
113<h1><a name="options">OPTIONS</a></h1> 113<h1><a name="options">OPTIONS</a></h1>
… …
171<p>Turn on/off inheriting parent window's pixmap. Alternative form is 171<p>Turn on/off inheriting parent window's pixmap. Alternative form is
172<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.</p> 172<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.</p>
173</dd> 173</dd>
174<dd> 174<dd>
175<p><em>Please note that transparency of any kind if completely unsupported by 175<p><em>Please note that transparency of any kind if completely unsupported by
176the author. Don't bug him with installation questions!</em></p> 176the author. Don't bug him with installation questions! Read the FAQ (man 7
177rxvt)!</em></p>
177</dd> 178</dd>
178</li> 179</li>
179<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong> 180<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong>
180 181
181<dd> 182<dd>
… …
208<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong> 209<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong>
209 210
210<dd> 211<dd>
211<p><em>number</em> Darken (0 .. 100) or lighten (-1 .. -100) the transparent 212<p><em>number</em> Darken (0 .. 100) or lighten (-1 .. -100) the transparent
212background image in addition to tinting it (i.e. <strong>-tint</strong> must be 213background image in addition to tinting it (i.e. <strong>-tint</strong> must be
213specified, too, e.g. <code>-tint white</code>).</p> 214specified, too, e.g. <code>-tint white</code>); resource <em>shading</em>.</p>
214</dd> 215</dd>
215</li> 216</li>
216<dt><strong><a name="item__2dbg_colour"><strong>-bg</strong> <em>colour</em></a></strong> 217<dt><strong><a name="item__2dbg_colour"><strong>-bg</strong> <em>colour</em></a></strong>
217 218
218<dd> 219<dd>
… …
541</li> 542</li>
542<dt><strong><a name="item__2dtcw"><strong>-tcw</strong></a></strong> 543<dt><strong><a name="item__2dtcw"><strong>-tcw</strong></a></strong>
543 544
544<dd> 545<dd>
545<p>Change the meaning of triple-click selection with the left mouse 546<p>Change the meaning of triple-click selection with the left mouse
547button. Only effective when the original (non-perl) selection code is
546button. Instead of selecting a full line it will extend the selection the 548in-use. Instead of selecting a full line it will extend the selection the
547end of the logical line only. resource <strong>tripleclickwords</strong>.</p> 549end of the logical line only. resource <strong>tripleclickwords</strong>.</p>
548</dd> 550</dd>
549</li> 551</li>
550<dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong> 552<dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong>
551 553
… …
609</dd> 611</dd>
610<dd> 612<dd>
611<p>It might be useful to know that rxvt will not close file 613<p>It might be useful to know that rxvt will not close file
612descriptors passed to it (except for stdin/out/err, of course), so you 614descriptors passed to it (except for stdin/out/err, of course), so you
613can use file descriptors to communicate with the programs within the 615can use file descriptors to communicate with the programs within the
614terminal. This works regardless of wether the <code>-embed</code> option was used or 616terminal. This works regardless of whether the <code>-embed</code> option was used or
615not.</p> 617not.</p>
616</dd> 618</dd>
617<dd> 619<dd>
618<p>Here is a short Gtk2-perl snippet that illustrates how this option can be 620<p>Here is a short Gtk2-perl snippet that illustrates how this option can be
619used (a longer example is in <em>doc/embed</em>):</p> 621used (a longer example is in <em>doc/embed</em>):</p>
… …
629</li> 631</li>
630<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong> 632<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong>
631 633
632<dd> 634<dd>
633<p>Tells rxvt NOT to execute any commands or create a new pty/tty 635<p>Tells rxvt NOT to execute any commands or create a new pty/tty
634pair but instead use the given filehandle as the tty master. This is 636pair but instead use the given file descriptor as the tty master. This is
635useful if you want to drive rxvt as a generic terminal emulator 637useful if you want to drive rxvt as a generic terminal emulator
636without having to run a program within it.</p> 638without having to run a program within it.</p>
637</dd> 639</dd>
638<dd> 640<dd>
639<p>If this switch is given, rxvt will not create any utmp/wtmp 641<p>If this switch is given, rxvt will not create any utmp/wtmp
… …
767</dd> 769</dd>
768</li> 770</li>
769<dt><strong><a name="item_colorrv_3a_colour"><strong>colorRV:</strong> <em>colour</em></a></strong> 771<dt><strong><a name="item_colorrv_3a_colour"><strong>colorRV:</strong> <em>colour</em></a></strong>
770 772
771<dd> 773<dd>
772<p>Use the specified colour as the background for reverse video 774<p>Use the specified colour as the background for reverse video characters
773characters.</p> 775when OPTION_HC is disabled (--disable-frills).</p>
774</dd> 776</dd>
775</li> 777</li>
776<dt><strong><a name="item_underlinecolor_3a_colour"><strong>underlineColor:</strong> <em>colour</em></a></strong> 778<dt><strong><a name="item_underlinecolor_3a_colour"><strong>underlineColor:</strong> <em>colour</em></a></strong>
777 779
778<dd> 780<dd>
… …
844</dd> 846</dd>
845</li> 847</li>
846<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong> 848<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong>
847 849
848<dd> 850<dd>
849<p>Darken (0 .. 100) or lighten (-1 .. -100) the transparent background 851<p>Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image
850image in addition to tinting it.</p> 852in addition to tinting it; option <strong>-sh</strong>.</p>
851</dd> 853</dd>
852</li> 854</li>
853<dt><strong><a name="item_scrollcolor_3a_colour"><strong>scrollColor:</strong> <em>colour</em></a></strong> 855<dt><strong><a name="item_scrollcolor_3a_colour"><strong>scrollColor:</strong> <em>colour</em></a></strong>
854 856
855<dd> 857<dd>
… …
971<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong> 973<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong>
972 974
973<dd> 975<dd>
974<p>When font styles are not enabled, or this option is enabled (<strong>True</strong>, 976<p>When font styles are not enabled, or this option is enabled (<strong>True</strong>,
975option <strong>-is</strong>, the default), bold and italic font styles imply high 977option <strong>-is</strong>, the default), bold and italic font styles imply high
976intensity foreground/backround colours. Disabling this option (<strong>False</strong>, 978intensity foreground/background colours. Disabling this option (<strong>False</strong>,
977option <strong>+is</strong>) disables this behaviour, the high intensity colours are not 979option <strong>+is</strong>) disables this behaviour, the high intensity colours are not
978reachable.</p> 980reachable.</p>
979</dd> 981</dd>
980</li> 982</li>
981<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong> 983<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong>
982 984
983<dd> 985<dd>
984<p>Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is 986<p>Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which
985xterm style with 2.20 old word selection, or anything else which gives 987is xterm style with 2.20 old word selection, or anything else which
986xterm style selection.</p> 988gives xterm style selection. Only effective when the original (non-perl)
989selection code is in use.</p>
987</dd> 990</dd>
988</li> 991</li>
989<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong> 992<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong>
990 993
991<dd> 994<dd>
… …
1014<dd> 1017<dd>
1015<p><strong>True</strong>: de-iconify (map) on receipt of a bell character. <strong>False</strong>: no 1018<p><strong>True</strong>: de-iconify (map) on receipt of a bell character. <strong>False</strong>: no
1016de-iconify (map) on receipt of a bell character [default].</p> 1019de-iconify (map) on receipt of a bell character [default].</p>
1017</dd> 1020</dd>
1018</li> 1021</li>
1022<dt><strong><a name="item_urgentonbell_3a_boolean"><strong>urgentOnBell:</strong> <em>boolean</em></a></strong>
1023
1024<dd>
1025<p><strong>True</strong>: set the urgency hint for the wm on receipt of a bell character.
1026<strong>False</strong>: do not set the urgency hint [default].</p>
1027</dd>
1028</li>
1019<dt><strong><a name="item_visualbell_3a_boolean"><strong>visualBell:</strong> <em>boolean</em></a></strong> 1029<dt><strong><a name="item_visualbell_3a_boolean"><strong>visualBell:</strong> <em>boolean</em></a></strong>
1020 1030
1021<dd> 1031<dd>
1022<p><strong>True</strong>: use visual bell on receipt of a bell character; option <strong>-vb</strong>. 1032<p><strong>True</strong>: use visual bell on receipt of a bell character; option <strong>-vb</strong>.
1023<strong>False</strong>: no visual bell [default]; option <strong>+vb</strong>.</p> 1033<strong>False</strong>: no visual bell [default]; option <strong>+vb</strong>.</p>
… …
1056<pre> 1066<pre>
1057 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> 1067 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
1058</dd> 1068</dd>
1059<dd> 1069<dd>
1060<p>This creates a new file in your home directory with the screen contents 1070<p>This creates a new file in your home directory with the screen contents
1061everytime you hit <code>Print</code>.</p> 1071every time you hit <code>Print</code>.</p>
1062</dd> 1072</dd>
1063</li> 1073</li>
1064<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong> 1074<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong>
1065 1075
1066<dd> 1076<dd>
… …
1100<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong> 1110<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong>
1101 1111
1102<dd> 1112<dd>
1103<p><strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and 1113<p><strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and
1104<strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll 1114<strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll
1105with scrollback buffer when tty recieves new lines; option <strong>+sw</strong>.</p> 1115with scrollback buffer when tty receives new lines; option <strong>+sw</strong>.</p>
1106</dd> 1116</dd>
1107</li> 1117</li>
1108<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong> 1118<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong>
1109 1119
1110<dd> 1120<dd>
… …
1242<dd> 1252<dd>
1243<p>The characters used as delimiters for double-click word selection 1253<p>The characters used as delimiters for double-click word selection
1244(whitespace delimiting is added automatically if resource is given).</p> 1254(whitespace delimiting is added automatically if resource is given).</p>
1245</dd> 1255</dd>
1246<dd> 1256<dd>
1247<p>When the selection extension is in use (the default if compiled in, see 1257<p>When the perl selection extension is in use (the default if compiled
1248the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters 1258in, see the <code>rxvtperl(3)</code> manpage), a suitable regex using these
1249will be created (if the resource exists, otherwise, no regex will be 1259characters will be created (if the resource exists, otherwise, no regex
1250created). In this mode, characters outside ISO-8859-1 can be used.</p> 1260will be created). In this mode, characters outside ISO-8859-1 can be used.</p>
1251</dd> 1261</dd>
1252<dd> 1262<dd>
1253<p>When the selection extension is not used, only ISO-8859-1 characters can 1263<p>When the selection extension is not used, only ISO-8859-1 characters can
1254be used. If not specified, the built-in default is used:</p> 1264be used. If not specified, the built-in default is used:</p>
1255</dd> 1265</dd>
… …
1337</dd> 1347</dd>
1338</li> 1348</li>
1339<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong> 1349<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong>
1340 1350
1341<dd> 1351<dd>
1342<p>Turn on/off secondary screen scroll (default enabled). If the this 1352<p>Turn on/off secondary screen scroll (default enabled). If this
1343option is enabled, scrolls on the secondary screen will change the 1353option is enabled, scrolls on the secondary screen will change the
1344scrollback buffer and switching to/from the secondary screen will 1354scrollback buffer and switching to/from the secondary screen will
1345instead scroll the screen up.</p> 1355instead scroll the screen up.</p>
1346</dd> 1356</dd>
1347</li> 1357</li>
… …
1383<dd> 1393<dd>
1384<p><em>string</em> may contain escape values (<code>\a</code>: bell, <code>\b</code>: backspace, 1394<p><em>string</em> may contain escape values (<code>\a</code>: bell, <code>\b</code>: backspace,
1385<code>\e</code>, <code>\E</code>: escape, <code>\n</code>: newline, <code>\r</code>: carriage return, <code>\t</code>: tab, 1395<code>\e</code>, <code>\E</code>: escape, <code>\n</code>: newline, <code>\r</code>: carriage return, <code>\t</code>: tab,
1386<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete, 1396<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete,
1387<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it 1397<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it
1388can start or end with whitespace.</p> 1398can start or end with whitespace. <strong>This feature is deprecated and will
1399be removed</strong>.</p>
1389</dd> 1400</dd>
1390<dd> 1401<dd>
1391<p>Please note that you need to double the <code>\</code> in resource files, as 1402<p>Please note that you need to double the <code>\</code> in resource files, as
1392Xlib itself does its own de-escaping (you can use <code>\033</code> instead of 1403Xlib itself does its own de-escaping (you can use <code>\033</code> instead of
1393<code>\e</code> (and so on), which will work with both Xt and rxvt's own 1404<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1394processing).</p> 1405processing).</p>
1395</dd> 1406</dd>
1396<dd> 1407<dd>
1397<p>You can define a range of keysyms in one shot by providing a <em>string</em> 1408<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1398with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' 1409with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimiter `/'
1399should be a character not used by the strings.</p> 1410should be a character not used by the strings.</p>
1400</dd> 1411</dd>
1401<dd> 1412<dd>
1402<p>Its usage can be demonstrated by an example:</p> 1413<p>Its usage can be demonstrated by an example:</p>
1403</dd> 1414</dd>
… …
1494<code>selection</code>.</p> 1505<code>selection</code>.</p>
1495</dd> 1506</dd>
1496<dd> 1507<dd>
1497<p>Extension names can also be followed by an argument in angle brackets 1508<p>Extension names can also be followed by an argument in angle brackets
1498(e.g. <code>searchable-scrollback&lt;M-s&gt;</code>, which binds the hotkey for 1509(e.g. <code>searchable-scrollback&lt;M-s&gt;</code>, which binds the hotkey for
1499searchable scorllback to Alt/Meta-s). Mentioning the same extension 1510searchable scrollback to Alt/Meta-s). Mentioning the same extension
1500multiple times with different arguments will pass multiple arguments to 1511multiple times with different arguments will pass multiple arguments to
1501the extension.</p> 1512the extension.</p>
1502</dd> 1513</dd>
1503<dd> 1514<dd>
1504<p>Each extension is looked up in the library directories, loaded if 1515<p>Each extension is looked up in the library directories, loaded if
… …
1555</li> 1566</li>
1556<dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong> 1567<dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong>
1557 1568
1558<dd> 1569<dd>
1559<p>Specifies the program to be started with a URL argument. Used by the 1570<p>Specifies the program to be started with a URL argument. Used by the
1560<code>selection-popup</code> and <code>mark-urls</code> perl extensions.</p> 1571<code>selection-popup</code> and <code>matcher</code> perl extensions.</p>
1561</dd> 1572</dd>
1562</li> 1573</li>
1563<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong> 1574<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong>
1564 1575
1565<dd> 1576<dd>
… …
1600up and down arrows sends <strong>ESC [ A</strong> (Up) and <strong>ESC [ B</strong> (Down), 1611up and down arrows sends <strong>ESC [ A</strong> (Up) and <strong>ESC [ B</strong> (Down),
1601respectively.</p> 1612respectively.</p>
1602<p> 1613<p>
1603</p> 1614</p>
1604<hr /> 1615<hr />
1605<h1><a name="text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></h1> 1616<h1><a name="the_selection__selecting_and_pasting_text">THE SELECTION: SELECTING AND PASTING TEXT</a></h1>
1606<p>The behaviour of text selection and insertion mechanism is similar to 1617<p>The behaviour of text selection and insertion/pasting mechanism is similar
1607<em>xterm</em>(1).</p> 1618to <em>xterm</em>(1).</p>
1608<dl> 1619<dl>
1609<dt><strong><a name="item_selection_3a"><strong>Selection</strong>:</a></strong> 1620<dt><strong><a name="item_selecting_3a"><strong>Selecting</strong>:</a></strong>
1610 1621
1611<dd> 1622<dd>
1612<p>Left click at the beginning of the region, drag to the end of the region 1623<p>Left click at the beginning of the region, drag to the end of the region
1613and release; Right click to extend the marked region; Left double-click 1624and release; Right click to extend the marked region; Left double-click
1614to select a word; Left triple-click to select the entire logical line 1625to select a word; Left triple-click to select the entire logical line
… …
1621normal one. In this mode, every selected row becomes its own line in the 1632normal one. In this mode, every selected row becomes its own line in the
1622selection, and trailing whitespace is visually underlined and removed from 1633selection, and trailing whitespace is visually underlined and removed from
1623the selection.</p> 1634the selection.</p>
1624</dd> 1635</dd>
1625</li> 1636</li>
1626<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong> 1637<dt><strong><a name="item_pasting_3a"><strong>Pasting</strong>:</a></strong>
1627 1638
1628<dd> 1639<dd>
1629<p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong> 1640<p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1630window causes the value of the PRIMARY selection (or CLIPBOARD with the 1641window causes the value of the PRIMARY selection (or CLIPBOARD with the
1631Meta modifier) to be inserted as if it had been typed on the keyboard.</p> 1642<strong>Meta</strong> modifier) to be inserted as if it had been typed on the keyboard.</p>
1632</dd> 1643</dd>
1633<dd> 1644<dd>
1634<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be 1645<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1635inserted too.</p> 1646inserted too.</p>
1636</dd> 1647</dd>
… …
1773<p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get 1784<p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1774their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code> 1785their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code>
1775(recommended, but <strong>MUST</strong> have 4 digits/component) colour specifications, 1786(recommended, but <strong>MUST</strong> have 4 digits/component) colour specifications,
1776in addition to the ones provided by X, where the additional A component 1787in addition to the ones provided by X, where the additional A component
1777specifies opacity (alpha) values. The minimum value of <code>0</code> is completely 1788specifies opacity (alpha) values. The minimum value of <code>0</code> is completely
1778transparent). You can also prefix any color with <code>[a]</code>, where <code>a</code> is on 1789transparent). You can also prefix any color with <code>[percent]</code>, where
1779to four hex digits specifiying the opacity value.</p> 1790<code>percent</code> is a decimal percentage (0-100) that specifies the opacity of
1791the color, where <code>0</code> is completely transparent and <code>100</code> is completelxy
1792opaque.</p>
1780<p>You probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that 1793<p>You probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that
1781your X-server uses ARGB pixel layout, as X is far from just supporting 1794your X-server uses ARGB pixel layout, as X is far from just supporting
1782ARGB visuals out of the box, and rxvt-unicode just fudges around.</p> 1795ARGB visuals out of the box, and rxvt-unicode just fudges around.</p>
1783<p>For example, the following selects an almost completely transparent red 1796<p>For example, the following selects an almost completely transparent red
1784background, and an almost opaque pink foreground:</p> 1797background, and an almost opaque pink foreground:</p>
1785<pre> 1798<pre>
1786 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg &quot;[e]pink&quot;</pre> 1799 rxvt -depth 32 -bg rgba:0000/0000/0000/aaaa -fg &quot;[80]pink&quot;</pre>
1787<p><em>Please note that transparency of any kind if completely unsupported by 1800<p><em>Please note that transparency of any kind if completely unsupported by
1788the author. Don't bug him with installation questions!</em></p> 1801the author. Don't bug him with installation questions!</em></p>
1789<p> 1802<p>
1790</p> 1803</p>
1791<hr /> 1804<hr />
… …
1794<dl> 1807<dl>
1795<dt><strong><a name="item_term"><strong>TERM</strong></a></strong> 1808<dt><strong><a name="item_term"><strong>TERM</strong></a></strong>
1796 1809
1797<dd> 1810<dd>
1798<p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via 1811<p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via
1799resources or on the commandline.</p> 1812resources or on the command line.</p>
1800</dd> 1813</dd>
1801</li> 1814</li>
1802<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong> 1815<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong>
1803 1816
1804<dd> 1817<dd>
1805<p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether rxvt was 1818<p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on whether rxvt was
1806compiled with XPM support, and optionally with the added extension 1819compiled with XPM support, and optionally with the added extension
1807<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.</p> 1820<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.</p>
1808</dd> 1821</dd>
1809</li> 1822</li>
1810<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong> 1823<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong>

Diff Legend

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