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.40 by root, Tue Jan 10 04:26:54 2006 UTC vs.
Revision 1.56 by root, Tue Jan 31 00:25:16 2006 UTC

… …
24 <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li> 24 <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li>
25 <li><a href="#changing_fonts">CHANGING FONTS</a></li> 25 <li><a href="#changing_fonts">CHANGING FONTS</a></li>
26 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li> 26 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li>
27 <li><a href="#login_stamp">LOGIN STAMP</a></li> 27 <li><a href="#login_stamp">LOGIN STAMP</a></li>
28 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> 28 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li>
29 <ul>
30
31 <li><a href="#alpha_channel_support">ALPHA CHANNEL SUPPORT</a></li>
32 </ul>
33
29 <li><a href="#environment">ENVIRONMENT</a></li> 34 <li><a href="#environment">ENVIRONMENT</a></li>
30 <li><a href="#files">FILES</a></li> 35 <li><a href="#files">FILES</a></li>
31 <li><a href="#see_also">SEE ALSO</a></li> 36 <li><a href="#see_also">SEE ALSO</a></li>
32 <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li> 37 <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li>
33 <li><a href="#authors">AUTHORS</a></li> 38 <li><a href="#authors">AUTHORS</a></li>
… …
46<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 51<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
47<p> 52<p>
48</p> 53</p>
49<hr /> 54<hr />
50<h1><a name="description">DESCRIPTION</a></h1> 55<h1><a name="description">DESCRIPTION</a></h1>
51<p><strong>rxvt-unicode</strong>, version <strong>6.3</strong>, is a colour vt102 terminal 56<p><strong>rxvt-unicode</strong>, version <strong>7.5</strong>, is a colour vt102 terminal
52emulator intended as an <em>xterm</em>(1) replacement for users who do not 57emulator intended as an <em>xterm</em>(1) replacement for users who do not
53require features such as Tektronix 4014 emulation and toolkit-style 58require features such as Tektronix 4014 emulation and toolkit-style
54configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 59configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
55a significant advantage on a machine serving many X sessions.</p> 60a significant advantage on a machine serving many X sessions.</p>
56<p> 61<p>
… …
131Attempt to open a window on the named X display (<strong>-d</strong> still 136Attempt to open a window on the named X display (<strong>-d</strong> still
132respected). In the absence of this option, the display specified by the 137respected). In the absence of this option, the display specified by the
133<strong>DISPLAY</strong> environment variable is used. 138<strong>DISPLAY</strong> environment variable is used.
134</dd> 139</dd>
135<p></p> 140<p></p>
141<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong><br />
142</dt>
143<dd>
144Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
145resource <strong>depth</strong>.
146</dd>
147<p></p>
136<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br /> 148<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br />
137</dt> 149</dt>
138<dd> 150<dd>
139Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>. 151Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>.
140</dd> 152</dd>
… …
154<dt><strong><a name="item__2dip_7c_2bip__7c__2dtr_7c_2btr"><strong>-ip</strong>|<strong>+ip</strong> | <strong>-tr</strong>|<strong>+tr</strong></a></strong><br /> 166<dt><strong><a name="item__2dip_7c_2bip__7c__2dtr_7c_2btr"><strong>-ip</strong>|<strong>+ip</strong> | <strong>-tr</strong>|<strong>+tr</strong></a></strong><br />
155</dt> 167</dt>
156<dd> 168<dd>
157Turn on/off inheriting parent window's pixmap. Alternative form is 169Turn on/off inheriting parent window's pixmap. Alternative form is
158<strong>-tr</strong>; resource <strong>inheritPixmap</strong>. 170<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.
171</dd>
172<dd>
173<p><em>Please note that transparency of any kind if completely unsupported by
174the author. Don't bug him with installation questions!</em></p>
159</dd> 175</dd>
160<p></p> 176<p></p>
161<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> 177<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br />
162</dt> 178</dt>
163<dd> 179<dd>
… …
168<p></p> 184<p></p>
169<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br /> 185<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br />
170</dt> 186</dt>
171<dd> 187<dd>
172Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour 188Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour
173is black. resource <strong>fadeColor</strong>. 189is opaque black. resource <strong>fadeColor</strong>.
174</dd> 190</dd>
175<p></p> 191<p></p>
176<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> 192<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br />
177</dt> 193</dt>
178<dd> 194<dd>
… …
243<p></p> 259<p></p>
244<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br /> 260<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br />
245</dt> 261</dt>
246<dd> 262<dd>
247Select the fonts to be used. This is a comma separated list of font names 263Select the fonts to be used. This is a comma separated list of font names
248that are used in turn when trying to display Unicode characters. The 264that are checked in order when trying to find glyphs for characters. The
249first font defines the cell size for characters; other fonts might be 265first font defines the cell size for characters; other fonts might be
250smaller, but not (in general) larger. A (hopefully) reasonable default 266smaller, but not (in general) larger. A (hopefully) reasonable default
251font list is always appended to it. See resource <strong>font</strong> for more details. 267font list is always appended to it. See resource <strong>font</strong> for more details.
252</dd> 268</dd>
253<dd> 269<dd>
… …
413</dt> 429</dt>
414<dd> 430<dd>
415Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e. 431Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e.
416if honoured by the WM, the rxvt-unicode window will not have window 432if honoured by the WM, the rxvt-unicode window will not have window
417decorations; resource <strong>borderLess</strong>. 433decorations; resource <strong>borderLess</strong>.
434</dd>
435<p></p>
436<dt><strong><a name="item__2doverride_2dredirect"><strong>-override-redirect</strong></a></strong><br />
437</dt>
438<dd>
439Compile <em>frills</em>: Sets override-redirect on the window; resource
440<strong>override-redirect</strong>.
418</dd> 441</dd>
419<p></p> 442<p></p>
420<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br /> 443<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br />
421</dt> 444</dt>
422<dd> 445<dd>
… …
653</p> 676</p>
654<hr /> 677<hr />
655<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> 678<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1>
656<p>Note: `rxvt --help' gives a list of all resources (long 679<p>Note: `rxvt --help' gives a list of all resources (long
657options) compiled into your version.</p> 680options) compiled into your version.</p>
658<p>There are two different methods that rxvt can use to get the 681<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
659Xresource data: using the X libraries (Xrm*-functions) or internal
660Xresources reader (<strong>~/.Xdefaults</strong>). For the first method (ie.
661<strong>rxvt -h</strong> lists <strong>XGetDefaults</strong>), you can set and change the
662resources using X11 tools like <strong>xrdb</strong>. Many distribution do also load
663settings from the <strong>~/.Xresources</strong> file when X starts. rxvt 682distribution do also load settings from the <strong>~/.Xresources</strong> file when X
664will consult the following files/resources in order, with later settings 683starts. rxvt will consult the following files/resources in order,
665overwriting earlier ones:</p> 684with later settings overwriting earlier ones:</p>
666<pre> 685<pre>
667 1. system-wide app-defaults file, either locale-dependent OR global 686 1. system-wide app-defaults file, either locale-dependent OR global
668 2. app-defaults file in $XAPPLRESDIR 687 2. app-defaults file in $XAPPLRESDIR
669 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 688 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
670 4. SCREEN_RESOURCES for the current screen 689 4. SCREEN_RESOURCES for the current screen
671 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre> 690 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre>
672<p>If compiled with internal Xresources support (i.e. <strong>rxvt -h</strong>
673lists <strong>.Xdefaults</strong>) then <strong>rxvt</strong> accepts application defaults
674set in XAPPLOADDIR/URxvt (compile-time defined: usually
675<strong>/usr/lib/X11/app-defaults/URxvt</strong>) and resources set in
676<strong>~/.Xdefaults</strong>, or <strong>~/.Xresources</strong> if <strong>~/.Xdefaults</strong> does not exist.
677Note that when reading X resources, <strong>rxvt</strong> recognizes two 691<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
678class names: <strong>XTerm</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows 692names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
679resources common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be 693common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily
680easily configured, while the class name <strong>URxvt</strong> allows resources 694configured, while the class name <strong>URxvt</strong> allows resources unique to
681unique to <strong>rxvt</strong>, notably colours and key-handling, to be 695<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
682shared between different <strong>rxvt</strong> configurations. If no 696configurations. If no resources are specified, suitable defaults will
683resources are specified, suitable defaults will be used. Command-line 697be used. Command-line arguments can be used to override resource
684arguments can be used to override resource settings. The following 698settings. The following resources are supported (you might want to
685resources are allowed:</p> 699check the <code>rxvtperl(3)</code> manpage for additional settings by perl
700extensions not documented here):</p>
686<dl> 701<dl>
702<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong><br />
703</dt>
704<dd>
705Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
706option <strong>-depth</strong>.
707</dd>
708<p></p>
687<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br /> 709<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
688</dt> 710</dt>
689<dd> 711<dd>
690Create the window with the specified X window geometry [default 80x24]; 712Create the window with the specified X window geometry [default 80x24];
691option <strong>-geometry</strong>. 713option <strong>-geometry</strong>.
… …
790</dt> 812</dt>
791<dd> 813<dd>
792<strong>True</strong>: make the background inherit the parent windows' pixmap, giving 814<strong>True</strong>: make the background inherit the parent windows' pixmap, giving
793artificial transparency. <strong>False</strong>: do not inherit the parent windows' 815artificial transparency. <strong>False</strong>: do not inherit the parent windows'
794pixmap. 816pixmap.
817</dd>
818<dd>
819<p><em>Please note that transparency of any kind if completely unsupported by
820the author. Don't bug him with installation questions!</em></p>
795</dd> 821</dd>
796<p></p> 822<p></p>
797<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> 823<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br />
798</dt> 824</dt>
799<dd> 825<dd>
… …
853specifies an integer number of images in that direction. No image will 879specifies an integer number of images in that direction. No image will
854be magnified beyond 10 times its original size. The maximum permitted 880be magnified beyond 10 times its original size. The maximum permitted
855scale is 1000. [default 0x0+50+50] 881scale is 1000. [default 0x0+50+50]
856</dd> 882</dd>
857<p></p> 883<p></p>
858<dt><strong><a name="item_menu_3a_file_5b_3btag_5d"><strong>menu:</strong> <em>file[;tag]</em></a></strong><br />
859</dt>
860<dd>
861Read in the specified menu file (note the `.menu' extension is
862optional) and also optionally specify a starting tag to find. See the
863reference documentation for details on the syntax for the menuBar.
864</dd>
865<p></p>
866<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br /> 884<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br />
867</dt> 885</dt>
868<dd> 886<dd>
869Specify the colon-delimited search path for finding files (XPM and 887Specify the colon-delimited search path for finding XPM files.
870menus), in addition to the paths specified by the <strong>RXVTPATH</strong> and
871<strong>PATH</strong> environment variables.
872</dd> 888</dd>
873<p></p> 889<p></p>
874<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br /> 890<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br />
875</dt> 891</dt>
876<dd> 892<dd>
877Select the fonts to be used. This is a comma separated list of font 893Select the fonts to be used. This is a comma separated list of font names
878names that are used in turn when trying to display Unicode characters. 894that are checked in order when trying to find glyphs for characters. The
879The first font defines the cell size for characters; other fonts might 895first font defines the cell size for characters; other fonts might be
880be smaller, but not larger. A reasonable default font list is always 896smaller, but not (in general) larger. A (hopefully) reasonable default
881appended to it; option <strong>-fn</strong>. 897font list is always appended to it; option <strong>-fn</strong>.
882</dd> 898</dd>
883<dd> 899<dd>
884<p>Each font can either be a standard X11 core font (XLFD) name, with 900<p>Each font can either be a standard X11 core font (XLFD) name, with
885optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p> 901optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p>
886</dd> 902</dd>
… …
893<dd> 909<dd>
894<p>For example, this font resource</p> 910<p>For example, this font resource</p>
895</dd> 911</dd>
896<dd> 912<dd>
897<pre> 913<pre>
898 URxvt*font: 9x15bold,\ 914 URxvt.font: 9x15bold,\
899 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ 915 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
900 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \ 916 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
901 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ 917 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
902 xft:Code2000:antialias=false</pre> 918 xft:Code2000:antialias=false</pre>
903</dd> 919</dd>
… …
1033<dd> 1049<dd>
1034<p>Example:</p> 1050<p>Example:</p>
1035</dd> 1051</dd>
1036<dd> 1052<dd>
1037<pre> 1053<pre>
1038 URxvt*print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> 1054 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
1039</dd> 1055</dd>
1040<dd> 1056<dd>
1041<p>This creates a new file in your home directory with the screen contents 1057<p>This creates a new file in your home directory with the screen contents
1042everytime you hit <code>Print</code>.</p> 1058everytime you hit <code>Print</code>.</p>
1043</dd> 1059</dd>
… …
1219</dd> 1235</dd>
1220<p></p> 1236<p></p>
1221<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br /> 1237<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br />
1222</dt> 1238</dt>
1223<dd> 1239<dd>
1224The characters used as delimiters for double-click word selection. The 1240The characters used as delimiters for double-click word selection
1225built-in default: 1241(whitespace delimiting is added automatically if resource is given).
1242</dd>
1243<dd>
1244<p>When the selection extension is in use (the default if compiled in, see
1245the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters
1246will be created (if the resource exists, otherwise, no regex will be
1247created). In this mode, characters outside ISO-8859-1 can be used.</p>
1248</dd>
1249<dd>
1250<p>When the selection extension is not used, only ISO-8859-1 characters can
1251be used. If not specified, the built-in default is used:</p>
1226</dd> 1252</dd>
1227<dd> 1253<dd>
1228<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p> 1254<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p>
1229</dd> 1255</dd>
1230<p></p> 1256<p></p>
… …
1280sequences enabled by default, which doesn't make it safer, though). 1306sequences enabled by default, which doesn't make it safer, though).
1281</dd> 1307</dd>
1282<dd> 1308<dd>
1283<p>You can enable them by setting this boolean resource or specifying 1309<p>You can enable them by setting this boolean resource or specifying
1284<strong>-insecure</strong> as an option. At the moment, this enables display-answer, 1310<strong>-insecure</strong> as an option. At the moment, this enables display-answer,
1285locale, findfont, icon label and window title requests as well as dynamic 1311locale, findfont, icon label and window title requests.</p>
1286menubar dispatch.</p>
1287</dd> 1312</dd>
1288<p></p> 1313<p></p>
1289<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> 1314<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br />
1290</dt> 1315</dt>
1291<dd> 1316<dd>
… …
1300Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E) 1325Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
1301character is passed through. It may contain escape values as described 1326character is passed through. It may contain escape values as described
1302in the entry on <strong>keysym</strong> following. 1327in the entry on <strong>keysym</strong> following.
1303</dd> 1328</dd>
1304<p></p> 1329<p></p>
1305<dt><strong><a name="item_secondaryscreen_3a_bool"><strong>secondaryScreen:</strong> <em>bool</em></a></strong><br /> 1330<dt><strong><a name="item_secondaryscreen_3a_boolean"><strong>secondaryScreen:</strong> <em>boolean</em></a></strong><br />
1306</dt> 1331</dt>
1307<dd> 1332<dd>
1308Turn on/off secondary screen (default enabled). 1333Turn on/off secondary screen (default enabled).
1309</dd> 1334</dd>
1310<p></p> 1335<p></p>
1311<dt><strong><a name="item_secondaryscroll_3a_bool"><strong>secondaryScroll:</strong> <em>bool</em></a></strong><br /> 1336<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong><br />
1312</dt> 1337</dt>
1313<dd> 1338<dd>
1314Turn on/off secondary screen scroll (default enabled). If the this 1339Turn on/off secondary screen scroll (default enabled). If the this
1315option is enabled, scrolls on the secondary screen will change the 1340option is enabled, scrolls on the secondary screen will change the
1316scrollback buffer and switching to/from the secondary screen will 1341scrollback buffer and switching to/from the secondary screen will
1317instead scroll the screen up. 1342instead scroll the screen up.
1318</dd> 1343</dd>
1319<p></p> 1344<p></p>
1320<dt><strong><a name="item_hold_3a_bool"><strong>hold</strong>: <em>bool</em></a></strong><br /> 1345<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong><br />
1321</dt> 1346</dt>
1322<dd> 1347<dd>
1323Turn on/off hold window after exit support. If enabled, rxvt 1348Turn on/off hold window after exit support. If enabled, rxvt
1324will not immediately destroy its window when the program executed within 1349will not immediately destroy its window when the program executed within
1325it exits. Instead, it will wait till it is being killed or closed by the 1350it exits. Instead, it will wait till it is being killed or closed by the
… …
1358<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete, 1383<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete,
1359<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it 1384<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it
1360can start or end with whitespace.</p> 1385can start or end with whitespace.</p>
1361</dd> 1386</dd>
1362<dd> 1387<dd>
1363<p>Please note that you need to double the <code>\</code> when using 1388<p>Please note that you need to double the <code>\</code> in resource files, as
1364<code>--enable-xgetdefault</code>, as X itself does it's own de-escaping (you can 1389Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of
1365use <code>\033</code> instead of <code>\e</code> (and so on), which will work with both Xt and 1390<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1366rxvt's own processing).</p> 1391processing).</p>
1367</dd> 1392</dd>
1368<dd> 1393<dd>
1369<p>You can define a range of keysyms in one shot by providing a <em>string</em> 1394<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1370with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' 1395with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/'
1371should be a character not used by the strings.</p> 1396should be a character not used by the strings.</p>
… …
1502</dd> 1527</dd>
1503<dd> 1528<dd>
1504<p>See the <code>rxvtperl(3)</code> manpage.</p> 1529<p>See the <code>rxvtperl(3)</code> manpage.</p>
1505</dd> 1530</dd>
1506<p></p> 1531<p></p>
1532<dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>&gt;: <em>perl-regex</em></a></strong><br />
1533</dt>
1534<dd>
1535Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
1536details.
1537</dd>
1538<p></p>
1539<dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>&gt;: <em>perl-transform</em></a></strong><br />
1540</dt>
1541<dd>
1542Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
1543for details.
1544</dd>
1545<p></p>
1546<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong><br />
1547</dt>
1548<dd>
1549Sets the hotkey that starts the incremental scrollback buffer search
1550(default: <code>M-s</code>).
1551</dd>
1552<p></p>
1553<dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong><br />
1554</dt>
1555<dd>
1556Specifies the program to be started with a URL argument. Used by the
1557<code>selection-popup</code> and <code>mark-urls</code> perl extensions.
1558</dd>
1559<p></p>
1507<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br /> 1560<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br />
1508</dt> 1561</dt>
1509<dd> 1562<dd>
1510Sets the WM_TRANSIENT_FOR property to the given window iw. 1563Compile <em>frills</em>: Sets the WM_TRANSIENT_FOR property to the given window id.
1564</dd>
1565<p></p>
1566<dt><strong><a name="item_override_2dredirect_3a_boolean"><strong>override-redirect</strong>: <em>boolean</em></a></strong><br />
1567</dt>
1568<dd>
1569Compile <em>frills</em>: Sets override-redirect for the terminal window, making
1570it almost invisible to window managers; option <strong>-override-redirect</strong>.
1511</dd> 1571</dd>
1512<p></p></dl> 1572<p></p></dl>
1513<p> 1573<p>
1514</p> 1574</p>
1515<hr /> 1575<hr />
… …
1560</dd> 1620</dd>
1561<p></p> 1621<p></p>
1562<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> 1622<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
1563</dt> 1623</dt>
1564<dd> 1624<dd>
1565Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in 1625Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1566an <strong>rxvt</strong> window causes the current text selection to be 1626window causes the value of the PRIMARY selection (or CLIPBOARD with the
1567inserted as if it had been typed on the keyboard. 1627Meta modifier) to be inserted as if it had been typed on the keyboard.
1628</dd>
1629<dd>
1630<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1631inserted too.</p>
1568</dd> 1632</dd>
1569<p></p></dl> 1633<p></p></dl>
1570<p> 1634<p>
1571</p> 1635</p>
1572<hr /> 1636<hr />
1573<h1><a name="changing_fonts">CHANGING FONTS</a></h1> 1637<h1><a name="changing_fonts">CHANGING FONTS</a></h1>
1574<p>Changing fonts (or font sizes, respectively) via the keypad is not yet 1638<p>Changing fonts (or font sizes, respectively) via the keypad is not yet
1575supported in rxvt-unicode. Bug me if you need this.</p> 1639supported in rxvt-unicode. Bug me if you need this.</p>
1576<p>You can, however, switch fonts at runtime using escape sequences (and 1640<p>You can, however, switch fonts at runtime using escape sequences, e.g.:</p>
1577therefore using the menubar), e.g.:</p>
1578<pre> 1641<pre>
1579 printf '\e]710;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre> 1642 printf '\e]710;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
1643<p>You can use keyboard shortcuts, too:</p>
1644<pre>
1645 URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
1646 URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre>
1580<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> 1647<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p>
1581<p> 1648<p>
1582</p> 1649</p>
1583<hr /> 1650<hr />
1584<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> 1651<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1>
… …
1648<hr /> 1715<hr />
1649<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1716<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1650<p>In addition to the default foreground and background colours, 1717<p>In addition to the default foreground and background colours,
1651<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus 1718<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
1652high-intensity bold/blink versions of the same). Here is a list of the 1719high-intensity bold/blink versions of the same). Here is a list of the
1653colours with their <strong>rgb.txt</strong> names.</p> 1720colours with their names.</p>
1654<table> 1721<table>
1655<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1722<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1656<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1723<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1657<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr> 1724<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr>
1658<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr> 1725<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr>
… …
1686on White. 1753on White.
1687</dd> 1754</dd>
1688<p></p></dl> 1755<p></p></dl>
1689<p> 1756<p>
1690</p> 1757</p>
1758<h2><a name="alpha_channel_support">ALPHA CHANNEL SUPPORT</a></h2>
1759<p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1760their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code>
1761(recommended, but <strong>MUST</strong> have 4 digits/component) colour specifications,
1762in addition to the ones provided by X, where the additional A component
1763specifies opacity (alpha) values. The minimum value of <code>0</code> is completely
1764transparent). You can also prefix any color with <code>[a]</code>, where <code>a</code> is on
1765to four hex digits specifiying the opacity value.</p>
1766<p>You probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that
1767your X-server uses ARGB pixel layout, as X is far from just supporting
1768ARGB visuals out of the box, and rxvt-unicode just fudges around.</p>
1769<p>For example, the following selects an almost completely transparent red
1770background, and an almost opaque pink foreground:</p>
1771<pre>
1772 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg &quot;[e]pink&quot;</pre>
1773<p><em>Please note that transparency of any kind if completely unsupported by
1774the author. Don't bug him with installation questions!</em></p>
1775<p>
1776</p>
1691<hr /> 1777<hr />
1692<h1><a name="environment">ENVIRONMENT</a></h1> 1778<h1><a name="environment">ENVIRONMENT</a></h1>
1693<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p> 1779<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
1694<dl> 1780<dl>
1695<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br /> 1781<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br />
… …
1743<p></p> 1829<p></p>
1744<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br /> 1830<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br />
1745</dt> 1831</dt>
1746<dd> 1832<dd>
1747The shell to be used for command execution, defaults to <code>/bin/sh</code>. 1833The shell to be used for command execution, defaults to <code>/bin/sh</code>.
1748</dd>
1749<p></p>
1750<dt><strong><a name="item_rxvtpath"><strong>RXVTPATH</strong></a></strong><br />
1751</dt>
1752<dd>
1753The path where rxvt looks for support files such as menu and xpm
1754files.
1755</dd>
1756<p></p>
1757<dt><strong><a name="item_path"><strong>PATH</strong></a></strong><br />
1758</dt>
1759<dd>
1760Used in the same way as <a href="#item_rxvtpath"><code>RXVTPATH</code></a>.
1761</dd> 1834</dd>
1762<p></p> 1835<p></p>
1763<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br /> 1836<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br />
1764</dt> 1837</dt>
1765<dd> 1838<dd>
… …
1860</dd> 1933</dd>
1861<p></p> 1934<p></p>
1862<dt><strong><a name="item_geoff_wing__3cgcw_40pobox_2ecom_3e">Geoff Wing <em><a href="mailto:<gcw@pobox.com"><gcw@pobox.com</a></em>&gt;</a></strong><br /> 1935<dt><strong><a name="item_geoff_wing__3cgcw_40pobox_2ecom_3e">Geoff Wing <em><a href="mailto:<gcw@pobox.com"><gcw@pobox.com</a></em>&gt;</a></strong><br />
1863</dt> 1936</dt>
1864<dd> 1937<dd>
1865Rewrote screen display and text selection routines. Project Coordinator 1938Rewrote screen display and text selection routines.
1866(changes.txt 2.4.6 - rxvt-unicode) 1939
1940</dd>
1941<dd>
1942<pre>
1943
1944Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)</pre>
1867</dd> 1945</dd>
1868<p></p> 1946<p></p>
1869<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_2dunicode_40schmorp">Marc Alexander Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>&gt;</a></strong><br /> 1947<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_2dunicode_40schmorp">Marc Alexander Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>&gt;</a></strong><br />
1870</dt> 1948</dt>
1871<dd> 1949<dd>
1872Forked rxvt-unicode, rewrote most of the display code and internal 1950Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1873character handling to store text in unicode, improve xterm 1951extension, random hacks, numerous bugfixes and extensions.
1874compatibility and apply numerous other bugfixes and extensions.
1875</dd> 1952</dd>
1876<dd> 1953<dd>
1877<p>Project Coordinator (Changes 1.0 -)</p> 1954<p>Project Coordinator (Changes 1.0 -)</p>
1955</dd>
1956<p></p>
1957<dt><strong><a name="item_emanuele_giaquinta__3ce_2egiaquinta_40glauco_2eit_">Emanuele Giaquinta <em><a href="mailto:<e.giaquinta@glauco.it"><e.giaquinta@glauco.it</a></em>&gt;</a></strong><br />
1958</dt>
1959<dd>
1960Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1878</dd> 1961</dd>
1879<p></p></dl> 1962<p></p></dl>
1880 1963
1881</body> 1964</body>
1882 1965

Diff Legend

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