… | |
… | |
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>6.3</strong>, is a colour vt102 terminal |
51 | <p><strong>rxvt-unicode</strong>, version <strong>7.0</strong>, is a colour vt102 terminal |
52 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
52 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
53 | require features such as Tektronix 4014 emulation and toolkit-style |
53 | require features such as Tektronix 4014 emulation and toolkit-style |
54 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
54 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
55 | a significant advantage on a machine serving many X sessions.</p> |
55 | a significant advantage on a machine serving many X sessions.</p> |
56 | <p> |
56 | <p> |
… | |
… | |
243 | <p></p> |
243 | <p></p> |
244 | <dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br /> |
244 | <dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br /> |
245 | </dt> |
245 | </dt> |
246 | <dd> |
246 | <dd> |
247 | Select the fonts to be used. This is a comma separated list of font names |
247 | Select the fonts to be used. This is a comma separated list of font names |
248 | that are used in turn when trying to display Unicode characters. The |
248 | that are checked in order when trying to find glyphs for characters. The |
249 | first font defines the cell size for characters; other fonts might be |
249 | first font defines the cell size for characters; other fonts might be |
250 | smaller, but not (in general) larger. A (hopefully) reasonable default |
250 | smaller, but not (in general) larger. A (hopefully) reasonable default |
251 | font list is always appended to it. See resource <strong>font</strong> for more details. |
251 | font list is always appended to it. See resource <strong>font</strong> for more details. |
252 | </dd> |
252 | </dd> |
253 | <dd> |
253 | <dd> |
… | |
… | |
653 | </p> |
653 | </p> |
654 | <hr /> |
654 | <hr /> |
655 | <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> |
656 | <p>Note: `rxvt --help' gives a list of all resources (long |
656 | <p>Note: `rxvt --help' gives a list of all resources (long |
657 | options) compiled into your version.</p> |
657 | options) compiled into your version.</p> |
658 | <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 |
659 | Xresource data: using the X libraries (Xrm*-functions) or internal |
|
|
660 | Xresources reader (<strong>~/.Xdefaults</strong>). For the first method (ie. |
|
|
661 | <strong>rxvt -h</strong> lists <strong>XGetDefaults</strong>), you can set and change the |
|
|
662 | resources using X11 tools like <strong>xrdb</strong>. Many distribution do also load |
|
|
663 | settings from the <strong>~/.Xresources</strong> file when X starts. rxvt |
659 | distribution do also load settings from the <strong>~/.Xresources</strong> file when X |
664 | will consult the following files/resources in order, with later settings |
660 | starts. rxvt will consult the following files/resources in order, |
665 | overwriting earlier ones:</p> |
661 | with later settings overwriting earlier ones:</p> |
666 | <pre> |
662 | <pre> |
667 | 1. system-wide app-defaults file, either locale-dependent OR global |
663 | 1. system-wide app-defaults file, either locale-dependent OR global |
668 | 2. app-defaults file in $XAPPLRESDIR |
664 | 2. app-defaults file in $XAPPLRESDIR |
669 | 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
665 | 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
670 | 4. SCREEN_RESOURCES for the current screen |
666 | 4. SCREEN_RESOURCES for the current screen |
671 | 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename></pre> |
667 | 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename></pre> |
672 | <p>If compiled with internal Xresources support (i.e. <strong>rxvt -h</strong> |
|
|
673 | lists <strong>.Xdefaults</strong>) then <strong>rxvt</strong> accepts application defaults |
|
|
674 | set 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. |
|
|
677 | Note that when reading X resources, <strong>rxvt</strong> recognizes two |
668 | <p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class |
678 | class names: <strong>XTerm</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows |
669 | names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources |
679 | resources common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be |
670 | common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily |
680 | easily configured, while the class name <strong>URxvt</strong> allows resources |
671 | configured, while the class name <strong>URxvt</strong> allows resources unique to |
681 | unique to <strong>rxvt</strong>, notably colours and key-handling, to be |
672 | <strong>rxvt</strong>, to be shared between different <strong>rxvt</strong> |
682 | shared between different <strong>rxvt</strong> configurations. If no |
673 | configurations. If no resources are specified, suitable defaults will |
683 | resources are specified, suitable defaults will be used. Command-line |
674 | be used. Command-line arguments can be used to override resource |
684 | arguments can be used to override resource settings. The following |
675 | settings. The following resources are supported (you might want to |
685 | resources are allowed:</p> |
676 | check the <code>rxvtperl(3)</code> manpage for additional settings by perl |
|
|
677 | extensions not documented here):</p> |
686 | <dl> |
678 | <dl> |
687 | <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 /> |
688 | </dt> |
680 | </dt> |
689 | <dd> |
681 | <dd> |
690 | Create the window with the specified X window geometry [default 80x24]; |
682 | Create the window with the specified X window geometry [default 80x24]; |
… | |
… | |
853 | specifies an integer number of images in that direction. No image will |
845 | specifies an integer number of images in that direction. No image will |
854 | be magnified beyond 10 times its original size. The maximum permitted |
846 | be magnified beyond 10 times its original size. The maximum permitted |
855 | scale is 1000. [default 0x0+50+50] |
847 | scale is 1000. [default 0x0+50+50] |
856 | </dd> |
848 | </dd> |
857 | <p></p> |
849 | <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> |
|
|
861 | Read in the specified menu file (note the `.menu' extension is |
|
|
862 | optional) and also optionally specify a starting tag to find. See the |
|
|
863 | reference 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 /> |
850 | <dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br /> |
867 | </dt> |
851 | </dt> |
868 | <dd> |
852 | <dd> |
869 | Specify the colon-delimited search path for finding files (XPM and |
853 | Specify the colon-delimited search path for finding XPM files. |
870 | menus), in addition to the paths specified by the <strong>RXVTPATH</strong> and |
|
|
871 | <strong>PATH</strong> environment variables. |
|
|
872 | </dd> |
854 | </dd> |
873 | <p></p> |
855 | <p></p> |
874 | <dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br /> |
856 | <dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br /> |
875 | </dt> |
857 | </dt> |
876 | <dd> |
858 | <dd> |
877 | Select the fonts to be used. This is a comma separated list of font |
859 | Select the fonts to be used. This is a comma separated list of font names |
878 | names that are used in turn when trying to display Unicode characters. |
860 | that are checked in order when trying to find glyphs for characters. The |
879 | The first font defines the cell size for characters; other fonts might |
861 | first font defines the cell size for characters; other fonts might be |
880 | be smaller, but not larger. A reasonable default font list is always |
862 | smaller, but not (in general) larger. A (hopefully) reasonable default |
881 | appended to it; option <strong>-fn</strong>. |
863 | font list is always appended to it; option <strong>-fn</strong>. |
882 | </dd> |
864 | </dd> |
883 | <dd> |
865 | <dd> |
884 | <p>Each font can either be a standard X11 core font (XLFD) name, with |
866 | <p>Each font can either be a standard X11 core font (XLFD) name, with |
885 | optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p> |
867 | optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p> |
886 | </dd> |
868 | </dd> |
… | |
… | |
893 | <dd> |
875 | <dd> |
894 | <p>For example, this font resource</p> |
876 | <p>For example, this font resource</p> |
895 | </dd> |
877 | </dd> |
896 | <dd> |
878 | <dd> |
897 | <pre> |
879 | <pre> |
898 | URxvt*font: 9x15bold,\ |
880 | URxvt.font: 9x15bold,\ |
899 | -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ |
881 | -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, \ |
882 | -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \ |
901 | [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ |
883 | [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ |
902 | xft:Code2000:antialias=false</pre> |
884 | xft:Code2000:antialias=false</pre> |
903 | </dd> |
885 | </dd> |
… | |
… | |
1033 | <dd> |
1015 | <dd> |
1034 | <p>Example:</p> |
1016 | <p>Example:</p> |
1035 | </dd> |
1017 | </dd> |
1036 | <dd> |
1018 | <dd> |
1037 | <pre> |
1019 | <pre> |
1038 | URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> |
1020 | URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> |
1039 | </dd> |
1021 | </dd> |
1040 | <dd> |
1022 | <dd> |
1041 | <p>This creates a new file in your home directory with the screen contents |
1023 | <p>This creates a new file in your home directory with the screen contents |
1042 | everytime you hit <code>Print</code>.</p> |
1024 | everytime you hit <code>Print</code>.</p> |
1043 | </dd> |
1025 | </dd> |
… | |
… | |
1280 | sequences enabled by default, which doesn't make it safer, though). |
1262 | sequences enabled by default, which doesn't make it safer, though). |
1281 | </dd> |
1263 | </dd> |
1282 | <dd> |
1264 | <dd> |
1283 | <p>You can enable them by setting this boolean resource or specifying |
1265 | <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, |
1266 | <strong>-insecure</strong> as an option. At the moment, this enables display-answer, |
1285 | locale, findfont, icon label and window title requests as well as dynamic |
1267 | locale, findfont, icon label and window title requests.</p> |
1286 | menubar dispatch.</p> |
|
|
1287 | </dd> |
1268 | </dd> |
1288 | <p></p> |
1269 | <p></p> |
1289 | <dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> |
1270 | <dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> |
1290 | </dt> |
1271 | </dt> |
1291 | <dd> |
1272 | <dd> |
… | |
… | |
1358 | <code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete, |
1339 | <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 |
1340 | <code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it |
1360 | can start or end with whitespace.</p> |
1341 | can start or end with whitespace.</p> |
1361 | </dd> |
1342 | </dd> |
1362 | <dd> |
1343 | <dd> |
1363 | <p>Please note that you need to double the <code>\</code> when using |
1344 | <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 |
1345 | Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of |
1365 | use <code>\033</code> instead of <code>\e</code> (and so on), which will work with both Xt and |
1346 | <code>\e</code> (and so on), which will work with both Xt and rxvt's own |
1366 | rxvt's own processing).</p> |
1347 | processing).</p> |
1367 | </dd> |
1348 | </dd> |
1368 | <dd> |
1349 | <dd> |
1369 | <p>You can define a range of keysyms in one shot by providing a <em>string</em> |
1350 | <p>You can define a range of keysyms in one shot by providing a <em>string</em> |
1370 | with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' |
1351 | with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' |
1371 | should be a character not used by the strings.</p> |
1352 | should be a character not used by the strings.</p> |
… | |
… | |
1500 | <em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource |
1481 | <em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource |
1501 | will be ignored when running setuid/setgid. |
1482 | will be ignored when running setuid/setgid. |
1502 | </dd> |
1483 | </dd> |
1503 | <dd> |
1484 | <dd> |
1504 | <p>See the <code>rxvtperl(3)</code> manpage.</p> |
1485 | <p>See the <code>rxvtperl(3)</code> manpage.</p> |
|
|
1486 | </dd> |
|
|
1487 | <p></p> |
|
|
1488 | <dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>>: <em>perl-regex</em></a></strong><br /> |
|
|
1489 | </dt> |
|
|
1490 | <dd> |
|
|
1491 | Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for |
|
|
1492 | details. |
|
|
1493 | </dd> |
|
|
1494 | <p></p> |
|
|
1495 | <dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>>: <em>perl-transform</em></a></strong><br /> |
|
|
1496 | </dt> |
|
|
1497 | <dd> |
|
|
1498 | Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage |
|
|
1499 | for details. |
|
|
1500 | </dd> |
|
|
1501 | <p></p> |
|
|
1502 | <dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong><br /> |
|
|
1503 | </dt> |
|
|
1504 | <dd> |
|
|
1505 | Sets the hotkey that starts the incremental scrollback buffer search |
|
|
1506 | (default: <code>M-s</code>). |
1505 | </dd> |
1507 | </dd> |
1506 | <p></p> |
1508 | <p></p> |
1507 | <dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong><br /> |
1509 | <dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong><br /> |
1508 | </dt> |
1510 | </dt> |
1509 | <dd> |
1511 | <dd> |
… | |
… | |
1578 | </p> |
1580 | </p> |
1579 | <hr /> |
1581 | <hr /> |
1580 | <h1><a name="changing_fonts">CHANGING FONTS</a></h1> |
1582 | <h1><a name="changing_fonts">CHANGING FONTS</a></h1> |
1581 | <p>Changing fonts (or font sizes, respectively) via the keypad is not yet |
1583 | <p>Changing fonts (or font sizes, respectively) via the keypad is not yet |
1582 | supported in rxvt-unicode. Bug me if you need this.</p> |
1584 | supported in rxvt-unicode. Bug me if you need this.</p> |
1583 | <p>You can, however, switch fonts at runtime using escape sequences (and |
1585 | <p>You can, however, switch fonts at runtime using escape sequences, e.g.:</p> |
1584 | therefore using the menubar), e.g.:</p> |
|
|
1585 | <pre> |
1586 | <pre> |
1586 | printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
1587 | printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
|
|
1588 | <p>You can use keyboard shortcuts, too:</p> |
|
|
1589 | <pre> |
|
|
1590 | URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 |
|
|
1591 | URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre> |
1587 | <p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> |
1592 | <p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> |
1588 | <p> |
1593 | <p> |
1589 | </p> |
1594 | </p> |
1590 | <hr /> |
1595 | <hr /> |
1591 | <h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> |
1596 | <h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> |